error: Simplify giterr_detach

Preserve file error in iterator

When the filesystem iterator encounters an error with a file, it
returns the error but because of the cleanup code, it was in some
cases erasing the error message.  This uses the giterr_detach API
to make sure that the actual error message is restored after the
cleanup code has been run.

Add giterr_detach API to get and clear error

There are a number of cases where it is convenient to be able to
fetch and "claim" the current error string, clearing the error.
This is helpful when you need to call some code that may alter
the error and you want to restore it later on and/or report it via
some other mechanism.

Merge pull request #1939 from ethomson/readwrite_odb

Allow backend consumers to specify file mode

Allow backend consumers to specify file mode

Merge pull request #1317 from libgit2/blame

Blame Canada

Merge pull request #1934 from libgit2/relicense-examples

Relicense examples under CC0

Merge pull request #1937 from scunz/checkout_assert

Don't assert in git_checkout_tree

Merge pull request #1929 from libgit2/rb/misc-diff-fixes

Fix some observed problems with incorrect diffs

examples: doc update

Update the explanation to reflect our use of git_status_list_new() and
make the breaks in rocco more meaningful.

Clarify why GIT_STATUS_CURRENT and index_to_workdir don't always imply
each other. Fixes #1740.

remote: don't write too much when dealing with multivars

We used to move `data_start` forward, which is wrong as that needs to
point to the beginning of the buffer in order to perform size
calculations.

Introduce a `write_start` variable which indicates where we should start
writing from, which is what the `data_start` was being wrongly reused to
be.

Fix a leak in the diff tests

Replace copyright topmatter in example files

Checkout: git_checkout_head is git_checkout_tree without a treeish

The last commit taught git_checkout_tree to actually do something
meaningfull, when treeish was NULL. This lets us rewrite
git_checkout_head to simply call git_checkout_tree without giving it a
treeish.

Checkout: Don't assert if treeish is NULL

In git_checkout_tree, the first check tests if either repo or treeish is
NULL and says that eithor of them has to have a valid value. But there
is no code to handle the treeish == NULL case.

So, do something meaningful in that case: use HEAD instead.

Checkout: Unifiy const-ness of `opts` parameter

Since all 3 checkout APIs perform the same operation with the options,
all of them should use the same const-ness.

Merge pull request #1935 from ethomson/winerrs

preserve windows error numbers as well

preserve windows error numbers as well

Fix --assume-unchanged support

This was never really working right because we were checking the
wrong flag and not checking it in all the places that we need to
be checking it.  I finally got around to writing a test and adding
actual support for it.

More tests and fixed for merging reversed diffs

There were a lot more cases to deal with to make sure that our
merged (i.e. workdir-to-tree-to-index) diffs were matching the
output of core Git.

Relicense examples under CC0

Add git_diff_options_init helper

Sometimes the static initializer for git_diff_options cannot be
used and since setting them to all zeroes doesn't actually work
quite right, this adds a new helper for that situation.

This also adds an explicit new value to the submodule settings
options to be used when those enums need static initialization.

Convert git_index_read to have a "force" flag

This is a little more intuitive than the turned-around option that
I originally wrote.

Make diff and status perform soft index reload

This changes `git_index_read` to have two modes - a hard index
reload that always resets the index to match the on-disk data
(which was the old behavior) and a soft index reload that uses
the timestamp / file size information and only replaces the index
data if the file on disk has been modified.

This then updates the git_status code to do a soft reload unless
the new GIT_STATUS_OPT_NO_REFRESH flag is passed in.

This also changes the behavior of the git_diff functions that use
the index so that when an index is not explicitly passed in (i.e.
when the functions call git_repository_index for you), they will
also do a soft reload for you.

This intentionally breaks the file signature of git_index_read
because there has been some confusion about the behavior previously
and it seems like all existing uses of the API should probably be
examined to select the desired behavior.

Fix some of the glaring errors in GIT_DIFF_REVERSE

These changes fix the basic problem with GIT_DIFF_REVERSE being
broken for text diffs.  The reversed diff entries were getting
added to the git_diff correctly, but some of the metadata was kept
incorrectly in a way that prevented the text diffs from being
generated correctly.  Once I fixed that, it became clear that it
was not possible to merge reversed diffs correctly.  This has a
first pass at fixing that problem.  We probably need more tests
to make sure that is really fixed thoroughly.

Merge pull request #1916 from libgit2/simplify-examples

Fix examples to make the important stuff more obvious

Merge pull request #1933 from libgit2/vmg/gcc-warnings

Warnings for Windows x64 (MSVC) and GCC on Linux

clar: Fix warnings in GCC/Linux

iconv: Do not fake an API when iconv is not available

checkout: Remove unused vector

array: Wrap `array_alloc` as a single statement

pack: `__object_header` always returns unsigned values

Fix warning on win64

Merge pull request #1918 from libgit2/cmn/indexer-naming

indexer: remove the stream infix

config_file: Style fixes

Merge remote-tracking branch 'drodriguez/fix-remote-save' into development

Fix typos

Merge pull request #1928 from libgit2/parse-bad-urls

Improve bad URL handling

A few formatting changes for rocco

I'm not too happy about manually inserting < and > but those get
output as html tags otherwise.

Set new multivar values using unmatcheable regexp.

Seems that regexp in Mac OS X and Linux were behaving
differently: while in OS X the empty string didn't
match any value, in Linux it was matching all of them,
so the the second fetch refspec was overwritting the
first one, instead of creating a new one.

Using an unmatcheable regular expression solves the
problem (and seems to be portable).

Fix memory leaks.

Fix saving remotes with several fetch/push ref specs.

At some moment git_config_delete_entry lost the ability to delete one entry of
a multivar configuration. The moment you had more than one fetch or push
ref spec for a remote you will not be able to save that remote anymore. The
changes in network::remote::remotes::save show that problem.

I needed to create a new git_config_delete_multivar because I was not able to
remove one or several entries of a multivar config with the current API.
Several tries modifying how git_config_set_multivar(..., NULL) behaved were
not successful.

git_config_delete_multivar is very similar to git_config_set_multivar, and
delegates into config_delete_multivar of config_file. This function search
for the cvar_t that will be deleted, storing them in a temporal array, and
rebuilding the linked list. After calling config_write to delete the entries,
the cvar_t stored in the temporal array are freed.

There is a little fix in config_write, it avoids an infinite loop when using
a regular expression (case for the multivars). This error was found by the
test network::remote::remotes::tagopt.

Update examples/README.md

Format comments for use with docco

Prevent another segfault from bad URL

Test another bad URL

Prevent segfault with a badly-formed URL

Add tests for badly-formed URLs

Merge pull request #1924 from linquize/gmtime

Use gmtime() instead of gmtime_t()

Use gmtime() instead of gmtime_t()

The latter is not available on Windows

Test more kinds of bad url

Initialize variables

Clean up showindex sample

Reorganize rev-parse example

rev-list.c example: use common utils, reorganize

Merge pull request #1919 from libgit2/cmn/multi-ack-detailed

protocol: basic support for multi_ack_detailed

merge: any non-zero return from the user is an error

This fixes #1703.

protocol: basic support for multi_ack_detailed

This tells the server that we speak it, but we don't make use of its
extra information to determine if there's a better place to stop
negotiating.

In a somewhat-related change, reorder the capabilities so we ask for
them in the same order as git does.

Also take this opportunity to factor out a fairly-indented portion of
the negotiation logic.

cat-file.c example: deploy helpers, reorg

add.c: proper frontmatter

Remove leftover function declaration

indexer: remove the stream infix

It was there to keep it apart from the one which read in from a file on
disk. This other indexer does not exist anymore, so there is no need for
anything other than git_indexer to refer to it.

While here, rename _add() function to _append() and _finalize() to
_commit(). The former change is cosmetic, while the latter avoids
talking about "finalizing", which OO languages use to mean something
completely different.

init.c example: deploy more helpers

add.c example: deploy helpers, reorg

pack-objects: Depth can be negative

init example: deploy helpers, reorg

Extract common example helpers and reorg examples

This reorganizes a few of the examples so that the main function
comes first with the argument parsing extracted into a helper
that can come at the end of the file (so the example focuses more
on the use of libgit2 instead of command line support).  This also
creates a shared examples/common.[ch] so that useful helper funcs
can be shared across examples instead of repeated.

Adjust for diff API changes

Merge remote-tracking branch 'libgit2/development' into blame

Merge pull request #1891 from libgit2/cmn/fix-thin-packs

Add support for thin packs

Merge pull request #1912 from ethomson/push_err_messages

Test for failure, but don't test the error message

Merge pull request #1904 from libgit2/cmn/ssh-naming

Rename the ssh credentials

Merge pull request #1802 from libgit2/cmn/reflog-backend

Make reflog part of refdb

:heart: bool

Mmmm, GIT_FLEX_ARRAY

Avoid temporary object in lookup routine

Merge pull request #1915 from zcbenz/common-h-before-config-h

The "common.h" should be included before "config.h".

The "common.h" should be included before "config.h".

When building libgit2 for ia32 architecture on a x64 machine, including
"config.h" without a "common.h" would result the following error:
C:\Program Files\Microsoft SDKs\Windows\v7.1\include\winbase.h(2288): error C2373: 'InterlockedIncrement' : redefinition; different type modifiers [C:\cygwin\home\zcbenz\codes\git-utils\build\libgit2.vcxproj]
C:\Program Files\Microsoft SDKs\Windows\v7.1\include\winbase.h(2295): error C2373: 'InterlockedDecrement' : redefinition; different type modifiers [C:\cygwin\home\zcbenz\codes\git-utils\build\libgit2.vcxproj]
C:\Program Files\Microsoft SDKs\Windows\v7.1\include\winbase.h(2303): error C2373: 'InterlockedExchange' : redefinition; different type modifiers [C:\cygwin\home\zcbenz\codes\git-utils\build\libgit2.vcxproj]
C:\Program Files\Microsoft SDKs\Windows\v7.1\include\winbase.h(2314): error C2373: 'InterlockedExchangeAdd' : redefinition; different type modifiers [C:\cygwin\home\zcbenz\codes\git-utils\build\libgit2.vcxproj]

Merge pull request #1913 from nvloff/remove_fedora_spec

remove rpm spec file and readme

remove rpm spec

Fedora provides a rpm package for libgit2 -
https://apps.fedoraproject.org/packages/libgit2.

Test for failure, but don't test the error message

Merge pull request #1910 from ethomson/disable_winhttp

Allow -DWINHTTP=OFF to disable WinHTTP

Merge pull request #1911 from ethomson/http_headers

Use two calls to set two headers

Use two calls to set two headers

Allow -DWINHTTP=OFF to disable WinHTTP

Merge pull request #1907 from nikai3d/patch-1

fix typos in README.md

fix typos in README.md

Really fix the pc file

It turns out that variables have function scope by default. Let's
really set -liconv and add a few libraries that were forgotten in
the previous commit.

We also need to special-case OSX, as they ship zlib but do not provide
a pkg-config file for it.

Merge pull request #1905 from libgit2/cmn/list-deps

Be explicit about dependencies

Merge pull request #1906 from libgit2/cmn/net-cb-errors

transport: let the progress output return an error

transport: let the progress output return an error

There are any number of issues that can come up in the progress
callback, and we should let the user cancel at that point as well.

indexer: include the delta stats

The user is unable to derive the number of deltas in the pack, as that
would require them to capture the stats exactly in the moment between
download and final processing, which is abstracted away in the fetch.

Capture these numbers for the user and expose them in the progress
struct. The clone and fetch examples now also present this information
to the user.

examples: show used local objects in fetch

Show how many local objects were used to fix the thin pack in our fetch
example.

README: add a note about the optional dependencies

Set the correct dependencies in the pkg-config file

When linking statically, the including project needs to know what the
current library build depends on so they can link to it. Store this
information in the pkg-config file.

While here, remove claims that users need to link to zlib or libcrypto.

Rename the ssh credentials

The names from libssh2 are somewhat obtuse for us. We can simplify the
usual key/passphrase credential's name, as well as make clearer what the
custom signature function is.

Merge pull request #1897 from libgit2/split-patch-from-diff

RFC: Proposed reworking of diff APIs

Fix typo

Implement `git_odb_object_dup`

Implement patience and minimal diff flags

It seems that to implement these options, we just have to pass
the appropriate flags through to the libxdiff code taken from
core git.  So let's do it (and add a test).