Initializes a git_blame_options with default values. Equivalent to creating an instance with GIT_BLAME_OPTIONS_INIT.
Gets the number of lines that exist in the blame structure.
\n", + "comments": "", + "group": "blame" + }, + "git_blame_hunkcount": { + "type": "function", + "file": "git2/blame.h", + "line": 252, + "lineto": 252, + "args": [ + { + "name": "blame", + "type": "git_blame *", + "comment": "The blame structure to query." + } + ], + "argline": "git_blame *blame", + "sig": "git_blame *", + "return": { "type": "size_t", "comment": " The number of hunks." }, "description": "Gets the number of hunks that exist in the blame structure.
\n", "comments": "", "group": "blame" }, - "git_blame_get_hunk_byindex": { + "git_blame_hunk_byindex": { "type": "function", "file": "git2/blame.h", - "line": 219, - "lineto": 221, + "line": 261, + "lineto": 263, "args": [ { "name": "blame", @@ -1927,12 +1958,12 @@ }, { "name": "index", - "type": "uint32_t", + "type": "size_t", "comment": "index of the hunk to retrieve" } ], - "argline": "git_blame *blame, uint32_t index", - "sig": "git_blame *::uint32_t", + "argline": "git_blame *blame, size_t index", + "sig": "git_blame *::size_t", "return": { "type": "const git_blame_hunk *", "comment": " the hunk at the given index, or NULL on error" @@ -1941,11 +1972,11 @@ "comments": "", "group": "blame" }, - "git_blame_get_hunk_byline": { + "git_blame_hunk_byline": { "type": "function", "file": "git2/blame.h", - "line": 230, - "lineto": 232, + "line": 273, + "lineto": 275, "args": [ { "name": "blame", @@ -1964,56 +1995,118 @@ "type": "const git_blame_hunk *", "comment": " the hunk that contains the given line, or NULL on error" }, - "description": "Gets the hunk that relates to the given line number in the newest commit.
\n", + "description": "Gets the hunk that relates to the given line number in the newest\n commit.
\n", "comments": "", "group": "blame", "examples": { - "blame.c": ["ex/v1.8.4/blame.html#git_blame_get_hunk_byline-1"] + "blame.c": ["ex/v1.9.1/blame.html#git_blame_hunk_byline-1"] } }, - "git_blame_file": { + "git_blame_line_byindex": { "type": "function", "file": "git2/blame.h", - "line": 245, - "lineto": 249, + "line": 284, + "lineto": 286, "args": [ { - "name": "out", - "type": "git_blame **", - "comment": "pointer that will receive the blame object" + "name": "blame", + "type": "git_blame *", + "comment": "the blame structure to query" }, { - "name": "repo", - "type": "git_repository *", - "comment": "repository whose history is to be walked" + "name": "idx", + "type": "size_t", + "comment": "the (1-based) line number" + } + ], + "argline": "git_blame *blame, size_t idx", + "sig": "git_blame *::size_t", + "return": { + "type": "const git_blame_line *", + "comment": " the blamed line, or NULL on error" + }, + "description": "Gets the information about the line in the blame.
\n", + "comments": "", + "group": "blame" + }, + "git_blame_get_hunk_count": { + "type": "function", + "file": "git2/blame.h", + "line": 296, + "lineto": 296, + "args": [ + { + "name": "blame", + "type": "git_blame *", + "comment": "The blame structure to query." + } + ], + "argline": "git_blame *blame", + "sig": "git_blame *", + "return": { "type": "uint32_t", "comment": " The number of hunks." }, + "description": "Gets the number of hunks that exist in the blame structure.
\n", + "comments": "", + "group": "blame" + }, + "git_blame_get_hunk_byindex": { + "type": "function", + "file": "git2/blame.h", + "line": 305, + "lineto": 307, + "args": [ + { + "name": "blame", + "type": "git_blame *", + "comment": "the blame structure to query" }, { - "name": "path", - "type": "const char *", - "comment": "path to file to consider" + "name": "index", + "type": "uint32_t", + "comment": "index of the hunk to retrieve" + } + ], + "argline": "git_blame *blame, uint32_t index", + "sig": "git_blame *::uint32_t", + "return": { + "type": "const git_blame_hunk *", + "comment": " the hunk at the given index, or NULL on error" + }, + "description": "Gets the blame hunk at the given index.
\n", + "comments": "", + "group": "blame" + }, + "git_blame_get_hunk_byline": { + "type": "function", + "file": "git2/blame.h", + "line": 316, + "lineto": 318, + "args": [ + { + "name": "blame", + "type": "git_blame *", + "comment": "the blame structure to query" }, { - "name": "options", - "type": "git_blame_options *", - "comment": "options for the blame operation. If NULL, this is treated as\n though GIT_BLAME_OPTIONS_INIT were passed." + "name": "lineno", + "type": "size_t", + "comment": "the (1-based) line number to find a hunk for" } ], - "argline": "git_blame **out, git_repository *repo, const char *path, git_blame_options *options", - "sig": "git_blame **::git_repository *::const char *::git_blame_options *", + "argline": "git_blame *blame, size_t lineno", + "sig": "git_blame *::size_t", "return": { - "type": "int", - "comment": " 0 on success, or an error code. (use git_error_last for information\n about the error.)" + "type": "const git_blame_hunk *", + "comment": " the hunk that contains the given line, or NULL on error" }, - "description": "Get the blame for a single file.
\n", + "description": "Gets the hunk that relates to the given line number in the newest commit.
\n", "comments": "", - "group": "blame", - "examples": { "blame.c": ["ex/v1.8.4/blame.html#git_blame_file-2"] } + "group": "blame" }, "git_blame_buffer": { "type": "function", "file": "git2/blame.h", - "line": 269, - "lineto": 273, + "line": 374, + "lineto": 378, "args": [ { "name": "out", @@ -2021,7 +2114,7 @@ "comment": "pointer that will receive the resulting blame data" }, { - "name": "reference", + "name": "base", "type": "git_blame *", "comment": "cached blame from the history of the file (usually the output\n from git_blame_file)" }, @@ -2036,21 +2129,21 @@ "comment": "number of valid bytes in the buffer" } ], - "argline": "git_blame **out, git_blame *reference, const char *buffer, size_t buffer_len", + "argline": "git_blame **out, git_blame *base, const char *buffer, size_t buffer_len", "sig": "git_blame **::git_blame *::const char *::size_t", "return": { "type": "int", "comment": " 0 on success, or an error code. (use git_error_last for information\n about the error)" }, - "description": "Get blame data for a file that has been modified in memory. The reference\n parameter is a pre-calculated blame for the in-odb history of the file. This\n means that once a file blame is completed (which can be expensive), updating\n the buffer blame is very fast.
Get blame data for a file that has been modified in memory. The blame\n parameter is a pre-calculated blame for the in-odb history of the file.\n This means that once a file blame is completed (which can be expensive),\n updating the buffer blame is very fast.
Lines that differ between the buffer and the committed version are marked as having a zero OID for their final_commit_id.
\n", "group": "blame" }, "git_blame_free": { "type": "function", "file": "git2/blame.h", - "line": 280, - "lineto": 280, + "line": 385, + "lineto": 385, "args": [ { "name": "blame", @@ -2064,13 +2157,13 @@ "description": "Free memory allocated by git_blame_file or git_blame_buffer.
\n", "comments": "", "group": "blame", - "examples": { "blame.c": ["ex/v1.8.4/blame.html#git_blame_free-3"] } + "examples": { "blame.c": ["ex/v1.9.1/blame.html#git_blame_free-2"] } }, "git_blob_lookup": { "type": "function", "file": "git2/blob.h", - "line": 33, - "lineto": 33, + "line": 37, + "lineto": 40, "args": [ { "name": "blob", @@ -2095,15 +2188,15 @@ "comments": "", "group": "blob", "examples": { - "blame.c": ["ex/v1.8.4/blame.html#git_blob_lookup-4"], - "general.c": ["ex/v1.8.4/general.html#git_blob_lookup-1"] + "blame.c": ["ex/v1.9.1/blame.html#git_blob_lookup-3"], + "general.c": ["ex/v1.9.1/general.html#git_blob_lookup-1"] } }, "git_blob_lookup_prefix": { "type": "function", "file": "git2/blob.h", - "line": 47, - "lineto": 47, + "line": 54, + "lineto": 54, "args": [ { "name": "blob", @@ -2136,8 +2229,8 @@ "git_blob_free": { "type": "function", "file": "git2/blob.h", - "line": 60, - "lineto": 60, + "line": 67, + "lineto": 67, "args": [ { "name": "blob", "type": "git_blob *", "comment": "the blob to close" } ], @@ -2148,15 +2241,15 @@ "comments": "This is a wrapper around git_object_free()
\n\nIMPORTANT: It is necessary to call this method when you stop using a blob. Failure to do so will cause a memory leak.
\n", "group": "blob", "examples": { - "blame.c": ["ex/v1.8.4/blame.html#git_blob_free-5"], - "general.c": ["ex/v1.8.4/general.html#git_blob_free-2"] + "blame.c": ["ex/v1.9.1/blame.html#git_blob_free-4"], + "general.c": ["ex/v1.9.1/general.html#git_blob_free-2"] } }, "git_blob_id": { "type": "function", "file": "git2/blob.h", - "line": 68, - "lineto": 68, + "line": 75, + "lineto": 75, "args": [ { "name": "blob", @@ -2177,8 +2270,8 @@ "git_blob_owner": { "type": "function", "file": "git2/blob.h", - "line": 76, - "lineto": 76, + "line": 83, + "lineto": 83, "args": [ { "name": "blob", @@ -2199,8 +2292,8 @@ "git_blob_rawcontent": { "type": "function", "file": "git2/blob.h", - "line": 89, - "lineto": 89, + "line": 96, + "lineto": 96, "args": [ { "name": "blob", @@ -2212,22 +2305,22 @@ "sig": "const git_blob *", "return": { "type": "const void *", - "comment": " the pointer, or NULL on error" + "comment": " \n\n `unsigned char *` the pointer, or NULL on error" }, "description": "Get a read-only buffer with the raw content of a blob.
\n", "comments": "A pointer to the raw content of a blob is returned; this pointer is owned internally by the object and shall not be free'd. The pointer may be invalidated at a later time.
\n", "group": "blob", "examples": { - "blame.c": ["ex/v1.8.4/blame.html#git_blob_rawcontent-6"], - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_blob_rawcontent-1"], - "general.c": ["ex/v1.8.4/general.html#git_blob_rawcontent-3"] + "blame.c": ["ex/v1.9.1/blame.html#git_blob_rawcontent-5"], + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_blob_rawcontent-1"], + "general.c": ["ex/v1.9.1/general.html#git_blob_rawcontent-3"] } }, "git_blob_rawsize": { "type": "function", "file": "git2/blob.h", - "line": 97, - "lineto": 97, + "line": 104, + "lineto": 104, "args": [ { "name": "blob", @@ -2237,24 +2330,24 @@ ], "argline": "const git_blob *blob", "sig": "const git_blob *", - "return": { "type": "git_object_size_t", "comment": " size on bytes" }, + "return": { "type": "git_object_size_t", "comment": " size in bytes" }, "description": "Get the size in bytes of the contents of a blob
\n", "comments": "", "group": "blob", "examples": { - "blame.c": ["ex/v1.8.4/blame.html#git_blob_rawsize-7"], - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_blob_rawsize-2"], + "blame.c": ["ex/v1.9.1/blame.html#git_blob_rawsize-6"], + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_blob_rawsize-2"], "general.c": [ - "ex/v1.8.4/general.html#git_blob_rawsize-4", - "ex/v1.8.4/general.html#git_blob_rawsize-5" + "ex/v1.9.1/general.html#git_blob_rawsize-4", + "ex/v1.9.1/general.html#git_blob_rawsize-5" ] } }, "git_blob_filter_options_init": { "type": "function", "file": "git2/blob.h", - "line": 164, - "lineto": 164, + "line": 201, + "lineto": 203, "args": [ { "name": "opts", @@ -2264,7 +2357,7 @@ { "name": "version", "type": "unsigned int", - "comment": "The struct version; pass `GIT_BLOB_FILTER_OPTIONS_VERSION`." + "comment": "The struct version; pass GIT_BLOB_FILTER_OPTIONS_VERSION" } ], "argline": "git_blob_filter_options *opts, unsigned int version", @@ -2280,8 +2373,8 @@ "git_blob_filter": { "type": "function", "file": "git2/blob.h", - "line": 188, - "lineto": 192, + "line": 227, + "lineto": 231, "args": [ { "name": "out", @@ -2306,16 +2399,19 @@ ], "argline": "git_buf *out, git_blob *blob, const char *as_path, git_blob_filter_options *opts", "sig": "git_buf *::git_blob *::const char *::git_blob_filter_options *", - "return": { "type": "int", "comment": " 0 on success or an error code" }, + "return": { + "type": "int", + "comment": " \n\n[enum] git_error_code 0 on success or an error code" + }, "description": "Get a buffer with the filtered content of a blob.
\n", - "comments": "This applies filters as if the blob was being checked out to the working directory under the specified filename. This may apply CRLF filtering or other types of changes depending on the file attributes set for the blob and the content detected in it.
\n\nThe output is written into a git_buf which the caller must free when done (via git_buf_dispose).
If no filters need to be applied, then the out buffer will just be populated with a pointer to the raw content of the blob. In that case, be careful to not free the blob until done with the buffer or copy it into memory you own.
This applies filters as if the blob was being checked out to the working directory under the specified filename. This may apply CRLF filtering or other types of changes depending on the file attributes set for the blob and the content detected in it.
\n\nThe output is written into a git_buf which the caller must dispose when done (via git_buf_dispose).
If no filters need to be applied, then the out buffer will just be populated with a pointer to the raw content of the blob. In that case, be careful to not free the blob until done with the buffer or copy it into memory you own.
Read a file from the working folder of a repository\n and write it to the Object Database as a loose blob
\n", + "description": "Read a file from the working folder of a repository and write it\n to the object database.
\n", "comments": "", "group": "blob" }, "git_blob_create_from_disk": { "type": "function", "file": "git2/blob.h", - "line": 217, - "lineto": 217, + "line": 257, + "lineto": 260, "args": [ { "name": "id", @@ -2365,15 +2461,15 @@ "argline": "git_oid *id, git_repository *repo, const char *path", "sig": "git_oid *::git_repository *::const char *", "return": { "type": "int", "comment": " 0 or an error code" }, - "description": "Read a file from the filesystem and write its content\n to the Object Database as a loose blob
\n", + "description": "Read a file from the filesystem (not necessarily inside the\n working folder of the repository) and write it to the object\n database.
\n", "comments": "", "group": "blob" }, "git_blob_create_from_stream": { "type": "function", "file": "git2/blob.h", - "line": 244, - "lineto": 247, + "line": 287, + "lineto": 290, "args": [ { "name": "out", @@ -2394,15 +2490,15 @@ "argline": "git_writestream **out, git_repository *repo, const char *hintpath", "sig": "git_writestream **::git_repository *::const char *", "return": { "type": "int", "comment": " 0 or error code" }, - "description": "Create a stream to write a new blob into the object db
\n", + "description": "Create a stream to write a new blob into the object database.
\n", "comments": "This function may need to buffer the data on disk and will in general not be the right choice if you know the size of the data to write. If you have data in memory, use git_blob_create_from_buffer(). If you do not, but know the size of the contents (and don't want/need to perform filtering), use git_odb_open_wstream().
Don't close this stream yourself but pass it to git_blob_create_from_stream_commit() to commit the write to the object db and get the object id.
If the hintpath parameter is filled, it will be used to determine what git filters should be applied to the object before it is written to the object database.
Close the stream and write the blob to the object db
\n", + "description": "Close the stream and finalize writing the blob to the object database.
\n", "comments": "The stream will be closed and freed.
\n", "group": "blob" }, "git_blob_create_from_buffer": { "type": "function", "file": "git2/blob.h", - "line": 271, - "lineto": 272, + "line": 314, + "lineto": 315, "args": [ { "name": "id", @@ -2448,15 +2544,15 @@ "argline": "git_oid *id, git_repository *repo, const void *buffer, size_t len", "sig": "git_oid *::git_repository *::const void *::size_t", "return": { "type": "int", "comment": " 0 or an error code" }, - "description": "Write an in-memory buffer to the ODB as a blob
\n", + "description": "Write an in-memory buffer to the object database as a blob.
\n", "comments": "", "group": "blob" }, "git_blob_is_binary": { "type": "function", "file": "git2/blob.h", - "line": 285, - "lineto": 285, + "line": 328, + "lineto": 328, "args": [ { "name": "blob", @@ -2468,17 +2564,17 @@ "sig": "const git_blob *", "return": { "type": "int", - "comment": " 1 if the content of the blob is detected\n as binary; 0 otherwise." + "comment": " \n\n bool 1 if the content of the blob is detected\n as binary; 0 otherwise." }, - "description": "Determine if the blob content is most certainly binary or not.
\n", + "description": "Determine if the blob content is most likely binary or not.
\n", "comments": "The heuristic used to guess if a file is binary is taken from core git: Searching for NUL bytes and looking for a reasonable ratio of printable to non-printable characters among the first 8000 bytes.
\n", "group": "blob" }, "git_blob_data_is_binary": { "type": "function", "file": "git2/blob.h", - "line": 297, - "lineto": 297, + "line": 340, + "lineto": 340, "args": [ { "name": "data", @@ -2500,8 +2596,8 @@ "git_blob_dup": { "type": "function", "file": "git2/blob.h", - "line": 307, - "lineto": 307, + "line": 350, + "lineto": 350, "args": [ { "name": "out", @@ -2524,8 +2620,8 @@ "git_branch_create": { "type": "function", "file": "git2/branch.h", - "line": 52, - "lineto": 57, + "line": 53, + "lineto": 58, "args": [ { "name": "out", @@ -2540,12 +2636,12 @@ { "name": "branch_name", "type": "const char *", - "comment": "Name for the branch; this name is\n validated for consistency. It should also not conflict with\n an already existing branch name." + "comment": "Name for the branch; this name is\n validated for consistency. It should also not conflict with\n an already existing branch name." }, { "name": "target", "type": "const git_commit *", - "comment": "Commit to which this branch should point. This object\n must belong to the given `repo`." + "comment": "Commit to which this branch should point. This object\n must belong to the given `repo`." }, { "name": "force", @@ -2566,36 +2662,55 @@ "git_branch_create_from_annotated": { "type": "function", "file": "git2/branch.h", - "line": 70, - "lineto": 75, + "line": 77, + "lineto": 82, "args": [ - { "name": "ref_out", "type": "git_reference **", "comment": null }, - { "name": "repository", "type": "git_repository *", "comment": null }, - { "name": "branch_name", "type": "const char *", "comment": null }, { - "name": "commit", + "name": "ref_out", + "type": "git_reference **", + "comment": "Pointer where to store the underlying reference." + }, + { + "name": "repo", + "type": "git_repository *", + "comment": "the repository to create the branch in." + }, + { + "name": "branch_name", + "type": "const char *", + "comment": "Name for the branch; this name is\n validated for consistency. It should also not conflict with\n an already existing branch name." + }, + { + "name": "target", "type": "const git_annotated_commit *", - "comment": null + "comment": "Annotated commit to which this branch should point. This\n object must belong to the given `repo`." }, - { "name": "force", "type": "int", "comment": null } + { + "name": "force", + "type": "int", + "comment": "Overwrite existing branch." + } ], - "argline": "git_reference **ref_out, git_repository *repository, const char *branch_name, const git_annotated_commit *commit, int force", + "argline": "git_reference **ref_out, git_repository *repo, const char *branch_name, const git_annotated_commit *target, int force", "sig": "git_reference **::git_repository *::const char *::const git_annotated_commit *::int", - "return": { "type": "int", "comment": null }, + "return": { + "type": "int", + "comment": " 0, GIT_EINVALIDSPEC or an error code." + }, "description": "Create a new branch pointing at a target commit
\n", - "comments": "This behaves like git_branch_create() but takes an annotated commit, which lets you specify which extended sha syntax string was specified by a user, allowing for more exact reflog messages.
See the documentation for git_branch_create().
This behaves like git_branch_create() but takes an annotated commit, which lets you specify which extended sha syntax string was specified by a user, allowing for more exact reflog messages.
Get the branch name
\n", "comments": "Given a reference object, this will check that it really is a branch (ie. it lives under "refs/heads/" or "refs/remotes/"), and return the branch part of it.
\n", "group": "branch", - "examples": { "merge.c": ["ex/v1.8.4/merge.html#git_branch_name-4"] } + "examples": { "merge.c": ["ex/v1.9.1/merge.html#git_branch_name-4"] } }, "git_branch_upstream": { "type": "function", "file": "git2/branch.h", - "line": 209, - "lineto": 211, + "line": 216, + "lineto": 218, "args": [ { "name": "out", @@ -2825,8 +2940,8 @@ "git_branch_set_upstream": { "type": "function", "file": "git2/branch.h", - "line": 228, - "lineto": 230, + "line": 235, + "lineto": 237, "args": [ { "name": "branch", @@ -2843,7 +2958,7 @@ "sig": "git_reference *::const char *", "return": { "type": "int", - "comment": " 0 on success; GIT_ENOTFOUND if there's no branch named `branch_name`\n or an error code" + "comment": " \n\n git_error_t 0 on success; GIT_ENOTFOUND if there's no branch named `branch_name`\n or an error code" }, "description": "Set a branch's upstream branch
\n", "comments": "This will update the configuration to set the branch named branch_name as the upstream of branch. Pass a NULL name to unset the upstream information.
Clone a remote repository.
\n", - "comments": "By default this creates its repository and initial remote to match git's defaults. You can use the options in the callback to customize how these are created.
\n", + "comments": "By default this creates its repository and initial remote to match git's defaults. You can use the options in the callback to customize how these are created.
\n\nNote that the libgit2 library must be initialized using git_libgit2_init before any APIs can be called, including this one.
The returned object should be released with git_commit_free when no longer needed.
This is a wrapper around git_object_free()
\n\nIMPORTANT: It is necessary to call this method when you stop using a commit. Failure to do so will cause a memory leak.
\n", "group": "commit", "examples": { - "checkout.c": ["ex/v1.8.4/checkout.html#git_commit_free-10"], + "checkout.c": ["ex/v1.9.1/checkout.html#git_commit_free-10"], "general.c": [ - "ex/v1.8.4/general.html#git_commit_free-9", - "ex/v1.8.4/general.html#git_commit_free-10", - "ex/v1.8.4/general.html#git_commit_free-11", - "ex/v1.8.4/general.html#git_commit_free-12", - "ex/v1.8.4/general.html#git_commit_free-13" + "ex/v1.9.1/general.html#git_commit_free-9", + "ex/v1.9.1/general.html#git_commit_free-10", + "ex/v1.9.1/general.html#git_commit_free-11", + "ex/v1.9.1/general.html#git_commit_free-12", + "ex/v1.9.1/general.html#git_commit_free-13" ], "log.c": [ - "ex/v1.8.4/log.html#git_commit_free-2", - "ex/v1.8.4/log.html#git_commit_free-3", - "ex/v1.8.4/log.html#git_commit_free-4", - "ex/v1.8.4/log.html#git_commit_free-5" + "ex/v1.9.1/log.html#git_commit_free-2", + "ex/v1.9.1/log.html#git_commit_free-3", + "ex/v1.9.1/log.html#git_commit_free-4", + "ex/v1.9.1/log.html#git_commit_free-5" ] } }, "git_commit_id": { "type": "function", "file": "git2/commit.h", - "line": 78, - "lineto": 78, + "line": 82, + "lineto": 82, "args": [ { "name": "commit", @@ -3487,15 +3602,15 @@ "comments": "", "group": "commit", "examples": { - "general.c": ["ex/v1.8.4/general.html#git_commit_id-14"], - "log.c": ["ex/v1.8.4/log.html#git_commit_id-6"] + "general.c": ["ex/v1.9.1/general.html#git_commit_id-14"], + "log.c": ["ex/v1.9.1/log.html#git_commit_id-6"] } }, "git_commit_owner": { "type": "function", "file": "git2/commit.h", - "line": 86, - "lineto": 86, + "line": 90, + "lineto": 90, "args": [ { "name": "commit", @@ -3514,16 +3629,16 @@ "group": "commit", "examples": { "log.c": [ - "ex/v1.8.4/log.html#git_commit_owner-7", - "ex/v1.8.4/log.html#git_commit_owner-8" + "ex/v1.9.1/log.html#git_commit_owner-7", + "ex/v1.9.1/log.html#git_commit_owner-8" ] } }, "git_commit_message_encoding": { "type": "function", "file": "git2/commit.h", - "line": 98, - "lineto": 98, + "line": 102, + "lineto": 102, "args": [ { "name": "commit", @@ -3541,8 +3656,8 @@ "git_commit_message": { "type": "function", "file": "git2/commit.h", - "line": 109, - "lineto": 109, + "line": 113, + "lineto": 113, "args": [ { "name": "commit", @@ -3561,27 +3676,27 @@ "group": "commit", "examples": { "cat-file.c": [ - "ex/v1.8.4/cat-file.html#git_commit_message-3", - "ex/v1.8.4/cat-file.html#git_commit_message-4" + "ex/v1.9.1/cat-file.html#git_commit_message-3", + "ex/v1.9.1/cat-file.html#git_commit_message-4" ], "general.c": [ - "ex/v1.8.4/general.html#git_commit_message-15", - "ex/v1.8.4/general.html#git_commit_message-16", - "ex/v1.8.4/general.html#git_commit_message-17" + "ex/v1.9.1/general.html#git_commit_message-15", + "ex/v1.9.1/general.html#git_commit_message-16", + "ex/v1.9.1/general.html#git_commit_message-17" ], "log.c": [ - "ex/v1.8.4/log.html#git_commit_message-9", - "ex/v1.8.4/log.html#git_commit_message-10", - "ex/v1.8.4/log.html#git_commit_message-11" + "ex/v1.9.1/log.html#git_commit_message-9", + "ex/v1.9.1/log.html#git_commit_message-10", + "ex/v1.9.1/log.html#git_commit_message-11" ], - "tag.c": ["ex/v1.8.4/tag.html#git_commit_message-2"] + "tag.c": ["ex/v1.9.1/tag.html#git_commit_message-2"] } }, "git_commit_message_raw": { "type": "function", "file": "git2/commit.h", - "line": 117, - "lineto": 117, + "line": 121, + "lineto": 121, "args": [ { "name": "commit", @@ -3602,8 +3717,8 @@ "git_commit_summary": { "type": "function", "file": "git2/commit.h", - "line": 128, - "lineto": 128, + "line": 132, + "lineto": 132, "args": [ { "name": "commit", @@ -3624,8 +3739,8 @@ "git_commit_body": { "type": "function", "file": "git2/commit.h", - "line": 141, - "lineto": 141, + "line": 145, + "lineto": 145, "args": [ { "name": "commit", @@ -3646,8 +3761,8 @@ "git_commit_time": { "type": "function", "file": "git2/commit.h", - "line": 149, - "lineto": 149, + "line": 153, + "lineto": 153, "args": [ { "name": "commit", @@ -3663,16 +3778,16 @@ "group": "commit", "examples": { "general.c": [ - "ex/v1.8.4/general.html#git_commit_time-18", - "ex/v1.8.4/general.html#git_commit_time-19" + "ex/v1.9.1/general.html#git_commit_time-18", + "ex/v1.9.1/general.html#git_commit_time-19" ] } }, "git_commit_time_offset": { "type": "function", "file": "git2/commit.h", - "line": 157, - "lineto": 157, + "line": 161, + "lineto": 161, "args": [ { "name": "commit", @@ -3693,8 +3808,8 @@ "git_commit_committer": { "type": "function", "file": "git2/commit.h", - "line": 165, - "lineto": 165, + "line": 169, + "lineto": 169, "args": [ { "name": "commit", @@ -3712,16 +3827,16 @@ "comments": "", "group": "commit", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_commit_committer-5"], - "general.c": ["ex/v1.8.4/general.html#git_commit_committer-20"], - "log.c": ["ex/v1.8.4/log.html#git_commit_committer-12"] + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_commit_committer-5"], + "general.c": ["ex/v1.9.1/general.html#git_commit_committer-20"], + "log.c": ["ex/v1.9.1/log.html#git_commit_committer-12"] } }, "git_commit_author": { "type": "function", "file": "git2/commit.h", - "line": 173, - "lineto": 173, + "line": 177, + "lineto": 177, "args": [ { "name": "commit", @@ -3739,22 +3854,22 @@ "comments": "", "group": "commit", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_commit_author-6"], + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_commit_author-6"], "general.c": [ - "ex/v1.8.4/general.html#git_commit_author-21", - "ex/v1.8.4/general.html#git_commit_author-22" + "ex/v1.9.1/general.html#git_commit_author-21", + "ex/v1.9.1/general.html#git_commit_author-22" ], "log.c": [ - "ex/v1.8.4/log.html#git_commit_author-13", - "ex/v1.8.4/log.html#git_commit_author-14" + "ex/v1.9.1/log.html#git_commit_author-13", + "ex/v1.9.1/log.html#git_commit_author-14" ] } }, "git_commit_committer_with_mailmap": { "type": "function", "file": "git2/commit.h", - "line": 186, - "lineto": 187, + "line": 190, + "lineto": 191, "args": [ { "name": "out", @@ -3782,8 +3897,8 @@ "git_commit_author_with_mailmap": { "type": "function", "file": "git2/commit.h", - "line": 200, - "lineto": 201, + "line": 204, + "lineto": 205, "args": [ { "name": "out", @@ -3811,8 +3926,8 @@ "git_commit_raw_header": { "type": "function", "file": "git2/commit.h", - "line": 209, - "lineto": 209, + "line": 213, + "lineto": 213, "args": [ { "name": "commit", @@ -3833,8 +3948,8 @@ "git_commit_tree": { "type": "function", "file": "git2/commit.h", - "line": 218, - "lineto": 218, + "line": 222, + "lineto": 222, "args": [ { "name": "tree_out", @@ -3855,19 +3970,19 @@ "group": "commit", "examples": { "log.c": [ - "ex/v1.8.4/log.html#git_commit_tree-15", - "ex/v1.8.4/log.html#git_commit_tree-16", - "ex/v1.8.4/log.html#git_commit_tree-17", - "ex/v1.8.4/log.html#git_commit_tree-18", - "ex/v1.8.4/log.html#git_commit_tree-19" + "ex/v1.9.1/log.html#git_commit_tree-15", + "ex/v1.9.1/log.html#git_commit_tree-16", + "ex/v1.9.1/log.html#git_commit_tree-17", + "ex/v1.9.1/log.html#git_commit_tree-18", + "ex/v1.9.1/log.html#git_commit_tree-19" ] } }, "git_commit_tree_id": { "type": "function", "file": "git2/commit.h", - "line": 228, - "lineto": 228, + "line": 232, + "lineto": 232, "args": [ { "name": "commit", @@ -3885,14 +4000,14 @@ "comments": "", "group": "commit", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_commit_tree_id-7"] + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_commit_tree_id-7"] } }, "git_commit_parentcount": { "type": "function", "file": "git2/commit.h", - "line": 236, - "lineto": 236, + "line": 240, + "lineto": 240, "args": [ { "name": "commit", @@ -3910,19 +4025,19 @@ "comments": "", "group": "commit", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_commit_parentcount-8"], - "general.c": ["ex/v1.8.4/general.html#git_commit_parentcount-23"], + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_commit_parentcount-8"], + "general.c": ["ex/v1.9.1/general.html#git_commit_parentcount-23"], "log.c": [ - "ex/v1.8.4/log.html#git_commit_parentcount-20", - "ex/v1.8.4/log.html#git_commit_parentcount-21" + "ex/v1.9.1/log.html#git_commit_parentcount-20", + "ex/v1.9.1/log.html#git_commit_parentcount-21" ] } }, "git_commit_parent": { "type": "function", "file": "git2/commit.h", - "line": 246, - "lineto": 249, + "line": 250, + "lineto": 253, "args": [ { "name": "out", @@ -3947,18 +4062,18 @@ "comments": "", "group": "commit", "examples": { - "general.c": ["ex/v1.8.4/general.html#git_commit_parent-24"], + "general.c": ["ex/v1.9.1/general.html#git_commit_parent-24"], "log.c": [ - "ex/v1.8.4/log.html#git_commit_parent-22", - "ex/v1.8.4/log.html#git_commit_parent-23" + "ex/v1.9.1/log.html#git_commit_parent-22", + "ex/v1.9.1/log.html#git_commit_parent-23" ] } }, "git_commit_parent_id": { "type": "function", "file": "git2/commit.h", - "line": 260, - "lineto": 262, + "line": 264, + "lineto": 266, "args": [ { "name": "commit", @@ -3981,15 +4096,15 @@ "comments": "", "group": "commit", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_commit_parent_id-9"], - "log.c": ["ex/v1.8.4/log.html#git_commit_parent_id-24"] + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_commit_parent_id-9"], + "log.c": ["ex/v1.9.1/log.html#git_commit_parent_id-24"] } }, "git_commit_nth_gen_ancestor": { "type": "function", "file": "git2/commit.h", - "line": 278, - "lineto": 281, + "line": 282, + "lineto": 285, "args": [ { "name": "ancestor", @@ -4020,8 +4135,8 @@ "git_commit_header_field": { "type": "function", "file": "git2/commit.h", - "line": 293, - "lineto": 293, + "line": 297, + "lineto": 297, "args": [ { "name": "out", @@ -4052,8 +4167,8 @@ "git_commit_extract_signature": { "type": "function", "file": "git2/commit.h", - "line": 313, - "lineto": 313, + "line": 317, + "lineto": 317, "args": [ { "name": "signature", @@ -4094,8 +4209,8 @@ "git_commit_create": { "type": "function", "file": "git2/commit.h", - "line": 359, - "lineto": 369, + "line": 363, + "lineto": 373, "args": [ { "name": "id", @@ -4157,122 +4272,184 @@ "description": "Create new commit in the repository from a list of git_object pointers
The message will not be cleaned up automatically. You can do that with the git_message_prettify() function.
Create new commit in the repository using a variable argument list.
\n", - "comments": "The message will not be cleaned up automatically. You can do that with the git_message_prettify() function.
The parents for the commit are specified as a variable list of pointers to const git_commit *. Note that this is a convenience method which may not be safe to export for certain languages or compilers
All other parameters remain the same as git_commit_create().
Commits the staged changes in the repository; this is a near analog to\n git commit -m message.
By default, empty commits are not allowed.
\n", - "group": "commit" - }, - "git_commit_amend": { - "type": "function", - "file": "git2/commit.h", - "line": 461, - "lineto": 469, - "args": [ - { "name": "id", "type": "git_oid *", "comment": null }, - { - "name": "commit_to_amend", - "type": "const git_commit *", - "comment": null - }, - { "name": "update_ref", "type": "const char *", "comment": null }, - { "name": "author", "type": "const git_signature *", "comment": null }, - { - "name": "committer", - "type": "const git_signature *", - "comment": null - }, - { "name": "message_encoding", "type": "const char *", "comment": null }, - { "name": "message", "type": "const char *", "comment": null }, - { "name": "tree", "type": "const git_tree *", "comment": null } - ], - "argline": "git_oid *id, const git_commit *commit_to_amend, const char *update_ref, const git_signature *author, const git_signature *committer, const char *message_encoding, const char *message, const git_tree *tree", - "sig": "git_oid *::const git_commit *::const char *::const git_signature *::const git_signature *::const char *::const char *::const git_tree *", - "return": { "type": "int", "comment": null }, - "description": "Amend an existing commit by replacing only non-NULL values.
\n", - "comments": "This creates a new commit that is exactly the same as the old commit, except that any non-NULL values will be updated. The new commit has the same parents as the old commit.
\n\nThe update_ref value works as in the regular git_commit_create(), updating the ref to point to the newly rewritten commit. If you want to amend a commit that is not currently the tip of the branch and then rewrite the following commits to reach a ref, pass this as NULL and update the rest of the commit chain and ref separately.
Unlike git_commit_create(), the author, committer, message, message_encoding, and tree parameters can be NULL in which case this will use the values from the original commit_to_amend.
All parameters have the same meanings as in git_commit_create().
Create new commit in the repository using a variable argument list.
\n", + "comments": "The message will not be cleaned up automatically. You can do that with the git_message_prettify() function.
The parents for the commit are specified as a variable list of pointers to const git_commit *. Note that this is a convenience method which may not be safe to export for certain languages or compilers
All other parameters remain the same as git_commit_create().
Commits the staged changes in the repository; this is a near analog to\n git commit -m message.
By default, empty commits are not allowed.
\n", + "group": "commit" + }, + "git_commit_amend": { + "type": "function", + "file": "git2/commit.h", + "line": 528, + "lineto": 536, + "args": [ + { + "name": "id", + "type": "git_oid *", + "comment": "Pointer in which to store the OID of the newly created commit" + }, + { + "name": "commit_to_amend", + "type": "const git_commit *", + "comment": "The commit to amend" + }, + { + "name": "update_ref", + "type": "const char *", + "comment": "If not NULL, name of the reference that\n\twill be updated to point to this commit. If the reference\n\tis not direct, it will be resolved to a direct reference.\n\tUse \"HEAD\" to update the HEAD of the current branch and\n\tmake it point to this commit. If the reference doesn't\n\texist yet, it will be created. If it does exist, the first\n\tparent must be the tip of this branch." + }, + { + "name": "author", + "type": "const git_signature *", + "comment": "Signature with author and author time of commit" + }, + { + "name": "committer", + "type": "const git_signature *", + "comment": "Signature with committer and * commit time of commit" + }, + { + "name": "message_encoding", + "type": "const char *", + "comment": "The encoding for the message in the\n commit, represented with a standard encoding name.\n E.g. \"UTF-8\". If NULL, no encoding header is written and\n UTF-8 is assumed." + }, + { + "name": "message", + "type": "const char *", + "comment": "Full message for this commit" + }, + { + "name": "tree", + "type": "const git_tree *", + "comment": "An instance of a `git_tree` object that will\n be used as the tree for the commit. This tree object must\n also be owned by the given `repo`." + } + ], + "argline": "git_oid *id, const git_commit *commit_to_amend, const char *update_ref, const git_signature *author, const git_signature *committer, const char *message_encoding, const char *message, const git_tree *tree", + "sig": "git_oid *::const git_commit *::const char *::const git_signature *::const git_signature *::const char *::const char *::const git_tree *", + "return": { + "type": "int", + "comment": " 0 or an error code\n\tThe created commit will be written to the Object Database and\n\tthe given reference will be updated to point to it" + }, + "description": "Amend an existing commit by replacing only non-NULL values.
\n", + "comments": "This creates a new commit that is exactly the same as the old commit, except that any non-NULL values will be updated. The new commit has the same parents as the old commit.
\n\nThe update_ref value works as in the regular git_commit_create(), updating the ref to point to the newly rewritten commit. If you want to amend a commit that is not currently the tip of the branch and then rewrite the following commits to reach a ref, pass this as NULL and update the rest of the commit chain and ref separately.
Unlike git_commit_create(), the author, committer, message, message_encoding, and tree parameters can be NULL in which case this will use the values from the original commit_to_amend.
All parameters have the same meanings as in git_commit_create().
Query compile time options for libgit2.
\n", - "comments": "GIT_FEATURE_THREADS Libgit2 was compiled with thread support. Note that thread support is still to be seen as a 'work in progress' - basic object lookups are believed to be threadsafe, but other operations may not be.
GIT_FEATURE_HTTPS Libgit2 supports the https:// protocol. This requires the openssl library to be found when compiling libgit2.
GIT_FEATURE_SSH Libgit2 supports the SSH protocol for network operations. This requires the libssh2 library to be found when compiling libgit2
GIT_FEATURE_NSEC Libgit2 supports the sub-second resolution in file modification times.
Query the backend details for the compile-time feature in libgit2.
\n", + "comments": "This will return the "backend" for the feature, which is useful for things like HTTPS or SSH support, that can have multiple backends that could be compiled in.
\n\nFor example, when libgit2 is compiled with dynamic OpenSSL support, the feature backend will be openssl-dynamic. The feature backend names reflect the compilation options specified to the build system (though in all lower case). The backend may be "builtin" for features that are provided by libgit2 itself.
If the feature is not supported by the library, this API returns NULL.
Set or query a library global option
\n", - "comments": "Available options:
\n\n* opts(GIT_OPT_GET_MWINDOW_SIZE, size_t *):\n\n > Get the maximum mmap window size\n\n* opts(GIT_OPT_SET_MWINDOW_SIZE, size_t):\n\n > Set the maximum mmap window size\n\n* opts(GIT_OPT_GET_MWINDOW_MAPPED_LIMIT, size_t *):\n\n > Get the maximum memory that will be mapped in total by the library\n\n* opts(GIT_OPT_SET_MWINDOW_MAPPED_LIMIT, size_t):\n\n > Set the maximum amount of memory that can be mapped at any time > by the library\n\n* opts(GIT_OPT_GET_MWINDOW_FILE_LIMIT, size_t *):\n\n > Get the maximum number of files that will be mapped at any time by the > library\n\n* opts(GIT_OPT_SET_MWINDOW_FILE_LIMIT, size_t):\n\n > Set the maximum number of files that can be mapped at any time > by the library. The default (0) is unlimited.\n\n* opts(GIT_OPT_GET_SEARCH_PATH, int level, git_buf *buf)\n\n > Get the search path for a given level of config data. "level" must > be one of `GIT_CONFIG_LEVEL_SYSTEM`, `GIT_CONFIG_LEVEL_GLOBAL`, > `GIT_CONFIG_LEVEL_XDG`, or `GIT_CONFIG_LEVEL_PROGRAMDATA`. > The search path is written to the `out` buffer.\n\n* opts(GIT_OPT_SET_SEARCH_PATH, int level, const char *path)\n\n > Set the search path for a level of config data. The search path > applied to shared attributes and ignore files, too. > > - `path` lists directories delimited by GIT_PATH_LIST_SEPARATOR. > Pass NULL to reset to the default (generally based on environment > variables). Use magic path `$PATH` to include the old value > of the path (if you want to prepend or append, for instance). > > - `level` must be `GIT_CONFIG_LEVEL_SYSTEM`, > `GIT_CONFIG_LEVEL_GLOBAL`, `GIT_CONFIG_LEVEL_XDG`, or > `GIT_CONFIG_LEVEL_PROGRAMDATA`.\n\n* opts(GIT_OPT_SET_CACHE_OBJECT_LIMIT, git_object_t type, size_t size)\n\n > Set the maximum data size for the given type of object to be > considered eligible for caching in memory. Setting to value to > zero means that that type of object will not be cached. > Defaults to 0 for GIT_OBJECT_BLOB (i.e. won't cache blobs) and 4k > for GIT_OBJECT_COMMIT, GIT_OBJECT_TREE, and GIT_OBJECT_TAG.\n\n* opts(GIT_OPT_SET_CACHE_MAX_SIZE, ssize_t max_storage_bytes)\n\n > Set the maximum total data size that will be cached in memory > across all repositories before libgit2 starts evicting objects > from the cache. This is a soft limit, in that the library might > briefly exceed it, but will start aggressively evicting objects > from cache when that happens. The default cache size is 256MB.\n\n* opts(GIT_OPT_ENABLE_CACHING, int enabled)\n\n > Enable or disable caching completely. > > Because caches are repository-specific, disabling the cache > cannot immediately clear all cached objects, but each cache will > be cleared on the next attempt to update anything in it.\n\n* opts(GIT_OPT_GET_CACHED_MEMORY, ssize_t *current, ssize_t *allowed)\n\n > Get the current bytes in cache and the maximum that would be > allowed in the cache.\n\n* opts(GIT_OPT_GET_TEMPLATE_PATH, git_buf *out)\n\n > Get the default template path. > The path is written to the `out` buffer.\n\n* opts(GIT_OPT_SET_TEMPLATE_PATH, const char *path)\n\n > Set the default template path. > > - `path` directory of template.\n\n* opts(GIT_OPT_SET_SSL_CERT_LOCATIONS, const char *file, const char *path)\n\n > Set the SSL certificate-authority locations. > > - `file` is the location of a file containing several > certificates concatenated together. > - `path` is the location of a directory holding several > certificates, one per file. > > Either parameter may be `NULL`, but not both.\n\n* opts(GIT_OPT_SET_USER_AGENT, const char *user_agent)\n\n > Set the value of the comment section of the User-Agent header. > This can be information about your product and its version. > By default this is "libgit2" followed by the libgit2 version. > > This value will be appended to User-Agent _product_, which > is typically set to "git/2.0". > > Set to the empty string ("") to not send any information in the > comment section, or set to NULL to restore the default.\n\n* opts(GIT_OPT_GET_USER_AGENT, git_buf *out)\n\n > Get the value of the User-Agent header. > The User-Agent is written to the `out` buffer.\n\n* opts(GIT_OPT_SET_USER_AGENT_PRODUCT, const char *user_agent_product)\n\n > Set the value of the product portion of the User-Agent header. > This defaults to "git/2.0", for compatibility with other git > clients. It is recommended to keep this as git/<version> for > compatibility with servers that do user-agent detection. > > Set to the empty string ("") to not send any user-agent string, > or set to NULL to restore the default.\n\n* opts(GIT_OPT_GET_USER_AGENT_PRODUCT, git_buf *out)\n\n > Get the value of the User-Agent product header. > The User-Agent product is written to the `out` buffer.\n\n* opts(GIT_OPT_SET_WINDOWS_SHAREMODE, unsigned long value)\n\n > Set the share mode used when opening files on Windows. > For more information, see the documentation for CreateFile. > The default is: FILE_SHARE_READ | FILE_SHARE_WRITE. This is > ignored and unused on non-Windows platforms.\n\n* opts(GIT_OPT_GET_WINDOWS_SHAREMODE, unsigned long *value)\n\n > Get the share mode used when opening files on Windows.\n\n* opts(GIT_OPT_ENABLE_STRICT_OBJECT_CREATION, int enabled)\n\n > Enable strict input validation when creating new objects > to ensure that all inputs to the new objects are valid. For > example, when this is enabled, the parent(s) and tree inputs > will be validated when creating a new commit. This defaults > to enabled.\n\n* opts(GIT_OPT_ENABLE_STRICT_SYMBOLIC_REF_CREATION, int enabled)\n\n > Validate the target of a symbolic ref when creating it. For > example, `foobar` is not a valid ref, therefore `foobar` is > not a valid target for a symbolic ref by default, whereas > `refs/heads/foobar` is. Disabling this bypasses validation > so that an arbitrary strings such as `foobar` can be used > for a symbolic ref target. This defaults to enabled.\n\n* opts(GIT_OPT_SET_SSL_CIPHERS, const char *ciphers)\n\n > Set the SSL ciphers use for HTTPS connections. > > - `ciphers` is the list of ciphers that are eanbled.\n\n* opts(GIT_OPT_ENABLE_OFS_DELTA, int enabled)\n\n > Enable or disable the use of "offset deltas" when creating packfiles, > and the negotiation of them when talking to a remote server. > Offset deltas store a delta base location as an offset into the > packfile from the current location, which provides a shorter encoding > and thus smaller resultant packfiles. > Packfiles containing offset deltas can still be read. > This defaults to enabled.\n\n* opts(GIT_OPT_ENABLE_FSYNC_GITDIR, int enabled)\n\n > Enable synchronized writes of files in the gitdir using `fsync` > (or the platform equivalent) to ensure that new object data > is written to permanent storage, not simply cached. This > defaults to disabled.\n\n opts(GIT_OPT_ENABLE_STRICT_HASH_VERIFICATION, int enabled)\n\n > Enable strict verification of object hashsums when reading > objects from disk. This may impact performance due to an > additional checksum calculation on each object. This defaults > to enabled.\n\n opts(GIT_OPT_SET_ALLOCATOR, git_allocator *allocator)\n\n > Set the memory allocator to a different memory allocator. This > allocator will then be used to make all memory allocations for > libgit2 operations. If the given `allocator` is NULL, then the > system default will be restored.\n\n opts(GIT_OPT_ENABLE_UNSAVED_INDEX_SAFETY, int enabled)\n\n > Ensure that there are no unsaved changes in the index before > beginning any operation that reloads the index from disk (eg, > checkout). If there are unsaved changes, the instruction will > fail. (Using the FORCE flag to checkout will still overwrite > these changes.)\n\n opts(GIT_OPT_GET_PACK_MAX_OBJECTS, size_t *out)\n\n > Get the maximum number of objects libgit2 will allow in a pack > file when downloading a pack file from a remote. This can be > used to limit maximum memory usage when fetching from an untrusted > remote.\n\n opts(GIT_OPT_SET_PACK_MAX_OBJECTS, size_t objects)\n\n > Set the maximum number of objects libgit2 will allow in a pack > file when downloading a pack file from a remote.\n\n opts(GIT_OPT_DISABLE_PACK_KEEP_FILE_CHECKS, int enabled) > This will cause .keep file existence checks to be skipped when > accessing packfiles, which can help performance with remote filesystems.\n\n opts(GIT_OPT_ENABLE_HTTP_EXPECT_CONTINUE, int enabled) > When connecting to a server using NTLM or Negotiate > authentication, use expect/continue when POSTing data. > This option is not available on Windows.\nopts(GIT_OPT_SET_ODB_PACKED_PRIORITY, int priority) > Override the default priority of the packed ODB backend which > is added when default backends are assigned to a repository
\n\nopts(GIT_OPT_SET_ODB_LOOSE_PRIORITY, int priority) > Override the default priority of the loose ODB backend which > is added when default backends are assigned to a repository
\n\nopts(GIT_OPT_GET_EXTENSIONS, git_strarray *out) > Returns the list of git extensions that are supported. This > is the list of built-in extensions supported by libgit2 and > custom extensions that have been added with > GIT_OPT_SET_EXTENSIONS. Extensions that have been negated > will not be returned. The returned list should be released > with git_strarray_dispose.
opts(GIT_OPT_SET_EXTENSIONS, const char **extensions, size_t len) > Set that the given git extensions are supported by the caller. > Extensions supported by libgit2 may be negated by prefixing > them with a !. For example: setting extensions to > { "!noop", "newext" } indicates that the caller does not want > to support repositories with the noop extension but does want > to support repositories with the newext extension.
opts(GIT_OPT_GET_OWNER_VALIDATION, int *enabled) > Gets the owner validation setting for repository > directories.
\n\nopts(GIT_OPT_SET_OWNER_VALIDATION, int enabled) > Set that repository directories should be owned by the current > user. The default is to validate ownership.
\n\nopts(GIT_OPT_GET_HOMEDIR, git_buf *out) > Gets the current user's home directory, as it will be used > for file lookups. The path is written to the out buffer.
opts(GIT_OPT_SET_HOMEDIR, const char *path) > Sets the directory used as the current user's home directory, > for file lookups. > > - path directory of home directory.
opts(GIT_OPT_GET_SERVER_CONNECT_TIMEOUT, int *timeout) > Gets the timeout (in milliseconds) to attempt connections to > a remote server.
\n\nopts(GIT_OPT_SET_SERVER_CONNECT_TIMEOUT, int timeout) > Sets the timeout (in milliseconds) to attempt connections to > a remote server. Set to 0 to use the system default. Note that > this may not be able to be configured longer than the system > default, typically 75 seconds.
\n\nopts(GIT_OPT_GET_SERVER_TIMEOUT, int *timeout) > Gets the timeout (in milliseconds) for reading from and writing > to a remote server.
\n\nopts(GIT_OPT_SET_SERVER_TIMEOUT, int timeout) > Sets the timeout (in milliseconds) for reading from and writing > to a remote server. Set to 0 to use the system default.
\n", + "comments": "Available options:
\n\n* opts(GIT_OPT_GET_MWINDOW_SIZE, size_t *):\n\n > Get the maximum mmap window size\n\n* opts(GIT_OPT_SET_MWINDOW_SIZE, size_t):\n\n > Set the maximum mmap window size\n\n* opts(GIT_OPT_GET_MWINDOW_MAPPED_LIMIT, size_t *):\n\n > Get the maximum memory that will be mapped in total by the library\n\n* opts(GIT_OPT_SET_MWINDOW_MAPPED_LIMIT, size_t):\n\n > Set the maximum amount of memory that can be mapped at any time > by the library\n\n* opts(GIT_OPT_GET_MWINDOW_FILE_LIMIT, size_t *):\n\n > Get the maximum number of files that will be mapped at any time by the > library\n\n* opts(GIT_OPT_SET_MWINDOW_FILE_LIMIT, size_t):\n\n > Set the maximum number of files that can be mapped at any time > by the library. The default (0) is unlimited.\n\n* opts(GIT_OPT_GET_SEARCH_PATH, int level, git_buf *buf)\n\n > Get the search path for a given level of config data. "level" must > be one of `GIT_CONFIG_LEVEL_SYSTEM`, `GIT_CONFIG_LEVEL_GLOBAL`, > `GIT_CONFIG_LEVEL_XDG`, or `GIT_CONFIG_LEVEL_PROGRAMDATA`. > The search path is written to the `out` buffer.\n\n* opts(GIT_OPT_SET_SEARCH_PATH, int level, const char *path)\n\n > Set the search path for a level of config data. The search path > applied to shared attributes and ignore files, too. > > - `path` lists directories delimited by GIT_PATH_LIST_SEPARATOR. > Pass NULL to reset to the default (generally based on environment > variables). Use magic path `$PATH` to include the old value > of the path (if you want to prepend or append, for instance). > > - `level` must be `GIT_CONFIG_LEVEL_SYSTEM`, > `GIT_CONFIG_LEVEL_GLOBAL`, `GIT_CONFIG_LEVEL_XDG`, or > `GIT_CONFIG_LEVEL_PROGRAMDATA`.\n\n* opts(GIT_OPT_SET_CACHE_OBJECT_LIMIT, git_object_t type, size_t size)\n\n > Set the maximum data size for the given type of object to be > considered eligible for caching in memory. Setting to value to > zero means that that type of object will not be cached. > Defaults to 0 for GIT_OBJECT_BLOB (i.e. won't cache blobs) and 4k > for GIT_OBJECT_COMMIT, GIT_OBJECT_TREE, and GIT_OBJECT_TAG.\n\n* opts(GIT_OPT_SET_CACHE_MAX_SIZE, ssize_t max_storage_bytes)\n\n > Set the maximum total data size that will be cached in memory > across all repositories before libgit2 starts evicting objects > from the cache. This is a soft limit, in that the library might > briefly exceed it, but will start aggressively evicting objects > from cache when that happens. The default cache size is 256MB.\n\n* opts(GIT_OPT_ENABLE_CACHING, int enabled)\n\n > Enable or disable caching completely. > > Because caches are repository-specific, disabling the cache > cannot immediately clear all cached objects, but each cache will > be cleared on the next attempt to update anything in it.\n\n* opts(GIT_OPT_GET_CACHED_MEMORY, ssize_t *current, ssize_t *allowed)\n\n > Get the current bytes in cache and the maximum that would be > allowed in the cache.\n\n* opts(GIT_OPT_GET_TEMPLATE_PATH, git_buf *out)\n\n > Get the default template path. > The path is written to the `out` buffer.\n\n* opts(GIT_OPT_SET_TEMPLATE_PATH, const char *path)\n\n > Set the default template path. > > - `path` directory of template.\n\n* opts(GIT_OPT_SET_SSL_CERT_LOCATIONS, const char *file, const char *path)\n\n > Set the SSL certificate-authority locations. > > - `file` is the location of a file containing several > certificates concatenated together. > - `path` is the location of a directory holding several > certificates, one per file. > > Calling `GIT_OPT_ADD_SSL_X509_CERT` may override the > data in `path`. > > Either parameter may be `NULL`, but not both.\nopts(GIT_OPT_ADD_SSL_X509_CERT, const X509 *cert)
\n\n> Add a raw X509 certificate into the SSL certs store. > This certificate is only used by libgit2 invocations > during the application lifetime and is not persisted > to disk. This certificate cannot be removed from the > application once is has been added. > > - `cert` is the raw X509 cert will be added to cert store.\nopts(GIT_OPT_SET_USER_AGENT, const char *user_agent)
\n\n\nSet the value of the comment section of the User-Agent header. > This can be information about your product and its version. > By default this is "libgit2" followed by the libgit2 version. > > This value will be appended to User-Agent product, which > is typically set to "git/2.0". > > Set to the empty string ("") to not send any information in the > comment section, or set to NULL to restore the default.
\n
opts(GIT_OPT_GET_USER_AGENT, git_buf *out)
\n\n\nGet the value of the User-Agent header. > The User-Agent is written to the
\noutbuffer.
opts(GIT_OPT_SET_USER_AGENT_PRODUCT, const char *user_agent_product)
\n\n\nSet the value of the product portion of the User-Agent header. > This defaults to "git/2.0", for compatibility with other git > clients. It is recommended to keep this as git/
\nfor > compatibility with servers that do user-agent detection. > > Set to the empty string ("") to not send any user-agent string, > or set to NULL to restore the default.
opts(GIT_OPT_GET_USER_AGENT_PRODUCT, git_buf *out)
\n\n\nGet the value of the User-Agent product header. > The User-Agent product is written to the
\noutbuffer.
opts(GIT_OPT_SET_WINDOWS_SHAREMODE, unsigned long value)
\n\n\nSet the share mode used when opening files on Windows. > For more information, see the documentation for CreateFile. > The default is: FILE_SHARE_READ | FILE_SHARE_WRITE. This is > ignored and unused on non-Windows platforms.
\n
opts(GIT_OPT_GET_WINDOWS_SHAREMODE, unsigned long *value)
\n\n\nGet the share mode used when opening files on Windows.
\n
opts(GIT_OPT_ENABLE_STRICT_OBJECT_CREATION, int enabled)
\n\n\nEnable strict input validation when creating new objects > to ensure that all inputs to the new objects are valid. For > example, when this is enabled, the parent(s) and tree inputs > will be validated when creating a new commit. This defaults > to enabled.
\n
opts(GIT_OPT_ENABLE_STRICT_SYMBOLIC_REF_CREATION, int enabled)
\n\n\nValidate the target of a symbolic ref when creating it. For > example,
\nfoobaris not a valid ref, thereforefoobaris > not a valid target for a symbolic ref by default, whereas >refs/heads/foobaris. Disabling this bypasses validation > so that an arbitrary strings such asfoobarcan be used > for a symbolic ref target. This defaults to enabled.
opts(GIT_OPT_SET_SSL_CIPHERS, const char *ciphers)
\n\n\nSet the SSL ciphers use for HTTPS connections. > > -
\nciphersis the list of ciphers that are eanbled.
opts(GIT_OPT_ENABLE_OFS_DELTA, int enabled)
\n\n\nEnable or disable the use of "offset deltas" when creating packfiles, > and the negotiation of them when talking to a remote server. > Offset deltas store a delta base location as an offset into the > packfile from the current location, which provides a shorter encoding > and thus smaller resultant packfiles. > Packfiles containing offset deltas can still be read. > This defaults to enabled.
\n
opts(GIT_OPT_ENABLE_FSYNC_GITDIR, int enabled)
\n\n\nEnable synchronized writes of files in the gitdir using
\nfsync> (or the platform equivalent) to ensure that new object data > is written to permanent storage, not simply cached. This > defaults to disabled.
opts(GIT_OPT_ENABLE_STRICT_HASH_VERIFICATION, int enabled)
\n\n> Enable strict verification of object hashsums when reading > objects from disk. This may impact performance due to an > additional checksum calculation on each object. This defaults > to enabled.\nopts(GIT_OPT_SET_ALLOCATOR, git_allocator *allocator)
\n\n> Set the memory allocator to a different memory allocator. This > allocator will then be used to make all memory allocations for > libgit2 operations. If the given `allocator` is NULL, then the > system default will be restored.\nopts(GIT_OPT_ENABLE_UNSAVED_INDEX_SAFETY, int enabled)
\n\n> Ensure that there are no unsaved changes in the index before > beginning any operation that reloads the index from disk (eg, > checkout). If there are unsaved changes, the instruction will > fail. (Using the FORCE flag to checkout will still overwrite > these changes.)\nopts(GIT_OPT_GET_PACK_MAX_OBJECTS, size_t *out)
\n\n> Get the maximum number of objects libgit2 will allow in a pack > file when downloading a pack file from a remote. This can be > used to limit maximum memory usage when fetching from an untrusted > remote.\nopts(GIT_OPT_SET_PACK_MAX_OBJECTS, size_t objects)
\n\n> Set the maximum number of objects libgit2 will allow in a pack > file when downloading a pack file from a remote.\nopts(GIT_OPT_DISABLE_PACK_KEEP_FILE_CHECKS, int enabled) > This will cause .keep file existence checks to be skipped when > accessing packfiles, which can help performance with remote filesystems.
\n\nopts(GIT_OPT_ENABLE_HTTP_EXPECT_CONTINUE, int enabled) > When connecting to a server using NTLM or Negotiate > authentication, use expect/continue when POSTing data. > This option is not available on Windows.
opts(GIT_OPT_SET_ODB_PACKED_PRIORITY, int priority) > Override the default priority of the packed ODB backend which > is added when default backends are assigned to a repository
\n\nopts(GIT_OPT_SET_ODB_LOOSE_PRIORITY, int priority) > Override the default priority of the loose ODB backend which > is added when default backends are assigned to a repository
\n\nopts(GIT_OPT_GET_EXTENSIONS, git_strarray *out) > Returns the list of git extensions that are supported. This > is the list of built-in extensions supported by libgit2 and > custom extensions that have been added with > GIT_OPT_SET_EXTENSIONS. Extensions that have been negated > will not be returned. The returned list should be released > with git_strarray_dispose.
opts(GIT_OPT_SET_EXTENSIONS, const char **extensions, size_t len) > Set that the given git extensions are supported by the caller. > Extensions supported by libgit2 may be negated by prefixing > them with a !. For example: setting extensions to > { "!noop", "newext" } indicates that the caller does not want > to support repositories with the noop extension but does want > to support repositories with the newext extension.
opts(GIT_OPT_GET_OWNER_VALIDATION, int *enabled) > Gets the owner validation setting for repository > directories.
\n\nopts(GIT_OPT_SET_OWNER_VALIDATION, int enabled) > Set that repository directories should be owned by the current > user. The default is to validate ownership.
\n\nopts(GIT_OPT_GET_HOMEDIR, git_buf *out) > Gets the current user's home directory, as it will be used > for file lookups. The path is written to the out buffer.
opts(GIT_OPT_SET_HOMEDIR, const char *path) > Sets the directory used as the current user's home directory, > for file lookups. > > - path directory of home directory.
opts(GIT_OPT_GET_SERVER_CONNECT_TIMEOUT, int *timeout) > Gets the timeout (in milliseconds) to attempt connections to > a remote server.
\n\nopts(GIT_OPT_SET_SERVER_CONNECT_TIMEOUT, int timeout) > Sets the timeout (in milliseconds) to attempt connections to > a remote server. Set to 0 to use the system default. Note that > this may not be able to be configured longer than the system > default, typically 75 seconds.
\n\nopts(GIT_OPT_GET_SERVER_TIMEOUT, int *timeout) > Gets the timeout (in milliseconds) for reading from and writing > to a remote server.
\n\nopts(GIT_OPT_SET_SERVER_TIMEOUT, int timeout) > Sets the timeout (in milliseconds) for reading from and writing > to a remote server. Set to 0 to use the system default.
\n", "group": "libgit2" }, "git_config_entry_free": { "type": "function", "file": "git2/config.h", - "line": 113, - "lineto": 113, + "line": 131, + "lineto": 131, "args": [ { "name": "entry", @@ -4494,21 +4693,21 @@ "argline": "git_config_entry *entry", "sig": "git_config_entry *", "return": { "type": "void", "comment": null }, - "description": "Free a config entry
\n", + "description": "Free a config entry.
\n", "comments": "", "group": "config", "examples": { "config.c": [ - "ex/v1.8.4/config.html#git_config_entry_free-1", - "ex/v1.8.4/config.html#git_config_entry_free-2" + "ex/v1.9.1/config.html#git_config_entry_free-1", + "ex/v1.9.1/config.html#git_config_entry_free-2" ] } }, "git_config_find_global": { "type": "function", "file": "git2/config.h", - "line": 165, - "lineto": 165, + "line": 183, + "lineto": 183, "args": [ { "name": "out", @@ -4529,8 +4728,8 @@ "git_config_find_xdg": { "type": "function", "file": "git2/config.h", - "line": 182, - "lineto": 182, + "line": 200, + "lineto": 200, "args": [ { "name": "out", @@ -4551,8 +4750,8 @@ "git_config_find_system": { "type": "function", "file": "git2/config.h", - "line": 194, - "lineto": 194, + "line": 212, + "lineto": 212, "args": [ { "name": "out", @@ -4573,8 +4772,8 @@ "git_config_find_programdata": { "type": "function", "file": "git2/config.h", - "line": 205, - "lineto": 205, + "line": 223, + "lineto": 223, "args": [ { "name": "out", @@ -4595,8 +4794,8 @@ "git_config_open_default": { "type": "function", "file": "git2/config.h", - "line": 217, - "lineto": 217, + "line": 235, + "lineto": 235, "args": [ { "name": "out", @@ -4614,8 +4813,8 @@ "git_config_new": { "type": "function", "file": "git2/config.h", - "line": 228, - "lineto": 228, + "line": 246, + "lineto": 246, "args": [ { "name": "out", @@ -4633,8 +4832,8 @@ "git_config_add_file_ondisk": { "type": "function", "file": "git2/config.h", - "line": 257, - "lineto": 262, + "line": 275, + "lineto": 280, "args": [ { "name": "cfg", @@ -4675,8 +4874,8 @@ "git_config_open_ondisk": { "type": "function", "file": "git2/config.h", - "line": 276, - "lineto": 276, + "line": 294, + "lineto": 294, "args": [ { "name": "out", @@ -4696,14 +4895,14 @@ "comments": "This method is a simple utility wrapper for the following sequence of calls: - git_config_new - git_config_add_file_ondisk
\n", "group": "config", "examples": { - "general.c": ["ex/v1.8.4/general.html#git_config_open_ondisk-26"] + "general.c": ["ex/v1.9.1/general.html#git_config_open_ondisk-26"] } }, "git_config_open_level": { "type": "function", "file": "git2/config.h", - "line": 294, - "lineto": 297, + "line": 312, + "lineto": 315, "args": [ { "name": "out", @@ -4734,8 +4933,8 @@ "git_config_open_global": { "type": "function", "file": "git2/config.h", - "line": 312, - "lineto": 312, + "line": 330, + "lineto": 330, "args": [ { "name": "out", @@ -4755,11 +4954,40 @@ "comments": "Git allows you to store your global configuration at $HOME/.gitconfig or $XDG_CONFIG_HOME/git/config. For backwards compatibility, the XDG file shouldn't be used unless the use has created it explicitly. With this function you'll open the correct one to write to.
Set the write order for configuration backends. By default, the\n write ordering does not match the read ordering; for example, the\n worktree configuration is a high-priority for reading, but is not\n written to unless explicitly chosen.
\n", + "comments": "", + "group": "config" + }, "git_config_snapshot": { "type": "function", "file": "git2/config.h", - "line": 333, - "lineto": 333, + "line": 362, + "lineto": 362, "args": [ { "name": "out", @@ -4782,8 +5010,8 @@ "git_config_free": { "type": "function", "file": "git2/config.h", - "line": 340, - "lineto": 340, + "line": 369, + "lineto": 369, "args": [ { "name": "cfg", @@ -4798,18 +5026,18 @@ "comments": "", "group": "config", "examples": { - "config.c": ["ex/v1.8.4/config.html#git_config_free-3"], + "config.c": ["ex/v1.9.1/config.html#git_config_free-3"], "general.c": [ - "ex/v1.8.4/general.html#git_config_free-27", - "ex/v1.8.4/general.html#git_config_free-28" + "ex/v1.9.1/general.html#git_config_free-27", + "ex/v1.9.1/general.html#git_config_free-28" ] } }, "git_config_get_entry": { "type": "function", "file": "git2/config.h", - "line": 352, - "lineto": 355, + "line": 381, + "lineto": 384, "args": [ { "name": "out", @@ -4834,14 +5062,14 @@ "comments": "Free the git_config_entry after use with git_config_entry_free().
A copy of the string is made and the user is free to use it afterwards.
\n", "group": "config", "examples": { - "config.c": ["ex/v1.8.4/config.html#git_config_set_string-5"] + "config.c": ["ex/v1.9.1/config.html#git_config_set_string-5"] } }, "git_config_set_multivar": { "type": "function", "file": "git2/config.h", - "line": 566, - "lineto": 566, + "line": 595, + "lineto": 595, "args": [ { "name": "cfg", @@ -5290,8 +5518,8 @@ "git_config_delete_entry": { "type": "function", "file": "git2/config.h", - "line": 576, - "lineto": 576, + "line": 605, + "lineto": 605, "args": [ { "name": "cfg", @@ -5314,8 +5542,8 @@ "git_config_delete_multivar": { "type": "function", "file": "git2/config.h", - "line": 589, - "lineto": 589, + "line": 618, + "lineto": 618, "args": [ { "name": "cfg", @@ -5343,8 +5571,8 @@ "git_config_foreach": { "type": "function", "file": "git2/config.h", - "line": 607, - "lineto": 610, + "line": 636, + "lineto": 639, "args": [ { "name": "cfg", @@ -5375,8 +5603,8 @@ "git_config_iterator_new": { "type": "function", "file": "git2/config.h", - "line": 622, - "lineto": 622, + "line": 651, + "lineto": 651, "args": [ { "name": "out", @@ -5399,8 +5627,8 @@ "git_config_iterator_glob_new": { "type": "function", "file": "git2/config.h", - "line": 639, - "lineto": 639, + "line": 668, + "lineto": 668, "args": [ { "name": "out", @@ -5428,8 +5656,8 @@ "git_config_foreach_match": { "type": "function", "file": "git2/config.h", - "line": 661, - "lineto": 665, + "line": 690, + "lineto": 694, "args": [ { "name": "cfg", @@ -5465,8 +5693,8 @@ "git_config_get_mapped": { "type": "function", "file": "git2/config.h", - "line": 701, - "lineto": 706, + "line": 730, + "lineto": 735, "args": [ { "name": "out", @@ -5507,8 +5735,8 @@ "git_config_lookup_map_value": { "type": "function", "file": "git2/config.h", - "line": 717, - "lineto": 721, + "line": 746, + "lineto": 750, "args": [ { "name": "out", @@ -5537,8 +5765,8 @@ "git_config_parse_bool": { "type": "function", "file": "git2/config.h", - "line": 734, - "lineto": 734, + "line": 763, + "lineto": 763, "args": [ { "name": "out", @@ -5557,8 +5785,8 @@ "git_config_parse_int32": { "type": "function", "file": "git2/config.h", - "line": 747, - "lineto": 747, + "line": 776, + "lineto": 776, "args": [ { "name": "out", @@ -5577,8 +5805,8 @@ "git_config_parse_int64": { "type": "function", "file": "git2/config.h", - "line": 760, - "lineto": 760, + "line": 789, + "lineto": 789, "args": [ { "name": "out", @@ -5597,8 +5825,8 @@ "git_config_parse_path": { "type": "function", "file": "git2/config.h", - "line": 776, - "lineto": 776, + "line": 805, + "lineto": 805, "args": [ { "name": "out", @@ -5621,8 +5849,8 @@ "git_config_backend_foreach_match": { "type": "function", "file": "git2/config.h", - "line": 795, - "lineto": 799, + "line": 824, + "lineto": 828, "args": [ { "name": "backend", @@ -5655,8 +5883,8 @@ "git_config_lock": { "type": "function", "file": "git2/config.h", - "line": 818, - "lineto": 818, + "line": 847, + "lineto": 847, "args": [ { "name": "tx", @@ -5679,8 +5907,8 @@ "git_credential_free": { "type": "function", "file": "git2/credential.h", - "line": 146, - "lineto": 146, + "line": 149, + "lineto": 149, "args": [ { "name": "cred", @@ -5698,8 +5926,8 @@ "git_credential_has_username": { "type": "function", "file": "git2/credential.h", - "line": 154, - "lineto": 154, + "line": 157, + "lineto": 157, "args": [ { "name": "cred", @@ -5720,8 +5948,8 @@ "git_credential_get_username": { "type": "function", "file": "git2/credential.h", - "line": 162, - "lineto": 162, + "line": 165, + "lineto": 165, "args": [ { "name": "cred", @@ -5742,8 +5970,8 @@ "git_credential_userpass_plaintext_new": { "type": "function", "file": "git2/credential.h", - "line": 173, - "lineto": 176, + "line": 176, + "lineto": 179, "args": [ { "name": "out", @@ -5774,8 +6002,8 @@ "git_credential_default_new": { "type": "function", "file": "git2/credential.h", - "line": 185, - "lineto": 185, + "line": 188, + "lineto": 188, "args": [ { "name": "out", @@ -5796,8 +6024,8 @@ "git_credential_username_new": { "type": "function", "file": "git2/credential.h", - "line": 197, - "lineto": 197, + "line": 200, + "lineto": 200, "args": [ { "name": "out", @@ -5823,8 +6051,8 @@ "git_credential_ssh_key_new": { "type": "function", "file": "git2/credential.h", - "line": 210, - "lineto": 215, + "line": 213, + "lineto": 218, "args": [ { "name": "out", @@ -5865,8 +6093,8 @@ "git_credential_ssh_key_memory_new": { "type": "function", "file": "git2/credential.h", - "line": 227, - "lineto": 232, + "line": 230, + "lineto": 235, "args": [ { "name": "out", @@ -5907,8 +6135,8 @@ "git_credential_ssh_interactive_new": { "type": "function", "file": "git2/credential.h", - "line": 263, - "lineto": 267, + "line": 278, + "lineto": 282, "args": [ { "name": "out", @@ -5944,8 +6172,8 @@ "git_credential_ssh_key_from_agent": { "type": "function", "file": "git2/credential.h", - "line": 277, - "lineto": 279, + "line": 292, + "lineto": 294, "args": [ { "name": "out", @@ -5971,8 +6199,8 @@ "git_credential_ssh_custom_new": { "type": "function", "file": "git2/credential.h", - "line": 305, - "lineto": 311, + "line": 332, + "lineto": 338, "args": [ { "name": "out", @@ -6057,8 +6285,8 @@ "git_blob_filtered_content": { "type": "function", "file": "git2/deprecated.h", - "line": 115, - "lineto": 119, + "line": 124, + "lineto": 128, "args": [ { "name": "out", "type": "git_buf *", "comment": null }, { "name": "blob", "type": "git_blob *", "comment": null }, @@ -6075,8 +6303,8 @@ "git_filter_list_stream_data": { "type": "function", "file": "git2/deprecated.h", - "line": 139, - "lineto": 142, + "line": 148, + "lineto": 151, "args": [ { "name": "filters", "type": "git_filter_list *", "comment": null }, { "name": "data", "type": "git_buf *", "comment": null }, @@ -6092,8 +6320,8 @@ "git_filter_list_apply_to_data": { "type": "function", "file": "git2/deprecated.h", - "line": 149, - "lineto": 152, + "line": 158, + "lineto": 161, "args": [ { "name": "out", "type": "git_buf *", "comment": null }, { "name": "filters", "type": "git_filter_list *", "comment": null }, @@ -6109,8 +6337,8 @@ "git_treebuilder_write_with_buffer": { "type": "function", "file": "git2/deprecated.h", - "line": 178, - "lineto": 179, + "line": 187, + "lineto": 188, "args": [ { "name": "oid", "type": "git_oid *", "comment": null }, { "name": "bld", "type": "git_treebuilder *", "comment": null }, @@ -6126,8 +6354,8 @@ "git_buf_grow": { "type": "function", "file": "git2/deprecated.h", - "line": 220, - "lineto": 220, + "line": 229, + "lineto": 229, "args": [ { "name": "buffer", @@ -6153,8 +6381,8 @@ "git_buf_set": { "type": "function", "file": "git2/deprecated.h", - "line": 230, - "lineto": 231, + "line": 239, + "lineto": 240, "args": [ { "name": "buffer", @@ -6185,8 +6413,8 @@ "git_buf_is_binary": { "type": "function", "file": "git2/deprecated.h", - "line": 239, - "lineto": 239, + "line": 248, + "lineto": 248, "args": [ { "name": "buf", @@ -6207,8 +6435,8 @@ "git_buf_contains_nul": { "type": "function", "file": "git2/deprecated.h", - "line": 247, - "lineto": 247, + "line": 256, + "lineto": 256, "args": [ { "name": "buf", @@ -6229,8 +6457,8 @@ "git_buf_free": { "type": "function", "file": "git2/deprecated.h", - "line": 259, - "lineto": 259, + "line": 268, + "lineto": 268, "args": [{ "name": "buffer", "type": "git_buf *", "comment": null }], "argline": "git_buf *buffer", "sig": "git_buf *", @@ -6242,8 +6470,8 @@ "git_diff_format_email": { "type": "function", "file": "git2/deprecated.h", - "line": 357, - "lineto": 360, + "line": 374, + "lineto": 377, "args": [ { "name": "out", "type": "git_buf *", "comment": null }, { "name": "diff", "type": "git_diff *", "comment": null }, @@ -6263,8 +6491,8 @@ "git_diff_commit_as_email": { "type": "function", "file": "git2/deprecated.h", - "line": 368, - "lineto": 375, + "line": 385, + "lineto": 392, "args": [ { "name": "out", "type": "git_buf *", "comment": null }, { "name": "repo", "type": "git_repository *", "comment": null }, @@ -6288,8 +6516,8 @@ "git_diff_format_email_options_init": { "type": "function", "file": "git2/deprecated.h", - "line": 387, - "lineto": 389, + "line": 404, + "lineto": 406, "args": [ { "name": "opts", @@ -6315,8 +6543,8 @@ "giterr_last": { "type": "function", "file": "git2/deprecated.h", - "line": 452, - "lineto": 452, + "line": 503, + "lineto": 503, "args": [], "argline": "", "sig": "", @@ -6328,8 +6556,8 @@ "giterr_clear": { "type": "function", "file": "git2/deprecated.h", - "line": 464, - "lineto": 464, + "line": 515, + "lineto": 515, "args": [], "argline": "", "sig": "", @@ -6341,8 +6569,8 @@ "giterr_set_str": { "type": "function", "file": "git2/deprecated.h", - "line": 476, - "lineto": 476, + "line": 527, + "lineto": 527, "args": [ { "name": "error_class", "type": "int", "comment": null }, { "name": "string", "type": "const char *", "comment": null } @@ -6357,8 +6585,8 @@ "giterr_set_oom": { "type": "function", "file": "git2/deprecated.h", - "line": 488, - "lineto": 488, + "line": 539, + "lineto": 539, "args": [], "argline": "", "sig": "", @@ -6370,8 +6598,8 @@ "git_object__size": { "type": "function", "file": "git2/deprecated.h", - "line": 578, - "lineto": 578, + "line": 666, + "lineto": 666, "args": [ { "name": "type", @@ -6389,8 +6617,8 @@ "git_remote_is_valid_name": { "type": "function", "file": "git2/deprecated.h", - "line": 599, - "lineto": 599, + "line": 687, + "lineto": 687, "args": [ { "name": "remote_name", @@ -6411,8 +6639,8 @@ "git_reference_is_valid_name": { "type": "function", "file": "git2/deprecated.h", - "line": 643, - "lineto": 643, + "line": 741, + "lineto": 741, "args": [ { "name": "refname", @@ -6433,8 +6661,8 @@ "git_oidarray_free": { "type": "function", "file": "git2/deprecated.h", - "line": 810, - "lineto": 810, + "line": 922, + "lineto": 922, "args": [{ "name": "array", "type": "git_oidarray *", "comment": null }], "argline": "git_oidarray *array", "sig": "git_oidarray *", @@ -6446,8 +6674,8 @@ "git_strarray_copy": { "type": "function", "file": "git2/deprecated.h", - "line": 879, - "lineto": 879, + "line": 991, + "lineto": 991, "args": [ { "name": "tgt", "type": "git_strarray *", "comment": "target" }, { "name": "src", "type": "const git_strarray *", "comment": "source" } @@ -6465,8 +6693,8 @@ "git_strarray_free": { "type": "function", "file": "git2/deprecated.h", - "line": 891, - "lineto": 891, + "line": 1003, + "lineto": 1003, "args": [{ "name": "array", "type": "git_strarray *", "comment": null }], "argline": "git_strarray *array", "sig": "git_strarray *", @@ -6478,8 +6706,8 @@ "git_blame_init_options": { "type": "function", "file": "git2/deprecated.h", - "line": 905, - "lineto": 905, + "line": 1035, + "lineto": 1035, "args": [ { "name": "opts", "type": "git_blame_options *", "comment": null }, { "name": "version", "type": "unsigned int", "comment": null } @@ -6494,8 +6722,8 @@ "git_describe_options_init": { "type": "function", "file": "git2/describe.h", - "line": 82, - "lineto": 82, + "line": 91, + "lineto": 91, "args": [ { "name": "opts", @@ -6518,14 +6746,14 @@ "comments": "Initializes a git_describe_options with default values. Equivalent to creating an instance with GIT_DESCRIBE_OPTIONS_INIT.
Perform the describe operation on the given committish object.
\n", "group": "describe", "examples": { - "describe.c": ["ex/v1.8.4/describe.html#git_describe_commit-3"] + "describe.c": ["ex/v1.9.1/describe.html#git_describe_commit-3"] } }, "git_describe_workdir": { "type": "function", "file": "git2/describe.h", - "line": 165, - "lineto": 168, + "line": 177, + "lineto": 180, "args": [ { "name": "out", @@ -6614,14 +6842,14 @@ "comments": "Perform the describe operation on the current commit and the worktree. After performing describe on HEAD, a status is run and the description is considered to be dirty if there are.
\n", "group": "describe", "examples": { - "describe.c": ["ex/v1.8.4/describe.html#git_describe_workdir-4"] + "describe.c": ["ex/v1.9.1/describe.html#git_describe_workdir-4"] } }, "git_describe_format": { "type": "function", "file": "git2/describe.h", - "line": 179, - "lineto": 182, + "line": 191, + "lineto": 194, "args": [ { "name": "out", @@ -6646,14 +6874,14 @@ "comments": "", "group": "describe", "examples": { - "describe.c": ["ex/v1.8.4/describe.html#git_describe_format-5"] + "describe.c": ["ex/v1.9.1/describe.html#git_describe_format-5"] } }, "git_describe_result_free": { "type": "function", "file": "git2/describe.h", - "line": 189, - "lineto": 189, + "line": 201, + "lineto": 201, "args": [ { "name": "result", @@ -6671,8 +6899,8 @@ "git_diff_options_init": { "type": "function", "file": "git2/diff.h", - "line": 485, - "lineto": 487, + "line": 492, + "lineto": 494, "args": [ { "name": "opts", @@ -6698,8 +6926,8 @@ "git_diff_find_options_init": { "type": "function", "file": "git2/diff.h", - "line": 818, - "lineto": 820, + "line": 846, + "lineto": 848, "args": [ { "name": "opts", @@ -6725,8 +6953,8 @@ "git_diff_free": { "type": "function", "file": "git2/diff.h", - "line": 834, - "lineto": 834, + "line": 862, + "lineto": 862, "args": [ { "name": "diff", @@ -6741,18 +6969,18 @@ "comments": "", "group": "diff", "examples": { - "diff.c": ["ex/v1.8.4/diff.html#git_diff_free-3"], + "diff.c": ["ex/v1.9.1/diff.html#git_diff_free-3"], "log.c": [ - "ex/v1.8.4/log.html#git_diff_free-25", - "ex/v1.8.4/log.html#git_diff_free-26" + "ex/v1.9.1/log.html#git_diff_free-25", + "ex/v1.9.1/log.html#git_diff_free-26" ] } }, "git_diff_tree_to_tree": { "type": "function", "file": "git2/diff.h", - "line": 853, - "lineto": 858, + "line": 881, + "lineto": 886, "args": [ { "name": "diff", @@ -6787,18 +7015,18 @@ "comments": "This is equivalent to git diff <old-tree> <new-tree>
The first tree will be used for the "old_file" side of the delta and the second tree will be used for the "new_file" side of the delta. You can pass NULL to indicate an empty tree, although it is an error to pass NULL for both the old_tree and new_tree.
Create a diff between a tree and repository index.
\n", "comments": "This is equivalent to git diff --cached <treeish> or if you pass the HEAD tree, then like git diff --cached.
The tree you pass will be used for the "old_file" side of the delta, and the index will be used for the "new_file" side of the delta.
\n\nIf you pass NULL for the index, then the existing index of the repo will be used. In this case, the index will be refreshed from disk (if it has changed) before the diff is generated.
This matches the git diff command. See the note below on git_diff_tree_to_workdir for a discussion of the difference between git diff and git diff HEAD and how to emulate a git diff <treeish> using libgit2.
The index will be used for the "old_file" side of the delta, and the working directory will be used for the "new_file" side of the delta.
\n\nIf you pass NULL for the index, then the existing index of the repo will be used. In this case, the index will be refreshed from disk (if it has changed) before the diff is generated.
The tree you provide will be used for the "old_file" side of the delta, and the working directory will be used for the "new_file" side.
\n\nThis is not the same as git diff <treeish> or git diff-index <treeish>. Those commands use information from the index, whereas this function strictly returns the differences between the tree and the files in the working directory, regardless of the state of the index. Use git_diff_tree_to_workdir_with_index to emulate those commands.
To see difference between this and git_diff_tree_to_workdir_with_index, consider the example of a staged file deletion where the file has then been put back into the working dir and further modified. The tree-to-workdir diff for that file is 'modified', but git diff would show status 'deleted' since there is a staged delete.
This emulates git diff <tree> by diffing the tree to the index and the index to the working directory and blending the results into a single diff that includes staged deleted, etc.
Transform a diff marking file renames, copies, etc.
\n", "comments": "This modifies a diff in place, replacing old entries that look like renames or copies with new entries reflecting those changes. This also will, if requested, break modified files into add/remove pairs if the amount of change is above a threshold.
\n", "group": "diff", - "examples": { "diff.c": ["ex/v1.8.4/diff.html#git_diff_find_similar-9"] } + "examples": { "diff.c": ["ex/v1.9.1/diff.html#git_diff_find_similar-9"] } }, "git_diff_num_deltas": { "type": "function", "file": "git2/diff.h", - "line": 1034, - "lineto": 1034, + "line": 1062, + "lineto": 1062, "args": [ { "name": "diff", @@ -7054,13 +7282,13 @@ "description": "Query how many diff records are there in a diff.
\n", "comments": "", "group": "diff", - "examples": { "log.c": ["ex/v1.8.4/log.html#git_diff_num_deltas-29"] } + "examples": { "log.c": ["ex/v1.9.1/log.html#git_diff_num_deltas-29"] } }, "git_diff_num_deltas_of_type": { "type": "function", "file": "git2/diff.h", - "line": 1047, - "lineto": 1048, + "line": 1075, + "lineto": 1076, "args": [ { "name": "diff", @@ -7086,8 +7314,8 @@ "git_diff_get_delta": { "type": "function", "file": "git2/diff.h", - "line": 1067, - "lineto": 1068, + "line": 1095, + "lineto": 1096, "args": [ { "name": "diff", @@ -7109,8 +7337,8 @@ "git_diff_is_sorted_icase": { "type": "function", "file": "git2/diff.h", - "line": 1076, - "lineto": 1076, + "line": 1104, + "lineto": 1104, "args": [ { "name": "diff", @@ -7131,8 +7359,8 @@ "git_diff_foreach": { "type": "function", "file": "git2/diff.h", - "line": 1104, - "lineto": 1110, + "line": 1132, + "lineto": 1138, "args": [ { "name": "diff", @@ -7178,8 +7406,8 @@ "git_diff_status_char": { "type": "function", "file": "git2/diff.h", - "line": 1123, - "lineto": 1123, + "line": 1151, + "lineto": 1151, "args": [ { "name": "status", @@ -7200,8 +7428,8 @@ "git_diff_print": { "type": "function", "file": "git2/diff.h", - "line": 1149, - "lineto": 1153, + "line": 1177, + "lineto": 1181, "args": [ { "name": "diff", @@ -7234,15 +7462,15 @@ "comments": "Returning a non-zero value from the callbacks will terminate the iteration and return the non-zero value to the caller.
\n", "group": "diff", "examples": { - "diff.c": ["ex/v1.8.4/diff.html#git_diff_print-10"], - "log.c": ["ex/v1.8.4/log.html#git_diff_print-30"] + "diff.c": ["ex/v1.9.1/diff.html#git_diff_print-10"], + "log.c": ["ex/v1.9.1/log.html#git_diff_print-30"] } }, "git_diff_to_buf": { "type": "function", "file": "git2/diff.h", - "line": 1165, - "lineto": 1168, + "line": 1193, + "lineto": 1196, "args": [ { "name": "out", @@ -7270,8 +7498,8 @@ "git_diff_blobs": { "type": "function", "file": "git2/diff.h", - "line": 1204, - "lineto": 1214, + "line": 1232, + "lineto": 1242, "args": [ { "name": "old_blob", @@ -7337,8 +7565,8 @@ "git_diff_blob_to_buffer": { "type": "function", "file": "git2/diff.h", - "line": 1241, - "lineto": 1252, + "line": 1269, + "lineto": 1280, "args": [ { "name": "old_blob", @@ -7409,8 +7637,8 @@ "git_diff_buffers": { "type": "function", "file": "git2/diff.h", - "line": 1275, - "lineto": 1287, + "line": 1303, + "lineto": 1315, "args": [ { "name": "old_buffer", @@ -7486,8 +7714,8 @@ "git_diff_from_buffer": { "type": "function", "file": "git2/diff.h", - "line": 1327, - "lineto": 1334, + "line": 1355, + "lineto": 1362, "args": [ { "name": "out", @@ -7513,16 +7741,16 @@ "group": "diff", "examples": { "diff.c": [ - "ex/v1.8.4/diff.html#git_diff_from_buffer-11", - "ex/v1.8.4/diff.html#git_diff_from_buffer-12" + "ex/v1.9.1/diff.html#git_diff_from_buffer-11", + "ex/v1.9.1/diff.html#git_diff_from_buffer-12" ] } }, "git_diff_get_stats": { "type": "function", "file": "git2/diff.h", - "line": 1370, - "lineto": 1372, + "line": 1398, + "lineto": 1400, "args": [ { "name": "out", @@ -7544,13 +7772,13 @@ "description": "Accumulate diff statistics for all patches.
\n", "comments": "", "group": "diff", - "examples": { "diff.c": ["ex/v1.8.4/diff.html#git_diff_get_stats-13"] } + "examples": { "diff.c": ["ex/v1.9.1/diff.html#git_diff_get_stats-13"] } }, "git_diff_stats_files_changed": { "type": "function", "file": "git2/diff.h", - "line": 1380, - "lineto": 1381, + "line": 1408, + "lineto": 1409, "args": [ { "name": "stats", @@ -7571,8 +7799,8 @@ "git_diff_stats_insertions": { "type": "function", "file": "git2/diff.h", - "line": 1389, - "lineto": 1390, + "line": 1417, + "lineto": 1418, "args": [ { "name": "stats", @@ -7593,8 +7821,8 @@ "git_diff_stats_deletions": { "type": "function", "file": "git2/diff.h", - "line": 1398, - "lineto": 1399, + "line": 1426, + "lineto": 1427, "args": [ { "name": "stats", @@ -7615,8 +7843,8 @@ "git_diff_stats_to_buf": { "type": "function", "file": "git2/diff.h", - "line": 1410, - "lineto": 1414, + "line": 1438, + "lineto": 1442, "args": [ { "name": "out", @@ -7648,13 +7876,13 @@ "description": "Print diff statistics to a git_buf.
Deallocate a git_diff_stats.
Calculate a stable patch ID for the given patch by summing the hash of the file diffs, ignoring whitespace and line numbers. This can be used to derive whether two diffs are the same with a high probability.
\n\nCurrently, this function only calculates stable patch IDs, as defined in git-patch-id(1), and should in fact generate the same IDs as the upstream git project does.
\n", "group": "diff" }, - "git_email_create_from_diff": { - "type": "function", - "file": "git2/email.h", - "line": 100, - "lineto": 109, - "args": [ - { - "name": "out", - "type": "git_buf *", - "comment": "buffer to store the e-mail patch in" - }, - { - "name": "diff", - "type": "git_diff *", - "comment": "the changes to include in the email" - }, - { "name": "patch_idx", "type": "size_t", "comment": "the patch index" }, - { - "name": "patch_count", - "type": "size_t", - "comment": "the total number of patches that will be included" - }, - { - "name": "commit_id", - "type": "const git_oid *", - "comment": "the commit id for this change" - }, - { - "name": "summary", - "type": "const char *", - "comment": "the commit message for this change" - }, - { - "name": "body", - "type": "const char *", - "comment": "optional text to include above the diffstat" - }, - { - "name": "author", - "type": "const git_signature *", - "comment": "the person who authored this commit" - }, - { - "name": "opts", - "type": "const git_email_create_options *", - "comment": "email creation options" - } - ], - "argline": "git_buf *out, git_diff *diff, size_t patch_idx, size_t patch_count, const git_oid *commit_id, const char *summary, const char *body, const git_signature *author, const git_email_create_options *opts", - "sig": "git_buf *::git_diff *::size_t::size_t::const git_oid *::const char *::const char *::const git_signature *::const git_email_create_options *", - "return": { "type": "int", "comment": null }, - "description": "Create a diff for a commit in mbox format for sending via email.
\n", - "comments": "", - "group": "email" - }, "git_email_create_from_commit": { "type": "function", "file": "git2/email.h", - "line": 119, - "lineto": 122, + "line": 99, + "lineto": 102, "args": [ { "name": "out", @@ -7808,7 +7981,7 @@ ], "argline": "git_buf *out, git_commit *commit, const git_email_create_options *opts", "sig": "git_buf *::git_commit *::const git_email_create_options *", - "return": { "type": "int", "comment": null }, + "return": { "type": "int", "comment": " 0 or an error code" }, "description": "Create a diff for a commit in mbox format for sending via email.\n The commit must not be a merge commit.
\n", "comments": "", "group": "email" @@ -7816,43 +7989,43 @@ "git_error_last": { "type": "function", "file": "git2/errors.h", - "line": 139, - "lineto": 139, + "line": 149, + "lineto": 149, "args": [], "argline": "", "sig": "", "return": { "type": "const git_error *", - "comment": " A git_error object." + "comment": " A pointer to a `git_error` object that describes the error." }, "description": "Return the last git_error object that was generated for the\n current thread.
This function will never return NULL.
\n\nCallers should not rely on this to determine whether an error has occurred. For error checking, callers should examine the return codes of libgit2 functions.
\n\nThis call can only reliably report error messages when an error has occurred. (It may contain stale information if it is called after a different function that succeeds.)
\n\nThe memory for this object is managed by libgit2. It should not be freed.
\n", "group": "error", "examples": { "checkout.c": [ - "ex/v1.8.4/checkout.html#git_error_last-11", - "ex/v1.8.4/checkout.html#git_error_last-12", - "ex/v1.8.4/checkout.html#git_error_last-13", - "ex/v1.8.4/checkout.html#git_error_last-14" + "ex/v1.9.1/checkout.html#git_error_last-11", + "ex/v1.9.1/checkout.html#git_error_last-12", + "ex/v1.9.1/checkout.html#git_error_last-13", + "ex/v1.9.1/checkout.html#git_error_last-14" ], - "commit.c": ["ex/v1.8.4/commit.html#git_error_last-2"], + "commit.c": ["ex/v1.9.1/commit.html#git_error_last-2"], "config.c": [ - "ex/v1.8.4/config.html#git_error_last-6", - "ex/v1.8.4/config.html#git_error_last-7", - "ex/v1.8.4/config.html#git_error_last-8" + "ex/v1.9.1/config.html#git_error_last-6", + "ex/v1.9.1/config.html#git_error_last-7", + "ex/v1.9.1/config.html#git_error_last-8" ], - "general.c": ["ex/v1.8.4/general.html#git_error_last-33"], + "general.c": ["ex/v1.9.1/general.html#git_error_last-33"], "merge.c": [ - "ex/v1.8.4/merge.html#git_error_last-8", - "ex/v1.8.4/merge.html#git_error_last-9" + "ex/v1.9.1/merge.html#git_error_last-8", + "ex/v1.9.1/merge.html#git_error_last-9" ] } }, "git_filter_list_load": { "type": "function", "file": "git2/filter.h", - "line": 129, - "lineto": 135, + "line": 138, + "lineto": 144, "args": [ { "name": "filters", @@ -7898,8 +8071,8 @@ "git_filter_list_load_ext": { "type": "function", "file": "git2/filter.h", - "line": 152, - "lineto": 158, + "line": 161, + "lineto": 167, "args": [ { "name": "filters", @@ -7945,8 +8118,8 @@ "git_filter_list_contains": { "type": "function", "file": "git2/filter.h", - "line": 172, - "lineto": 174, + "line": 181, + "lineto": 183, "args": [ { "name": "filters", @@ -7972,8 +8145,8 @@ "git_filter_list_apply_to_buffer": { "type": "function", "file": "git2/filter.h", - "line": 185, - "lineto": 189, + "line": 194, + "lineto": 198, "args": [ { "name": "out", @@ -8009,8 +8182,8 @@ "git_filter_list_apply_to_file": { "type": "function", "file": "git2/filter.h", - "line": 201, - "lineto": 205, + "line": 210, + "lineto": 214, "args": [ { "name": "out", @@ -8043,8 +8216,8 @@ "git_filter_list_apply_to_blob": { "type": "function", "file": "git2/filter.h", - "line": 215, - "lineto": 218, + "line": 224, + "lineto": 227, "args": [ { "name": "out", @@ -8072,8 +8245,8 @@ "git_filter_list_stream_buffer": { "type": "function", "file": "git2/filter.h", - "line": 229, - "lineto": 233, + "line": 238, + "lineto": 242, "args": [ { "name": "filters", @@ -8106,8 +8279,8 @@ "git_filter_list_stream_file": { "type": "function", "file": "git2/filter.h", - "line": 245, - "lineto": 249, + "line": 254, + "lineto": 258, "args": [ { "name": "filters", @@ -8140,8 +8313,8 @@ "git_filter_list_stream_blob": { "type": "function", "file": "git2/filter.h", - "line": 259, - "lineto": 262, + "line": 268, + "lineto": 271, "args": [ { "name": "filters", @@ -8169,8 +8342,8 @@ "git_filter_list_free": { "type": "function", "file": "git2/filter.h", - "line": 269, - "lineto": 269, + "line": 278, + "lineto": 278, "args": [ { "name": "filters", @@ -8188,8 +8361,8 @@ "git_libgit2_init": { "type": "function", "file": "git2/global.h", - "line": 26, - "lineto": 26, + "line": 32, + "lineto": 32, "args": [], "argline": "", "sig": "", @@ -8201,14 +8374,14 @@ "comments": "This function must be called before any other libgit2 function in order to set up global state and threading.
\n\nThis function may be called multiple times - it will return the number of times the initialization has been called (including this one) that have not subsequently been shutdown.
\n", "group": "libgit2", "examples": { - "general.c": ["ex/v1.8.4/general.html#git_libgit2_init-34"] + "general.c": ["ex/v1.9.1/general.html#git_libgit2_init-34"] } }, "git_libgit2_shutdown": { "type": "function", "file": "git2/global.h", - "line": 39, - "lineto": 39, + "line": 45, + "lineto": 45, "args": [], "argline": "", "sig": "", @@ -8331,8 +8504,8 @@ "git_ignore_add_rule": { "type": "function", "file": "git2/ignore.h", - "line": 37, - "lineto": 39, + "line": 46, + "lineto": 48, "args": [ { "name": "repo", @@ -8355,8 +8528,8 @@ "git_ignore_clear_internal_rules": { "type": "function", "file": "git2/ignore.h", - "line": 52, - "lineto": 53, + "line": 61, + "lineto": 62, "args": [ { "name": "repo", @@ -8374,8 +8547,8 @@ "git_ignore_path_is_ignored": { "type": "function", "file": "git2/ignore.h", - "line": 71, - "lineto": 74, + "line": 80, + "lineto": 83, "args": [ { "name": "ignored", @@ -8403,11 +8576,54 @@ "comments": "This function checks the ignore rules to see if they would apply to the given file. This indicates if the file would be ignored regardless of whether the file is already in the index or committed to the repository.
\n\nOne way to think of this is if you were to do "git check-ignore --no-index" on the given file, would it be shown or not?
\n", "group": "ignore" }, + "git_index_open": { + "type": "function", + "file": "git2/index.h", + "line": 278, + "lineto": 278, + "args": [ + { + "name": "index_out", + "type": "git_index **", + "comment": "the pointer for the new index" + }, + { + "name": "index_path", + "type": "const char *", + "comment": "the path to the index file in disk" + } + ], + "argline": "git_index **index_out, const char *index_path", + "sig": "git_index **::const char *", + "return": { "type": "int", "comment": " 0 or an error code" }, + "description": "Create a new bare Git index object as a memory representation\n of the Git index file in 'index_path', without a repository\n to back it.
\n", + "comments": "Since there is no ODB or working directory behind this index, any Index methods which rely on these (e.g. index_add_bypath) will fail with the GIT_ERROR error code.
\n\nIf you need to access the index of an actual repository, use the git_repository_index wrapper.
The index must be freed once it's no longer in use.
\n", + "group": "index" + }, + "git_index_new": { + "type": "function", + "file": "git2/index.h", + "line": 291, + "lineto": 291, + "args": [ + { + "name": "index_out", + "type": "git_index **", + "comment": "the pointer for the new index" + } + ], + "argline": "git_index **index_out", + "sig": "git_index **", + "return": { "type": "int", "comment": " 0 or an error code" }, + "description": "Create an in-memory index object.
\n", + "comments": "This index object cannot be read/written to the filesystem, but may be used to perform in-memory index operations.
\n\nThe index must be freed once it's no longer in use.
\n", + "group": "index" + }, "git_index_free": { "type": "function", "file": "git2/index.h", - "line": 216, - "lineto": 216, + "line": 300, + "lineto": 300, "args": [ { "name": "index", @@ -8422,18 +8638,18 @@ "comments": "", "group": "index", "examples": { - "add.c": ["ex/v1.8.4/add.html#git_index_free-1"], - "commit.c": ["ex/v1.8.4/commit.html#git_index_free-3"], - "general.c": ["ex/v1.8.4/general.html#git_index_free-35"], - "init.c": ["ex/v1.8.4/init.html#git_index_free-2"], - "ls-files.c": ["ex/v1.8.4/ls-files.html#git_index_free-1"] + "add.c": ["ex/v1.9.1/add.html#git_index_free-1"], + "commit.c": ["ex/v1.9.1/commit.html#git_index_free-3"], + "general.c": ["ex/v1.9.1/general.html#git_index_free-35"], + "init.c": ["ex/v1.9.1/init.html#git_index_free-2"], + "ls-files.c": ["ex/v1.9.1/ls-files.html#git_index_free-1"] } }, "git_index_owner": { "type": "function", "file": "git2/index.h", - "line": 224, - "lineto": 224, + "line": 308, + "lineto": 308, "args": [ { "name": "index", "type": "const git_index *", "comment": "The index" } ], @@ -8450,8 +8666,8 @@ "git_index_caps": { "type": "function", "file": "git2/index.h", - "line": 232, - "lineto": 232, + "line": 316, + "lineto": 316, "args": [ { "name": "index", @@ -8472,8 +8688,8 @@ "git_index_set_caps": { "type": "function", "file": "git2/index.h", - "line": 245, - "lineto": 245, + "line": 329, + "lineto": 329, "args": [ { "name": "index", @@ -8496,8 +8712,8 @@ "git_index_version": { "type": "function", "file": "git2/index.h", - "line": 257, - "lineto": 257, + "line": 341, + "lineto": 341, "args": [ { "name": "index", @@ -8515,8 +8731,8 @@ "git_index_set_version": { "type": "function", "file": "git2/index.h", - "line": 270, - "lineto": 270, + "line": 354, + "lineto": 354, "args": [ { "name": "index", @@ -8539,8 +8755,8 @@ "git_index_read": { "type": "function", "file": "git2/index.h", - "line": 289, - "lineto": 289, + "line": 373, + "lineto": 373, "args": [ { "name": "index", @@ -8563,8 +8779,8 @@ "git_index_write": { "type": "function", "file": "git2/index.h", - "line": 298, - "lineto": 298, + "line": 382, + "lineto": 382, "args": [ { "name": "index", @@ -8579,15 +8795,15 @@ "comments": "", "group": "index", "examples": { - "add.c": ["ex/v1.8.4/add.html#git_index_write-2"], - "commit.c": ["ex/v1.8.4/commit.html#git_index_write-4"] + "add.c": ["ex/v1.9.1/add.html#git_index_write-2"], + "commit.c": ["ex/v1.9.1/commit.html#git_index_write-4"] } }, "git_index_path": { "type": "function", "file": "git2/index.h", - "line": 306, - "lineto": 306, + "line": 390, + "lineto": 390, "args": [ { "name": "index", @@ -8608,8 +8824,8 @@ "git_index_checksum": { "type": "function", "file": "git2/index.h", - "line": 320, - "lineto": 320, + "line": 404, + "lineto": 404, "args": [ { "name": "index", @@ -8630,8 +8846,8 @@ "git_index_read_tree": { "type": "function", "file": "git2/index.h", - "line": 332, - "lineto": 332, + "line": 416, + "lineto": 416, "args": [ { "name": "index", @@ -8654,8 +8870,8 @@ "git_index_write_tree": { "type": "function", "file": "git2/index.h", - "line": 353, - "lineto": 353, + "line": 437, + "lineto": 437, "args": [ { "name": "out", @@ -8674,16 +8890,16 @@ "comments": "This method will scan the index and write a representation of its current state back to disk; it recursively creates tree objects for each of the subtrees stored in the index, but only returns the OID of the root tree. This is the OID that can be used e.g. to create a commit.
\n\nThe index instance cannot be bare, and needs to be associated to an existing repository.
\n\nThe index must not contain any file in conflict.
\n", "group": "index", "examples": { - "commit.c": ["ex/v1.8.4/commit.html#git_index_write_tree-5"], - "init.c": ["ex/v1.8.4/init.html#git_index_write_tree-3"], - "merge.c": ["ex/v1.8.4/merge.html#git_index_write_tree-10"] + "commit.c": ["ex/v1.9.1/commit.html#git_index_write_tree-5"], + "init.c": ["ex/v1.9.1/init.html#git_index_write_tree-3"], + "merge.c": ["ex/v1.9.1/merge.html#git_index_write_tree-10"] } }, "git_index_write_tree_to": { "type": "function", "file": "git2/index.h", - "line": 370, - "lineto": 370, + "line": 454, + "lineto": 454, "args": [ { "name": "out", @@ -8710,8 +8926,8 @@ "git_index_entrycount": { "type": "function", "file": "git2/index.h", - "line": 389, - "lineto": 389, + "line": 473, + "lineto": 473, "args": [ { "name": "index", @@ -8729,15 +8945,15 @@ "comments": "", "group": "index", "examples": { - "general.c": ["ex/v1.8.4/general.html#git_index_entrycount-36"], - "ls-files.c": ["ex/v1.8.4/ls-files.html#git_index_entrycount-2"] + "general.c": ["ex/v1.9.1/general.html#git_index_entrycount-36"], + "ls-files.c": ["ex/v1.9.1/ls-files.html#git_index_entrycount-2"] } }, "git_index_clear": { "type": "function", "file": "git2/index.h", - "line": 400, - "lineto": 400, + "line": 484, + "lineto": 484, "args": [ { "name": "index", @@ -8758,8 +8974,8 @@ "git_index_get_byindex": { "type": "function", "file": "git2/index.h", - "line": 413, - "lineto": 414, + "line": 497, + "lineto": 498, "args": [ { "name": "index", @@ -8782,15 +8998,15 @@ "comments": "The entry is not modifiable and should not be freed. Because the git_index_entry struct is a publicly defined struct, you should be able to make your own permanent copy of the data if necessary.
The entry is not modifiable and should not be freed. Because the git_index_entry struct is a publicly defined struct, you should be able to make your own permanent copy of the data if necessary.
Add or update index entries matching files in the working directory.
\n", "comments": "This method will fail in bare index instances.
\n\nThe pathspec is a list of file names or shell glob patterns that will be matched against files in the repository's working directory. Each file that matches will be added to the index (either updating an existing entry or adding a new entry). You can disable glob expansion and force exact matching with the GIT_INDEX_ADD_DISABLE_PATHSPEC_MATCH flag.
Files that are ignored will be skipped (unlike git_index_add_bypath). If a file is already tracked in the index, then it will be updated even if it is ignored. Pass the GIT_INDEX_ADD_FORCE flag to skip the checking of ignore rules.
To emulate git add -A and generate an error if the pathspec contains the exact path of an ignored file (when not using FORCE), add the GIT_INDEX_ADD_CHECK_PATHSPEC flag. This checks that each entry in the pathspec that is an exact match to a filename on disk is either not ignored or already in the index. If this check fails, the function will return GIT_EINVALIDSPEC.
To emulate git add -A with the "dry-run" option, just use a callback function that always returns a positive value. See below for details.
If any files are currently the result of a merge conflict, those files will no longer be marked as conflicting. The data about the conflicts will be moved to the "resolve undo" (REUC) section.
\n\nIf you provide a callback function, it will be invoked on each matching item in the working directory immediately before it is added to / updated in the index. Returning zero will add the item to the index, greater than zero will skip the item, and less than zero will abort the scan and return that value to the caller.
\n", "group": "index", - "examples": { "add.c": ["ex/v1.8.4/add.html#git_index_add_all-3"] } + "examples": { "add.c": ["ex/v1.9.1/add.html#git_index_add_all-3"] } }, "git_index_remove_all": { "type": "function", "file": "git2/index.h", - "line": 676, - "lineto": 680, + "line": 760, + "lineto": 764, "args": [ { "name": "index", @@ -9151,8 +9367,8 @@ "git_index_update_all": { "type": "function", "file": "git2/index.h", - "line": 705, - "lineto": 709, + "line": 789, + "lineto": 793, "args": [ { "name": "index", @@ -9184,13 +9400,13 @@ "description": "Update all index entries to match the working directory
\n", "comments": "This method will fail in bare index instances.
\n\nThis scans the existing index entries and synchronizes them with the working directory, deleting them if the corresponding working directory file no longer exists otherwise updating the information (including adding the latest version of file to the ODB if needed).
\n\nIf you provide a callback function, it will be invoked on each matching item in the index immediately before it is updated (either refreshed or removed depending on working directory state). Return 0 to proceed with updating the item, > 0 to skip the item, and < 0 to abort the scan.
\n", "group": "index", - "examples": { "add.c": ["ex/v1.8.4/add.html#git_index_update_all-4"] } + "examples": { "add.c": ["ex/v1.9.1/add.html#git_index_update_all-4"] } }, "git_index_find": { "type": "function", "file": "git2/index.h", - "line": 720, - "lineto": 720, + "line": 804, + "lineto": 804, "args": [ { "name": "at_pos", @@ -9214,8 +9430,8 @@ "git_index_find_prefix": { "type": "function", "file": "git2/index.h", - "line": 731, - "lineto": 731, + "line": 815, + "lineto": 815, "args": [ { "name": "at_pos", @@ -9243,8 +9459,8 @@ "git_index_conflict_add": { "type": "function", "file": "git2/index.h", - "line": 756, - "lineto": 760, + "line": 840, + "lineto": 844, "args": [ { "name": "index", @@ -9277,8 +9493,8 @@ "git_index_conflict_get": { "type": "function", "file": "git2/index.h", - "line": 776, - "lineto": 781, + "line": 860, + "lineto": 865, "args": [ { "name": "ancestor_out", @@ -9312,8 +9528,8 @@ "git_index_conflict_remove": { "type": "function", "file": "git2/index.h", - "line": 790, - "lineto": 790, + "line": 874, + "lineto": 874, "args": [ { "name": "index", @@ -9336,8 +9552,8 @@ "git_index_conflict_cleanup": { "type": "function", "file": "git2/index.h", - "line": 798, - "lineto": 798, + "line": 882, + "lineto": 882, "args": [ { "name": "index", @@ -9355,8 +9571,8 @@ "git_index_has_conflicts": { "type": "function", "file": "git2/index.h", - "line": 806, - "lineto": 806, + "line": 890, + "lineto": 890, "args": [ { "name": "index", @@ -9374,14 +9590,14 @@ "comments": "", "group": "index", "examples": { - "merge.c": ["ex/v1.8.4/merge.html#git_index_has_conflicts-11"] + "merge.c": ["ex/v1.9.1/merge.html#git_index_has_conflicts-11"] } }, "git_index_conflict_iterator_new": { "type": "function", "file": "git2/index.h", - "line": 817, - "lineto": 819, + "line": 901, + "lineto": 903, "args": [ { "name": "iterator_out", @@ -9401,14 +9617,14 @@ "comments": "The index must not be modified while iterating; the results are undefined.
\n", "group": "index", "examples": { - "merge.c": ["ex/v1.8.4/merge.html#git_index_conflict_iterator_new-12"] + "merge.c": ["ex/v1.9.1/merge.html#git_index_conflict_iterator_new-12"] } }, "git_index_conflict_next": { "type": "function", "file": "git2/index.h", - "line": 832, - "lineto": 836, + "line": 916, + "lineto": 920, "args": [ { "name": "ancestor_out", @@ -9441,14 +9657,14 @@ "comments": "", "group": "index", "examples": { - "merge.c": ["ex/v1.8.4/merge.html#git_index_conflict_next-13"] + "merge.c": ["ex/v1.9.1/merge.html#git_index_conflict_next-13"] } }, "git_index_conflict_iterator_free": { "type": "function", "file": "git2/index.h", - "line": 843, - "lineto": 844, + "line": 927, + "lineto": 928, "args": [ { "name": "iterator", @@ -9463,14 +9679,14 @@ "comments": "", "group": "index", "examples": { - "merge.c": ["ex/v1.8.4/merge.html#git_index_conflict_iterator_free-14"] + "merge.c": ["ex/v1.9.1/merge.html#git_index_conflict_iterator_free-14"] } }, "git_indexer_options_init": { "type": "function", "file": "git2/indexer.h", - "line": 99, - "lineto": 101, + "line": 116, + "lineto": 118, "args": [ { "name": "opts", @@ -9496,8 +9712,8 @@ "git_indexer_new": { "type": "function", "file": "git2/indexer.h", - "line": 131, - "lineto": 136, + "line": 147, + "lineto": 152, "args": [ { "name": "out", @@ -9535,8 +9751,8 @@ "git_indexer_append": { "type": "function", "file": "git2/indexer.h", - "line": 148, - "lineto": 148, + "line": 164, + "lineto": 164, "args": [ { "name": "idx", "type": "git_indexer *", "comment": "the indexer" }, { @@ -9565,8 +9781,8 @@ "git_indexer_commit": { "type": "function", "file": "git2/indexer.h", - "line": 159, - "lineto": 159, + "line": 175, + "lineto": 175, "args": [ { "name": "idx", "type": "git_indexer *", "comment": "the indexer" }, { @@ -9585,8 +9801,8 @@ "git_indexer_hash": { "type": "function", "file": "git2/indexer.h", - "line": 172, - "lineto": 172, + "line": 188, + "lineto": 188, "args": [ { "name": "idx", @@ -9607,8 +9823,8 @@ "git_indexer_name": { "type": "function", "file": "git2/indexer.h", - "line": 184, - "lineto": 184, + "line": 200, + "lineto": 200, "args": [ { "name": "idx", @@ -9629,8 +9845,8 @@ "git_indexer_free": { "type": "function", "file": "git2/indexer.h", - "line": 191, - "lineto": 191, + "line": 207, + "lineto": 207, "args": [ { "name": "idx", @@ -9648,8 +9864,8 @@ "git_mailmap_new": { "type": "function", "file": "git2/mailmap.h", - "line": 32, - "lineto": 32, + "line": 37, + "lineto": 37, "args": [ { "name": "out", @@ -9667,8 +9883,8 @@ "git_mailmap_free": { "type": "function", "file": "git2/mailmap.h", - "line": 39, - "lineto": 39, + "line": 44, + "lineto": 44, "args": [ { "name": "mm", @@ -9686,8 +9902,8 @@ "git_mailmap_add_entry": { "type": "function", "file": "git2/mailmap.h", - "line": 52, - "lineto": 54, + "line": 57, + "lineto": 59, "args": [ { "name": "mm", @@ -9725,8 +9941,8 @@ "git_mailmap_from_buffer": { "type": "function", "file": "git2/mailmap.h", - "line": 64, - "lineto": 65, + "line": 69, + "lineto": 70, "args": [ { "name": "out", @@ -9754,8 +9970,8 @@ "git_mailmap_from_repository": { "type": "function", "file": "git2/mailmap.h", - "line": 81, - "lineto": 82, + "line": 86, + "lineto": 87, "args": [ { "name": "out", @@ -9778,8 +9994,8 @@ "git_mailmap_resolve": { "type": "function", "file": "git2/mailmap.h", - "line": 96, - "lineto": 98, + "line": 101, + "lineto": 103, "args": [ { "name": "real_name", @@ -9817,8 +10033,8 @@ "git_mailmap_resolve_signature": { "type": "function", "file": "git2/mailmap.h", - "line": 110, - "lineto": 111, + "line": 115, + "lineto": 116, "args": [ { "name": "out", @@ -9846,8 +10062,8 @@ "git_merge_file_input_init": { "type": "function", "file": "git2/merge.h", - "line": 60, - "lineto": 62, + "line": 66, + "lineto": 68, "args": [ { "name": "opts", @@ -9873,8 +10089,8 @@ "git_merge_file_options_init": { "type": "function", "file": "git2/merge.h", - "line": 233, - "lineto": 233, + "line": 243, + "lineto": 243, "args": [ { "name": "opts", @@ -9900,8 +10116,8 @@ "git_merge_options_init": { "type": "function", "file": "git2/merge.h", - "line": 329, - "lineto": 329, + "line": 342, + "lineto": 342, "args": [ { "name": "opts", @@ -9927,8 +10143,8 @@ "git_merge_analysis": { "type": "function", "file": "git2/merge.h", - "line": 399, - "lineto": 404, + "line": 412, + "lineto": 417, "args": [ { "name": "analysis_out", @@ -9962,13 +10178,13 @@ "description": "Analyzes the given branch(es) and determines the opportunities for\n merging them into the HEAD of the repository.
\n", "comments": "", "group": "merge", - "examples": { "merge.c": ["ex/v1.8.4/merge.html#git_merge_analysis-15"] } + "examples": { "merge.c": ["ex/v1.9.1/merge.html#git_merge_analysis-15"] } }, "git_merge_analysis_for_ref": { "type": "function", "file": "git2/merge.h", - "line": 418, - "lineto": 424, + "line": 431, + "lineto": 437, "args": [ { "name": "analysis_out", @@ -10011,8 +10227,8 @@ "git_merge_base": { "type": "function", "file": "git2/merge.h", - "line": 435, - "lineto": 439, + "line": 448, + "lineto": 452, "args": [ { "name": "out", @@ -10045,15 +10261,15 @@ "comments": "", "group": "merge", "examples": { - "log.c": ["ex/v1.8.4/log.html#git_merge_base-31"], - "rev-parse.c": ["ex/v1.8.4/rev-parse.html#git_merge_base-1"] + "log.c": ["ex/v1.9.1/log.html#git_merge_base-31"], + "rev-parse.c": ["ex/v1.9.1/rev-parse.html#git_merge_base-1"] } }, "git_merge_bases": { "type": "function", "file": "git2/merge.h", - "line": 450, - "lineto": 454, + "line": 463, + "lineto": 467, "args": [ { "name": "out", @@ -10089,8 +10305,8 @@ "git_merge_base_many": { "type": "function", "file": "git2/merge.h", - "line": 465, - "lineto": 469, + "line": 478, + "lineto": 482, "args": [ { "name": "out", @@ -10126,8 +10342,8 @@ "git_merge_bases_many": { "type": "function", "file": "git2/merge.h", - "line": 480, - "lineto": 484, + "line": 524, + "lineto": 528, "args": [ { "name": "out", @@ -10157,14 +10373,14 @@ "comment": " Zero on success; GIT_ENOTFOUND or -1 on failure." }, "description": "Find all merge bases given a list of commits
\n", - "comments": "", + "comments": "This behaves similar to git merge-base.
Given three commits a, b, and c, merge_base_many will compute a hypothetical commit m, which is a merge between b and c.
For example, with the following topology: text o---o---o---o---C / / o---o---o---B / / ---2---1---o---o---o---A
the result of merge_base_many given a, b, and c is 1. This is because the equivalent topology with the imaginary merge commit m between b and c is: text o---o---o---o---o / \\ / o---o---o---o---M / / ---2---1---o---o---o---A
and the result of merge_base_many given a and m is 1.
If you're looking to recieve the common ancestor between all the given commits, use merge_base_octopus.
Merges the given commit(s) into HEAD, writing the results into the working\n directory. Any changes are staged for commit and any conflicts are written\n to the index. Callers should inspect the repository's index after this\n completes, resolve any conflicts and prepare a commit.
\n", "comments": "For compatibility with git, the repository is put into a merging state. Once the commit is done (or if the user wishes to abort), you should clear this state by calling git_repository_state_cleanup().
Creates a new iterator for notes
\n", - "comments": "The iterator must be freed manually by the user.
\n", - "group": "note" - }, - "git_note_commit_iterator_new": { - "type": "function", - "file": "git2/notes.h", - "line": 64, - "lineto": 66, - "args": [ - { - "name": "out", - "type": "git_note_iterator **", - "comment": "pointer to the iterator" - }, - { - "name": "notes_commit", - "type": "git_commit *", - "comment": "a pointer to the notes commit object" - } - ], - "argline": "git_note_iterator **out, git_commit *notes_commit", - "sig": "git_note_iterator **::git_commit *", - "return": { "type": "int", "comment": " 0 or an error code" }, - "description": "Creates a new iterator for notes from a commit
\n", - "comments": "The iterator must be freed manually by the user.
\n", - "group": "note" - }, "git_note_iterator_free": { "type": "function", "file": "git2/notes.h", - "line": 73, - "lineto": 73, + "line": 75, + "lineto": 75, "args": [ { "name": "it", @@ -10577,8 +10740,8 @@ "git_note_next": { "type": "function", "file": "git2/notes.h", - "line": 86, - "lineto": 89, + "line": 88, + "lineto": 91, "args": [ { "name": "note_id", @@ -10606,413 +10769,11 @@ "comments": "", "group": "note" }, - "git_note_read": { - "type": "function", - "file": "git2/notes.h", - "line": 105, - "lineto": 109, - "args": [ - { - "name": "out", - "type": "git_note **", - "comment": "pointer to the read note; NULL in case of error" - }, - { - "name": "repo", - "type": "git_repository *", - "comment": "repository where to look up the note" - }, - { - "name": "notes_ref", - "type": "const char *", - "comment": "canonical name of the reference to use (optional); defaults to\n \"refs/notes/commits\"" - }, - { - "name": "oid", - "type": "const git_oid *", - "comment": "OID of the git object to read the note from" - } - ], - "argline": "git_note **out, git_repository *repo, const char *notes_ref, const git_oid *oid", - "sig": "git_note **::git_repository *::const char *::const git_oid *", - "return": { "type": "int", "comment": " 0 or an error code" }, - "description": "Read the note for an object
\n", - "comments": "The note must be freed manually by the user.
\n", - "group": "note" - }, - "git_note_commit_read": { - "type": "function", - "file": "git2/notes.h", - "line": 124, - "lineto": 128, - "args": [ - { - "name": "out", - "type": "git_note **", - "comment": "pointer to the read note; NULL in case of error" - }, - { - "name": "repo", - "type": "git_repository *", - "comment": "repository where to look up the note" - }, - { - "name": "notes_commit", - "type": "git_commit *", - "comment": "a pointer to the notes commit object" - }, - { - "name": "oid", - "type": "const git_oid *", - "comment": "OID of the git object to read the note from" - } - ], - "argline": "git_note **out, git_repository *repo, git_commit *notes_commit, const git_oid *oid", - "sig": "git_note **::git_repository *::git_commit *::const git_oid *", - "return": { "type": "int", "comment": " 0 or an error code" }, - "description": "Read the note for an object from a note commit
\n", - "comments": "The note must be freed manually by the user.
\n", - "group": "note" - }, - "git_note_author": { - "type": "function", - "file": "git2/notes.h", - "line": 136, - "lineto": 136, - "args": [ - { "name": "note", "type": "const git_note *", "comment": "the note" } - ], - "argline": "const git_note *note", - "sig": "const git_note *", - "return": { "type": "const git_signature *", "comment": " the author" }, - "description": "Get the note author
\n", - "comments": "", - "group": "note" - }, - "git_note_committer": { - "type": "function", - "file": "git2/notes.h", - "line": 144, - "lineto": 144, - "args": [ - { "name": "note", "type": "const git_note *", "comment": "the note" } - ], - "argline": "const git_note *note", - "sig": "const git_note *", - "return": { - "type": "const git_signature *", - "comment": " the committer" - }, - "description": "Get the note committer
\n", - "comments": "", - "group": "note" - }, - "git_note_message": { - "type": "function", - "file": "git2/notes.h", - "line": 153, - "lineto": 153, - "args": [ - { "name": "note", "type": "const git_note *", "comment": "the note" } - ], - "argline": "const git_note *note", - "sig": "const git_note *", - "return": { "type": "const char *", "comment": " the note message" }, - "description": "Get the note message
\n", - "comments": "", - "group": "note" - }, - "git_note_id": { - "type": "function", - "file": "git2/notes.h", - "line": 162, - "lineto": 162, - "args": [ - { "name": "note", "type": "const git_note *", "comment": "the note" } - ], - "argline": "const git_note *note", - "sig": "const git_note *", - "return": { - "type": "const git_oid *", - "comment": " the note object's id" - }, - "description": "Get the note object's id
\n", - "comments": "", - "group": "note" - }, - "git_note_create": { - "type": "function", - "file": "git2/notes.h", - "line": 179, - "lineto": 187, - "args": [ - { - "name": "out", - "type": "git_oid *", - "comment": "pointer to store the OID (optional); NULL in case of error" - }, - { - "name": "repo", - "type": "git_repository *", - "comment": "repository where to store the note" - }, - { - "name": "notes_ref", - "type": "const char *", - "comment": "canonical name of the reference to use (optional);\n\t\t\t\t\tdefaults to \"refs/notes/commits\"" - }, - { - "name": "author", - "type": "const git_signature *", - "comment": "signature of the notes commit author" - }, - { - "name": "committer", - "type": "const git_signature *", - "comment": "signature of the notes commit committer" - }, - { - "name": "oid", - "type": "const git_oid *", - "comment": "OID of the git object to decorate" - }, - { - "name": "note", - "type": "const char *", - "comment": "Content of the note to add for object oid" - }, - { "name": "force", "type": "int", "comment": "Overwrite existing note" } - ], - "argline": "git_oid *out, git_repository *repo, const char *notes_ref, const git_signature *author, const git_signature *committer, const git_oid *oid, const char *note, int force", - "sig": "git_oid *::git_repository *::const char *::const git_signature *::const git_signature *::const git_oid *::const char *::int", - "return": { "type": "int", "comment": " 0 or an error code" }, - "description": "Add a note for an object
\n", - "comments": "", - "group": "note" - }, - "git_note_commit_create": { - "type": "function", - "file": "git2/notes.h", - "line": 209, - "lineto": 218, - "args": [ - { - "name": "notes_commit_out", - "type": "git_oid *", - "comment": "pointer to store the commit (optional);\n\t\t\t\t\tNULL in case of error" - }, - { - "name": "notes_blob_out", - "type": "git_oid *", - "comment": "a point to the id of a note blob (optional)" - }, - { - "name": "repo", - "type": "git_repository *", - "comment": "repository where the note will live" - }, - { - "name": "parent", - "type": "git_commit *", - "comment": "Pointer to parent note\n\t\t\t\t\tor NULL if this shall start a new notes tree" - }, - { - "name": "author", - "type": "const git_signature *", - "comment": "signature of the notes commit author" - }, - { - "name": "committer", - "type": "const git_signature *", - "comment": "signature of the notes commit committer" - }, - { - "name": "oid", - "type": "const git_oid *", - "comment": "OID of the git object to decorate" - }, - { - "name": "note", - "type": "const char *", - "comment": "Content of the note to add for object oid" - }, - { - "name": "allow_note_overwrite", - "type": "int", - "comment": "Overwrite existing note" - } - ], - "argline": "git_oid *notes_commit_out, git_oid *notes_blob_out, git_repository *repo, git_commit *parent, const git_signature *author, const git_signature *committer, const git_oid *oid, const char *note, int allow_note_overwrite", - "sig": "git_oid *::git_oid *::git_repository *::git_commit *::const git_signature *::const git_signature *::const git_oid *::const char *::int", - "return": { "type": "int", "comment": " 0 or an error code" }, - "description": "Add a note for an object from a commit
\n", - "comments": "This function will create a notes commit for a given object, the commit is a dangling commit, no reference is created.
\n", - "group": "note" - }, - "git_note_remove": { - "type": "function", - "file": "git2/notes.h", - "line": 232, - "lineto": 237, - "args": [ - { - "name": "repo", - "type": "git_repository *", - "comment": "repository where the note lives" - }, - { - "name": "notes_ref", - "type": "const char *", - "comment": "canonical name of the reference to use (optional);\n\t\t\t\t\tdefaults to \"refs/notes/commits\"" - }, - { - "name": "author", - "type": "const git_signature *", - "comment": "signature of the notes commit author" - }, - { - "name": "committer", - "type": "const git_signature *", - "comment": "signature of the notes commit committer" - }, - { - "name": "oid", - "type": "const git_oid *", - "comment": "OID of the git object to remove the note from" - } - ], - "argline": "git_repository *repo, const char *notes_ref, const git_signature *author, const git_signature *committer, const git_oid *oid", - "sig": "git_repository *::const char *::const git_signature *::const git_signature *::const git_oid *", - "return": { "type": "int", "comment": " 0 or an error code" }, - "description": "Remove the note for an object
\n", - "comments": "", - "group": "note" - }, - "git_note_commit_remove": { - "type": "function", - "file": "git2/notes.h", - "line": 257, - "lineto": 263, - "args": [ - { - "name": "notes_commit_out", - "type": "git_oid *", - "comment": "pointer to store the new notes commit (optional);\n\t\t\t\t\tNULL in case of error.\n\t\t\t\t\tWhen removing a note a new tree containing all notes\n\t\t\t\t\tsans the note to be removed is created and a new commit\n\t\t\t\t\tpointing to that tree is also created.\n\t\t\t\t\tIn the case where the resulting tree is an empty tree\n\t\t\t\t\ta new commit pointing to this empty tree will be returned." - }, - { - "name": "repo", - "type": "git_repository *", - "comment": "repository where the note lives" - }, - { - "name": "notes_commit", - "type": "git_commit *", - "comment": "a pointer to the notes commit object" - }, - { - "name": "author", - "type": "const git_signature *", - "comment": "signature of the notes commit author" - }, - { - "name": "committer", - "type": "const git_signature *", - "comment": "signature of the notes commit committer" - }, - { - "name": "oid", - "type": "const git_oid *", - "comment": "OID of the git object to remove the note from" - } - ], - "argline": "git_oid *notes_commit_out, git_repository *repo, git_commit *notes_commit, const git_signature *author, const git_signature *committer, const git_oid *oid", - "sig": "git_oid *::git_repository *::git_commit *::const git_signature *::const git_signature *::const git_oid *", - "return": { "type": "int", "comment": " 0 or an error code" }, - "description": "Remove the note for an object
\n", - "comments": "", - "group": "note" - }, - "git_note_free": { - "type": "function", - "file": "git2/notes.h", - "line": 270, - "lineto": 270, - "args": [ - { "name": "note", "type": "git_note *", "comment": "git_note object" } - ], - "argline": "git_note *note", - "sig": "git_note *", - "return": { "type": "void", "comment": null }, - "description": "Free a git_note object
\n", - "comments": "", - "group": "note" - }, - "git_note_default_ref": { - "type": "function", - "file": "git2/notes.h", - "line": 280, - "lineto": 280, - "args": [ - { - "name": "out", - "type": "git_buf *", - "comment": "buffer in which to store the name of the default notes reference" - }, - { - "name": "repo", - "type": "git_repository *", - "comment": "The Git repository" - } - ], - "argline": "git_buf *out, git_repository *repo", - "sig": "git_buf *::git_repository *", - "return": { "type": "int", "comment": " 0 or an error code" }, - "description": "Get the default notes reference for a repository
\n", - "comments": "", - "group": "note" - }, - "git_note_foreach": { - "type": "function", - "file": "git2/notes.h", - "line": 298, - "lineto": 302, - "args": [ - { - "name": "repo", - "type": "git_repository *", - "comment": "Repository where to find the notes." - }, - { - "name": "notes_ref", - "type": "const char *", - "comment": "Reference to read from (optional); defaults to\n \"refs/notes/commits\"." - }, - { - "name": "note_cb", - "type": "git_note_foreach_cb", - "comment": "Callback to invoke per found annotation. Return non-zero\n to stop looping." - }, - { - "name": "payload", - "type": "void *", - "comment": "Extra parameter to callback function." - } - ], - "argline": "git_repository *repo, const char *notes_ref, git_note_foreach_cb note_cb, void *payload", - "sig": "git_repository *::const char *::git_note_foreach_cb::void *", - "return": { - "type": "int", - "comment": " 0 on success, non-zero callback return value, or error code" - }, - "description": "Loop over all the notes within a specified namespace\n and issue a callback for each one.
\n", - "comments": "", - "group": "note" - }, "git_object_lookup": { "type": "function", "file": "git2/object.h", - "line": 44, - "lineto": 48, + "line": 45, + "lineto": 49, "args": [ { "name": "object", @@ -11042,15 +10803,15 @@ "comments": "The generated reference is owned by the repository and should be closed with the git_object_free method instead of free'd manually.
The 'type' parameter must match the type of the object in the odb; the method will fail otherwise. The special value 'GIT_OBJECT_ANY' may be passed to let the method guess the object's type.
\n", "group": "object", "examples": { - "log.c": ["ex/v1.8.4/log.html#git_object_lookup-32"], - "merge.c": ["ex/v1.8.4/merge.html#git_object_lookup-17"] + "log.c": ["ex/v1.9.1/log.html#git_object_lookup-32"], + "merge.c": ["ex/v1.9.1/merge.html#git_object_lookup-17"] } }, "git_object_lookup_prefix": { "type": "function", "file": "git2/object.h", - "line": 77, - "lineto": 82, + "line": 78, + "lineto": 83, "args": [ { "name": "object_out", @@ -11082,14 +10843,14 @@ "sig": "git_object **::git_repository *::const git_oid *::size_t::git_object_t", "return": { "type": "int", "comment": " 0 or an error code" }, "description": "Lookup a reference to one of the objects in a repository,\n given a prefix of its identifier (short id).
\n", - "comments": "The object obtained will be so that its identifier matches the first 'len' hexadecimal characters (packets of 4 bits) of the given 'id'. 'len' must be at least GIT_OID_MINPREFIXLEN, and long enough to identify a unique object matching the prefix; otherwise the method will fail.
\n\nThe generated reference is owned by the repository and should be closed with the git_object_free method instead of free'd manually.
The 'type' parameter must match the type of the object in the odb; the method will fail otherwise. The special value 'GIT_OBJECT_ANY' may be passed to let the method guess the object's type.
\n", + "comments": "The object obtained will be so that its identifier matches the first 'len' hexadecimal characters (packets of 4 bits) of the given id. len must be at least GIT_OID_MINPREFIXLEN, and long enough to identify a unique object matching the prefix; otherwise the method will fail.
The generated reference is owned by the repository and should be closed with the git_object_free method instead of free'd manually.
The type parameter must match the type of the object in the odb; the method will fail otherwise. The special value GIT_OBJECT_ANY may be passed to let the method guess the object's type.
Get a short abbreviated OID string for the object
\n", "comments": "This starts at the "core.abbrev" length (default 7 characters) and iteratively extends to a longer string if that length is ambiguous. The result will be unambiguous (at least until new objects are added to the repository).
\n", "group": "object", - "examples": { "tag.c": ["ex/v1.8.4/tag.html#git_object_short_id-3"] } + "examples": { "tag.c": ["ex/v1.9.1/tag.html#git_object_short_id-3"] } }, "git_object_type": { "type": "function", "file": "git2/object.h", - "line": 129, - "lineto": 129, + "line": 130, + "lineto": 130, "args": [ { "name": "obj", @@ -11208,18 +10969,18 @@ "group": "object", "examples": { "cat-file.c": [ - "ex/v1.8.4/cat-file.html#git_object_type-12", - "ex/v1.8.4/cat-file.html#git_object_type-13", - "ex/v1.8.4/cat-file.html#git_object_type-14" + "ex/v1.9.1/cat-file.html#git_object_type-12", + "ex/v1.9.1/cat-file.html#git_object_type-13", + "ex/v1.9.1/cat-file.html#git_object_type-14" ], - "tag.c": ["ex/v1.8.4/tag.html#git_object_type-4"] + "tag.c": ["ex/v1.9.1/tag.html#git_object_type-4"] } }, "git_object_owner": { "type": "function", "file": "git2/object.h", - "line": 143, - "lineto": 143, + "line": 144, + "lineto": 144, "args": [ { "name": "obj", "type": "const git_object *", "comment": "the object" } ], @@ -11236,8 +10997,8 @@ "git_object_free": { "type": "function", "file": "git2/object.h", - "line": 160, - "lineto": 160, + "line": 161, + "lineto": 161, "args": [ { "name": "object", @@ -11253,34 +11014,34 @@ "group": "object", "examples": { "blame.c": [ - "ex/v1.8.4/blame.html#git_object_free-12", - "ex/v1.8.4/blame.html#git_object_free-13", - "ex/v1.8.4/blame.html#git_object_free-14", - "ex/v1.8.4/blame.html#git_object_free-15" - ], - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_object_free-15"], - "commit.c": ["ex/v1.8.4/commit.html#git_object_free-6"], - "general.c": ["ex/v1.8.4/general.html#git_object_free-38"], - "log.c": ["ex/v1.8.4/log.html#git_object_free-37"], - "merge.c": ["ex/v1.8.4/merge.html#git_object_free-18"], + "ex/v1.9.1/blame.html#git_object_free-11", + "ex/v1.9.1/blame.html#git_object_free-12", + "ex/v1.9.1/blame.html#git_object_free-13", + "ex/v1.9.1/blame.html#git_object_free-14" + ], + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_object_free-15"], + "commit.c": ["ex/v1.9.1/commit.html#git_object_free-6"], + "general.c": ["ex/v1.9.1/general.html#git_object_free-38"], + "log.c": ["ex/v1.9.1/log.html#git_object_free-37"], + "merge.c": ["ex/v1.9.1/merge.html#git_object_free-18"], "rev-parse.c": [ - "ex/v1.8.4/rev-parse.html#git_object_free-7", - "ex/v1.8.4/rev-parse.html#git_object_free-8", - "ex/v1.8.4/rev-parse.html#git_object_free-9" + "ex/v1.9.1/rev-parse.html#git_object_free-7", + "ex/v1.9.1/rev-parse.html#git_object_free-8", + "ex/v1.9.1/rev-parse.html#git_object_free-9" ], "tag.c": [ - "ex/v1.8.4/tag.html#git_object_free-5", - "ex/v1.8.4/tag.html#git_object_free-6", - "ex/v1.8.4/tag.html#git_object_free-7", - "ex/v1.8.4/tag.html#git_object_free-8" + "ex/v1.9.1/tag.html#git_object_free-5", + "ex/v1.9.1/tag.html#git_object_free-6", + "ex/v1.9.1/tag.html#git_object_free-7", + "ex/v1.9.1/tag.html#git_object_free-8" ] } }, "git_object_type2string": { "type": "function", "file": "git2/object.h", - "line": 171, - "lineto": 171, + "line": 172, + "lineto": 172, "args": [ { "name": "type", @@ -11299,22 +11060,22 @@ "group": "object", "examples": { "cat-file.c": [ - "ex/v1.8.4/cat-file.html#git_object_type2string-16", - "ex/v1.8.4/cat-file.html#git_object_type2string-17", - "ex/v1.8.4/cat-file.html#git_object_type2string-18", - "ex/v1.8.4/cat-file.html#git_object_type2string-19" + "ex/v1.9.1/cat-file.html#git_object_type2string-16", + "ex/v1.9.1/cat-file.html#git_object_type2string-17", + "ex/v1.9.1/cat-file.html#git_object_type2string-18", + "ex/v1.9.1/cat-file.html#git_object_type2string-19" ], "general.c": [ - "ex/v1.8.4/general.html#git_object_type2string-39", - "ex/v1.8.4/general.html#git_object_type2string-40" + "ex/v1.9.1/general.html#git_object_type2string-39", + "ex/v1.9.1/general.html#git_object_type2string-40" ] } }, "git_object_string2type": { "type": "function", "file": "git2/object.h", - "line": 179, - "lineto": 179, + "line": 180, + "lineto": 180, "args": [ { "name": "str", @@ -11335,8 +11096,8 @@ "git_object_typeisloose": { "type": "function", "file": "git2/object.h", - "line": 188, - "lineto": 188, + "line": 189, + "lineto": 189, "args": [ { "name": "type", @@ -11357,8 +11118,8 @@ "git_object_peel": { "type": "function", "file": "git2/object.h", - "line": 213, - "lineto": 216, + "line": 214, + "lineto": 217, "args": [ { "name": "peeled", @@ -11389,8 +11150,8 @@ "git_object_dup": { "type": "function", "file": "git2/object.h", - "line": 226, - "lineto": 226, + "line": 227, + "lineto": 227, "args": [ { "name": "dest", @@ -11413,8 +11174,8 @@ "git_object_rawcontent_is_valid": { "type": "function", "file": "git2/object.h", - "line": 269, - "lineto": 273, + "line": 270, + "lineto": 274, "args": [ { "name": "valid", @@ -11444,11 +11205,54 @@ "comments": "", "group": "object" }, + "git_odb_new": { + "type": "function", + "file": "git2/odb.h", + "line": 102, + "lineto": 102, + "args": [ + { + "name": "odb", + "type": "git_odb **", + "comment": "location to store the database pointer, if opened." + } + ], + "argline": "git_odb **odb", + "sig": "git_odb **", + "return": { "type": "int", "comment": " 0 or an error code" }, + "description": "Create a new object database with no backends.
\n", + "comments": "Before the ODB can be used for read/writing, a custom database backend must be manually added using git_odb_add_backend()
Create a new object database and automatically add\n the two default backends:
\n", + "comments": "- git_odb_backend_loose: read and write loose object files from disk, assuming `objects_dir` as the Objects folder\n\n- git_odb_backend_pack: read objects from packfiles, assuming `objects_dir` as the Objects folder which contains a 'pack/' folder with the corresponding data\nThis method queries all available ODB backends trying to read the given OID.
\n\nThe returned object is reference counted and internally cached, so it should be closed by the user once it's no longer in use.
\n", "group": "odb", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_odb_read-21"], - "general.c": ["ex/v1.8.4/general.html#git_odb_read-42"] + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_odb_read-21"], + "general.c": ["ex/v1.9.1/general.html#git_odb_read-42"] } }, "git_odb_read_prefix": { "type": "function", "file": "git2/odb.h", - "line": 171, - "lineto": 171, + "line": 191, + "lineto": 191, "args": [ { - "name": "out", + "name": "obj", "type": "git_odb_object **", "comment": "pointer where to store the read object" }, @@ -11557,7 +11361,7 @@ "comment": "the length of the prefix" } ], - "argline": "git_odb_object **out, git_odb *db, const git_oid *short_id, size_t len", + "argline": "git_odb_object **obj, git_odb *db, const git_oid *short_id, size_t len", "sig": "git_odb_object **::git_odb *::const git_oid *::size_t", "return": { "type": "int", @@ -11570,8 +11374,8 @@ "git_odb_read_header": { "type": "function", "file": "git2/odb.h", - "line": 190, - "lineto": 190, + "line": 210, + "lineto": 210, "args": [ { "name": "len_out", @@ -11607,8 +11411,8 @@ "git_odb_exists": { "type": "function", "file": "git2/odb.h", - "line": 199, - "lineto": 199, + "line": 219, + "lineto": 219, "args": [ { "name": "db", @@ -11634,8 +11438,8 @@ "git_odb_exists_ext": { "type": "function", "file": "git2/odb.h", - "line": 210, - "lineto": 210, + "line": 230, + "lineto": 230, "args": [ { "name": "db", @@ -11666,8 +11470,8 @@ "git_odb_exists_prefix": { "type": "function", "file": "git2/odb.h", - "line": 223, - "lineto": 224, + "line": 243, + "lineto": 244, "args": [ { "name": "out", @@ -11703,8 +11507,8 @@ "git_odb_expand_ids": { "type": "function", "file": "git2/odb.h", - "line": 266, - "lineto": 269, + "line": 286, + "lineto": 289, "args": [ { "name": "db", @@ -11735,17 +11539,13 @@ "git_odb_refresh": { "type": "function", "file": "git2/odb.h", - "line": 289, - "lineto": 289, + "line": 309, + "lineto": 309, "args": [ - { - "name": "db", - "type": "struct git_odb *", - "comment": "database to refresh" - } + { "name": "db", "type": "git_odb *", "comment": "database to refresh" } ], - "argline": "struct git_odb *db", - "sig": "struct git_odb *", + "argline": "git_odb *db", + "sig": "git_odb *", "return": { "type": "int", "comment": " 0 on success, error code otherwise" @@ -11757,8 +11557,8 @@ "git_odb_foreach": { "type": "function", "file": "git2/odb.h", - "line": 304, - "lineto": 304, + "line": 324, + "lineto": 327, "args": [ { "name": "db", "type": "git_odb *", "comment": "database to use" }, { @@ -11785,8 +11585,8 @@ "git_odb_write": { "type": "function", "file": "git2/odb.h", - "line": 324, - "lineto": 324, + "line": 347, + "lineto": 347, "args": [ { "name": "out", @@ -11801,7 +11601,7 @@ { "name": "data", "type": "const void *", - "comment": "buffer with the data to store" + "comment": "`const unsigned char *` buffer with the data to store" }, { "name": "len", "type": "size_t", "comment": "size of the buffer" }, { @@ -11816,13 +11616,13 @@ "description": "Write an object directly into the ODB
\n", "comments": "This method writes a full object straight into the ODB. For most cases, it is preferred to write objects through a write stream, which is both faster and less memory intensive, specially for big objects.
\n\nThis method is provided for compatibility with custom backends which are not able to support streaming writes
\n", "group": "odb", - "examples": { "general.c": ["ex/v1.8.4/general.html#git_odb_write-43"] } + "examples": { "general.c": ["ex/v1.9.1/general.html#git_odb_write-43"] } }, "git_odb_open_wstream": { "type": "function", "file": "git2/odb.h", - "line": 347, - "lineto": 347, + "line": 370, + "lineto": 370, "args": [ { "name": "out", @@ -11858,8 +11658,8 @@ "git_odb_stream_write": { "type": "function", "file": "git2/odb.h", - "line": 360, - "lineto": 360, + "line": 383, + "lineto": 383, "args": [ { "name": "stream", @@ -11886,8 +11686,8 @@ "git_odb_stream_finalize_write": { "type": "function", "file": "git2/odb.h", - "line": 375, - "lineto": 375, + "line": 398, + "lineto": 398, "args": [ { "name": "out", @@ -11913,8 +11713,8 @@ "git_odb_stream_read": { "type": "function", "file": "git2/odb.h", - "line": 387, - "lineto": 387, + "line": 410, + "lineto": 410, "args": [ { "name": "stream", @@ -11932,7 +11732,7 @@ "sig": "git_odb_stream *::char *::size_t", "return": { "type": "int", - "comment": " 0 if the read succeeded, error code otherwise" + "comment": " the number of bytes read if succeeded, error code otherwise" }, "description": "Read from an odb stream
\n", "comments": "Most backends don't implement streaming reads
\n", @@ -11941,8 +11741,8 @@ "git_odb_stream_free": { "type": "function", "file": "git2/odb.h", - "line": 394, - "lineto": 394, + "line": 417, + "lineto": 417, "args": [ { "name": "stream", @@ -11960,8 +11760,8 @@ "git_odb_open_rstream": { "type": "function", "file": "git2/odb.h", - "line": 422, - "lineto": 427, + "line": 445, + "lineto": 450, "args": [ { "name": "out", @@ -12002,8 +11802,8 @@ "git_odb_write_pack": { "type": "function", "file": "git2/odb.h", - "line": 448, - "lineto": 452, + "line": 471, + "lineto": 475, "args": [ { "name": "out", @@ -12036,8 +11836,8 @@ "git_odb_write_multi_pack_index": { "type": "function", "file": "git2/odb.h", - "line": 466, - "lineto": 467, + "line": 489, + "lineto": 490, "args": [ { "name": "db", @@ -12052,11 +11852,66 @@ "comments": "If the ODB layer understands pack files, then this will create a file called multi-pack-index next to the .pack and .idx files, which will contain an index of all objects stored in .pack files. This will allow for O(log n) lookup for n objects (regardless of how many packfiles there exist).
Determine the object-ID (sha1 or sha256 hash) of a data buffer
\n", + "comments": "The resulting OID will be the identifier for the data buffer as if the data buffer it were to written to the ODB.
\n", + "group": "odb" + }, + "git_odb_hashfile": { + "type": "function", + "file": "git2/odb.h", + "line": 554, + "lineto": 554, + "args": [ + { + "name": "oid", + "type": "git_oid *", + "comment": "oid structure the result is written into." + }, + { + "name": "path", + "type": "const char *", + "comment": "file to read and determine object id for" + }, + { + "name": "object_type", + "type": "git_object_t", + "comment": "of the data to hash" + } + ], + "argline": "git_oid *oid, const char *path, git_object_t object_type", + "sig": "git_oid *::const char *::git_object_t", + "return": { "type": "int", "comment": " 0 or an error code" }, + "description": "Read a file from disk and fill a git_oid with the object id\n that the file would have if it were written to the Object\n Database as an object of the given type (w/o applying filters).\n Similar functionality to git.git's git hash-object without\n the -w flag, however, with the --no-filters flag.\n If you need filters, see git_repository_hashfile.
This method must always be called once a git_odb_object is no longer needed, otherwise memory will leak.
Return the data of an ODB object
\n", "comments": "This is the uncompressed, raw data as read from the ODB, without the leading header.
\n\nThis pointer is owned by the object and shall not be free'd.
\n", "group": "odb", "examples": { - "general.c": ["ex/v1.8.4/general.html#git_odb_object_data-45"] + "general.c": ["ex/v1.9.1/general.html#git_odb_object_data-45"] } }, "git_odb_object_size": { "type": "function", "file": "git2/odb.h", - "line": 573, - "lineto": 573, + "line": 614, + "lineto": 614, "args": [ { "name": "object", @@ -12162,15 +12020,15 @@ "comments": "This is the real size of the data buffer, not the actual size of the object.
After a successful call, the ownership of the cgraph parameter will be transferred to libgit2, and the caller should not free it.
\n\nThe commit-graph can also be unset by explicitly passing NULL as the cgraph parameter.
\n", "group": "odb" }, + "git_odb_backend_pack": { + "type": "function", + "file": "git2/odb_backend.h", + "line": 142, + "lineto": 144, + "args": [ + { + "name": "out", + "type": "git_odb_backend **", + "comment": "location to store the odb backend pointer" + }, + { + "name": "objects_dir", + "type": "const char *", + "comment": "the Git repository's objects directory" + } + ], + "argline": "git_odb_backend **out, const char *objects_dir", + "sig": "git_odb_backend **::const char *", + "return": { "type": "int", "comment": " 0 or an error code" }, + "description": "Create a backend for a directory containing packfiles.
\n", + "comments": "", + "group": "odb" + }, + "git_odb_backend_one_pack": { + "type": "function", + "file": "git2/odb_backend.h", + "line": 156, + "lineto": 158, + "args": [ + { + "name": "out", + "type": "git_odb_backend **", + "comment": "location to store the odb backend pointer" + }, + { + "name": "index_file", + "type": "const char *", + "comment": "path to the packfile's .idx file" + } + ], + "argline": "git_odb_backend **out, const char *index_file", + "sig": "git_odb_backend **::const char *", + "return": { "type": "int", "comment": " 0 or an error code" }, + "description": "Create a backend out of a single packfile
\n", + "comments": "This can be useful for inspecting the contents of a single packfile.
\n", + "group": "odb" + }, + "git_odb_backend_loose": { + "type": "function", + "file": "git2/odb_backend.h", + "line": 171, + "lineto": 177, + "args": [ + { + "name": "out", + "type": "git_odb_backend **", + "comment": "location to store the odb backend pointer" + }, + { + "name": "objects_dir", + "type": "const char *", + "comment": "the Git repository's objects directory" + }, + { + "name": "compression_level", + "type": "int", + "comment": "zlib compression level (0-9), or -1 for the default" + }, + { + "name": "do_fsync", + "type": "int", + "comment": "if non-zero, perform an fsync on write" + }, + { + "name": "dir_mode", + "type": "unsigned int", + "comment": "permission to use when creating directories, or 0 for default" + }, + { + "name": "file_mode", + "type": "unsigned int", + "comment": "permission to use when creating directories, or 0 for default" + } + ], + "argline": "git_odb_backend **out, const char *objects_dir, int compression_level, int do_fsync, unsigned int dir_mode, unsigned int file_mode", + "sig": "git_odb_backend **::const char *::int::int::unsigned int::unsigned int", + "return": { "type": "int", "comment": " 0 or an error code" }, + "description": "Create a backend for loose objects
\n", + "comments": "", + "group": "odb" + }, + "git_oid_fromstr": { + "type": "function", + "file": "git2/oid.h", + "line": 137, + "lineto": 137, + "args": [ + { + "name": "out", + "type": "git_oid *", + "comment": "oid structure the result is written into." + }, + { + "name": "str", + "type": "const char *", + "comment": "input hex string; must be pointing at the start of\n\t\tthe hex sequence and have at least the number of bytes\n\t\tneeded for an oid encoded in hex (40 bytes for sha1,\n\t\t256 bytes for sha256)." + } + ], + "argline": "git_oid *out, const char *str", + "sig": "git_oid *::const char *", + "return": { "type": "int", "comment": " 0 or an error code" }, + "description": "Parse a hex formatted object id into a git_oid.
\n", + "comments": "The appropriate number of bytes for the given object ID type will be read from the string - 40 bytes for SHA1, 64 bytes for SHA256. The given string need not be NUL terminated.
\n", + "group": "oid", + "examples": { + "general.c": [ + "ex/v1.9.1/general.html#git_oid_fromstr-48", + "ex/v1.9.1/general.html#git_oid_fromstr-49", + "ex/v1.9.1/general.html#git_oid_fromstr-50", + "ex/v1.9.1/general.html#git_oid_fromstr-51", + "ex/v1.9.1/general.html#git_oid_fromstr-52", + "ex/v1.9.1/general.html#git_oid_fromstr-53", + "ex/v1.9.1/general.html#git_oid_fromstr-54", + "ex/v1.9.1/general.html#git_oid_fromstr-55", + "ex/v1.9.1/general.html#git_oid_fromstr-56", + "ex/v1.9.1/general.html#git_oid_fromstr-57", + "ex/v1.9.1/general.html#git_oid_fromstr-58", + "ex/v1.9.1/general.html#git_oid_fromstr-59", + "ex/v1.9.1/general.html#git_oid_fromstr-60", + "ex/v1.9.1/general.html#git_oid_fromstr-61", + "ex/v1.9.1/general.html#git_oid_fromstr-62", + "ex/v1.9.1/general.html#git_oid_fromstr-63" + ] + } + }, + "git_oid_fromstrp": { + "type": "function", + "file": "git2/oid.h", + "line": 146, + "lineto": 146, + "args": [ + { + "name": "out", + "type": "git_oid *", + "comment": "oid structure the result is written into." + }, + { + "name": "str", + "type": "const char *", + "comment": "input hex string; must be null-terminated." + } + ], + "argline": "git_oid *out, const char *str", + "sig": "git_oid *::const char *", + "return": { "type": "int", "comment": " 0 or an error code" }, + "description": "Parse a hex formatted NUL-terminated string into a git_oid.
\n", + "comments": "", + "group": "oid" + }, + "git_oid_fromstrn": { + "type": "function", + "file": "git2/oid.h", + "line": 159, + "lineto": 159, + "args": [ + { + "name": "out", + "type": "git_oid *", + "comment": "oid structure the result is written into." + }, + { + "name": "str", + "type": "const char *", + "comment": "input hex string of at least size `length`" + }, + { + "name": "length", + "type": "size_t", + "comment": "length of the input string" + } + ], + "argline": "git_oid *out, const char *str, size_t length", + "sig": "git_oid *::const char *::size_t", + "return": { "type": "int", "comment": " 0 or an error code" }, + "description": "Parse N characters of a hex formatted object id into a git_oid.
\n", + "comments": "If N is odd, the last byte's high nibble will be read in and the low nibble set to zero.
\n", + "group": "oid" + }, + "git_oid_fromraw": { + "type": "function", + "file": "git2/oid.h", + "line": 168, + "lineto": 168, + "args": [ + { + "name": "out", + "type": "git_oid *", + "comment": "oid structure the result is written into." + }, + { + "name": "raw", + "type": "const unsigned char *", + "comment": "the raw input bytes to be copied." + } + ], + "argline": "git_oid *out, const unsigned char *raw", + "sig": "git_oid *::const unsigned char *", + "return": { "type": "int", "comment": " 0 on success or error code" }, + "description": "Copy an already raw oid into a git_oid structure.
\n", + "comments": "", + "group": "oid" + }, "git_oid_fmt": { "type": "function", "file": "git2/oid.h", - "line": 188, - "lineto": 188, + "line": 184, + "lineto": 184, "args": [ { "name": "out", @@ -12346,24 +12417,24 @@ "group": "oid", "examples": { "fetch.c": [ - "ex/v1.8.4/fetch.html#git_oid_fmt-1", - "ex/v1.8.4/fetch.html#git_oid_fmt-2" + "ex/v1.9.1/fetch.html#git_oid_fmt-1", + "ex/v1.9.1/fetch.html#git_oid_fmt-2" ], "general.c": [ - "ex/v1.8.4/general.html#git_oid_fmt-48", - "ex/v1.8.4/general.html#git_oid_fmt-49", - "ex/v1.8.4/general.html#git_oid_fmt-50", - "ex/v1.8.4/general.html#git_oid_fmt-51", - "ex/v1.8.4/general.html#git_oid_fmt-52" + "ex/v1.9.1/general.html#git_oid_fmt-64", + "ex/v1.9.1/general.html#git_oid_fmt-65", + "ex/v1.9.1/general.html#git_oid_fmt-66", + "ex/v1.9.1/general.html#git_oid_fmt-67", + "ex/v1.9.1/general.html#git_oid_fmt-68" ], - "ls-remote.c": ["ex/v1.8.4/ls-remote.html#git_oid_fmt-1"] + "ls-remote.c": ["ex/v1.9.1/ls-remote.html#git_oid_fmt-1"] } }, "git_oid_nfmt": { "type": "function", "file": "git2/oid.h", - "line": 200, - "lineto": 200, + "line": 196, + "lineto": 196, "args": [ { "name": "out", @@ -12391,8 +12462,8 @@ "git_oid_pathfmt": { "type": "function", "file": "git2/oid.h", - "line": 217, - "lineto": 217, + "line": 213, + "lineto": 213, "args": [ { "name": "out", @@ -12418,8 +12489,8 @@ "git_oid_tostr_s": { "type": "function", "file": "git2/oid.h", - "line": 230, - "lineto": 230, + "line": 226, + "lineto": 226, "args": [ { "name": "oid", @@ -12438,16 +12509,16 @@ "group": "oid", "examples": { "merge.c": [ - "ex/v1.8.4/merge.html#git_oid_tostr_s-19", - "ex/v1.8.4/merge.html#git_oid_tostr_s-20" + "ex/v1.9.1/merge.html#git_oid_tostr_s-19", + "ex/v1.9.1/merge.html#git_oid_tostr_s-20" ] } }, "git_oid_tostr": { "type": "function", "file": "git2/oid.h", - "line": 251, - "lineto": 251, + "line": 247, + "lineto": 247, "args": [ { "name": "out", @@ -12476,33 +12547,33 @@ "group": "oid", "examples": { "blame.c": [ - "ex/v1.8.4/blame.html#git_oid_tostr-16", - "ex/v1.8.4/blame.html#git_oid_tostr-17" + "ex/v1.9.1/blame.html#git_oid_tostr-15", + "ex/v1.9.1/blame.html#git_oid_tostr-16" ], "cat-file.c": [ - "ex/v1.8.4/cat-file.html#git_oid_tostr-24", - "ex/v1.8.4/cat-file.html#git_oid_tostr-25", - "ex/v1.8.4/cat-file.html#git_oid_tostr-26", - "ex/v1.8.4/cat-file.html#git_oid_tostr-27", - "ex/v1.8.4/cat-file.html#git_oid_tostr-28" + "ex/v1.9.1/cat-file.html#git_oid_tostr-24", + "ex/v1.9.1/cat-file.html#git_oid_tostr-25", + "ex/v1.9.1/cat-file.html#git_oid_tostr-26", + "ex/v1.9.1/cat-file.html#git_oid_tostr-27", + "ex/v1.9.1/cat-file.html#git_oid_tostr-28" ], "log.c": [ - "ex/v1.8.4/log.html#git_oid_tostr-38", - "ex/v1.8.4/log.html#git_oid_tostr-39" + "ex/v1.9.1/log.html#git_oid_tostr-38", + "ex/v1.9.1/log.html#git_oid_tostr-39" ], "rev-parse.c": [ - "ex/v1.8.4/rev-parse.html#git_oid_tostr-10", - "ex/v1.8.4/rev-parse.html#git_oid_tostr-11", - "ex/v1.8.4/rev-parse.html#git_oid_tostr-12", - "ex/v1.8.4/rev-parse.html#git_oid_tostr-13" + "ex/v1.9.1/rev-parse.html#git_oid_tostr-10", + "ex/v1.9.1/rev-parse.html#git_oid_tostr-11", + "ex/v1.9.1/rev-parse.html#git_oid_tostr-12", + "ex/v1.9.1/rev-parse.html#git_oid_tostr-13" ] } }, "git_oid_cpy": { "type": "function", "file": "git2/oid.h", - "line": 260, - "lineto": 260, + "line": 256, + "lineto": 256, "args": [ { "name": "out", @@ -12523,17 +12594,17 @@ "group": "oid", "examples": { "blame.c": [ - "ex/v1.8.4/blame.html#git_oid_cpy-18", - "ex/v1.8.4/blame.html#git_oid_cpy-19", - "ex/v1.8.4/blame.html#git_oid_cpy-20" + "ex/v1.9.1/blame.html#git_oid_cpy-17", + "ex/v1.9.1/blame.html#git_oid_cpy-18", + "ex/v1.9.1/blame.html#git_oid_cpy-19" ] } }, "git_oid_cmp": { "type": "function", "file": "git2/oid.h", - "line": 269, - "lineto": 269, + "line": 265, + "lineto": 265, "args": [ { "name": "a", @@ -12559,8 +12630,8 @@ "git_oid_equal": { "type": "function", "file": "git2/oid.h", - "line": 278, - "lineto": 278, + "line": 274, + "lineto": 274, "args": [ { "name": "a", @@ -12583,8 +12654,8 @@ "git_oid_ncmp": { "type": "function", "file": "git2/oid.h", - "line": 289, - "lineto": 289, + "line": 285, + "lineto": 285, "args": [ { "name": "a", @@ -12612,8 +12683,8 @@ "git_oid_streq": { "type": "function", "file": "git2/oid.h", - "line": 298, - "lineto": 298, + "line": 294, + "lineto": 294, "args": [ { "name": "id", @@ -12639,8 +12710,8 @@ "git_oid_strcmp": { "type": "function", "file": "git2/oid.h", - "line": 308, - "lineto": 308, + "line": 304, + "lineto": 304, "args": [ { "name": "id", @@ -12666,9 +12737,15 @@ "git_oid_is_zero": { "type": "function", "file": "git2/oid.h", - "line": 315, - "lineto": 315, - "args": [{ "name": "id", "type": "const git_oid *", "comment": null }], + "line": 312, + "lineto": 312, + "args": [ + { + "name": "id", + "type": "const git_oid *", + "comment": "the object ID to check" + } + ], "argline": "const git_oid *id", "sig": "const git_oid *", "return": { "type": "int", "comment": " 1 if all zeros, 0 otherwise." }, @@ -12676,15 +12753,15 @@ "comments": "", "group": "oid", "examples": { - "blame.c": ["ex/v1.8.4/blame.html#git_oid_is_zero-21"], - "fetch.c": ["ex/v1.8.4/fetch.html#git_oid_is_zero-3"] + "blame.c": ["ex/v1.9.1/blame.html#git_oid_is_zero-20"], + "fetch.c": ["ex/v1.9.1/fetch.html#git_oid_is_zero-3"] } }, "git_oid_shorten_new": { "type": "function", "file": "git2/oid.h", - "line": 336, - "lineto": 336, + "line": 333, + "lineto": 333, "args": [ { "name": "min_length", @@ -12705,8 +12782,8 @@ "git_oid_shorten_add": { "type": "function", "file": "git2/oid.h", - "line": 362, - "lineto": 362, + "line": 359, + "lineto": 359, "args": [ { "name": "os", @@ -12732,8 +12809,8 @@ "git_oid_shorten_free": { "type": "function", "file": "git2/oid.h", - "line": 369, - "lineto": 369, + "line": 366, + "lineto": 366, "args": [ { "name": "os", @@ -12751,8 +12828,8 @@ "git_oidarray_dispose": { "type": "function", "file": "git2/oidarray.h", - "line": 31, - "lineto": 31, + "line": 38, + "lineto": 38, "args": [ { "name": "array", @@ -13128,8 +13205,8 @@ "git_packbuilder_set_callbacks": { "type": "function", "file": "git2/pack.h", - "line": 253, - "lineto": 256, + "line": 264, + "lineto": 267, "args": [ { "name": "pb", @@ -13139,7 +13216,7 @@ { "name": "progress_cb", "type": "git_packbuilder_progress", - "comment": "Function to call with progress information during\n pack building. Be aware that this is called inline with pack building\n operations, so performance may be affected." + "comment": "Function to call with progress information during\n pack building. Be aware that this is called inline with pack building\n operations, so performance may be affected.\n When progress_cb returns an error, the pack building process will be\n aborted and the error will be returned from the invoked function.\n `pb` must then be freed." }, { "name": "progress_cb_payload", @@ -13157,8 +13234,8 @@ "git_packbuilder_free": { "type": "function", "file": "git2/pack.h", - "line": 263, - "lineto": 263, + "line": 274, + "lineto": 274, "args": [ { "name": "pb", @@ -13371,7 +13448,7 @@ "comments": "This is just like git_diff_buffers() except it generates a patch object for the difference instead of directly making callbacks. You can use the standard git_patch accessor functions to read the patch data, and you must call git_patch_free() on the patch when done.
Free a git_patch object.
\n", "comments": "", "group": "patch", - "examples": { "diff.c": ["ex/v1.8.4/diff.html#git_patch_free-17"] } + "examples": { "diff.c": ["ex/v1.9.1/diff.html#git_patch_free-17"] } }, "git_patch_get_delta": { "type": "function", @@ -13661,13 +13738,13 @@ "description": "Get the content of a patch as a single diff text.
\n", "comments": "", "group": "patch", - "examples": { "diff.c": ["ex/v1.8.4/diff.html#git_patch_to_buf-18"] } + "examples": { "diff.c": ["ex/v1.9.1/diff.html#git_patch_to_buf-18"] } }, "git_pathspec_new": { "type": "function", "file": "git2/pathspec.h", - "line": 82, - "lineto": 83, + "line": 89, + "lineto": 90, "args": [ { "name": "out", @@ -13689,13 +13766,13 @@ "description": "Compile a pathspec
\n", "comments": "", "group": "pathspec", - "examples": { "log.c": ["ex/v1.8.4/log.html#git_pathspec_new-40"] } + "examples": { "log.c": ["ex/v1.9.1/log.html#git_pathspec_new-40"] } }, "git_pathspec_free": { "type": "function", "file": "git2/pathspec.h", - "line": 90, - "lineto": 90, + "line": 97, + "lineto": 97, "args": [ { "name": "ps", @@ -13709,13 +13786,13 @@ "description": "Free a pathspec
\n", "comments": "", "group": "pathspec", - "examples": { "log.c": ["ex/v1.8.4/log.html#git_pathspec_free-41"] } + "examples": { "log.c": ["ex/v1.9.1/log.html#git_pathspec_free-41"] } }, "git_pathspec_matches_path": { "type": "function", "file": "git2/pathspec.h", - "line": 105, - "lineto": 106, + "line": 112, + "lineto": 113, "args": [ { "name": "ps", @@ -13746,8 +13823,8 @@ "git_pathspec_match_workdir": { "type": "function", "file": "git2/pathspec.h", - "line": 130, - "lineto": 134, + "line": 137, + "lineto": 141, "args": [ { "name": "out", @@ -13783,8 +13860,8 @@ "git_pathspec_match_index": { "type": "function", "file": "git2/pathspec.h", - "line": 159, - "lineto": 163, + "line": 166, + "lineto": 170, "args": [ { "name": "out", @@ -13820,8 +13897,8 @@ "git_pathspec_match_tree": { "type": "function", "file": "git2/pathspec.h", - "line": 183, - "lineto": 187, + "line": 190, + "lineto": 194, "args": [ { "name": "out", @@ -13853,13 +13930,13 @@ "description": "Match a pathspec against files in a tree.
\n", "comments": "This matches the pathspec against the files in the given tree.
\n\nIf out is not NULL, this returns a git_patchspec_match_list. That contains the list of all matched filenames (unless you pass the GIT_PATHSPEC_FAILURES_ONLY flag) and may also contain the list of pathspecs with no match (if you used the GIT_PATHSPEC_FIND_FAILURES flag). You must call git_pathspec_match_list_free() on this object.
Lookup a reference by DWIMing its short name
\n", "comments": "Apply the git precedence rules to the given shorthand to determine which reference the user is referring to.
\n", "group": "reference", - "examples": { "merge.c": ["ex/v1.8.4/merge.html#git_reference_dwim-22"] } + "examples": { "merge.c": ["ex/v1.9.1/merge.html#git_reference_dwim-22"] } }, "git_reference_symbolic_create_matching": { "type": "function", @@ -15136,7 +15213,7 @@ "comments": "A direct reference (also called an object id reference) refers directly to a specific object id (a.k.a. OID or SHA) in the repository. The id permanently refers to the object (although the reference itself can be moved). For example, in libgit2 the direct ref "refs/tags/v0.17.0" refers to OID 5b9fac39d8a76b9139667c26a63e6b3f204b3977.
\n\nThe direct reference will be created in the repository and written to the disk. The generated reference object must be freed by the user.
\n\nValid reference names must follow one of two patterns:
\n\nThis function will return an error if a reference already exists with the given name unless force is true, in which case it will be overwritten.
The message for the reflog will be ignored if the reference does not belong in the standard set (HEAD, branches and remote-tracking branches) and it does not have a reflog.
\n", "group": "reference", "examples": { - "merge.c": ["ex/v1.8.4/merge.html#git_reference_create-23"] + "merge.c": ["ex/v1.9.1/merge.html#git_reference_create-23"] } }, "git_reference_create_matching": { @@ -15213,7 +15290,7 @@ "comments": "Only available if the reference is direct (i.e. an object id reference, not a symbolic one).
\n\nTo find the OID of a symbolic ref, call git_reference_resolve() and then this function (or maybe use git_reference_name_to_id() to directly resolve a reference name all the way through to an OID).
Either direct (GIT_REFERENCE_DIRECT) or symbolic (GIT_REFERENCE_SYMBOLIC)
\n", "group": "reference", "examples": { - "general.c": ["ex/v1.8.4/general.html#git_reference_type-56"] + "general.c": ["ex/v1.9.1/general.html#git_reference_type-72"] } }, "git_reference_name": { @@ -15310,8 +15387,8 @@ "comments": "See git_reference_symbolic_create() for rules about valid names.
The new reference will be written to disk, overwriting the given reference.
\n", "group": "reference", "examples": { - "merge.c": ["ex/v1.8.4/merge.html#git_reference_set_target-26"] + "merge.c": ["ex/v1.9.1/merge.html#git_reference_set_target-26"] } }, "git_reference_rename": { "type": "function", "file": "git2/refs.h", - "line": 381, - "lineto": 386, + "line": 382, + "lineto": 387, "args": [ - { "name": "new_ref", "type": "git_reference **", "comment": null }, + { + "name": "new_ref", + "type": "git_reference **", + "comment": "The new reference" + }, { "name": "ref", "type": "git_reference *", @@ -15478,8 +15559,8 @@ "git_reference_delete": { "type": "function", "file": "git2/refs.h", - "line": 401, - "lineto": 401, + "line": 402, + "lineto": 402, "args": [ { "name": "ref", @@ -15500,10 +15581,14 @@ "git_reference_remove": { "type": "function", "file": "git2/refs.h", - "line": 412, - "lineto": 412, + "line": 414, + "lineto": 414, "args": [ - { "name": "repo", "type": "git_repository *", "comment": null }, + { + "name": "repo", + "type": "git_repository *", + "comment": "The repository to remove the reference from" + }, { "name": "name", "type": "const char *", @@ -15520,8 +15605,8 @@ "git_reference_list": { "type": "function", "file": "git2/refs.h", - "line": 426, - "lineto": 426, + "line": 428, + "lineto": 428, "args": [ { "name": "array", @@ -15541,14 +15626,14 @@ "comments": "The string array will be filled with the names of all references; these values are owned by the user and should be free'd manually when no longer needed, using git_strarray_free().
Recursively peel reference until object of the specified type is found.
\n", "comments": "The retrieved peeled object is owned by the repository and should be closed with the git_object_free method.
If you pass GIT_OBJECT_ANY as the target type, then the object will be peeled until a non-tag object is met.
This will transform the reference name into a name "human-readable" version. If no shortname is appropriate, it will return the full name.
\n\nThe memory is owned by the reference and must not be freed.
\n", "group": "reference", "examples": { - "status.c": ["ex/v1.8.4/status.html#git_reference_shorthand-2"] + "status.c": ["ex/v1.9.1/status.html#git_reference_shorthand-2"] } }, "git_refspec_parse": { @@ -16270,7 +16355,7 @@ "comments": "", "group": "refspec" }, - "git_refspec_src_matches": { + "git_refspec_src_matches_negative": { "type": "function", "file": "git2/refspec.h", "line": 88, @@ -16293,11 +16378,11 @@ "type": "int", "comment": " 1 if the refspec matches, 0 otherwise" }, - "description": "Check if a refspec's source descriptor matches a reference
\n", + "description": "Check if a refspec's source descriptor matches a negative reference
\n", "comments": "", "group": "refspec" }, - "git_refspec_dst_matches": { + "git_refspec_src_matches": { "type": "function", "file": "git2/refspec.h", "line": 97, @@ -16320,6 +16405,33 @@ "type": "int", "comment": " 1 if the refspec matches, 0 otherwise" }, + "description": "Check if a refspec's source descriptor matches a reference
\n", + "comments": "", + "group": "refspec" + }, + "git_refspec_dst_matches": { + "type": "function", + "file": "git2/refspec.h", + "line": 106, + "lineto": 106, + "args": [ + { + "name": "refspec", + "type": "const git_refspec *", + "comment": "the refspec" + }, + { + "name": "refname", + "type": "const char *", + "comment": "the name of the reference to check" + } + ], + "argline": "const git_refspec *refspec, const char *refname", + "sig": "const git_refspec *::const char *", + "return": { + "type": "int", + "comment": " 1 if the refspec matches, 0 otherwise" + }, "description": "Check if a refspec's destination descriptor matches a reference
\n", "comments": "", "group": "refspec" @@ -16327,8 +16439,8 @@ "git_refspec_transform": { "type": "function", "file": "git2/refspec.h", - "line": 107, - "lineto": 107, + "line": 116, + "lineto": 116, "args": [ { "name": "out", @@ -16356,8 +16468,8 @@ "git_refspec_rtransform": { "type": "function", "file": "git2/refspec.h", - "line": 117, - "lineto": 117, + "line": 126, + "lineto": 126, "args": [ { "name": "out", @@ -16380,7 +16492,10 @@ "return": { "type": "int", "comment": " 0, GIT_EBUFS or another error" }, "description": "Transform a target reference to its source reference following the refspec's rules
\n", "comments": "", - "group": "refspec" + "group": "refspec", + "examples": { + "fetch.c": ["ex/v1.9.1/fetch.html#git_refspec_rtransform-4"] + } }, "git_remote_create": { "type": "function", @@ -16414,13 +16529,13 @@ "description": "Add a remote with the default fetch refspec to the repository's configuration.
\n", "comments": "", "group": "remote", - "examples": { "remote.c": ["ex/v1.8.4/remote.html#git_remote_create-1"] } + "examples": { "remote.c": ["ex/v1.9.1/remote.html#git_remote_create-1"] } }, "git_remote_create_options_init": { "type": "function", "file": "git2/remote.h", - "line": 132, - "lineto": 134, + "line": 135, + "lineto": 137, "args": [ { "name": "opts", @@ -16446,8 +16561,8 @@ "git_remote_create_with_opts": { "type": "function", "file": "git2/remote.h", - "line": 148, - "lineto": 151, + "line": 151, + "lineto": 154, "args": [ { "name": "out", @@ -16478,8 +16593,8 @@ "git_remote_create_with_fetchspec": { "type": "function", "file": "git2/remote.h", - "line": 164, - "lineto": 169, + "line": 167, + "lineto": 172, "args": [ { "name": "out", @@ -16520,8 +16635,8 @@ "git_remote_create_anonymous": { "type": "function", "file": "git2/remote.h", - "line": 182, - "lineto": 185, + "line": 185, + "lineto": 188, "args": [ { "name": "out", @@ -16546,17 +16661,17 @@ "comments": "Create a remote with the given url in-memory. You can use this when you have a URL instead of a remote's name.
\n", "group": "remote", "examples": { - "fetch.c": ["ex/v1.8.4/fetch.html#git_remote_create_anonymous-4"], + "fetch.c": ["ex/v1.9.1/fetch.html#git_remote_create_anonymous-5"], "ls-remote.c": [ - "ex/v1.8.4/ls-remote.html#git_remote_create_anonymous-2" + "ex/v1.9.1/ls-remote.html#git_remote_create_anonymous-2" ] } }, "git_remote_create_detached": { "type": "function", "file": "git2/remote.h", - "line": 201, - "lineto": 203, + "line": 204, + "lineto": 206, "args": [ { "name": "out", @@ -16579,8 +16694,8 @@ "git_remote_lookup": { "type": "function", "file": "git2/remote.h", - "line": 216, - "lineto": 216, + "line": 219, + "lineto": 219, "args": [ { "name": "out", @@ -16608,17 +16723,17 @@ "comments": "The name will be checked for validity. See git_tag_create() for rules about valid names.
Get the remote's url
\n", - "comments": "If url.*.insteadOf has been configured for this URL, it will return the modified URL. If git_remote_set_instance_pushurl has been called for this remote, then that URL will be returned.
If url.*.insteadOf has been configured for this URL, it will return the modified URL. This function does not consider if a push url has been configured for this remote (use git_remote_pushurl if needed).
Get the remote's url for pushing.
\n", "comments": "If url.*.pushInsteadOf has been configured for this URL, it will return the modified URL. If git_remote_set_instance_pushurl has been called for this remote, then that URL will be returned.
Set the remote's url in the configuration
\n", "comments": "Remote objects already in memory will not be affected. This assumes the common case of a single-url remote and will otherwise return an error.
\n", "group": "remote", - "examples": { "remote.c": ["ex/v1.8.4/remote.html#git_remote_set_url-5"] } + "examples": { "remote.c": ["ex/v1.9.1/remote.html#git_remote_set_url-5"] } }, "git_remote_set_pushurl": { "type": "function", "file": "git2/remote.h", - "line": 295, - "lineto": 295, + "line": 298, + "lineto": 298, "args": [ { "name": "repo", @@ -16776,14 +16891,14 @@ "comments": "Remote objects already in memory will not be affected. This assumes the common case of a single-url remote and will otherwise return an error.
\n", "group": "remote", "examples": { - "remote.c": ["ex/v1.8.4/remote.html#git_remote_set_pushurl-6"] + "remote.c": ["ex/v1.9.1/remote.html#git_remote_set_pushurl-6"] } }, "git_remote_set_instance_url": { "type": "function", "file": "git2/remote.h", - "line": 305, - "lineto": 305, + "line": 308, + "lineto": 308, "args": [ { "name": "remote", @@ -16802,8 +16917,8 @@ "git_remote_set_instance_pushurl": { "type": "function", "file": "git2/remote.h", - "line": 315, - "lineto": 315, + "line": 318, + "lineto": 318, "args": [ { "name": "remote", @@ -16822,8 +16937,8 @@ "git_remote_add_fetch": { "type": "function", "file": "git2/remote.h", - "line": 328, - "lineto": 328, + "line": 331, + "lineto": 331, "args": [ { "name": "repo", @@ -16854,8 +16969,8 @@ "git_remote_get_fetch_refspecs": { "type": "function", "file": "git2/remote.h", - "line": 340, - "lineto": 340, + "line": 343, + "lineto": 343, "args": [ { "name": "array", @@ -16878,8 +16993,8 @@ "git_remote_add_push": { "type": "function", "file": "git2/remote.h", - "line": 353, - "lineto": 353, + "line": 356, + "lineto": 356, "args": [ { "name": "repo", @@ -16910,8 +17025,8 @@ "git_remote_get_push_refspecs": { "type": "function", "file": "git2/remote.h", - "line": 365, - "lineto": 365, + "line": 368, + "lineto": 368, "args": [ { "name": "array", @@ -16934,8 +17049,8 @@ "git_remote_refspec_count": { "type": "function", "file": "git2/remote.h", - "line": 373, - "lineto": 373, + "line": 376, + "lineto": 376, "args": [ { "name": "remote", @@ -16956,8 +17071,8 @@ "git_remote_get_refspec": { "type": "function", "file": "git2/remote.h", - "line": 382, - "lineto": 382, + "line": 385, + "lineto": 385, "args": [ { "name": "remote", @@ -16979,8 +17094,8 @@ "git_remote_ls": { "type": "function", "file": "git2/remote.h", - "line": 404, - "lineto": 404, + "line": 407, + "lineto": 407, "args": [ { "name": "out", @@ -17001,14 +17116,14 @@ "comments": "Get the list of references with which the server responds to a new connection.
\n\nThe remote (or more exactly its transport) must have connected to the remote repository. This list is available as soon as the connection to the remote is initiated and it remains available after disconnecting.
\n\nThe memory belongs to the remote. The pointer will be valid as long as a new connection is not initiated, but it is recommended that you make a copy in order to make use of the data.
\n", "group": "remote", "examples": { - "ls-remote.c": ["ex/v1.8.4/ls-remote.html#git_remote_ls-4"] + "ls-remote.c": ["ex/v1.9.1/ls-remote.html#git_remote_ls-4"] } }, "git_remote_connected": { "type": "function", "file": "git2/remote.h", - "line": 415, - "lineto": 415, + "line": 418, + "lineto": 418, "args": [ { "name": "remote", @@ -17029,8 +17144,8 @@ "git_remote_stop": { "type": "function", "file": "git2/remote.h", - "line": 426, - "lineto": 426, + "line": 429, + "lineto": 429, "args": [ { "name": "remote", "type": "git_remote *", "comment": "the remote" } ], @@ -17044,8 +17159,8 @@ "git_remote_disconnect": { "type": "function", "file": "git2/remote.h", - "line": 436, - "lineto": 436, + "line": 439, + "lineto": 439, "args": [ { "name": "remote", @@ -17063,8 +17178,8 @@ "git_remote_free": { "type": "function", "file": "git2/remote.h", - "line": 446, - "lineto": 446, + "line": 449, + "lineto": 449, "args": [ { "name": "remote", @@ -17080,18 +17195,18 @@ "group": "remote", "examples": { "fetch.c": [ - "ex/v1.8.4/fetch.html#git_remote_free-6", - "ex/v1.8.4/fetch.html#git_remote_free-7" + "ex/v1.9.1/fetch.html#git_remote_free-7", + "ex/v1.9.1/fetch.html#git_remote_free-8" ], - "ls-remote.c": ["ex/v1.8.4/ls-remote.html#git_remote_free-5"], - "remote.c": ["ex/v1.8.4/remote.html#git_remote_free-7"] + "ls-remote.c": ["ex/v1.9.1/ls-remote.html#git_remote_free-5"], + "remote.c": ["ex/v1.9.1/remote.html#git_remote_free-7"] } }, "git_remote_list": { "type": "function", "file": "git2/remote.h", - "line": 457, - "lineto": 457, + "line": 460, + "lineto": 460, "args": [ { "name": "out", @@ -17111,15 +17226,15 @@ "comments": "The string array must be freed by the user.
\n", "group": "remote", "examples": { - "checkout.c": ["ex/v1.8.4/checkout.html#git_remote_list-22"], - "remote.c": ["ex/v1.8.4/remote.html#git_remote_list-8"] + "checkout.c": ["ex/v1.9.1/checkout.html#git_remote_list-22"], + "remote.c": ["ex/v1.9.1/remote.html#git_remote_list-8"] } }, "git_remote_init_callbacks": { "type": "function", "file": "git2/remote.h", - "line": 671, - "lineto": 673, + "line": 714, + "lineto": 716, "args": [ { "name": "opts", @@ -17142,14 +17257,14 @@ "comments": "", "group": "remote", "examples": { - "push.c": ["ex/v1.8.4/push.html#git_remote_init_callbacks-2"] + "push.c": ["ex/v1.9.1/push.html#git_remote_init_callbacks-2"] } }, "git_fetch_options_init": { "type": "function", "file": "git2/remote.h", - "line": 806, - "lineto": 808, + "line": 852, + "lineto": 854, "args": [ { "name": "opts", @@ -17175,8 +17290,8 @@ "git_push_options_init": { "type": "function", "file": "git2/remote.h", - "line": 868, - "lineto": 870, + "line": 917, + "lineto": 919, "args": [ { "name": "opts", @@ -17198,13 +17313,13 @@ "description": "Initialize git_push_options structure
\n", "comments": "Initializes a git_push_options with default values. Equivalent to creating an instance with GIT_PUSH_OPTIONS_INIT.
The transport is selected based on the URL; the direction argument is due to a limitation of the git protocol which starts up a specific binary which can only do the one or the other.
\n", "group": "remote", "examples": { - "ls-remote.c": ["ex/v1.8.4/ls-remote.html#git_remote_connect-6"] + "ls-remote.c": ["ex/v1.9.1/ls-remote.html#git_remote_connect-6"] } }, "git_remote_connect_ext": { "type": "function", "file": "git2/remote.h", - "line": 960, - "lineto": 963, + "line": 1012, + "lineto": 1015, "args": [ { "name": "remote", @@ -17301,8 +17416,8 @@ "git_remote_download": { "type": "function", "file": "git2/remote.h", - "line": 985, - "lineto": 988, + "line": 1037, + "lineto": 1040, "args": [ { "name": "remote", "type": "git_remote *", "comment": "the remote" }, { @@ -17326,8 +17441,8 @@ "git_remote_upload": { "type": "function", "file": "git2/remote.h", - "line": 1007, - "lineto": 1010, + "line": 1059, + "lineto": 1062, "args": [ { "name": "remote", "type": "git_remote *", "comment": "the remote" }, { @@ -17351,8 +17466,8 @@ "git_remote_update_tips": { "type": "function", "file": "git2/remote.h", - "line": 1029, - "lineto": 1034, + "line": 1081, + "lineto": 1086, "args": [ { "name": "remote", @@ -17390,8 +17505,8 @@ "git_remote_fetch": { "type": "function", "file": "git2/remote.h", - "line": 1054, - "lineto": 1058, + "line": 1106, + "lineto": 1110, "args": [ { "name": "remote", @@ -17420,13 +17535,13 @@ "description": "Download new data and update tips.
\n", "comments": "Convenience function to connect to a remote, download the data, disconnect and update the remote-tracking branches.
\n\nIf options are specified and this remote is already connected then the existing remote connection options will be discarded and the remote will now use the new options.
\n", "group": "remote", - "examples": { "fetch.c": ["ex/v1.8.4/fetch.html#git_remote_fetch-8"] } + "examples": { "fetch.c": ["ex/v1.9.1/fetch.html#git_remote_fetch-9"] } }, "git_remote_prune": { "type": "function", "file": "git2/remote.h", - "line": 1070, - "lineto": 1072, + "line": 1122, + "lineto": 1124, "args": [ { "name": "remote", @@ -17449,8 +17564,8 @@ "git_remote_push": { "type": "function", "file": "git2/remote.h", - "line": 1087, - "lineto": 1090, + "line": 1139, + "lineto": 1142, "args": [ { "name": "remote", @@ -17474,27 +17589,36 @@ "description": "Perform a push.
\n", "comments": "If options are specified and this remote is already connected then the existing remote connection options will be discarded and the remote will now use the new options.
\n", "group": "remote", - "examples": { "push.c": ["ex/v1.8.4/push.html#git_remote_push-4"] } + "examples": { "push.c": ["ex/v1.9.1/push.html#git_remote_push-4"] } }, "git_remote_stats": { "type": "function", "file": "git2/remote.h", - "line": 1095, - "lineto": 1095, - "args": [{ "name": "remote", "type": "git_remote *", "comment": null }], + "line": 1150, + "lineto": 1150, + "args": [ + { + "name": "remote", + "type": "git_remote *", + "comment": "the remote to get statistics for" + } + ], "argline": "git_remote *remote", "sig": "git_remote *", - "return": { "type": "const git_indexer_progress *", "comment": null }, + "return": { + "type": "const git_indexer_progress *", + "comment": " the git_indexer_progress for the remote" + }, "description": "Get the statistics structure that is filled in by the fetch operation.
\n", "comments": "", "group": "remote", - "examples": { "fetch.c": ["ex/v1.8.4/fetch.html#git_remote_stats-9"] } + "examples": { "fetch.c": ["ex/v1.9.1/fetch.html#git_remote_stats-10"] } }, "git_remote_autotag": { "type": "function", "file": "git2/remote.h", - "line": 1103, - "lineto": 1103, + "line": 1158, + "lineto": 1158, "args": [ { "name": "remote", @@ -17515,8 +17639,8 @@ "git_remote_set_autotag": { "type": "function", "file": "git2/remote.h", - "line": 1116, - "lineto": 1116, + "line": 1171, + "lineto": 1171, "args": [ { "name": "repo", @@ -17544,8 +17668,8 @@ "git_remote_prune_refs": { "type": "function", "file": "git2/remote.h", - "line": 1124, - "lineto": 1124, + "line": 1179, + "lineto": 1179, "args": [ { "name": "remote", @@ -17563,8 +17687,8 @@ "git_remote_rename": { "type": "function", "file": "git2/remote.h", - "line": 1146, - "lineto": 1150, + "line": 1201, + "lineto": 1205, "args": [ { "name": "problems", @@ -17596,13 +17720,13 @@ "description": "Give the remote a new name
\n", "comments": "All remote-tracking branches and configuration settings for the remote are updated.
\n\nThe new name will be checked for validity. See git_tag_create() for rules about valid names.
No loaded instances of a the remote with the old name will change their name or their list of refspecs.
\n", "group": "remote", - "examples": { "remote.c": ["ex/v1.8.4/remote.html#git_remote_rename-9"] } + "examples": { "remote.c": ["ex/v1.9.1/remote.html#git_remote_rename-9"] } }, "git_remote_name_is_valid": { "type": "function", "file": "git2/remote.h", - "line": 1159, - "lineto": 1159, + "line": 1214, + "lineto": 1214, "args": [ { "name": "valid", @@ -17625,8 +17749,8 @@ "git_remote_delete": { "type": "function", "file": "git2/remote.h", - "line": 1171, - "lineto": 1171, + "line": 1226, + "lineto": 1226, "args": [ { "name": "repo", @@ -17648,13 +17772,13 @@ "description": "Delete an existing persisted remote.
\n", "comments": "All remote-tracking branches and configuration settings for the remote will be removed.
\n", "group": "remote", - "examples": { "remote.c": ["ex/v1.8.4/remote.html#git_remote_delete-10"] } + "examples": { "remote.c": ["ex/v1.9.1/remote.html#git_remote_delete-10"] } }, "git_remote_default_branch": { "type": "function", "file": "git2/remote.h", - "line": 1189, - "lineto": 1189, + "line": 1244, + "lineto": 1244, "args": [ { "name": "out", @@ -17676,8 +17800,8 @@ "git_repository_open": { "type": "function", "file": "git2/repository.h", - "line": 38, - "lineto": 38, + "line": 43, + "lineto": 43, "args": [ { "name": "out", @@ -17694,17 +17818,17 @@ "sig": "git_repository **::const char *", "return": { "type": "int", "comment": " 0 or an error code" }, "description": "Open a git repository.
\n", - "comments": "The 'path' argument must point to either a git repository folder, or an existing work dir.
\n\nThe method will automatically detect if 'path' is a normal or bare repository or fail is 'path' is neither.
\n", + "comments": "The 'path' argument must point to either a git repository folder, or an existing work dir.
\n\nThe method will automatically detect if 'path' is a normal or bare repository or fail is 'path' is neither.
\n\nNote that the libgit2 library must be initialized using git_libgit2_init before any APIs can be called, including this one.
Open the working directory of the working tree as a normal repository that can then be worked on.
\n", "group": "repository" }, + "git_repository_wrap_odb": { + "type": "function", + "file": "git2/repository.h", + "line": 67, + "lineto": 69, + "args": [ + { + "name": "out", + "type": "git_repository **", + "comment": "pointer to the repo" + }, + { + "name": "odb", + "type": "git_odb *", + "comment": "the object database to wrap" + } + ], + "argline": "git_repository **out, git_odb *odb", + "sig": "git_repository **::git_odb *", + "return": { "type": "int", "comment": " 0 or an error code" }, + "description": "Create a "fake" repository to wrap an object database
\n", + "comments": "Create a repository object to wrap an object database to be used with the API when all you have is an object database. This doesn't have any paths associated with it, so use with care.
\n", + "group": "repository" + }, "git_repository_discover": { "type": "function", "file": "git2/repository.h", - "line": 100, - "lineto": 104, + "line": 101, + "lineto": 105, "args": [ { "name": "out", @@ -17755,14 +17903,14 @@ "sig": "git_buf *::const char *::int::const char *", "return": { "type": "int", "comment": " 0 or an error code" }, "description": "Look for a git repository and copy its path in the given buffer.\n The lookup start from base_path and walk across parent directories\n if nothing has been found. The lookup ends when the first repository\n is found, or when reaching a directory referenced in ceiling_dirs\n or when the filesystem changes (in case across_fs is true).
\n", - "comments": "The method will automatically detect if the repository is bare (if there is a repository).
\n", + "comments": "The method will automatically detect if the repository is bare (if there is a repository).
\n\nNote that the libgit2 library must be initialized using git_libgit2_init before any APIs can be called, including this one.
Find and open a repository with extended controls.
\n", - "comments": "", + "comments": "Note that the libgit2 library must be initialized using git_libgit2_init before any APIs can be called, including this one.
Open a bare repository on the serverside.
\n", - "comments": "This is a fast open for bare repositories that will come in handy if you're e.g. hosting git repositories and need to access them efficiently
\n", + "comments": "This is a fast open for bare repositories that will come in handy if you're e.g. hosting git repositories and need to access them efficiently
\n\nNote that the libgit2 library must be initialized using git_libgit2_init before any APIs can be called, including this one.
Note that after a repository is free'd, all the objects it has spawned will still exist until they are manually closed by the user with git_object_free, but accessing any of the attributes of an object without a backing repository will result in undefined behavior
Creates a new Git repository in the given folder.
\n", - "comments": "TODO: - Reinit the repository
\n", + "comments": "TODO: - Reinit the repository
\n\nNote that the libgit2 library must be initialized using git_libgit2_init before any APIs can be called, including this one.
Create a new Git repository in the given folder with extended controls.
\n", - "comments": "This will initialize a new git repository (creating the repo_path if requested by flags) and working directory as needed. It will auto-detect the case sensitivity of the file system and if the file system supports file mode bits correctly.
\n", + "comments": "This will initialize a new git repository (creating the repo_path if requested by flags) and working directory as needed. It will auto-detect the case sensitivity of the file system and if the file system supports file mode bits correctly.
\n\nNote that the libgit2 library must be initialized using git_libgit2_init before any APIs can be called, including this one.
This is the path of the .git folder for normal repositories, or of the repository itself for bare repositories.
Get the path of the working directory for this repository
\n", "comments": "If the repository is bare, this function will always return NULL.
\n", "group": "repository", - "examples": { "init.c": ["ex/v1.8.4/init.html#git_repository_workdir-8"] } + "examples": { "init.c": ["ex/v1.9.1/init.html#git_repository_workdir-8"] } }, "git_repository_commondir": { "type": "function", "file": "git2/repository.h", - "line": 559, - "lineto": 559, + "line": 579, + "lineto": 579, "args": [ { "name": "repo", @@ -18197,8 +18345,8 @@ "git_repository_set_workdir": { "type": "function", "file": "git2/repository.h", - "line": 578, - "lineto": 579, + "line": 598, + "lineto": 599, "args": [ { "name": "repo", @@ -18226,8 +18374,8 @@ "git_repository_is_bare": { "type": "function", "file": "git2/repository.h", - "line": 587, - "lineto": 587, + "line": 607, + "lineto": 607, "args": [ { "name": "repo", @@ -18245,14 +18393,14 @@ "comments": "", "group": "repository", "examples": { - "status.c": ["ex/v1.8.4/status.html#git_repository_is_bare-5"] + "status.c": ["ex/v1.9.1/status.html#git_repository_is_bare-5"] } }, "git_repository_is_worktree": { "type": "function", "file": "git2/repository.h", - "line": 595, - "lineto": 595, + "line": 615, + "lineto": 615, "args": [ { "name": "repo", @@ -18273,8 +18421,8 @@ "git_repository_config": { "type": "function", "file": "git2/repository.h", - "line": 611, - "lineto": 611, + "line": 631, + "lineto": 631, "args": [ { "name": "out", @@ -18294,14 +18442,14 @@ "comments": "If a configuration file has not been set, the default config set for the repository will be returned, including global and system configurations (if they are available).
\n\nThe configuration file must be freed once it's no longer being used by the user.
\n", "group": "repository", "examples": { - "config.c": ["ex/v1.8.4/config.html#git_repository_config-9"] + "config.c": ["ex/v1.9.1/config.html#git_repository_config-9"] } }, "git_repository_config_snapshot": { "type": "function", "file": "git2/repository.h", - "line": 627, - "lineto": 627, + "line": 647, + "lineto": 647, "args": [ { "name": "out", @@ -18322,16 +18470,16 @@ "group": "repository", "examples": { "general.c": [ - "ex/v1.8.4/general.html#git_repository_config_snapshot-61", - "ex/v1.8.4/general.html#git_repository_config_snapshot-62" + "ex/v1.9.1/general.html#git_repository_config_snapshot-77", + "ex/v1.9.1/general.html#git_repository_config_snapshot-78" ] } }, "git_repository_odb": { "type": "function", "file": "git2/repository.h", - "line": 643, - "lineto": 643, + "line": 663, + "lineto": 663, "args": [ { "name": "out", @@ -18351,15 +18499,15 @@ "comments": "If a custom ODB has not been set, the default database for the repository will be returned (the one located in .git/objects).
The ODB must be freed once it's no longer being used by the user.
\n", "group": "repository", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_repository_odb-29"], - "general.c": ["ex/v1.8.4/general.html#git_repository_odb-63"] + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_repository_odb-29"], + "general.c": ["ex/v1.9.1/general.html#git_repository_odb-79"] } }, "git_repository_refdb": { "type": "function", "file": "git2/repository.h", - "line": 659, - "lineto": 659, + "line": 679, + "lineto": 679, "args": [ { "name": "out", @@ -18382,8 +18530,8 @@ "git_repository_index": { "type": "function", "file": "git2/repository.h", - "line": 675, - "lineto": 675, + "line": 695, + "lineto": 695, "args": [ { "name": "out", @@ -18403,19 +18551,19 @@ "comments": "If a custom index has not been set, the default index for the repository will be returned (the one located in .git/index).
The index must be freed once it's no longer being used by the user.
\n", "group": "repository", "examples": { - "add.c": ["ex/v1.8.4/add.html#git_repository_index-5"], - "commit.c": ["ex/v1.8.4/commit.html#git_repository_index-8"], - "general.c": ["ex/v1.8.4/general.html#git_repository_index-64"], - "init.c": ["ex/v1.8.4/init.html#git_repository_index-9"], - "ls-files.c": ["ex/v1.8.4/ls-files.html#git_repository_index-5"], - "merge.c": ["ex/v1.8.4/merge.html#git_repository_index-33"] + "add.c": ["ex/v1.9.1/add.html#git_repository_index-5"], + "commit.c": ["ex/v1.9.1/commit.html#git_repository_index-8"], + "general.c": ["ex/v1.9.1/general.html#git_repository_index-80"], + "init.c": ["ex/v1.9.1/init.html#git_repository_index-9"], + "ls-files.c": ["ex/v1.9.1/ls-files.html#git_repository_index-5"], + "merge.c": ["ex/v1.9.1/merge.html#git_repository_index-33"] } }, "git_repository_message": { "type": "function", "file": "git2/repository.h", - "line": 693, - "lineto": 693, + "line": 713, + "lineto": 713, "args": [ { "name": "out", @@ -18441,8 +18589,8 @@ "git_repository_message_remove": { "type": "function", "file": "git2/repository.h", - "line": 703, - "lineto": 703, + "line": 723, + "lineto": 723, "args": [ { "name": "repo", @@ -18460,8 +18608,8 @@ "git_repository_state_cleanup": { "type": "function", "file": "git2/repository.h", - "line": 712, - "lineto": 712, + "line": 732, + "lineto": 732, "args": [ { "name": "repo", @@ -18476,14 +18624,14 @@ "comments": "", "group": "repository", "examples": { - "merge.c": ["ex/v1.8.4/merge.html#git_repository_state_cleanup-34"] + "merge.c": ["ex/v1.9.1/merge.html#git_repository_state_cleanup-34"] } }, "git_repository_fetchhead_foreach": { "type": "function", "file": "git2/repository.h", - "line": 743, - "lineto": 746, + "line": 763, + "lineto": 766, "args": [ { "name": "repo", @@ -18514,8 +18662,8 @@ "git_repository_mergehead_foreach": { "type": "function", "file": "git2/repository.h", - "line": 772, - "lineto": 775, + "line": 792, + "lineto": 795, "args": [ { "name": "repo", @@ -18546,8 +18694,8 @@ "git_repository_hashfile": { "type": "function", "file": "git2/repository.h", - "line": 802, - "lineto": 807, + "line": 822, + "lineto": 827, "args": [ { "name": "out", @@ -18585,8 +18733,8 @@ "git_repository_set_head": { "type": "function", "file": "git2/repository.h", - "line": 827, - "lineto": 829, + "line": 847, + "lineto": 849, "args": [ { "name": "repo", @@ -18606,14 +18754,14 @@ "comments": "If the provided reference points to a Tree or a Blob, the HEAD is unaltered and -1 is returned.
\n\nIf the provided reference points to a branch, the HEAD will point to that branch, staying attached, or become attached if it isn't yet. If the branch doesn't exist yet, no error will be return. The HEAD will then be attached to an unborn branch.
\n\nOtherwise, the HEAD will be detached and will directly point to the Commit.
\n", "group": "repository", "examples": { - "checkout.c": ["ex/v1.8.4/checkout.html#git_repository_set_head-23"] + "checkout.c": ["ex/v1.9.1/checkout.html#git_repository_set_head-23"] } }, "git_repository_set_head_detached": { "type": "function", "file": "git2/repository.h", - "line": 847, - "lineto": 849, + "line": 867, + "lineto": 869, "args": [ { "name": "repo", @@ -18636,33 +18784,37 @@ "git_repository_set_head_detached_from_annotated": { "type": "function", "file": "git2/repository.h", - "line": 863, - "lineto": 865, + "line": 885, + "lineto": 887, "args": [ - { "name": "repo", "type": "git_repository *", "comment": null }, + { + "name": "repo", + "type": "git_repository *", + "comment": "Repository pointer" + }, { "name": "committish", "type": "const git_annotated_commit *", - "comment": null + "comment": "annotated commit to point HEAD to" } ], "argline": "git_repository *repo, const git_annotated_commit *committish", "sig": "git_repository *::const git_annotated_commit *", - "return": { "type": "int", "comment": null }, + "return": { "type": "int", "comment": " 0 on success, or an error code" }, "description": "Make the repository HEAD directly point to the Commit.
\n", "comments": "This behaves like git_repository_set_head_detached() but takes an annotated commit, which lets you specify which extended sha syntax string was specified by a user, allowing for more exact reflog messages.
See the documentation for git_repository_set_head_detached().
Sets the current head to the specified commit oid and optionally\n resets the index and working tree to match.
\n", "comments": "This behaves like git_reset() but takes an annotated commit, which lets you specify which extended sha syntax string was specified by a user, allowing for more exact reflog messages.
See the documentation for git_reset().
See man gitrevisions, or http://git-scm.com/docs/git-rev-parse.html#_specifying_revisions for information on the syntax accepted.
The returned object should be released with git_object_free when no longer needed.
Find a single object and intermediate reference by a revision string.
\n", "comments": "See man gitrevisions, or http://git-scm.com/docs/git-rev-parse.html#_specifying_revisions for information on the syntax accepted.
In some cases (@{<-n>} or <branchname>@{upstream}), the expression may point to an intermediate reference. When such expressions are being passed in, reference_out will be valued as well.
The returned object should be released with git_object_free and the returned reference with git_reference_free when no longer needed.
See man gitrevisions or http://git-scm.com/docs/git-rev-parse.html#_specifying_revisions for information on the syntax accepted.
This revision walker uses a custom memory pool and an internal commit cache, so it is relatively expensive to allocate.
\n\nFor maximum performance, this revision walker should be reused for different walks.
\n\nThis revision walker is not thread safe: it may only be used to walk a repository on a single thread; however, it is possible to have several revision walkers in several different threads walking the same repository.
\n", "group": "revwalk", "examples": { - "general.c": ["ex/v1.8.4/general.html#git_revwalk_new-65"], + "general.c": ["ex/v1.9.1/general.html#git_revwalk_new-81"], "log.c": [ - "ex/v1.8.4/log.html#git_revwalk_new-46", - "ex/v1.8.4/log.html#git_revwalk_new-47" + "ex/v1.9.1/log.html#git_revwalk_new-46", + "ex/v1.9.1/log.html#git_revwalk_new-47" ] } }, @@ -19255,8 +19415,8 @@ "comments": "The pushed commit will be marked as one of the roots from which to start the walk. This commit may not be walked if it or a child is hidden.
\n\nAt least one commit must be pushed onto the walker before a walk can be started.
\n\nThe given id must belong to a committish on the walked repository.
\n", "group": "revwalk", "examples": { - "general.c": ["ex/v1.8.4/general.html#git_revwalk_push-66"], - "log.c": ["ex/v1.8.4/log.html#git_revwalk_push-48"] + "general.c": ["ex/v1.9.1/general.html#git_revwalk_push-82"], + "log.c": ["ex/v1.9.1/log.html#git_revwalk_push-48"] } }, "git_revwalk_push_glob": { @@ -19301,7 +19461,7 @@ "description": "Push the repository's HEAD
\n", "comments": "", "group": "revwalk", - "examples": { "log.c": ["ex/v1.8.4/log.html#git_revwalk_push_head-49"] } + "examples": { "log.c": ["ex/v1.9.1/log.html#git_revwalk_push_head-49"] } }, "git_revwalk_hide": { "type": "function", @@ -19326,7 +19486,7 @@ "description": "Mark a commit (and its ancestors) uninteresting for the output.
\n", "comments": "The given id must belong to a committish on the walked repository.
\n\nThe resolved commit and all its parents will be hidden from the output on the revision walk.
\n", "group": "revwalk", - "examples": { "log.c": ["ex/v1.8.4/log.html#git_revwalk_hide-50"] } + "examples": { "log.c": ["ex/v1.9.1/log.html#git_revwalk_hide-50"] } }, "git_revwalk_hide_glob": { "type": "function", @@ -19446,8 +19606,8 @@ "comments": "The initial call to this method is not blocking when iterating through a repo with a time-sorting mode.
\n\nIterating with Topological or inverted modes makes the initial call blocking to preprocess the commit list, but this block should be mostly unnoticeable on most repositories (topological preprocessing times at 0.3s on the git.git repo).
\n\nThe revision walker is reset when the walk is over.
\n", "group": "revwalk", "examples": { - "general.c": ["ex/v1.8.4/general.html#git_revwalk_next-67"], - "log.c": ["ex/v1.8.4/log.html#git_revwalk_next-51"] + "general.c": ["ex/v1.9.1/general.html#git_revwalk_next-83"], + "log.c": ["ex/v1.9.1/log.html#git_revwalk_next-51"] } }, "git_revwalk_sorting": { @@ -19474,10 +19634,10 @@ "comments": "Changing the sorting mode resets the walker.
\n", "group": "revwalk", "examples": { - "general.c": ["ex/v1.8.4/general.html#git_revwalk_sorting-68"], + "general.c": ["ex/v1.9.1/general.html#git_revwalk_sorting-84"], "log.c": [ - "ex/v1.8.4/log.html#git_revwalk_sorting-52", - "ex/v1.8.4/log.html#git_revwalk_sorting-53" + "ex/v1.9.1/log.html#git_revwalk_sorting-52", + "ex/v1.9.1/log.html#git_revwalk_sorting-53" ] } }, @@ -19539,8 +19699,8 @@ "comments": "", "group": "revwalk", "examples": { - "general.c": ["ex/v1.8.4/general.html#git_revwalk_free-69"], - "log.c": ["ex/v1.8.4/log.html#git_revwalk_free-54"] + "general.c": ["ex/v1.9.1/general.html#git_revwalk_free-85"], + "log.c": ["ex/v1.9.1/log.html#git_revwalk_free-54"] } }, "git_revwalk_repository": { @@ -19597,8 +19757,8 @@ "git_signature_new": { "type": "function", "file": "git2/signature.h", - "line": 37, - "lineto": 37, + "line": 41, + "lineto": 41, "args": [ { "name": "out", @@ -19634,16 +19794,16 @@ "group": "signature", "examples": { "general.c": [ - "ex/v1.8.4/general.html#git_signature_new-70", - "ex/v1.8.4/general.html#git_signature_new-71" + "ex/v1.9.1/general.html#git_signature_new-86", + "ex/v1.9.1/general.html#git_signature_new-87" ] } }, "git_signature_now": { "type": "function", "file": "git2/signature.h", - "line": 49, - "lineto": 49, + "line": 53, + "lineto": 53, "args": [ { "name": "out", @@ -19667,13 +19827,50 @@ "description": "Create a new action signature with a timestamp of 'now'.
\n", "comments": "Call git_signature_free() to free the data.
Create a new author and/or committer signatures with default\n information based on the configuration and environment variables.
\n", + "comments": "If author_out is set, it will be populated with the author information. The GIT_AUTHOR_NAME and GIT_AUTHOR_EMAIL environment variables will be honored, and user.name and user.email configuration options will be honored if the environment variables are unset. For timestamps, GIT_AUTHOR_DATE will be used, otherwise the current time will be used.
If committer_out is set, it will be populated with the committer information. The GIT_COMMITTER_NAME and GIT_COMMITTER_EMAIL environment variables will be honored, and user.name and user.email configuration options will be honored if the environment variables are unset. For timestamps, GIT_COMMITTER_DATE will be used, otherwise the current time will be used.
If neither GIT_AUTHOR_DATE nor GIT_COMMITTER_DATE are set, both timestamps will be set to the same time.
It will return GIT_ENOTFOUND if either the user.name or user.email are not set and there is no fallback from an environment variable. One of author_out or committer_out must be set.
Create a new action signature with default user and now timestamp.
\n", - "comments": "This looks up the user.name and user.email from the configuration and uses the current time as the timestamp, and creates a new signature based on that information. It will return GIT_ENOTFOUND if either the user.name or user.email are not set.
\n", - "group": "signature", - "examples": { - "commit.c": ["ex/v1.8.4/commit.html#git_signature_default-10"], - "init.c": ["ex/v1.8.4/init.html#git_signature_default-10"], - "tag.c": ["ex/v1.8.4/tag.html#git_signature_default-13"] - } + "comments": "This looks up the user.name and user.email from the configuration and uses the current time as the timestamp, and creates a new signature based on that information. It will return GIT_ENOTFOUND if either the user.name or user.email are not set.
\n\nNote that these do not examine environment variables, only the configuration files. Use git_signature_default_from_env to consider the environment variables.
Because the signature is not an opaque structure, it is legal to free it manually, but be sure to free the "name" and "email" strings in addition to the structure itself.
\n", "group": "signature", "examples": { - "commit.c": ["ex/v1.8.4/commit.html#git_signature_free-11"], + "commit.c": [ + "ex/v1.9.1/commit.html#git_signature_free-11", + "ex/v1.9.1/commit.html#git_signature_free-12" + ], "general.c": [ - "ex/v1.8.4/general.html#git_signature_free-72", - "ex/v1.8.4/general.html#git_signature_free-73" + "ex/v1.9.1/general.html#git_signature_free-88", + "ex/v1.9.1/general.html#git_signature_free-89" + ], + "init.c": [ + "ex/v1.9.1/init.html#git_signature_free-11", + "ex/v1.9.1/init.html#git_signature_free-12" ], - "init.c": ["ex/v1.8.4/init.html#git_signature_free-11"], - "tag.c": ["ex/v1.8.4/tag.html#git_signature_free-14"] + "tag.c": ["ex/v1.9.1/tag.html#git_signature_free-14"] } }, "git_stash_save": { "type": "function", "file": "git2/stash.h", - "line": 67, - "lineto": 72, + "line": 72, + "lineto": 77, "args": [ { "name": "out", @@ -19821,8 +20019,8 @@ "git_stash_save_options_init": { "type": "function", "file": "git2/stash.h", - "line": 110, - "lineto": 111, + "line": 118, + "lineto": 119, "args": [ { "name": "opts", @@ -19848,8 +20046,8 @@ "git_stash_save_with_opts": { "type": "function", "file": "git2/stash.h", - "line": 123, - "lineto": 126, + "line": 131, + "lineto": 134, "args": [ { "name": "out", @@ -19880,8 +20078,8 @@ "git_stash_apply_options_init": { "type": "function", "file": "git2/stash.h", - "line": 210, - "lineto": 211, + "line": 225, + "lineto": 226, "args": [ { "name": "opts", @@ -19907,8 +20105,8 @@ "git_stash_apply": { "type": "function", "file": "git2/stash.h", - "line": 239, - "lineto": 242, + "line": 252, + "lineto": 255, "args": [ { "name": "repo", @@ -19933,14 +20131,14 @@ "comment": " 0 on success, GIT_ENOTFOUND if there's no stashed state for the\n given index, GIT_EMERGECONFLICT if changes exist in the working\n directory, or an error code" }, "description": "Apply a single stashed state from the stash list.
\n", - "comments": "If local changes in the working directory conflict with changes in the stash then GIT_EMERGECONFLICT will be returned. In this case, the index will always remain unmodified and all files in the working directory will remain unmodified. However, if you are restoring untracked files or ignored files and there is a conflict when applying the modified files, then those files will remain in the working directory.
\n\nIf passing the GIT_STASH_APPLY_REINSTATE_INDEX flag and there would be conflicts when reinstating the index, the function will return GIT_EMERGECONFLICT and both the working directory and index will be left unmodified.
\n\nNote that a minimum checkout strategy of GIT_CHECKOUT_SAFE is implied.
If local changes in the working directory conflict with changes in the stash then GIT_EMERGECONFLICT will be returned. In this case, the index will always remain unmodified and all files in the working directory will remain unmodified. However, if you are restoring untracked files or ignored files and there is a conflict when applying the modified files, then those files will remain in the working directory.
\n\nIf passing the GIT_STASH_APPLY_REINSTATE_INDEX flag and there would be conflicts when reinstating the index, the function will return GIT_EMERGECONFLICT and both the working directory and index will be left unmodified.
\n", "group": "stash" }, "git_stash_foreach": { "type": "function", "file": "git2/stash.h", - "line": 275, - "lineto": 278, + "line": 288, + "lineto": 291, "args": [ { "name": "repo", @@ -19971,8 +20169,8 @@ "git_stash_drop": { "type": "function", "file": "git2/stash.h", - "line": 291, - "lineto": 293, + "line": 304, + "lineto": 306, "args": [ { "name": "repo", @@ -19998,8 +20196,8 @@ "git_stash_pop": { "type": "function", "file": "git2/stash.h", - "line": 307, - "lineto": 310, + "line": 320, + "lineto": 323, "args": [ { "name": "repo", @@ -20030,8 +20228,8 @@ "git_status_options_init": { "type": "function", "file": "git2/status.h", - "line": 277, - "lineto": 279, + "line": 280, + "lineto": 282, "args": [ { "name": "opts", @@ -20057,8 +20255,8 @@ "git_status_foreach": { "type": "function", "file": "git2/status.h", - "line": 317, - "lineto": 320, + "line": 320, + "lineto": 323, "args": [ { "name": "repo", @@ -20085,13 +20283,13 @@ "description": "Gather file statuses and run a callback for each one.
\n", "comments": "The callback is passed the path of the file, the status (a combination of the git_status_t values above) and the payload data pointer passed into this function.
If the callback returns a non-zero value, this function will stop looping and return that value to caller.
\n", "group": "status", - "examples": { "status.c": ["ex/v1.8.4/status.html#git_status_foreach-6"] } + "examples": { "status.c": ["ex/v1.9.1/status.html#git_status_foreach-6"] } }, "git_status_foreach_ext": { "type": "function", "file": "git2/status.h", - "line": 341, - "lineto": 345, + "line": 344, + "lineto": 348, "args": [ { "name": "repo", @@ -20124,14 +20322,14 @@ "comments": "This is an extended version of the git_status_foreach() API that allows for more granular control over which paths will be processed and in what order. See the git_status_options structure for details about the additional controls that this makes available.
Note that if a pathspec is given in the git_status_options to filter the status, then the results from rename detection (if you enable it) may not be accurate. To do rename detection properly, this must be called with no pathspec so that all files can be considered.
Get file status for a single file.
\n", "comments": "This tries to get status for the filename that you give. If no files match that name (in either the HEAD, index, or working directory), this returns GIT_ENOTFOUND.
\n\nIf the name matches multiple files (for example, if the path names a directory or if running on a case- insensitive filesystem and yet the HEAD has two entries that both match the path), then this returns GIT_EAMBIGUOUS because it cannot give correct results.
This does not do any sort of rename detection. Renames require a set of targets and because of the path filtering, there is not enough information to check renames correctly. To check file status with rename detection, there is no choice but to do a full git_status_list_new and scan through looking for the path that you are interested in.
This does not free the git_strarray itself, since the library will never allocate that object directly itself.
See the note on git_submodule above. This iterates over the tracked submodules as described therein.
If you are concerned about items in the working directory that look like submodules but are not tracked, the diff API will generate a diff record for workdir items that look like submodules but are not tracked, showing them as added in the workdir. Also, the status API will treat the entire subdirectory of a contained git repo as a single GIT_STATUS_WT_NEW item.
\n", "group": "submodule", "examples": { - "status.c": ["ex/v1.8.4/status.html#git_submodule_foreach-19"] + "status.c": ["ex/v1.9.1/status.html#git_submodule_foreach-19"] } }, "git_submodule_add_setup": { "type": "function", "file": "git2/submodule.h", - "line": 292, - "lineto": 297, + "line": 301, + "lineto": 306, "args": [ { "name": "out", @@ -20552,8 +20750,8 @@ "git_submodule_clone": { "type": "function", "file": "git2/submodule.h", - "line": 310, - "lineto": 313, + "line": 319, + "lineto": 322, "args": [ { "name": "out", @@ -20584,8 +20782,8 @@ "git_submodule_add_finalize": { "type": "function", "file": "git2/submodule.h", - "line": 326, - "lineto": 326, + "line": 335, + "lineto": 335, "args": [ { "name": "submodule", @@ -20603,8 +20801,8 @@ "git_submodule_add_to_index": { "type": "function", "file": "git2/submodule.h", - "line": 338, - "lineto": 340, + "line": 347, + "lineto": 349, "args": [ { "name": "submodule", @@ -20630,8 +20828,8 @@ "git_submodule_owner": { "type": "function", "file": "git2/submodule.h", - "line": 353, - "lineto": 353, + "line": 362, + "lineto": 362, "args": [ { "name": "submodule", @@ -20652,8 +20850,8 @@ "git_submodule_name": { "type": "function", "file": "git2/submodule.h", - "line": 361, - "lineto": 361, + "line": 370, + "lineto": 370, "args": [ { "name": "submodule", @@ -20671,14 +20869,14 @@ "comments": "", "group": "submodule", "examples": { - "status.c": ["ex/v1.8.4/status.html#git_submodule_name-20"] + "status.c": ["ex/v1.9.1/status.html#git_submodule_name-20"] } }, "git_submodule_path": { "type": "function", "file": "git2/submodule.h", - "line": 372, - "lineto": 372, + "line": 381, + "lineto": 381, "args": [ { "name": "submodule", @@ -20696,14 +20894,14 @@ "comments": "The path is almost always the same as the submodule name, but the two are actually not required to match.
\n", "group": "submodule", "examples": { - "status.c": ["ex/v1.8.4/status.html#git_submodule_path-21"] + "status.c": ["ex/v1.9.1/status.html#git_submodule_path-21"] } }, "git_submodule_url": { "type": "function", "file": "git2/submodule.h", - "line": 380, - "lineto": 380, + "line": 389, + "lineto": 389, "args": [ { "name": "submodule", @@ -20724,8 +20922,8 @@ "git_submodule_resolve_url": { "type": "function", "file": "git2/submodule.h", - "line": 390, - "lineto": 390, + "line": 399, + "lineto": 399, "args": [ { "name": "out", @@ -20749,8 +20947,8 @@ "git_submodule_branch": { "type": "function", "file": "git2/submodule.h", - "line": 398, - "lineto": 398, + "line": 407, + "lineto": 407, "args": [ { "name": "submodule", @@ -20771,8 +20969,8 @@ "git_submodule_set_branch": { "type": "function", "file": "git2/submodule.h", - "line": 411, - "lineto": 411, + "line": 420, + "lineto": 420, "args": [ { "name": "repo", @@ -20803,8 +21001,8 @@ "git_submodule_set_url": { "type": "function", "file": "git2/submodule.h", - "line": 425, - "lineto": 425, + "line": 434, + "lineto": 434, "args": [ { "name": "repo", @@ -20835,8 +21033,8 @@ "git_submodule_index_id": { "type": "function", "file": "git2/submodule.h", - "line": 433, - "lineto": 433, + "line": 442, + "lineto": 442, "args": [ { "name": "submodule", @@ -20857,8 +21055,8 @@ "git_submodule_head_id": { "type": "function", "file": "git2/submodule.h", - "line": 441, - "lineto": 441, + "line": 450, + "lineto": 450, "args": [ { "name": "submodule", @@ -20879,8 +21077,8 @@ "git_submodule_wd_id": { "type": "function", "file": "git2/submodule.h", - "line": 454, - "lineto": 454, + "line": 463, + "lineto": 463, "args": [ { "name": "submodule", @@ -20901,8 +21099,8 @@ "git_submodule_ignore": { "type": "function", "file": "git2/submodule.h", - "line": 479, - "lineto": 480, + "line": 488, + "lineto": 489, "args": [ { "name": "submodule", @@ -20923,8 +21121,8 @@ "git_submodule_set_ignore": { "type": "function", "file": "git2/submodule.h", - "line": 492, - "lineto": 495, + "line": 501, + "lineto": 504, "args": [ { "name": "repo", @@ -20952,8 +21150,8 @@ "git_submodule_update_strategy": { "type": "function", "file": "git2/submodule.h", - "line": 507, - "lineto": 508, + "line": 516, + "lineto": 517, "args": [ { "name": "submodule", @@ -20974,8 +21172,8 @@ "git_submodule_set_update": { "type": "function", "file": "git2/submodule.h", - "line": 520, - "lineto": 523, + "line": 529, + "lineto": 532, "args": [ { "name": "repo", @@ -21003,16 +21201,20 @@ "git_submodule_fetch_recurse_submodules": { "type": "function", "file": "git2/submodule.h", - "line": 536, - "lineto": 537, + "line": 546, + "lineto": 547, "args": [ - { "name": "submodule", "type": "git_submodule *", "comment": null } + { + "name": "submodule", + "type": "git_submodule *", + "comment": "the submodule to examine" + } ], "argline": "git_submodule *submodule", "sig": "git_submodule *", "return": { "type": "git_submodule_recurse_t", - "comment": " 0 if fetchRecurseSubmodules is false, 1 if true" + "comment": " the submodule recursion configuration" }, "description": "Read the fetchRecurseSubmodules rule for a submodule.
\n", "comments": "This accesses the submodule.
Note that at this time, libgit2 does not honor this setting and the fetch functionality current ignores submodules.
\n", @@ -21021,8 +21223,8 @@ "git_submodule_set_fetch_recurse_submodules": { "type": "function", "file": "git2/submodule.h", - "line": 549, - "lineto": 552, + "line": 559, + "lineto": 562, "args": [ { "name": "repo", @@ -21037,7 +21239,7 @@ { "name": "fetch_recurse_submodules", "type": "git_submodule_recurse_t", - "comment": "Boolean value" + "comment": "the submodule recursion configuration" } ], "argline": "git_repository *repo, const char *name, git_submodule_recurse_t fetch_recurse_submodules", @@ -21053,8 +21255,8 @@ "git_submodule_init": { "type": "function", "file": "git2/submodule.h", - "line": 567, - "lineto": 567, + "line": 577, + "lineto": 577, "args": [ { "name": "submodule", @@ -21080,8 +21282,8 @@ "git_submodule_repo_init": { "type": "function", "file": "git2/submodule.h", - "line": 582, - "lineto": 585, + "line": 592, + "lineto": 595, "args": [ { "name": "out", @@ -21112,8 +21314,8 @@ "git_submodule_sync": { "type": "function", "file": "git2/submodule.h", - "line": 598, - "lineto": 598, + "line": 608, + "lineto": 608, "args": [ { "name": "submodule", @@ -21131,8 +21333,8 @@ "git_submodule_open": { "type": "function", "file": "git2/submodule.h", - "line": 612, - "lineto": 614, + "line": 622, + "lineto": 624, "args": [ { "name": "repo", @@ -21158,8 +21360,8 @@ "git_submodule_reload": { "type": "function", "file": "git2/submodule.h", - "line": 626, - "lineto": 626, + "line": 636, + "lineto": 636, "args": [ { "name": "submodule", @@ -21182,8 +21384,8 @@ "git_submodule_status": { "type": "function", "file": "git2/submodule.h", - "line": 642, - "lineto": 646, + "line": 652, + "lineto": 656, "args": [ { "name": "status", @@ -21213,14 +21415,14 @@ "comments": "This looks at a submodule and tries to determine the status. It will return a combination of the GIT_SUBMODULE_STATUS values above. How deeply it examines the working directory to do this will depend on the git_submodule_ignore_t value for the submodule.
Lookup a tag object from the repository.
\n", "comments": "", "group": "tag", - "examples": { "general.c": ["ex/v1.8.4/general.html#git_tag_lookup-75"] } + "examples": { "general.c": ["ex/v1.9.1/general.html#git_tag_lookup-91"] } }, "git_tag_lookup_prefix": { "type": "function", @@ -21318,7 +21520,7 @@ "description": "Close an open tag
\n", "comments": "You can no longer use the git_tag pointer after this call.
\n\nIMPORTANT: You MUST call this method when you are through with a tag to release memory. Failure to do so will cause a memory leak.
\n", "group": "tag", - "examples": { "general.c": ["ex/v1.8.4/general.html#git_tag_free-76"] } + "examples": { "general.c": ["ex/v1.9.1/general.html#git_tag_free-92"] } }, "git_tag_id": { "type": "function", @@ -21387,7 +21589,7 @@ "description": "Get the tagged object of a tag
\n", "comments": "This method performs a repository lookup for the given object and returns it
\n", "group": "tag", - "examples": { "general.c": ["ex/v1.8.4/general.html#git_tag_target-77"] } + "examples": { "general.c": ["ex/v1.9.1/general.html#git_tag_target-93"] } }, "git_tag_target_id": { "type": "function", @@ -21408,7 +21610,7 @@ "comments": "", "group": "tag", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_tag_target_id-31"] + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_tag_target_id-31"] } }, "git_tag_target_type": { @@ -21433,8 +21635,8 @@ "comments": "", "group": "tag", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_tag_target_type-32"], - "general.c": ["ex/v1.8.4/general.html#git_tag_target_type-78"] + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_tag_target_type-32"], + "general.c": ["ex/v1.9.1/general.html#git_tag_target_type-94"] } }, "git_tag_name": { @@ -21456,9 +21658,9 @@ "comments": "", "group": "tag", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_tag_name-33"], - "general.c": ["ex/v1.8.4/general.html#git_tag_name-79"], - "tag.c": ["ex/v1.8.4/tag.html#git_tag_name-16"] + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_tag_name-33"], + "general.c": ["ex/v1.9.1/general.html#git_tag_name-95"], + "tag.c": ["ex/v1.9.1/tag.html#git_tag_name-16"] } }, "git_tag_tagger": { @@ -21483,7 +21685,7 @@ "comments": "", "group": "tag", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_tag_tagger-34"] + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_tag_tagger-34"] } }, "git_tag_message": { @@ -21509,11 +21711,11 @@ "group": "tag", "examples": { "cat-file.c": [ - "ex/v1.8.4/cat-file.html#git_tag_message-35", - "ex/v1.8.4/cat-file.html#git_tag_message-36" + "ex/v1.9.1/cat-file.html#git_tag_message-35", + "ex/v1.9.1/cat-file.html#git_tag_message-36" ], - "general.c": ["ex/v1.8.4/general.html#git_tag_message-80"], - "tag.c": ["ex/v1.8.4/tag.html#git_tag_message-17"] + "general.c": ["ex/v1.9.1/general.html#git_tag_message-96"], + "tag.c": ["ex/v1.9.1/tag.html#git_tag_message-17"] } }, "git_tag_create": { @@ -21567,7 +21769,7 @@ "description": "Create a new tag in the repository from an object
\n", "comments": "A new reference will also be created pointing to this tag object. If force is true and a reference already exists with the given name, it'll be replaced.
The message will not be cleaned up. This can be achieved through git_message_prettify().
The tag name will be checked for validity. You must avoid the characters '~', '^', ':', '\\', '?', '[', and '*', and the sequences ".." and "@{" which have special meaning to revparse.
\n", "group": "tag", - "examples": { "tag.c": ["ex/v1.8.4/tag.html#git_tag_create-18"] } + "examples": { "tag.c": ["ex/v1.9.1/tag.html#git_tag_create-18"] } }, "git_tag_annotation_create": { "type": "function", @@ -21684,7 +21886,7 @@ "comments": "A new direct reference will be created pointing to this target object. If force is true and a reference already exists with the given name, it'll be replaced.
The tag name will be checked for validity. See git_tag_create() for rules about valid names.
Delete an existing tag reference.
\n", "comments": "The tag name will be checked for validity. See git_tag_create() for rules about valid names.
Fill a list with all the tags in the Repository\n which name match a defined pattern
\n", "comments": "If an empty pattern is provided, all the tags will be returned.
\n\nThe string array will be filled with the names of the matching tags; these values are owned by the user and should be free'd manually when no longer needed, using git_strarray_free.
Call callback `cb' for each tag in the repository
\n", "comments": "", "group": "tag" @@ -21797,8 +21999,8 @@ "git_tag_peel": { "type": "function", "file": "git2/tag.h", - "line": 355, - "lineto": 357, + "line": 356, + "lineto": 358, "args": [ { "name": "tag_target_out", @@ -21821,8 +22023,8 @@ "git_tag_dup": { "type": "function", "file": "git2/tag.h", - "line": 367, - "lineto": 367, + "line": 368, + "lineto": 368, "args": [ { "name": "out", @@ -21845,8 +22047,8 @@ "git_tag_name_is_valid": { "type": "function", "file": "git2/tag.h", - "line": 379, - "lineto": 379, + "line": 380, + "lineto": 380, "args": [ { "name": "valid", @@ -21869,8 +22071,8 @@ "git_trace_set": { "type": "function", "file": "git2/trace.h", - "line": 63, - "lineto": 63, + "line": 68, + "lineto": 68, "args": [ { "name": "level", @@ -22148,13 +22350,13 @@ "comments": "", "group": "tree", "examples": { - "commit.c": ["ex/v1.8.4/commit.html#git_tree_lookup-12"], + "commit.c": ["ex/v1.9.1/commit.html#git_tree_lookup-13"], "general.c": [ - "ex/v1.8.4/general.html#git_tree_lookup-81", - "ex/v1.8.4/general.html#git_tree_lookup-82" + "ex/v1.9.1/general.html#git_tree_lookup-97", + "ex/v1.9.1/general.html#git_tree_lookup-98" ], - "init.c": ["ex/v1.8.4/init.html#git_tree_lookup-12"], - "merge.c": ["ex/v1.8.4/merge.html#git_tree_lookup-37"] + "init.c": ["ex/v1.9.1/init.html#git_tree_lookup-13"], + "merge.c": ["ex/v1.9.1/merge.html#git_tree_lookup-37"] } }, "git_tree_lookup_prefix": { @@ -22206,22 +22408,22 @@ "comments": "You can no longer use the git_tree pointer after this call.
\n\nIMPORTANT: You MUST call this method when you stop using a tree to release memory. Failure to do so will cause a memory leak.
\n", "group": "tree", "examples": { - "commit.c": ["ex/v1.8.4/commit.html#git_tree_free-13"], + "commit.c": ["ex/v1.9.1/commit.html#git_tree_free-14"], "diff.c": [ - "ex/v1.8.4/diff.html#git_tree_free-19", - "ex/v1.8.4/diff.html#git_tree_free-20" + "ex/v1.9.1/diff.html#git_tree_free-19", + "ex/v1.9.1/diff.html#git_tree_free-20" ], "general.c": [ - "ex/v1.8.4/general.html#git_tree_free-83", - "ex/v1.8.4/general.html#git_tree_free-84" + "ex/v1.9.1/general.html#git_tree_free-99", + "ex/v1.9.1/general.html#git_tree_free-100" ], - "init.c": ["ex/v1.8.4/init.html#git_tree_free-13"], + "init.c": ["ex/v1.9.1/init.html#git_tree_free-14"], "log.c": [ - "ex/v1.8.4/log.html#git_tree_free-55", - "ex/v1.8.4/log.html#git_tree_free-56", - "ex/v1.8.4/log.html#git_tree_free-57", - "ex/v1.8.4/log.html#git_tree_free-58", - "ex/v1.8.4/log.html#git_tree_free-59" + "ex/v1.9.1/log.html#git_tree_free-55", + "ex/v1.9.1/log.html#git_tree_free-56", + "ex/v1.9.1/log.html#git_tree_free-57", + "ex/v1.9.1/log.html#git_tree_free-58", + "ex/v1.9.1/log.html#git_tree_free-59" ] } }, @@ -22291,8 +22493,8 @@ "comments": "", "group": "tree", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_tree_entrycount-37"], - "general.c": ["ex/v1.8.4/general.html#git_tree_entrycount-85"] + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_tree_entrycount-37"], + "general.c": ["ex/v1.9.1/general.html#git_tree_entrycount-101"] } }, "git_tree_entry_byname": { @@ -22322,7 +22524,7 @@ "comments": "This returns a git_tree_entry that is owned by the git_tree. You don't have to free it, but you must not use it after the git_tree is released.
\n", "group": "tree", "examples": { - "general.c": ["ex/v1.8.4/general.html#git_tree_entry_byname-86"] + "general.c": ["ex/v1.9.1/general.html#git_tree_entry_byname-102"] } }, "git_tree_entry_byindex": { @@ -22352,8 +22554,8 @@ "comments": "This returns a git_tree_entry that is owned by the git_tree. You don't have to free it, but you must not use it after the git_tree is released.
\n", "group": "tree", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_tree_entry_byindex-38"], - "general.c": ["ex/v1.8.4/general.html#git_tree_entry_byindex-87"] + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_tree_entry_byindex-38"], + "general.c": ["ex/v1.9.1/general.html#git_tree_entry_byindex-103"] } }, "git_tree_entry_byid": { @@ -22477,10 +22679,10 @@ "comments": "", "group": "tree", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_tree_entry_name-39"], + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_tree_entry_name-39"], "general.c": [ - "ex/v1.8.4/general.html#git_tree_entry_name-88", - "ex/v1.8.4/general.html#git_tree_entry_name-89" + "ex/v1.9.1/general.html#git_tree_entry_name-104", + "ex/v1.9.1/general.html#git_tree_entry_name-105" ] } }, @@ -22506,7 +22708,7 @@ "comments": "", "group": "tree", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_tree_entry_id-40"] + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_tree_entry_id-40"] } }, "git_tree_entry_type": { @@ -22531,7 +22733,7 @@ "comments": "", "group": "tree", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_tree_entry_type-41"] + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_tree_entry_type-41"] } }, "git_tree_entry_filemode": { @@ -22556,7 +22758,7 @@ "comments": "", "group": "tree", "examples": { - "cat-file.c": ["ex/v1.8.4/cat-file.html#git_tree_entry_filemode-42"] + "cat-file.c": ["ex/v1.9.1/cat-file.html#git_tree_entry_filemode-42"] } }, "git_tree_entry_filemode_raw": { @@ -22637,7 +22839,7 @@ "comments": "You must call git_object_free() on the object when you are done with it.
Checkout notification callback function
\n", + "return": { "type": "int", "comment": " 0 on success, or an error code" }, + "description": "Checkout notification callback function.
\n", "comments": "" }, "git_checkout_progress_cb": { "type": "callback", "file": "git2/checkout.h", - "line": 264, - "lineto": 268, + "line": 291, + "lineto": 295, "args": [ - { "name": "path", "type": "const char *", "comment": null }, - { "name": "completed_steps", "type": "size_t", "comment": null }, - { "name": "total_steps", "type": "size_t", "comment": null }, - { "name": "payload", "type": "void *", "comment": null } + { + "name": "path", + "type": "const char *", + "comment": "the path to the file being checked out" + }, + { + "name": "completed_steps", + "type": "size_t", + "comment": "number of checkout steps completed" + }, + { + "name": "total_steps", + "type": "size_t", + "comment": "number of total steps in the checkout process" + }, + { + "name": "payload", + "type": "void *", + "comment": "the user-supplied callback payload" + } ], "argline": "const char *path, size_t completed_steps, size_t total_steps, void *payload", "sig": "const char *::size_t::size_t::void *", "return": { "type": "void", "comment": null }, - "description": "Checkout progress notification function
\n", + "description": "Checkout progress notification function.
\n", "comments": "" }, "git_checkout_perfdata_cb": { "type": "callback", "file": "git2/checkout.h", - "line": 271, - "lineto": 273, + "line": 303, + "lineto": 305, "args": [ { "name": "perfdata", "type": "const git_checkout_perfdata *", - "comment": null + "comment": "the performance data for the checkout" }, - { "name": "payload", "type": "void *", "comment": null } + { + "name": "payload", + "type": "void *", + "comment": "the user-supplied callback payload" + } ], "argline": "const git_checkout_perfdata *perfdata, void *payload", "sig": "const git_checkout_perfdata *::void *", "return": { "type": "void", "comment": null }, - "description": "Checkout perfdata notification function
\n", + "description": "Checkout performance data reporting function.
\n", "comments": "" }, "git_remote_create_cb": { "type": "callback", "file": "git2/clone.h", - "line": 69, - "lineto": 74, + "line": 73, + "lineto": 78, "args": [ { "name": "out", @@ -23576,8 +23818,8 @@ "git_repository_create_cb": { "type": "callback", "file": "git2/clone.h", - "line": 90, - "lineto": 94, + "line": 94, + "lineto": 98, "args": [ { "name": "out", @@ -23612,8 +23854,8 @@ "git_commit_create_cb": { "type": "callback", "file": "git2/commit.h", - "line": 576, - "lineto": 585, + "line": 643, + "lineto": 652, "args": [ { "name": "out", @@ -23673,8 +23915,8 @@ "git_config_foreach_cb": { "type": "callback", "file": "git2/config.h", - "line": 122, - "lineto": 122, + "line": 140, + "lineto": 140, "args": [ { "name": "entry", @@ -23693,14 +23935,14 @@ "type": "int", "comment": " non-zero to terminate the iteration." }, - "description": "A config enumeration callback
\n", + "description": "A config enumeration callback.
\n", "comments": "" }, "git_credential_acquire_cb": { "type": "callback", "file": "git2/credential.h", - "line": 131, - "lineto": 136, + "line": 134, + "lineto": 139, "args": [ { "name": "out", @@ -23737,11 +23979,98 @@ "description": "Credential acquisition callback.
\n", "comments": "This callback is usually involved any time another system might need authentication. As such, you are expected to provide a valid git_credential object back, depending on allowed_types (a git_credential_t bitmask).
\n\nNote that most authentication details are your responsibility - this callback will be called until the authentication succeeds, or you report an error. As such, it's easy to get in a loop if you fail to stop providing the same incorrect credentials.
\n" }, + "git_credential_ssh_interactive_cb": { + "type": "callback", + "file": "git2/credential.h", + "line": 259, + "lineto": 265, + "args": [ + { "name": "name", "type": "const char *", "comment": "the name" }, + { + "name": "name_len", + "type": "int", + "comment": "the length of the name" + }, + { + "name": "instruction", + "type": "const char *", + "comment": "the authentication instruction" + }, + { + "name": "instruction_len", + "type": "int", + "comment": "the length of the instruction" + }, + { + "name": "num_prompts", + "type": "int", + "comment": "the number of prompts" + }, + { + "name": "prompts", + "type": "const LIBSSH2_USERAUTH_KBDINT_PROMPT *", + "comment": "the prompts" + }, + { + "name": "responses", + "type": "LIBSSH2_USERAUTH_KBDINT_RESPONSE *", + "comment": "the responses" + }, + { "name": "abstract", "type": "void **", "comment": "the abstract" } + ], + "argline": "const char *name, int name_len, const char *instruction, int instruction_len, int num_prompts, const LIBSSH2_USERAUTH_KBDINT_PROMPT *prompts, LIBSSH2_USERAUTH_KBDINT_RESPONSE *responses, void **abstract", + "sig": "const char *::int::const char *::int::int::const LIBSSH2_USERAUTH_KBDINT_PROMPT *::LIBSSH2_USERAUTH_KBDINT_RESPONSE *::void **", + "return": { "type": "void", "comment": null }, + "description": "Callback for interactive SSH credentials.
\n", + "comments": "" + }, + "git_credential_sign_cb": { + "type": "callback", + "file": "git2/credential.h", + "line": 308, + "lineto": 312, + "args": [ + { + "name": "session", + "type": "LIBSSH2_SESSION *", + "comment": "the libssh2 session" + }, + { + "name": "sig", + "type": "unsigned char **", + "comment": "the signature" + }, + { + "name": "sig_len", + "type": "size_t *", + "comment": "the length of the signature" + }, + { + "name": "data", + "type": "const unsigned char *", + "comment": "the data" + }, + { + "name": "data_len", + "type": "size_t", + "comment": "the length of the data" + }, + { "name": "abstract", "type": "void **", "comment": "the abstract" } + ], + "argline": "LIBSSH2_SESSION *session, unsigned char **sig, size_t *sig_len, const unsigned char *data, size_t data_len, void **abstract", + "sig": "LIBSSH2_SESSION *::unsigned char **::size_t *::const unsigned char *::size_t::void **", + "return": { + "type": "int", + "comment": " 0 for success, \n<\n 0 to indicate an error, > 0 to indicate\n no credential was acquired" + }, + "description": "Callback for credential signing.
\n", + "comments": "" + }, "git_commit_signing_cb": { "type": "callback", "file": "git2/deprecated.h", - "line": 276, - "lineto": 280, + "line": 285, + "lineto": 289, "args": [ { "name": "signature", "type": "git_buf *", "comment": null }, { "name": "signature_field", "type": "git_buf *", "comment": null }, @@ -23757,8 +24086,8 @@ "git_headlist_cb": { "type": "callback", "file": "git2/deprecated.h", - "line": 855, - "lineto": 855, + "line": 967, + "lineto": 967, "args": [ { "name": "rhead", "type": "git_remote_head *", "comment": null }, { "name": "payload", "type": "void *", "comment": null } @@ -23772,29 +24101,44 @@ "git_diff_notify_cb": { "type": "callback", "file": "git2/diff.h", - "line": 346, - "lineto": 350, + "line": 352, + "lineto": 356, "args": [ - { "name": "diff_so_far", "type": "const git_diff *", "comment": null }, + { + "name": "diff_so_far", + "type": "const git_diff *", + "comment": "the diff structure as it currently exists" + }, { "name": "delta_to_add", "type": "const git_diff_delta *", - "comment": null + "comment": "the delta that is to be added" }, - { "name": "matched_pathspec", "type": "const char *", "comment": null }, - { "name": "payload", "type": "void *", "comment": null } + { + "name": "matched_pathspec", + "type": "const char *", + "comment": "the pathspec" + }, + { + "name": "payload", + "type": "void *", + "comment": "the user-specified callback payload" + } ], "argline": "const git_diff *diff_so_far, const git_diff_delta *delta_to_add, const char *matched_pathspec, void *payload", "sig": "const git_diff *::const git_diff_delta *::const char *::void *", - "return": { "type": "int", "comment": null }, + "return": { + "type": "int", + "comment": " 0 on success, 1 to skip this delta, or an error code" + }, "description": "Diff notification callback function.
\n", "comments": "The callback will be called for each file, just before the git_diff_delta gets inserted into the diff.
When the callback: - returns < 0, the diff process will be aborted. - returns > 0, the delta will not be inserted into the diff, but the diff process continues. - returns 0, the delta is inserted into the diff, and the diff process continues.
\n" }, "git_diff_progress_cb": { "type": "callback", "file": "git2/diff.h", - "line": 362, - "lineto": 366, + "line": 369, + "lineto": 373, "args": [ { "name": "diff_so_far", @@ -23811,19 +24155,23 @@ "type": "const char *", "comment": "The path to the new file or NULL." }, - { "name": "payload", "type": "void *", "comment": null } + { + "name": "payload", + "type": "void *", + "comment": "the user-specified callback payload" + } ], "argline": "const git_diff *diff_so_far, const char *old_path, const char *new_path, void *payload", "sig": "const git_diff *::const char *::const char *::void *", - "return": { "type": "int", "comment": " Non-zero to abort the diff." }, + "return": { "type": "int", "comment": " 0 or an error code" }, "description": "Diff progress callback.
\n", "comments": "Called before each file comparison.
\n" }, "git_diff_file_cb": { "type": "callback", "file": "git2/diff.h", - "line": 496, - "lineto": 499, + "line": 504, + "lineto": 507, "args": [ { "name": "delta", @@ -23843,84 +24191,131 @@ ], "argline": "const git_diff_delta *delta, float progress, void *payload", "sig": "const git_diff_delta *::float::void *", - "return": { "type": "int", "comment": null }, + "return": { "type": "int", "comment": " 0 or an error code" }, "description": "When iterating over a diff, callback that will be made per file.
\n", "comments": "" }, "git_diff_binary_cb": { "type": "callback", "file": "git2/diff.h", - "line": 562, - "lineto": 565, + "line": 576, + "lineto": 579, "args": [ - { "name": "delta", "type": "const git_diff_delta *", "comment": null }, + { + "name": "delta", + "type": "const git_diff_delta *", + "comment": "the delta" + }, { "name": "binary", "type": "const git_diff_binary *", - "comment": null + "comment": "the binary content" }, - { "name": "payload", "type": "void *", "comment": null } + { + "name": "payload", + "type": "void *", + "comment": "the user-specified callback payload" + } ], "argline": "const git_diff_delta *delta, const git_diff_binary *binary, void *payload", "sig": "const git_diff_delta *::const git_diff_binary *::void *", - "return": { "type": "int", "comment": null }, + "return": { "type": "int", "comment": " 0 or an error code" }, "description": "When iterating over a diff, callback that will be made for\n binary content within the diff.
\n", "comments": "" }, "git_diff_hunk_cb": { "type": "callback", "file": "git2/diff.h", - "line": 588, - "lineto": 591, + "line": 607, + "lineto": 610, "args": [ - { "name": "delta", "type": "const git_diff_delta *", "comment": null }, - { "name": "hunk", "type": "const git_diff_hunk *", "comment": null }, - { "name": "payload", "type": "void *", "comment": null } + { + "name": "delta", + "type": "const git_diff_delta *", + "comment": "the delta" + }, + { + "name": "hunk", + "type": "const git_diff_hunk *", + "comment": "the hunk" + }, + { + "name": "payload", + "type": "void *", + "comment": "the user-specified callback payload" + } ], "argline": "const git_diff_delta *delta, const git_diff_hunk *hunk, void *payload", "sig": "const git_diff_delta *::const git_diff_hunk *::void *", - "return": { "type": "int", "comment": null }, + "return": { "type": "int", "comment": " 0 or an error code" }, "description": "When iterating over a diff, callback that will be made per hunk.
\n", "comments": "" }, "git_diff_line_cb": { "type": "callback", "file": "git2/diff.h", - "line": 649, - "lineto": 653, + "line": 674, + "lineto": 678, "args": [ - { "name": "delta", "type": "const git_diff_delta *", "comment": null }, - { "name": "hunk", "type": "const git_diff_hunk *", "comment": null }, - { "name": "line", "type": "const git_diff_line *", "comment": null }, - { "name": "payload", "type": "void *", "comment": null } + { + "name": "delta", + "type": "const git_diff_delta *", + "comment": "the delta that contains the line" + }, + { + "name": "hunk", + "type": "const git_diff_hunk *", + "comment": "the hunk that contains the line" + }, + { + "name": "line", + "type": "const git_diff_line *", + "comment": "the line in the diff" + }, + { + "name": "payload", + "type": "void *", + "comment": "the user-specified callback payload" + } ], "argline": "const git_diff_delta *delta, const git_diff_hunk *hunk, const git_diff_line *line, void *payload", "sig": "const git_diff_delta *::const git_diff_hunk *::const git_diff_line *::void *", - "return": { "type": "int", "comment": null }, + "return": { "type": "int", "comment": " 0 or an error code" }, "description": "When iterating over a diff, callback that will be made per text diff\n line. In this context, the provided range will be NULL.
\n", "comments": "When printing a diff, callback that will be made to output each line of text. This uses some extra GIT_DIFF_LINE_... constants for output of lines of file and hunk headers.
\n" }, "git_index_matched_path_cb": { "type": "callback", "file": "git2/index.h", - "line": 135, - "lineto": 136, + "line": 158, + "lineto": 159, "args": [ - { "name": "path", "type": "const char *", "comment": null }, - { "name": "matched_pathspec", "type": "const char *", "comment": null }, - { "name": "payload", "type": "void *", "comment": null } + { "name": "path", "type": "const char *", "comment": "the path" }, + { + "name": "matched_pathspec", + "type": "const char *", + "comment": "the given pathspec" + }, + { + "name": "payload", + "type": "void *", + "comment": "the user-specified payload" + } ], "argline": "const char *path, const char *matched_pathspec, void *payload", "sig": "const char *::const char *::void *", - "return": { "type": "int", "comment": null }, - "description": "Callback for APIs that add/remove/update files matching pathspec
\n", + "return": { + "type": "int", + "comment": " 0 to continue with the index operation, positive number to skip this file for the index operation, negative number on failure" + }, + "description": "Callback for APIs that add/remove/update files matching pathspec
\n", "comments": "" }, "git_indexer_progress_cb": { "type": "callback", "file": "git2/indexer.h", - "line": 57, - "lineto": 57, + "line": 68, + "lineto": 68, "args": [ { "name": "stats", @@ -23935,7 +24330,7 @@ ], "argline": "const git_indexer_progress *stats, void *payload", "sig": "const git_indexer_progress *::void *", - "return": { "type": "int", "comment": null }, + "return": { "type": "int", "comment": " 0 on success or an error code" }, "description": "Type for progress callbacks during indexing. Return a value less\n than zero to cancel the indexing or download.
\n", "comments": "" }, @@ -23943,34 +24338,53 @@ "type": "callback", "file": "git2/notes.h", "line": 29, - "lineto": 30, + "lineto": 32, "args": [ - { "name": "blob_id", "type": "const git_oid *", "comment": null }, + { + "name": "blob_id", + "type": "const git_oid *", + "comment": "object id of the blob containing the message" + }, { "name": "annotated_object_id", "type": "const git_oid *", - "comment": null + "comment": "the id of the object being annotated" }, - { "name": "payload", "type": "void *", "comment": null } + { + "name": "payload", + "type": "void *", + "comment": "user-specified data to the foreach function" + } ], "argline": "const git_oid *blob_id, const git_oid *annotated_object_id, void *payload", "sig": "const git_oid *::const git_oid *::void *", - "return": { "type": "int", "comment": null }, + "return": { + "type": "int", + "comment": " 0 on success, or a negative number on failure" + }, "description": "Callback for git_note_foreach.
\n", - "comments": "Receives: - blob_id: Oid of the blob containing the message - annotated_object_id: Oid of the git object being annotated - payload: Payload data passed to git_note_foreach
Function type for callbacks from git_odb_foreach.
\n", "comments": "" }, @@ -24008,25 +24422,41 @@ "git_packbuilder_progress": { "type": "callback", "file": "git2/pack.h", - "line": 237, - "lineto": 241, + "line": 245, + "lineto": 249, "args": [ - { "name": "stage", "type": "int", "comment": null }, - { "name": "current", "type": "uint32_t", "comment": null }, - { "name": "total", "type": "uint32_t", "comment": null }, - { "name": "payload", "type": "void *", "comment": null } + { + "name": "stage", + "type": "int", + "comment": "the stage of the packbuilder" + }, + { + "name": "current", + "type": "uint32_t", + "comment": "the current object" + }, + { + "name": "total", + "type": "uint32_t", + "comment": "the total number of objects" + }, + { + "name": "payload", + "type": "void *", + "comment": "the callback payload" + } ], "argline": "int stage, uint32_t current, uint32_t total, void *payload", "sig": "int::uint32_t::uint32_t::void *", - "return": { "type": "int", "comment": null }, - "description": "Packbuilder progress notification function
\n", + "return": { "type": "int", "comment": " 0 on success or an error code" }, + "description": "Packbuilder progress notification function.
\n", "comments": "" }, "git_reference_foreach_cb": { "type": "callback", "file": "git2/refs.h", - "line": 437, - "lineto": 437, + "line": 439, + "lineto": 439, "args": [ { "name": "reference", @@ -24051,8 +24481,8 @@ "git_reference_foreach_name_cb": { "type": "callback", "file": "git2/refs.h", - "line": 448, - "lineto": 448, + "line": 450, + "lineto": 450, "args": [ { "name": "name", @@ -24077,25 +24507,44 @@ "git_push_transfer_progress_cb": { "type": "callback", "file": "git2/remote.h", - "line": 470, - "lineto": 474, + "line": 481, + "lineto": 485, "args": [ - { "name": "current", "type": "unsigned int", "comment": null }, - { "name": "total", "type": "unsigned int", "comment": null }, - { "name": "bytes", "type": "size_t", "comment": null }, - { "name": "payload", "type": "void *", "comment": null } + { + "name": "current", + "type": "unsigned int", + "comment": "The number of objects pushed so far" + }, + { + "name": "total", + "type": "unsigned int", + "comment": "The total number of objects to push" + }, + { + "name": "bytes", + "type": "size_t", + "comment": "The number of bytes pushed" + }, + { + "name": "payload", + "type": "void *", + "comment": "The user-specified payload callback" + } ], "argline": "unsigned int current, unsigned int total, size_t bytes, void *payload", "sig": "unsigned int::unsigned int::size_t::void *", - "return": { "type": "int", "comment": null }, - "description": "Push network progress notification function
\n", + "return": { + "type": "int", + "comment": " 0 or an error code to stop the transfer" + }, + "description": "Push network progress notification callback.
\n", "comments": "" }, "git_push_negotiation": { "type": "callback", "file": "git2/remote.h", - "line": 506, - "lineto": 506, + "line": 518, + "lineto": 521, "args": [ { "name": "updates", @@ -24115,15 +24564,18 @@ ], "argline": "const git_push_update **updates, size_t len, void *payload", "sig": "const git_push_update **::size_t::void *", - "return": { "type": "int", "comment": null }, + "return": { + "type": "int", + "comment": " 0 or an error code to stop the push" + }, "description": "Callback used to inform of upcoming updates.
\n", "comments": "" }, "git_push_update_reference_cb": { "type": "callback", "file": "git2/remote.h", - "line": 520, - "lineto": 520, + "line": 535, + "lineto": 535, "args": [ { "name": "refname", @@ -24153,8 +24605,8 @@ "git_url_resolve_cb": { "type": "callback", "file": "git2/remote.h", - "line": 536, - "lineto": 536, + "line": 551, + "lineto": 551, "args": [ { "name": "url_resolved", @@ -24189,8 +24641,8 @@ "git_remote_ready_cb": { "type": "callback", "file": "git2/remote.h", - "line": 549, - "lineto": 549, + "line": 564, + "lineto": 564, "args": [ { "name": "remote", @@ -24217,8 +24669,8 @@ "git_repository_fetchhead_foreach_cb": { "type": "callback", "file": "git2/repository.h", - "line": 726, - "lineto": 730, + "line": 746, + "lineto": 750, "args": [ { "name": "ref_name", @@ -24258,8 +24710,8 @@ "git_repository_mergehead_foreach_cb": { "type": "callback", "file": "git2/repository.h", - "line": 757, - "lineto": 758, + "line": 777, + "lineto": 778, "args": [ { "name": "oid", @@ -24310,27 +24762,31 @@ "git_stash_apply_progress_cb": { "type": "callback", "file": "git2/stash.h", - "line": 169, - "lineto": 171, + "line": 181, + "lineto": 183, "args": [ { "name": "progress", "type": "git_stash_apply_progress_t", - "comment": null + "comment": "the progress information" }, - { "name": "payload", "type": "void *", "comment": null } + { + "name": "payload", + "type": "void *", + "comment": "the user-specified payload to the apply function" + } ], "argline": "git_stash_apply_progress_t progress, void *payload", "sig": "git_stash_apply_progress_t::void *", - "return": { "type": "int", "comment": null }, + "return": { "type": "int", "comment": " 0 on success, -1 on error" }, "description": "Stash application progress notification function.\n Return 0 to continue processing, or a negative value to\n abort the stash application.
\n", "comments": "" }, "git_stash_cb": { "type": "callback", "file": "git2/stash.h", - "line": 255, - "lineto": 259, + "line": 268, + "lineto": 272, "args": [ { "name": "index", @@ -24365,24 +24821,39 @@ "git_status_cb": { "type": "callback", "file": "git2/status.h", - "line": 63, - "lineto": 64, + "line": 62, + "lineto": 63, "args": [ - { "name": "path", "type": "const char *", "comment": null }, - { "name": "status_flags", "type": "unsigned int", "comment": null }, - { "name": "payload", "type": "void *", "comment": null } + { + "name": "path", + "type": "const char *", + "comment": "is the path to the file" + }, + { + "name": "status_flags", + "type": "unsigned int", + "comment": "the `git_status_t` values for file's status" + }, + { + "name": "payload", + "type": "void *", + "comment": "the user-specified payload to the foreach function" + } ], "argline": "const char *path, unsigned int status_flags, void *payload", "sig": "const char *::unsigned int::void *", - "return": { "type": "int", "comment": null }, + "return": { + "type": "int", + "comment": " 0 on success, or a negative number on failure" + }, "description": "Function pointer to receive status on individual files
\n", - "comments": "path is the relative path to the file from the root of the repository.
status_flags is a combination of git_status_t values that apply.
payload is the value you passed to the foreach function as payload.
Callback for messages received by the transport.
\n", "comments": "Return a negative value to cancel the network operation.
\n" }, "git_transport_cb": { "type": "callback", "file": "git2/transport.h", - "line": 37, - "lineto": 37, + "line": 45, + "lineto": 45, "args": [ - { "name": "out", "type": "git_transport **", "comment": null }, - { "name": "owner", "type": "git_remote *", "comment": null }, - { "name": "param", "type": "void *", "comment": null } + { + "name": "out", + "type": "git_transport **", + "comment": "the transport generate" + }, + { + "name": "owner", + "type": "git_remote *", + "comment": "the owner for the transport" + }, + { + "name": "param", + "type": "void *", + "comment": "the param to the transport creation" + } ], "argline": "git_transport **out, git_remote *owner, void *param", "sig": "git_transport **::git_remote *::void *", - "return": { "type": "int", "comment": null }, - "description": "Signature of a function which creates a transport
\n", + "return": { "type": "int", "comment": " 0 on success or an error code" }, + "description": "Signature of a function which creates a transport.
\n", "comments": "" }, "git_treebuilder_filter_cb": { "type": "callback", "file": "git2/tree.h", - "line": 349, - "lineto": 350, + "line": 353, + "lineto": 354, "args": [ - { "name": "entry", "type": "const git_tree_entry *", "comment": null }, - { "name": "payload", "type": "void *", "comment": null } + { + "name": "entry", + "type": "const git_tree_entry *", + "comment": "the tree entry for the callback to examine" + }, + { + "name": "payload", + "type": "void *", + "comment": "the payload from the caller" + } ], "argline": "const git_tree_entry *entry, void *payload", "sig": "const git_tree_entry *::void *", - "return": { "type": "int", "comment": null }, + "return": { + "type": "int", + "comment": " 0 to do nothing, non-zero to remove the entry" + }, "description": "Callback for git_treebuilder_filter
\n", "comments": "The return value is treated as a boolean, with zero indicating that the entry should be left alone and any non-zero value meaning that the entry should be removed from the treebuilder list (i.e. filtered out).
\n" }, "git_treewalk_cb": { "type": "callback", "file": "git2/tree.h", - "line": 383, - "lineto": 384, + "line": 394, + "lineto": 395, "args": [ - { "name": "root", "type": "const char *", "comment": null }, - { "name": "entry", "type": "const git_tree_entry *", "comment": null }, - { "name": "payload", "type": "void *", "comment": null } + { + "name": "root", + "type": "const char *", + "comment": "the current (relative) root to the entry" + }, + { + "name": "entry", + "type": "const git_tree_entry *", + "comment": "the tree entry" + }, + { + "name": "payload", + "type": "void *", + "comment": "the caller-provided callback payload" + } ], "argline": "const char *root, const git_tree_entry *entry, void *payload", "sig": "const char *::const git_tree_entry *::void *", - "return": { "type": "int", "comment": null }, - "description": "Callback for the tree traversal method
\n", + "return": { + "type": "int", + "comment": " a positive value to skip the entry, a negative value to stop the walk" + }, + "description": "Callback for the tree traversal method.
\n", "comments": "" } }, @@ -24529,11 +25046,11 @@ "type": "struct", "value": "git_annotated_commit", "file": "git2/types.h", - "line": 198, - "lineto": 198, + "line": 214, + "lineto": 214, "tdef": "typedef", - "description": " Annotated commits, the input to merge and rebase. ", - "comments": "", + "description": " Annotated commits are commits with additional metadata about how the\n commit was resolved, which can be used for maintaining the user's\n \"intent\" through commands like merge and rebase.", + "comments": "For example, if a user wants to conceptually "merge HEAD", then the commit portion of an annotated commit will point to the HEAD commit, but the annotation will denote the ref HEAD. This allows git to perform the internal bookkeeping so that the system knows both the content of what is being merged but also how the content was looked up so that it can be recorded in the reflog appropriately.
When the callback: - returns < 0, the apply process will be aborted. - returns > 0, the hunk will not be applied, but the apply process continues - returns 0, the hunk is applied, and the apply process continues.
\n", "fields": [ { "type": "int", @@ -24588,8 +25105,8 @@ ], "type": "enum", "file": "git2/apply.h", - "line": 127, - "lineto": 145, + "line": 148, + "lineto": 166, "block": "GIT_APPLY_LOCATION_WORKDIR\nGIT_APPLY_LOCATION_INDEX\nGIT_APPLY_LOCATION_BOTH", "tdef": "typedef", "description": " Possible application locations for git_apply ", @@ -24630,12 +25147,12 @@ "type": "struct", "value": "git_apply_options", "file": "git2/apply.h", - "line": 77, - "lineto": 91, + "line": 95, + "lineto": 109, "block": "unsigned int version\ngit_apply_delta_cb delta_cb\ngit_apply_hunk_cb hunk_cb\nvoid * payload\nunsigned int flags", "tdef": "typedef", - "description": " Apply options structure", - "comments": "Initialize with GIT_APPLY_OPTIONS_INIT. Alternatively, you can use git_apply_options_init.
When the callback: - returns < 0, the apply process will be aborted. - returns > 0, the hunk will not be applied, but the apply process continues - returns 0, the hunk is applied, and the apply process continues.
\n\nInitialize with GIT_APPLY_OPTIONS_INIT. Alternatively, you can use git_apply_options_init.
Initialize with GIT_BLAME_OPTIONS_INIT. Alternatively, you can use git_blame_options_init.
Initialize with GIT_BLOB_FILTER_OPTIONS_INIT. Alternatively, you can use git_blob_filter_options_init.
Initialize with GIT_BLOB_FILTER_OPTIONS_INIT. Alternatively, you can use git_blob_filter_options_init.
[version] GIT_BLOB_FILTER_OPTIONS_VERSION [init_macro] GIT_BLOB_FILTER_OPTIONS_INIT [init_function] git_blob_filter_options_init
\n", "fields": [ - { "type": "int", "name": "version", "comments": "" }, + { + "type": "int", + "name": "version", + "comments": " Version number of the options structure. " + }, { "type": "uint32_t", "name": "flags", - "comments": " Flags to control the filtering process, see `git_blob_filter_flag_t` above " + "comments": " Flags to control the filtering process, see `git_blob_filter_flag_t` above.\n\n \n\n[flags] git_blob_filter_flag_t" + }, + { + "type": "git_oid *", + "name": "commit_id", + "comments": " This value is unused and reserved for API compatibility.\n\n " }, - { "type": "git_oid *", "name": "commit_id", "comments": "" }, { "type": "git_oid", "name": "attr_commit_id", @@ -25134,8 +25603,8 @@ "type": "struct", "value": "git_branch_iterator", "file": "git2/branch.h", - "line": 90, - "lineto": 90, + "line": 97, + "lineto": 97, "tdef": "typedef", "description": " Iterator type for branches ", "comments": "", @@ -25155,8 +25624,8 @@ "decl": ["GIT_BRANCH_LOCAL", "GIT_BRANCH_REMOTE", "GIT_BRANCH_ALL"], "type": "enum", "file": "git2/types.h", - "line": 215, - "lineto": 219, + "line": 231, + "lineto": 235, "block": "GIT_BRANCH_LOCAL\nGIT_BRANCH_REMOTE\nGIT_BRANCH_ALL", "tdef": "typedef", "description": " Basic type of any Git branch. ", @@ -25198,8 +25667,8 @@ "type": "struct", "value": "git_buf", "file": "git2/buffer.h", - "line": 33, - "lineto": 52, + "line": 36, + "lineto": 55, "block": "char * ptr\nsize_t reserved\nsize_t size", "tdef": "typedef", "description": " A data buffer for exporting data from libgit2", @@ -25253,14 +25722,12 @@ "git_diff_stats_to_buf", "git_diff_to_buf", "git_email_create_from_commit", - "git_email_create_from_diff", "git_filter_list_apply_to_blob", "git_filter_list_apply_to_buffer", "git_filter_list_apply_to_data", "git_filter_list_apply_to_file", "git_filter_list_stream_data", "git_message_prettify", - "git_note_default_ref", "git_object_short_id", "git_packbuilder_write_buf", "git_patch_to_buf", @@ -25285,8 +25752,8 @@ "type": "struct", "value": "git_cert", "file": "git2/types.h", - "line": 262, - "lineto": 262, + "line": 278, + "lineto": 278, "block": "git_cert_t cert_type", "tdef": "typedef", "description": " Parent type for `git_cert_hostkey` and `git_cert_x509`.", @@ -25510,8 +25977,8 @@ ], "type": "enum", "file": "git2/checkout.h", - "line": 214, - "lineto": 245, + "line": 224, + "lineto": 255, "block": "GIT_CHECKOUT_NOTIFY_NONE\nGIT_CHECKOUT_NOTIFY_CONFLICT\nGIT_CHECKOUT_NOTIFY_DIRTY\nGIT_CHECKOUT_NOTIFY_UPDATED\nGIT_CHECKOUT_NOTIFY_UNTRACKED\nGIT_CHECKOUT_NOTIFY_IGNORED\nGIT_CHECKOUT_NOTIFY_ALL", "tdef": "typedef", "description": " Checkout notification flags", @@ -25591,12 +26058,12 @@ "type": "struct", "value": "git_checkout_options", "file": "git2/checkout.h", - "line": 282, - "lineto": 345, + "line": 317, + "lineto": 391, "block": "unsigned int version\nunsigned int checkout_strategy\nint disable_filters\nunsigned int dir_mode\nunsigned int file_mode\nint file_open_flags\nunsigned int notify_flags\ngit_checkout_notify_cb notify_cb\nvoid * notify_payload\ngit_checkout_progress_cb progress_cb\nvoid * progress_payload\ngit_strarray paths\ngit_tree * baseline\ngit_index * baseline_index\nconst char * target_directory\nconst char * ancestor_label\nconst char * our_label\nconst char * their_label\ngit_checkout_perfdata_cb perfdata_cb\nvoid * perfdata_payload", "tdef": "typedef", "description": " Checkout options structure", - "comments": "Initialize with GIT_CHECKOUT_OPTIONS_INIT. Alternatively, you can use git_checkout_options_init.
Initialize with GIT_CHECKOUT_OPTIONS_INIT. Alternatively, you can use git_checkout_options_init.
[version] GIT_CHECKOUT_OPTIONS_VERSION [init_macro] GIT_CHECKOUT_OPTIONS_INIT [init_function] git_checkout_options_init
\n", "fields": [ { "type": "unsigned int", @@ -25631,7 +26098,7 @@ { "type": "unsigned int", "name": "notify_flags", - "comments": " see `git_checkout_notify_t` above " + "comments": " Checkout notification flags specify what operations the notify\n callback is invoked for.\n\n \n\n[flags] git_checkout_notify_t" }, { "type": "git_checkout_notify_cb", @@ -25724,8 +26191,8 @@ "type": "struct", "value": "git_checkout_perfdata", "file": "git2/checkout.h", - "line": 248, - "lineto": 252, + "line": 258, + "lineto": 262, "block": "size_t mkdir_calls\nsize_t stat_calls\nsize_t chmod_calls", "tdef": "typedef", "description": " Checkout performance-reporting structure ", @@ -25742,7 +26209,6 @@ "git_checkout_strategy_t", { "decl": [ - "GIT_CHECKOUT_NONE", "GIT_CHECKOUT_SAFE", "GIT_CHECKOUT_FORCE", "GIT_CHECKOUT_RECREATE_MISSING", @@ -25764,34 +26230,29 @@ "GIT_CHECKOUT_DONT_WRITE_INDEX", "GIT_CHECKOUT_DRY_RUN", "GIT_CHECKOUT_CONFLICT_STYLE_ZDIFF3", + "GIT_CHECKOUT_NONE", "GIT_CHECKOUT_UPDATE_SUBMODULES", "GIT_CHECKOUT_UPDATE_SUBMODULES_IF_CHANGED" ], "type": "enum", "file": "git2/checkout.h", - "line": 106, - "lineto": 198, - "block": "GIT_CHECKOUT_NONE\nGIT_CHECKOUT_SAFE\nGIT_CHECKOUT_FORCE\nGIT_CHECKOUT_RECREATE_MISSING\nGIT_CHECKOUT_ALLOW_CONFLICTS\nGIT_CHECKOUT_REMOVE_UNTRACKED\nGIT_CHECKOUT_REMOVE_IGNORED\nGIT_CHECKOUT_UPDATE_ONLY\nGIT_CHECKOUT_DONT_UPDATE_INDEX\nGIT_CHECKOUT_NO_REFRESH\nGIT_CHECKOUT_SKIP_UNMERGED\nGIT_CHECKOUT_USE_OURS\nGIT_CHECKOUT_USE_THEIRS\nGIT_CHECKOUT_DISABLE_PATHSPEC_MATCH\nGIT_CHECKOUT_SKIP_LOCKED_DIRECTORIES\nGIT_CHECKOUT_DONT_OVERWRITE_IGNORED\nGIT_CHECKOUT_CONFLICT_STYLE_MERGE\nGIT_CHECKOUT_CONFLICT_STYLE_DIFF3\nGIT_CHECKOUT_DONT_REMOVE_EXISTING\nGIT_CHECKOUT_DONT_WRITE_INDEX\nGIT_CHECKOUT_DRY_RUN\nGIT_CHECKOUT_CONFLICT_STYLE_ZDIFF3\nGIT_CHECKOUT_UPDATE_SUBMODULES\nGIT_CHECKOUT_UPDATE_SUBMODULES_IF_CHANGED", + "line": 113, + "lineto": 206, + "block": "GIT_CHECKOUT_SAFE\nGIT_CHECKOUT_FORCE\nGIT_CHECKOUT_RECREATE_MISSING\nGIT_CHECKOUT_ALLOW_CONFLICTS\nGIT_CHECKOUT_REMOVE_UNTRACKED\nGIT_CHECKOUT_REMOVE_IGNORED\nGIT_CHECKOUT_UPDATE_ONLY\nGIT_CHECKOUT_DONT_UPDATE_INDEX\nGIT_CHECKOUT_NO_REFRESH\nGIT_CHECKOUT_SKIP_UNMERGED\nGIT_CHECKOUT_USE_OURS\nGIT_CHECKOUT_USE_THEIRS\nGIT_CHECKOUT_DISABLE_PATHSPEC_MATCH\nGIT_CHECKOUT_SKIP_LOCKED_DIRECTORIES\nGIT_CHECKOUT_DONT_OVERWRITE_IGNORED\nGIT_CHECKOUT_CONFLICT_STYLE_MERGE\nGIT_CHECKOUT_CONFLICT_STYLE_DIFF3\nGIT_CHECKOUT_DONT_REMOVE_EXISTING\nGIT_CHECKOUT_DONT_WRITE_INDEX\nGIT_CHECKOUT_DRY_RUN\nGIT_CHECKOUT_CONFLICT_STYLE_ZDIFF3\nGIT_CHECKOUT_NONE\nGIT_CHECKOUT_UPDATE_SUBMODULES\nGIT_CHECKOUT_UPDATE_SUBMODULES_IF_CHANGED", "tdef": "typedef", "description": " Checkout behavior flags", - "comments": "In libgit2, checkout is used to update the working directory and index to match a target tree. Unlike git checkout, it does not move the HEAD commit for you - use git_repository_set_head or the like to do that.
Checkout looks at (up to) four things: the "target" tree you want to check out, the "baseline" tree of what was checked out previously, the working directory for actual files, and the index for staged changes.
\n\nYou give checkout one of three strategies for update:
\n\nGIT_CHECKOUT_NONE is a dry-run strategy that checks for conflicts, etc., but doesn't make any actual changes.
GIT_CHECKOUT_FORCE is at the opposite extreme, taking any action to make the working directory match the target (including potentially discarding modified files).
GIT_CHECKOUT_SAFE is between these two options, it will only make modifications that will not lose changes.
| target == baseline | target != baseline | ---------------------|-----------------------|----------------------| workdir == baseline | no action | create, update, or | | | delete file | ---------------------|-----------------------|----------------------| workdir exists and | no action | conflict (notify | is != baseline | notify dirty MODIFIED | and cancel checkout) | ---------------------|-----------------------|----------------------| workdir missing, | notify dirty DELETED | create file | baseline present | | | ---------------------|-----------------------|----------------------|\nTo emulate git checkout, use GIT_CHECKOUT_SAFE with a checkout notification callback (see below) that displays information about dirty files. The default behavior will cancel checkout on conflicts.
To emulate git checkout-index, use GIT_CHECKOUT_SAFE with a notification callback that cancels the operation if a dirty-but-existing file is found in the working directory. This core git command isn't quite "force" but is sensitive about some types of changes.
To emulate git checkout -f, use GIT_CHECKOUT_FORCE.
There are some additional flags to modify the behavior of checkout:
\n\nGIT_CHECKOUT_ALLOW_CONFLICTS makes SAFE mode apply safe file updates even if there are conflicts (instead of cancelling the checkout).
GIT_CHECKOUT_REMOVE_UNTRACKED means remove untracked files (i.e. not in target, baseline, or index, and not ignored) from the working dir.
GIT_CHECKOUT_REMOVE_IGNORED means remove ignored files (that are also untracked) from the working directory as well.
GIT_CHECKOUT_UPDATE_ONLY means to only update the content of files that already exist. Files will not be created nor deleted. This just skips applying adds, deletes, and typechanges.
GIT_CHECKOUT_DONT_UPDATE_INDEX prevents checkout from writing the updated files' information to the index.
Normally, checkout will reload the index and git attributes from disk before any operations. GIT_CHECKOUT_NO_REFRESH prevents this reload.
Unmerged index entries are conflicts. GIT_CHECKOUT_SKIP_UNMERGED skips files with unmerged index entries instead. GIT_CHECKOUT_USE_OURS and GIT_CHECKOUT_USE_THEIRS to proceed with the checkout using either the stage 2 ("ours") or stage 3 ("theirs") version of files in the index.
GIT_CHECKOUT_DONT_OVERWRITE_IGNORED prevents ignored files from being overwritten. Normally, files that are ignored in the working directory are not considered "precious" and may be overwritten if the checkout target contains that file.
GIT_CHECKOUT_DONT_REMOVE_EXISTING prevents checkout from removing files or folders that fold to the same name on case insensitive filesystems. This can cause files to retain their existing names and write through existing symbolic links.
In libgit2, checkout is used to update the working directory and index to match a target tree. Unlike git checkout, it does not move the HEAD commit for you - use git_repository_set_head or the like to do that.
Checkout looks at (up to) four things: the "target" tree you want to check out, the "baseline" tree of what was checked out previously, the working directory for actual files, and the index for staged changes.
\n\nYou give checkout one of two strategies for update:
\n\nGIT_CHECKOUT_SAFE is the default, and similar to git's default, which will make modifications that will not lose changes in the working directory.
| target == baseline | target != baseline | ---------------------|-----------------------|----------------------| workdir == baseline | no action | create, update, or | | | delete file | ---------------------|-----------------------|----------------------| workdir exists and | no action | conflict (notify | is != baseline | notify dirty MODIFIED | and cancel checkout) | ---------------------|-----------------------|----------------------| workdir missing, | notify dirty DELETED | create file | baseline present | | | ---------------------|-----------------------|----------------------|\nGIT_CHECKOUT_FORCE will take any action to make the working directory match the target (including potentially discarding modified files).
To emulate git checkout, use GIT_CHECKOUT_SAFE with a checkout notification callback (see below) that displays information about dirty files. The default behavior will cancel checkout on conflicts.
To emulate git checkout-index, use GIT_CHECKOUT_SAFE with a notification callback that cancels the operation if a dirty-but-existing file is found in the working directory. This core git command isn't quite "force" but is sensitive about some types of changes.
To emulate git checkout -f, use GIT_CHECKOUT_FORCE.
There are some additional flags to modify the behavior of checkout:
\n\nGIT_CHECKOUT_DRY_RUN is a dry-run strategy that checks for conflicts, etc., but doesn't make any actual changes.
GIT_CHECKOUT_ALLOW_CONFLICTS makes SAFE mode apply safe file updates even if there are conflicts (instead of cancelling the checkout).
GIT_CHECKOUT_REMOVE_UNTRACKED means remove untracked files (i.e. not in target, baseline, or index, and not ignored) from the working dir.
GIT_CHECKOUT_REMOVE_IGNORED means remove ignored files (that are also untracked) from the working directory as well.
GIT_CHECKOUT_UPDATE_ONLY means to only update the content of files that already exist. Files will not be created nor deleted. This just skips applying adds, deletes, and typechanges.
GIT_CHECKOUT_DONT_UPDATE_INDEX prevents checkout from writing the updated files' information to the index.
Normally, checkout will reload the index and git attributes from disk before any operations. GIT_CHECKOUT_NO_REFRESH prevents this reload.
Unmerged index entries are conflicts. GIT_CHECKOUT_SKIP_UNMERGED skips files with unmerged index entries instead. GIT_CHECKOUT_USE_OURS and GIT_CHECKOUT_USE_THEIRS to proceed with the checkout using either the stage 2 ("ours") or stage 3 ("theirs") version of files in the index.
GIT_CHECKOUT_DONT_OVERWRITE_IGNORED prevents ignored files from being overwritten. Normally, files that are ignored in the working directory are not considered "precious" and may be overwritten if the checkout target contains that file.
GIT_CHECKOUT_DONT_REMOVE_EXISTING prevents checkout from removing files or folders that fold to the same name on case insensitive filesystems. This can cause files to retain their existing names and write through existing symbolic links.
default is a dry run, no actual updates
\n", - "value": 0 - }, { "type": "int", "name": "GIT_CHECKOUT_SAFE", - "comments": "Allow safe updates that cannot overwrite uncommitted data.\n If the uncommitted changes don't conflict with the checked out files,\n the checkout will still proceed, leaving the changes intact.
\n\nMutually exclusive with GIT_CHECKOUT_FORCE.\n GIT_CHECKOUT_FORCE takes precedence over GIT_CHECKOUT_SAFE.
\n", - "value": 1 + "comments": "Allow safe updates that cannot overwrite uncommitted data.\n If the uncommitted changes don't conflict with the checked\n out files, the checkout will still proceed, leaving the\n changes intact.
\n", + "value": 0 }, { "type": "int", "name": "GIT_CHECKOUT_FORCE", - "comments": "Allow all updates to force working directory to look like index.
\n\nMutually exclusive with GIT_CHECKOUT_SAFE.\n GIT_CHECKOUT_FORCE takes precedence over GIT_CHECKOUT_SAFE.
\n", + "comments": "Allow all updates to force working directory to look like\n the index, potentially losing data in the process.
\n", "value": 2 }, { @@ -25899,7 +26360,7 @@ { "type": "int", "name": "GIT_CHECKOUT_DRY_RUN", - "comments": "Show what would be done by a checkout. Stop after sending\n notifications; don't update the working directory or index.
\n", + "comments": "Perform a "dry run", reporting what would be done but\n without actually making changes in the working directory\n or the index.
\n", "value": 16777216 }, { @@ -25908,6 +26369,12 @@ "comments": "Include common ancestor data in zdiff3 format for conflicts
\n", "value": 33554432 }, + { + "type": "int", + "name": "GIT_CHECKOUT_NONE", + "comments": "Do not do a checkout and do not fire callbacks; this is primarily\n useful only for internal functions that will perform the\n checkout themselves but need to pass checkout options into\n another function, for example, git_clone.
Initialize with GIT_CLONE_OPTIONS_INIT. Alternatively, you can use git_clone_options_init.
Initialize with GIT_CLONE_OPTIONS_INIT. Alternatively, you can use git_clone_options_init.
[version] GIT_CLONE_OPTIONS_VERSION [init_macro] GIT_CLONE_OPTIONS_INIT [init_function] git_clone_options_init
\n", "fields": [ { "type": "unsigned int", "name": "version", "comments": "" }, { "type": "git_checkout_options", "name": "checkout_opts", - "comments": " These options are passed to the checkout step. To disable\n checkout, set the `checkout_strategy` to\n `GIT_CHECKOUT_NONE`." + "comments": " These options are passed to the checkout step. To disable\n checkout, set the `checkout_strategy` to `GIT_CHECKOUT_NONE`\n or `GIT_CHECKOUT_DRY_RUN`." }, { "type": "git_fetch_options", @@ -26097,8 +26564,8 @@ "type": "struct", "value": "git_commit", "file": "git2/types.h", - "line": 136, - "lineto": 136, + "line": 141, + "lineto": 141, "tdef": "typedef", "description": " Parsed representation of a commit object. ", "comments": "", @@ -26142,10 +26609,6 @@ "git_diff_commit_as_email", "git_email_create_from_commit", "git_merge_commits", - "git_note_commit_create", - "git_note_commit_iterator_new", - "git_note_commit_read", - "git_note_commit_remove", "git_odb_set_commit_graph", "git_repository_commit_parents", "git_revert", @@ -26161,8 +26624,8 @@ "type": "struct", "value": "git_commit_graph", "file": "git2/types.h", - "line": 109, - "lineto": 109, + "line": 114, + "lineto": 114, "tdef": "typedef", "description": " A git commit-graph ", "comments": "", @@ -26175,8 +26638,8 @@ "decl": ["GIT_COMMIT_GRAPH_SPLIT_STRATEGY_SINGLE_FILE"], "type": "enum", "file": "git2/sys/commit_graph.h", - "line": 102, - "lineto": 108, + "line": 93, + "lineto": 99, "block": "GIT_COMMIT_GRAPH_SPLIT_STRATEGY_SINGLE_FILE", "tdef": "typedef", "description": " The strategy to use when adding a new set of commits to a pre-existing\n commit-graph chain.", @@ -26199,8 +26662,8 @@ "type": "struct", "value": "git_commit_graph_writer", "file": "git2/types.h", - "line": 112, - "lineto": 112, + "line": 117, + "lineto": 117, "tdef": "typedef", "description": " a writer for commit-graph files. ", "comments": "", @@ -26214,8 +26677,8 @@ "type": "struct", "value": "git_commitarray", "file": "git2/commit.h", - "line": 588, - "lineto": 591, + "line": 655, + "lineto": 658, "block": "git_commit *const * commits\nsize_t count", "tdef": "typedef", "description": " An array of commits returned from the library ", @@ -26237,8 +26700,8 @@ "type": "struct", "value": "git_config", "file": "git2/types.h", - "line": 157, - "lineto": 157, + "line": 162, + "lineto": 162, "tdef": "typedef", "description": " Memory representation of a set of config files ", "comments": "", @@ -26280,6 +26743,7 @@ "git_config_set_int64", "git_config_set_multivar", "git_config_set_string", + "git_config_set_writeorder", "git_config_snapshot", "git_repository_config", "git_repository_config_snapshot" @@ -26294,8 +26758,8 @@ "type": "struct", "value": "git_config_backend", "file": "git2/types.h", - "line": 160, - "lineto": 160, + "line": 165, + "lineto": 165, "tdef": "typedef", "description": " Interface to access a configuration file ", "comments": "", @@ -26313,8 +26777,8 @@ "type": "struct", "value": "git_config_backend_memory_options", "file": "git2/sys/config.h", - "line": 129, - "lineto": 143, + "line": 148, + "lineto": 162, "block": "unsigned int version\nconst char * backend_type\nconst char * origin_path", "tdef": "typedef", "description": " Options for in-memory configuration backends. ", @@ -26344,15 +26808,14 @@ "const char * backend_type", "const char * origin_path", "unsigned int include_depth", - "git_config_level_t level", - "void (*)(struct git_config_entry *) free" + "git_config_level_t level" ], "type": "struct", "value": "git_config_entry", "file": "git2/config.h", - "line": 79, - "lineto": 106, - "block": "const char * name\nconst char * value\nconst char * backend_type\nconst char * origin_path\nunsigned int include_depth\ngit_config_level_t level\nvoid (*)(struct git_config_entry *) free", + "line": 103, + "lineto": 124, + "block": "const char * name\nconst char * value\nconst char * backend_type\nconst char * origin_path\nunsigned int include_depth\ngit_config_level_t level", "tdef": "typedef", "description": " An entry in a configuration file", "comments": "", @@ -26360,17 +26823,17 @@ { "type": "const char *", "name": "name", - "comments": " Name of the configuration entry (normalized) " + "comments": " Name of the configuration entry (normalized). " }, { "type": "const char *", "name": "value", - "comments": " Literal (string) value of the entry " + "comments": " Literal (string) value of the entry. " }, { "type": "const char *", "name": "backend_type", - "comments": " The type of backend that this entry exists in (eg, \"file\") " + "comments": " The type of backend that this entry exists in (eg, \"file\"). " }, { "type": "const char *", @@ -26380,17 +26843,12 @@ { "type": "unsigned int", "name": "include_depth", - "comments": " Depth of includes where this variable was found " + "comments": " Depth of includes where this variable was found. " }, { "type": "git_config_level_t", "name": "level", - "comments": " Configuration level for the file this was found in " - }, - { - "type": "void (*)(struct git_config_entry *)", - "name": "free", - "comments": "" + "comments": " Configuration level for the file this was found in. " } ], "used": { @@ -26411,10 +26869,10 @@ "type": "struct", "value": "git_config_iterator", "file": "git2/config.h", - "line": 127, - "lineto": 127, + "line": 145, + "lineto": 145, "tdef": "typedef", - "description": " An opaque structure for a configuration iterator", + "description": " An opaque structure for a configuration iterator.", "comments": "", "used": { "returns": [], @@ -26443,8 +26901,8 @@ ], "type": "enum", "file": "git2/config.h", - "line": 42, - "lineto": 74, + "line": 49, + "lineto": 98, "block": "GIT_CONFIG_LEVEL_PROGRAMDATA\nGIT_CONFIG_LEVEL_SYSTEM\nGIT_CONFIG_LEVEL_XDG\nGIT_CONFIG_LEVEL_GLOBAL\nGIT_CONFIG_LEVEL_LOCAL\nGIT_CONFIG_LEVEL_WORKTREE\nGIT_CONFIG_LEVEL_APP\nGIT_CONFIG_HIGHEST_LEVEL", "tdef": "typedef", "description": " Priority level of a config file.", @@ -26453,55 +26911,59 @@ { "type": "int", "name": "GIT_CONFIG_LEVEL_PROGRAMDATA", - "comments": "System-wide on Windows, for compatibility with portable git
\n", + "comments": "System-wide on Windows, for compatibility with "Portable Git".
\n", "value": 1 }, { "type": "int", "name": "GIT_CONFIG_LEVEL_SYSTEM", - "comments": "System-wide configuration file; /etc/gitconfig on Linux systems
\n", + "comments": "System-wide configuration file; /etc/gitconfig on Linux.
XDG compatible configuration file; typically ~/.config/git/config
\n", + "comments": "XDG compatible configuration file; typically\n ~/.config/git/config.
User-specific configuration file (also called Global configuration\n file); typically ~/.gitconfig
\n", + "comments": "Global configuration file is the user-specific configuration;\n typically ~/.gitconfig.
Repository specific configuration file; $WORK_DIR/.git/config on\n non-bare repos
\n", + "comments": "Local configuration, the repository-specific configuration file;\n typically $GIT_DIR/config.
Worktree specific configuration file; $GIT_DIR/config.worktree
\n", + "comments": "Worktree-specific configuration; typically\n $GIT_DIR/config.worktree.
Application specific configuration file; freely defined by applications
\n", + "comments": "Application-specific configuration file. Callers into libgit2\n can add their own configuration beginning at this level.
\n", "value": 7 }, { "type": "int", "name": "GIT_CONFIG_HIGHEST_LEVEL", - "comments": "Represents the highest level available config file (i.e. the most\n specific config file available that actually is loaded)
\n", + "comments": "Not a configuration level; callers can use this value when\n querying configuration levels to specify that they want to\n have data from the highest-level currently configuration.\n This can be used to indicate that callers want the most\n specific config file available that actually is loaded.
\n", "value": -1 } ], "used": { "returns": [], - "needs": ["git_config_add_file_ondisk", "git_config_open_level"] + "needs": [ + "git_config_add_file_ondisk", + "git_config_open_level", + "git_config_set_writeorder" + ] } } ], @@ -26516,8 +26978,8 @@ "type": "struct", "value": "git_configmap", "file": "git2/config.h", - "line": 142, - "lineto": 146, + "line": 160, + "lineto": 164, "block": "git_configmap_t type\nconst char * str_match\nint map_value", "tdef": "typedef", "description": " Mapping from config variables to values.", @@ -26544,8 +27006,8 @@ ], "type": "enum", "file": "git2/config.h", - "line": 132, - "lineto": 137, + "line": 150, + "lineto": 155, "block": "GIT_CONFIGMAP_FALSE\nGIT_CONFIGMAP_TRUE\nGIT_CONFIGMAP_INT32\nGIT_CONFIGMAP_STRING", "tdef": "typedef", "description": " Config var type", @@ -26586,8 +27048,8 @@ "type": "struct", "value": "git_credential", "file": "git2/credential.h", - "line": 84, - "lineto": 84, + "line": 87, + "lineto": 87, "tdef": "typedef", "description": " The base structure for all credential types", "comments": "", @@ -26618,8 +27080,8 @@ "type": "struct", "value": "git_credential_default", "file": "git2/credential.h", - "line": 92, - "lineto": 92, + "line": 95, + "lineto": 95, "tdef": "typedef", "description": " A key for NTLM/Kerberos \"default\" credentials ", "comments": "", @@ -26633,8 +27095,8 @@ "type": "struct", "value": "git_credential_ssh_custom", "file": "git2/credential.h", - "line": 107, - "lineto": 107, + "line": 110, + "lineto": 110, "tdef": "typedef", "description": " A key with a custom signature function", "comments": "", @@ -26648,8 +27110,8 @@ "type": "struct", "value": "git_credential_ssh_interactive", "file": "git2/credential.h", - "line": 102, - "lineto": 102, + "line": 105, + "lineto": 105, "tdef": "typedef", "description": " Keyboard-interactive based ssh authentication", "comments": "", @@ -26666,8 +27128,8 @@ "type": "struct", "value": "git_credential_ssh_key", "file": "git2/credential.h", - "line": 97, - "lineto": 97, + "line": 100, + "lineto": 100, "tdef": "typedef", "description": " A ssh key from disk", "comments": "", @@ -26688,8 +27150,8 @@ ], "type": "enum", "file": "git2/credential.h", - "line": 27, - "lineto": 79, + "line": 30, + "lineto": 82, "block": "GIT_CREDENTIAL_USERPASS_PLAINTEXT\nGIT_CREDENTIAL_SSH_KEY\nGIT_CREDENTIAL_SSH_CUSTOM\nGIT_CREDENTIAL_DEFAULT\nGIT_CREDENTIAL_SSH_INTERACTIVE\nGIT_CREDENTIAL_USERNAME\nGIT_CREDENTIAL_SSH_MEMORY", "tdef": "typedef", "description": " Supported credential types", @@ -26748,8 +27210,8 @@ "type": "struct", "value": "git_credential_username", "file": "git2/credential.h", - "line": 89, - "lineto": 89, + "line": 92, + "lineto": 92, "tdef": "typedef", "description": " Username-only credential information ", "comments": "", @@ -26886,8 +27348,8 @@ "type": "struct", "value": "git_describe_format_options", "file": "git2/describe.h", - "line": 91, - "lineto": 111, + "line": 100, + "lineto": 120, "block": "unsigned int version\nunsigned int abbreviated_size\nint always_use_long_format\nconst char * dirty_suffix", "tdef": "typedef", "description": " Describe format options structure", @@ -26930,8 +27392,8 @@ "type": "struct", "value": "git_describe_options", "file": "git2/describe.h", - "line": 43, - "lineto": 61, + "line": 47, + "lineto": 65, "block": "unsigned int version\nunsigned int max_candidates_tags\nunsigned int describe_strategy\nconst char * pattern\nint only_follow_first_parent\nint show_commit_oid_as_fallback", "tdef": "typedef", "description": " Describe options structure", @@ -26977,8 +27439,8 @@ "type": "struct", "value": "git_describe_result", "file": "git2/describe.h", - "line": 134, - "lineto": 134, + "line": 146, + "lineto": 146, "tdef": "typedef", "description": " A struct that stores the result of a describe operation.", "comments": "", @@ -27003,8 +27465,8 @@ ], "type": "enum", "file": "git2/describe.h", - "line": 30, - "lineto": 34, + "line": 34, + "lineto": 38, "block": "GIT_DESCRIBE_DEFAULT\nGIT_DESCRIBE_TAGS\nGIT_DESCRIBE_ALL", "tdef": "typedef", "description": " Reference lookup strategy", @@ -27095,7 +27557,6 @@ "git_diff_tree_to_tree", "git_diff_tree_to_workdir", "git_diff_tree_to_workdir_with_index", - "git_email_create_from_diff", "git_patch_from_blob_and_buffer", "git_patch_from_blobs", "git_patch_from_buffers", @@ -27119,8 +27580,8 @@ "type": "struct", "value": "git_diff_binary", "file": "git2/diff.h", - "line": 544, - "lineto": 556, + "line": 553, + "lineto": 565, "block": "unsigned int contains_data\ngit_diff_binary_file old_file\ngit_diff_binary_file new_file", "tdef": "typedef", "description": " Structure describing the binary contents of a diff.", @@ -27166,8 +27627,8 @@ "type": "struct", "value": "git_diff_binary_file", "file": "git2/diff.h", - "line": 521, - "lineto": 533, + "line": 530, + "lineto": 542, "block": "git_diff_binary_t type\nconst char * data\nsize_t datalen\nsize_t inflatedlen", "tdef": "typedef", "description": " The contents of one of the files in a binary diff. ", @@ -27207,8 +27668,8 @@ ], "type": "enum", "file": "git2/diff.h", - "line": 509, - "lineto": 518, + "line": 518, + "lineto": 527, "block": "GIT_DIFF_BINARY_NONE\nGIT_DIFF_BINARY_LITERAL\nGIT_DIFF_BINARY_DELTA", "tdef": "typedef", "description": " When producing a binary diff, the binary data returned will be\n either the deflated full (\"literal\") contents of the file, or\n the deflated binary delta between the two sides (whichever is\n smaller).", @@ -27373,8 +27834,8 @@ "type": "struct", "value": "git_diff_find_options", "file": "git2/diff.h", - "line": 749, - "lineto": 803, + "line": 774, + "lineto": 828, "block": "unsigned int version\nuint32_t flags\nuint16_t rename_threshold\nuint16_t rename_from_rewrite_threshold\nuint16_t copy_threshold\nuint16_t break_rewrite_threshold\nsize_t rename_limit\ngit_diff_similarity_metric * metric", "tdef": "typedef", "description": " Control behavior of rename and copy detection", @@ -27446,8 +27907,8 @@ ], "type": "enum", "file": "git2/diff.h", - "line": 658, - "lineto": 727, + "line": 683, + "lineto": 752, "block": "GIT_DIFF_FIND_BY_CONFIG\nGIT_DIFF_FIND_RENAMES\nGIT_DIFF_FIND_RENAMES_FROM_REWRITES\nGIT_DIFF_FIND_COPIES\nGIT_DIFF_FIND_COPIES_FROM_UNMODIFIED\nGIT_DIFF_FIND_REWRITES\nGIT_DIFF_BREAK_REWRITES\nGIT_DIFF_FIND_AND_BREAK_REWRITES\nGIT_DIFF_FIND_FOR_UNTRACKED\nGIT_DIFF_FIND_ALL\nGIT_DIFF_FIND_IGNORE_LEADING_WHITESPACE\nGIT_DIFF_FIND_IGNORE_WHITESPACE\nGIT_DIFF_FIND_DONT_IGNORE_WHITESPACE\nGIT_DIFF_FIND_EXACT_MATCH_ONLY\nGIT_DIFF_BREAK_REWRITES_FOR_RENAMES_ONLY\nGIT_DIFF_FIND_REMOVE_UNMODIFIED", "tdef": "typedef", "description": " Flags to control the behavior of diff rename/copy detection.", @@ -27615,8 +28076,8 @@ ], "type": "enum", "file": "git2/deprecated.h", - "line": 311, - "lineto": 318, + "line": 325, + "lineto": 331, "block": "GIT_DIFF_FORMAT_EMAIL_NONE\nGIT_DIFF_FORMAT_EMAIL_EXCLUDE_SUBJECT_PATCH_MARKER", "tdef": "typedef", "description": " Formatting options for diff e-mail generation", @@ -27654,8 +28115,8 @@ "type": "struct", "value": "git_diff_format_email_options", "file": "git2/deprecated.h", - "line": 323, - "lineto": 346, + "line": 338, + "lineto": 361, "block": "unsigned int version\nuint32_t flags\nsize_t patch_no\nsize_t total_patches\nconst git_oid * id\nconst char * summary\nconst char * body\nconst git_signature * author", "tdef": "typedef", "description": " Options for controlling the formatting of the generated e-mail.", @@ -27720,8 +28181,8 @@ ], "type": "enum", "file": "git2/diff.h", - "line": 1128, - "lineto": 1135, + "line": 1156, + "lineto": 1163, "block": "GIT_DIFF_FORMAT_PATCH\nGIT_DIFF_FORMAT_PATCH_HEADER\nGIT_DIFF_FORMAT_RAW\nGIT_DIFF_FORMAT_NAME_ONLY\nGIT_DIFF_FORMAT_NAME_STATUS\nGIT_DIFF_FORMAT_PATCH_ID", "tdef": "typedef", "description": " Possible output formats for diff data", @@ -27784,8 +28245,8 @@ "type": "struct", "value": "git_diff_hunk", "file": "git2/diff.h", - "line": 576, - "lineto": 583, + "line": 590, + "lineto": 597, "block": "int old_start\nint old_lines\nint new_start\nint new_lines\nsize_t header_len\nchar [128] header", "tdef": "typedef", "description": " Structure describing a hunk of a diff.", @@ -27852,8 +28313,8 @@ "type": "struct", "value": "git_diff_line", "file": "git2/diff.h", - "line": 631, - "lineto": 639, + "line": 650, + "lineto": 658, "block": "char origin\nint old_lineno\nint new_lineno\nint num_lines\nsize_t content_len\ngit_off_t content_offset\nconst char * content", "tdef": "typedef", "description": " Structure describing a line (or data span) of a diff.", @@ -27926,8 +28387,8 @@ ], "type": "enum", "file": "git2/diff.h", - "line": 602, - "lineto": 618, + "line": 621, + "lineto": 637, "block": "GIT_DIFF_LINE_CONTEXT\nGIT_DIFF_LINE_ADDITION\nGIT_DIFF_LINE_DELETION\nGIT_DIFF_LINE_CONTEXT_EOFNL\nGIT_DIFF_LINE_ADD_EOFNL\nGIT_DIFF_LINE_DEL_EOFNL\nGIT_DIFF_LINE_FILE_HDR\nGIT_DIFF_LINE_HUNK_HDR\nGIT_DIFF_LINE_BINARY", "tdef": "typedef", "description": " Line origin constants.", @@ -28248,8 +28709,8 @@ "type": "struct", "value": "git_diff_options", "file": "git2/diff.h", - "line": 376, - "lineto": 464, + "line": 383, + "lineto": 471, "block": "unsigned int version\nuint32_t flags\ngit_submodule_ignore_t ignore_submodules\ngit_strarray pathspec\ngit_diff_notify_cb notify_cb\ngit_diff_progress_cb progress_cb\nvoid * payload\nuint32_t context_lines\nuint32_t interhunk_lines\ngit_oid_t oid_type\nuint16_t id_abbrev\ngit_off_t max_size\nconst char * old_prefix\nconst char * new_prefix", "tdef": "typedef", "description": " Structure describing options about how the diff should be executed.", @@ -28354,8 +28815,8 @@ "type": "struct", "value": "git_diff_parse_options", "file": "git2/diff.h", - "line": 1294, - "lineto": 1297, + "line": 1322, + "lineto": 1325, "block": "unsigned int version\ngit_oid_t oid_type", "tdef": "typedef", "description": " Options for parsing a diff / patch file.", @@ -28374,8 +28835,8 @@ "type": "struct", "value": "git_diff_patchid_options", "file": "git2/diff.h", - "line": 1431, - "lineto": 1433, + "line": 1459, + "lineto": 1461, "block": "unsigned int version", "tdef": "typedef", "description": " Patch ID options structure", @@ -28402,8 +28863,8 @@ "type": "struct", "value": "git_diff_similarity_metric", "file": "git2/diff.h", - "line": 732, - "lineto": 742, + "line": 757, + "lineto": 767, "block": "int (*)(void **, const git_diff_file *, const char *, void *) file_signature\nint (*)(void **, const git_diff_file *, const char *, size_t, void *) buffer_signature\nvoid (*)(void *, void *) free_signature\nint (*)(int *, void *, void *, void *) similarity\nvoid * payload", "tdef": "typedef", "description": " Pluggable similarity metric", @@ -28441,8 +28902,8 @@ "type": "struct", "value": "git_diff_stats", "file": "git2/diff.h", - "line": 1341, - "lineto": 1341, + "line": 1369, + "lineto": 1369, "tdef": "typedef", "description": " This is an opaque structure which is allocated by `git_diff_get_stats`.\n You are responsible for releasing the object memory when done, using the\n `git_diff_stats_free()` function.", "comments": "", @@ -28471,8 +28932,8 @@ ], "type": "enum", "file": "git2/diff.h", - "line": 1346, - "lineto": 1361, + "line": 1374, + "lineto": 1389, "block": "GIT_DIFF_STATS_NONE\nGIT_DIFF_STATS_FULL\nGIT_DIFF_STATS_SHORT\nGIT_DIFF_STATS_NUMBER\nGIT_DIFF_STATS_INCLUDE_SUMMARY", "tdef": "typedef", "description": " Formatting options for diff stats", @@ -28518,8 +28979,8 @@ "decl": ["GIT_DIRECTION_FETCH", "GIT_DIRECTION_PUSH"], "type": "enum", "file": "git2/net.h", - "line": 31, - "lineto": 34, + "line": 32, + "lineto": 35, "block": "GIT_DIRECTION_FETCH\nGIT_DIRECTION_PUSH", "tdef": "typedef", "description": " Direction of the connection.", @@ -28644,13 +29105,7 @@ "comments": " The \"re-roll\" number. By default, there is no re-roll. " } ], - "used": { - "returns": [], - "needs": [ - "git_email_create_from_commit", - "git_email_create_from_diff" - ] - } + "used": { "returns": [], "needs": ["git_email_create_from_commit"] } } ], [ @@ -28660,15 +29115,23 @@ "type": "struct", "value": "git_error", "file": "git2/errors.h", - "line": 74, - "lineto": 77, + "line": 125, + "lineto": 128, "block": "char * message\nint klass", "tdef": "typedef", "description": " Structure to store extra details of the last error that occurred.", "comments": "This is kept on a per-thread basis if GIT_THREADS was defined when the library was build, otherwise one is kept globally for the library
\n", "fields": [ - { "type": "char *", "name": "message", "comments": "" }, - { "type": "int", "name": "klass", "comments": "" } + { + "type": "char *", + "name": "message", + "comments": " The error message for the last error. " + }, + { + "type": "int", + "name": "klass", + "comments": " The category of the last error. \n\n git_error_t " + } ], "used": { "returns": ["git_error_last", "giterr_last"], "needs": [] } } @@ -28716,7 +29179,7 @@ "type": "enum", "file": "git2/errors.h", "line": 21, - "lineto": 66, + "lineto": 73, "block": "GIT_OK\nGIT_ERROR\nGIT_ENOTFOUND\nGIT_EEXISTS\nGIT_EAMBIGUOUS\nGIT_EBUFS\nGIT_EUSER\nGIT_EBAREREPO\nGIT_EUNBORNBRANCH\nGIT_EUNMERGED\nGIT_ENONFASTFORWARD\nGIT_EINVALIDSPEC\nGIT_ECONFLICT\nGIT_ELOCKED\nGIT_EMODIFIED\nGIT_EAUTH\nGIT_ECERTIFICATE\nGIT_EAPPLIED\nGIT_EPEEL\nGIT_EEOF\nGIT_EINVALID\nGIT_EUNCOMMITTED\nGIT_EDIRECTORY\nGIT_EMERGECONFLICT\nGIT_PASSTHROUGH\nGIT_ITEROVER\nGIT_RETRY\nGIT_EMISMATCH\nGIT_EINDEXDIRTY\nGIT_EAPPLYFAIL\nGIT_EOWNER\nGIT_TIMEOUT\nGIT_EUNCHANGED\nGIT_ENOTSUPPORTED\nGIT_EREADONLY", "tdef": "typedef", "description": " Generic return codes ", @@ -28725,37 +29188,37 @@ { "type": "int", "name": "GIT_OK", - "comments": "No error
\n", + "comments": "No error occurred; the call was successful.
\n", "value": 0 }, { "type": "int", "name": "GIT_ERROR", - "comments": "Generic error
\n", + "comments": "An error occurred; call git_error_last for more information.
Requested object could not be found
\n", + "comments": "Requested object could not be found.
\n", "value": -3 }, { "type": "int", "name": "GIT_EEXISTS", - "comments": "Object exists preventing operation
\n", + "comments": "Object exists preventing operation.
\n", "value": -4 }, { "type": "int", "name": "GIT_EAMBIGUOUS", - "comments": "More than one object matches
\n", + "comments": "More than one object matches.
\n", "value": -5 }, { "type": "int", "name": "GIT_EBUFS", - "comments": "Output buffer too short to hold data
\n", + "comments": "Output buffer too short to hold data.
\n", "value": -6 }, { @@ -28767,13 +29230,13 @@ { "type": "int", "name": "GIT_EBAREREPO", - "comments": "Operation not allowed on bare repository
\n", + "comments": "Operation not allowed on bare repository.
\n", "value": -8 }, { "type": "int", "name": "GIT_EUNBORNBRANCH", - "comments": "HEAD refers to branch with no commits
\n", + "comments": "HEAD refers to branch with no commits.
\n", "value": -9 }, { @@ -28980,11 +29443,11 @@ ], "type": "enum", "file": "git2/errors.h", - "line": 80, - "lineto": 118, + "line": 79, + "lineto": 117, "block": "GIT_ERROR_NONE\nGIT_ERROR_NOMEMORY\nGIT_ERROR_OS\nGIT_ERROR_INVALID\nGIT_ERROR_REFERENCE\nGIT_ERROR_ZLIB\nGIT_ERROR_REPOSITORY\nGIT_ERROR_CONFIG\nGIT_ERROR_REGEX\nGIT_ERROR_ODB\nGIT_ERROR_INDEX\nGIT_ERROR_OBJECT\nGIT_ERROR_NET\nGIT_ERROR_TAG\nGIT_ERROR_TREE\nGIT_ERROR_INDEXER\nGIT_ERROR_SSL\nGIT_ERROR_SUBMODULE\nGIT_ERROR_THREAD\nGIT_ERROR_STASH\nGIT_ERROR_CHECKOUT\nGIT_ERROR_FETCHHEAD\nGIT_ERROR_MERGE\nGIT_ERROR_SSH\nGIT_ERROR_FILTER\nGIT_ERROR_REVERT\nGIT_ERROR_CALLBACK\nGIT_ERROR_CHERRYPICK\nGIT_ERROR_DESCRIBE\nGIT_ERROR_REBASE\nGIT_ERROR_FILESYSTEM\nGIT_ERROR_PATCH\nGIT_ERROR_WORKTREE\nGIT_ERROR_SHA\nGIT_ERROR_HTTP\nGIT_ERROR_INTERNAL\nGIT_ERROR_GRAFTS", "tdef": "typedef", - "description": " Error classes ", + "description": " Error classes are the category of error. They reflect the area of the\n code where an error occurred.", "comments": "", "fields": [ { @@ -29215,43 +29678,99 @@ "GIT_FEATURE_THREADS", "GIT_FEATURE_HTTPS", "GIT_FEATURE_SSH", - "GIT_FEATURE_NSEC" + "GIT_FEATURE_NSEC", + "GIT_FEATURE_HTTP_PARSER", + "GIT_FEATURE_REGEX", + "GIT_FEATURE_I18N", + "GIT_FEATURE_AUTH_NTLM", + "GIT_FEATURE_AUTH_NEGOTIATE", + "GIT_FEATURE_COMPRESSION", + "GIT_FEATURE_SHA1", + "GIT_FEATURE_SHA256" ], "type": "enum", "file": "git2/common.h", - "line": 134, - "lineto": 157, - "block": "GIT_FEATURE_THREADS\nGIT_FEATURE_HTTPS\nGIT_FEATURE_SSH\nGIT_FEATURE_NSEC", + "line": 138, + "lineto": 177, + "block": "GIT_FEATURE_THREADS\nGIT_FEATURE_HTTPS\nGIT_FEATURE_SSH\nGIT_FEATURE_NSEC\nGIT_FEATURE_HTTP_PARSER\nGIT_FEATURE_REGEX\nGIT_FEATURE_I18N\nGIT_FEATURE_AUTH_NTLM\nGIT_FEATURE_AUTH_NEGOTIATE\nGIT_FEATURE_COMPRESSION\nGIT_FEATURE_SHA1\nGIT_FEATURE_SHA256", "tdef": "typedef", - "description": " Combinations of these values describe the features with which libgit2\n was compiled", + "description": " Configurable features of libgit2; either optional settings (like\n threading), or features that can be enabled by one of a number of\n different backend \"providers\" (like HTTPS, which can be provided by\n OpenSSL, mbedTLS, or system libraries).", "comments": "", "fields": [ { "type": "int", "name": "GIT_FEATURE_THREADS", - "comments": "If set, libgit2 was built thread-aware and can be safely used from multiple\n threads.
\n", + "comments": "libgit2 is thread-aware and can be used from multiple threads\n (as described in the documentation).
\n", "value": 1 }, { "type": "int", "name": "GIT_FEATURE_HTTPS", - "comments": "If set, libgit2 was built with and linked against a TLS implementation.\n Custom TLS streams may still be added by the user to support HTTPS\n regardless of this.
\n", + "comments": "HTTPS remotes
\n", "value": 2 }, { "type": "int", "name": "GIT_FEATURE_SSH", - "comments": "If set, libgit2 was built with and linked against libssh2. A custom\n transport may still be added by the user to support libssh2 regardless of\n this.
\n", + "comments": "SSH remotes
\n", "value": 4 }, { "type": "int", "name": "GIT_FEATURE_NSEC", - "comments": "If set, libgit2 was built with support for sub-second resolution in file\n modification times.
\n", + "comments": "Sub-second resolution in index timestamps
\n", "value": 8 + }, + { + "type": "int", + "name": "GIT_FEATURE_HTTP_PARSER", + "comments": "HTTP parsing; always available
\n", + "value": 16 + }, + { + "type": "int", + "name": "GIT_FEATURE_REGEX", + "comments": "Regular expression support; always available
\n", + "value": 32 + }, + { + "type": "int", + "name": "GIT_FEATURE_I18N", + "comments": "Internationalization support for filename translation
\n", + "value": 64 + }, + { + "type": "int", + "name": "GIT_FEATURE_AUTH_NTLM", + "comments": "NTLM support over HTTPS
\n", + "value": 128 + }, + { + "type": "int", + "name": "GIT_FEATURE_AUTH_NEGOTIATE", + "comments": "Kerberos (SPNEGO) authentication support over HTTPS
\n", + "value": 256 + }, + { + "type": "int", + "name": "GIT_FEATURE_COMPRESSION", + "comments": "zlib support; always available
\n", + "value": 512 + }, + { + "type": "int", + "name": "GIT_FEATURE_SHA1", + "comments": "SHA1 object support; always available
\n", + "value": 1024 + }, + { + "type": "int", + "name": "GIT_FEATURE_SHA256", + "comments": "SHA256 object support
\n", + "value": 2048 } ], - "used": { "returns": [], "needs": [] } + "used": { "returns": [], "needs": ["git_libgit2_feature_backend"] } } ], [ @@ -29260,8 +29779,8 @@ "decl": ["GIT_FETCH_DEPTH_FULL", "GIT_FETCH_DEPTH_UNSHALLOW"], "type": "enum", "file": "git2/remote.h", - "line": 717, - "lineto": 723, + "line": 760, + "lineto": 766, "block": "GIT_FETCH_DEPTH_FULL\nGIT_FETCH_DEPTH_UNSHALLOW", "tdef": "typedef", "description": " Constants for fetch depth (shallowness of fetch). ", @@ -29300,8 +29819,8 @@ "type": "struct", "value": "git_fetch_options", "file": "git2/remote.h", - "line": 733, - "lineto": 785, + "line": 776, + "lineto": 828, "block": "int version\ngit_remote_callbacks callbacks\ngit_fetch_prune_t prune\nunsigned int update_fetchhead\ngit_remote_autotag_option_t download_tags\ngit_proxy_options proxy_opts\nint depth\ngit_remote_redirect_t follow_redirects\ngit_strarray custom_headers", "tdef": "typedef", "description": " Fetch options structure.", @@ -29369,8 +29888,8 @@ ], "type": "enum", "file": "git2/remote.h", - "line": 676, - "lineto": 689, + "line": 719, + "lineto": 732, "block": "GIT_FETCH_PRUNE_UNSPECIFIED\nGIT_FETCH_PRUNE\nGIT_FETCH_NO_PRUNE", "tdef": "typedef", "description": " Acceptable prune settings when fetching ", @@ -29411,8 +29930,8 @@ ], "type": "enum", "file": "git2/types.h", - "line": 222, - "lineto": 229, + "line": 238, + "lineto": 245, "block": "GIT_FILEMODE_UNREADABLE\nGIT_FILEMODE_TREE\nGIT_FILEMODE_BLOB\nGIT_FILEMODE_BLOB_EXECUTABLE\nGIT_FILEMODE_LINK\nGIT_FILEMODE_COMMIT", "tdef": "typedef", "description": " Valid modes for index and tree entries. ", @@ -29468,8 +29987,8 @@ "type": "struct", "value": "git_filter", "file": "git2/filter.h", - "line": 100, - "lineto": 100, + "line": 109, + "lineto": 109, "tdef": "typedef", "description": " A filter that can transform file data", "comments": "This represents a filter that can be used to transform or even replace file data. Libgit2 includes one built in filter and it is possible to write your own (see git2/sys/filter.h for information on that).
\n\nThe two builtin filters are:
\n\nThis represents a list of filters to be applied to a file / blob. You can build the list with one call, apply it with another, and dispose it with a third. In typical usage, there are not many occasions where a git_filter_list is needed directly since the library will generally handle conversions for you, but it can be convenient to be able to build and apply the list sometimes.
\n", @@ -29587,8 +30106,8 @@ ], "type": "enum", "file": "git2/filter.h", - "line": 31, - "lineto": 36, + "line": 37, + "lineto": 42, "block": "GIT_FILTER_TO_WORKTREE\nGIT_FILTER_SMUDGE\nGIT_FILTER_TO_ODB\nGIT_FILTER_CLEAN", "tdef": "typedef", "description": " Filters are applied in one of two directions: smudging - which is\n exporting a file from the Git object database to the working directory,\n and cleaning - which is importing a file from the working directory to\n the Git object database. These values control which direction of\n change is being applied.", @@ -29637,8 +30156,8 @@ "type": "struct", "value": "git_filter_options", "file": "git2/filter.h", - "line": 63, - "lineto": 80, + "line": 69, + "lineto": 86, "block": "unsigned int version\nuint32_t flags\ngit_oid * commit_id\ngit_oid attr_commit_id", "tdef": "typedef", "description": " Filtering options", @@ -29667,8 +30186,8 @@ "type": "struct", "value": "git_filter_source", "file": "git2/sys/filter.h", - "line": 95, - "lineto": 95, + "line": 109, + "lineto": 109, "tdef": "typedef", "description": " A filter source represents a file/blob to be processed", "comments": "", @@ -29686,8 +30205,8 @@ ], "type": "enum", "file": "git2/sys/hashsig.h", - "line": 25, - "lineto": 45, + "line": 35, + "lineto": 55, "block": "GIT_HASHSIG_NORMAL\nGIT_HASHSIG_IGNORE_WHITESPACE\nGIT_HASHSIG_SMART_WHITESPACE\nGIT_HASHSIG_ALLOW_SMALL_FILES", "tdef": "typedef", "description": " Options for hashsig computation", @@ -29728,8 +30247,8 @@ "type": "struct", "value": "git_index", "file": "git2/types.h", - "line": 148, - "lineto": 148, + "line": 153, + "lineto": 153, "tdef": "typedef", "description": " Memory representation of an index file. ", "comments": "", @@ -29772,6 +30291,8 @@ "git_index_iterator_free", "git_index_iterator_new", "git_index_iterator_next", + "git_index_new", + "git_index_open", "git_index_owner", "git_index_path", "git_index_read", @@ -29819,8 +30340,8 @@ ], "type": "enum", "file": "git2/index.h", - "line": 139, - "lineto": 144, + "line": 162, + "lineto": 167, "block": "GIT_INDEX_ADD_DEFAULT\nGIT_INDEX_ADD_FORCE\nGIT_INDEX_ADD_DISABLE_PATHSPEC_MATCH\nGIT_INDEX_ADD_CHECK_PATHSPEC", "tdef": "typedef", "description": " Flags for APIs that add files matching pathspec ", @@ -29865,8 +30386,8 @@ ], "type": "enum", "file": "git2/index.h", - "line": 126, - "lineto": 131, + "line": 142, + "lineto": 147, "block": "GIT_INDEX_CAPABILITY_IGNORE_CASE\nGIT_INDEX_CAPABILITY_NO_FILEMODE\nGIT_INDEX_CAPABILITY_NO_SYMLINKS\nGIT_INDEX_CAPABILITY_FROM_OWNER", "tdef": "typedef", "description": " Capabilities of system that affect index actions. ", @@ -29907,8 +30428,8 @@ "type": "struct", "value": "git_index_conflict_iterator", "file": "git2/types.h", - "line": 154, - "lineto": 154, + "line": 159, + "lineto": 159, "tdef": "typedef", "description": " An iterator for conflicts in the index. ", "comments": "", @@ -29942,8 +30463,8 @@ "type": "struct", "value": "git_index_entry", "file": "git2/index.h", - "line": 53, - "lineto": 70, + "line": 58, + "lineto": 75, "block": "git_index_time ctime\ngit_index_time mtime\nuint32_t dev\nuint32_t ino\nuint32_t mode\nuint32_t uid\nuint32_t gid\nuint32_t file_size\ngit_oid id\nuint16_t flags\nuint16_t flags_extended\nconst char * path", "tdef": "typedef", "description": " In-memory representation of a file entry in the index.", @@ -29989,8 +30510,8 @@ ], "type": "enum", "file": "git2/index.h", - "line": 116, - "lineto": 123, + "line": 132, + "lineto": 139, "block": "GIT_INDEX_ENTRY_INTENT_TO_ADD\nGIT_INDEX_ENTRY_SKIP_WORKTREE\nGIT_INDEX_ENTRY_EXTENDED_FLAGS\nGIT_INDEX_ENTRY_UPTODATE", "tdef": "typedef", "description": " Bitmasks for on-disk fields of `git_index_entry`'s `flags_extended`", @@ -30030,8 +30551,8 @@ "decl": ["GIT_INDEX_ENTRY_EXTENDED", "GIT_INDEX_ENTRY_VALID"], "type": "enum", "file": "git2/index.h", - "line": 87, - "lineto": 90, + "line": 95, + "lineto": 98, "block": "GIT_INDEX_ENTRY_EXTENDED\nGIT_INDEX_ENTRY_VALID", "tdef": "typedef", "description": " Flags for index entries", @@ -30060,8 +30581,8 @@ "type": "struct", "value": "git_index_iterator", "file": "git2/types.h", - "line": 151, - "lineto": 151, + "line": 156, + "lineto": 156, "tdef": "typedef", "description": " An iterator for entries in the index. ", "comments": "", @@ -30087,8 +30608,8 @@ ], "type": "enum", "file": "git2/index.h", - "line": 147, - "lineto": 167, + "line": 170, + "lineto": 190, "block": "GIT_INDEX_STAGE_ANY\nGIT_INDEX_STAGE_NORMAL\nGIT_INDEX_STAGE_ANCESTOR\nGIT_INDEX_STAGE_OURS\nGIT_INDEX_STAGE_THEIRS", "tdef": "typedef", "description": " Git index stage states ", @@ -30135,8 +30656,8 @@ "type": "struct", "value": "git_index_time", "file": "git2/index.h", - "line": 26, - "lineto": 30, + "line": 31, + "lineto": 35, "block": "int32_t seconds\nuint32_t nanoseconds", "tdef": "typedef", "description": " Time structure used in a git index entry ", @@ -30155,8 +30676,8 @@ "type": "struct", "value": "git_indexer", "file": "git2/indexer.h", - "line": 17, - "lineto": 17, + "line": 27, + "lineto": 27, "tdef": "typedef", "description": " A git indexer object ", "comments": "", @@ -30189,8 +30710,8 @@ "type": "struct", "value": "git_indexer_options", "file": "git2/indexer.h", - "line": 62, - "lineto": 86, + "line": 73, + "lineto": 100, "block": "unsigned int version\ngit_indexer_progress_cb progress_cb\nvoid * progress_cb_payload\nunsigned char verify", "tdef": "typedef", "description": " Options for indexer configuration", @@ -30234,8 +30755,8 @@ "type": "struct", "value": "git_indexer_progress", "file": "git2/indexer.h", - "line": 24, - "lineto": 48, + "line": 34, + "lineto": 58, "block": "unsigned int total_objects\nunsigned int indexed_objects\nunsigned int received_objects\nunsigned int local_objects\nunsigned int total_deltas\nunsigned int indexed_deltas\nsize_t received_bytes", "tdef": "typedef", "description": " This structure is used to provide callers information about the\n progress of indexing a packfile, either directly or part of a\n fetch or clone that downloads a packfile.", @@ -30337,13 +30858,14 @@ "GIT_OPT_SET_SERVER_TIMEOUT", "GIT_OPT_GET_SERVER_TIMEOUT", "GIT_OPT_SET_USER_AGENT_PRODUCT", - "GIT_OPT_GET_USER_AGENT_PRODUCT" + "GIT_OPT_GET_USER_AGENT_PRODUCT", + "GIT_OPT_ADD_SSL_X509_CERT" ], "type": "enum", "file": "git2/common.h", - "line": 188, - "lineto": 234, - "block": "GIT_OPT_GET_MWINDOW_SIZE\nGIT_OPT_SET_MWINDOW_SIZE\nGIT_OPT_GET_MWINDOW_MAPPED_LIMIT\nGIT_OPT_SET_MWINDOW_MAPPED_LIMIT\nGIT_OPT_GET_SEARCH_PATH\nGIT_OPT_SET_SEARCH_PATH\nGIT_OPT_SET_CACHE_OBJECT_LIMIT\nGIT_OPT_SET_CACHE_MAX_SIZE\nGIT_OPT_ENABLE_CACHING\nGIT_OPT_GET_CACHED_MEMORY\nGIT_OPT_GET_TEMPLATE_PATH\nGIT_OPT_SET_TEMPLATE_PATH\nGIT_OPT_SET_SSL_CERT_LOCATIONS\nGIT_OPT_SET_USER_AGENT\nGIT_OPT_ENABLE_STRICT_OBJECT_CREATION\nGIT_OPT_ENABLE_STRICT_SYMBOLIC_REF_CREATION\nGIT_OPT_SET_SSL_CIPHERS\nGIT_OPT_GET_USER_AGENT\nGIT_OPT_ENABLE_OFS_DELTA\nGIT_OPT_ENABLE_FSYNC_GITDIR\nGIT_OPT_GET_WINDOWS_SHAREMODE\nGIT_OPT_SET_WINDOWS_SHAREMODE\nGIT_OPT_ENABLE_STRICT_HASH_VERIFICATION\nGIT_OPT_SET_ALLOCATOR\nGIT_OPT_ENABLE_UNSAVED_INDEX_SAFETY\nGIT_OPT_GET_PACK_MAX_OBJECTS\nGIT_OPT_SET_PACK_MAX_OBJECTS\nGIT_OPT_DISABLE_PACK_KEEP_FILE_CHECKS\nGIT_OPT_ENABLE_HTTP_EXPECT_CONTINUE\nGIT_OPT_GET_MWINDOW_FILE_LIMIT\nGIT_OPT_SET_MWINDOW_FILE_LIMIT\nGIT_OPT_SET_ODB_PACKED_PRIORITY\nGIT_OPT_SET_ODB_LOOSE_PRIORITY\nGIT_OPT_GET_EXTENSIONS\nGIT_OPT_SET_EXTENSIONS\nGIT_OPT_GET_OWNER_VALIDATION\nGIT_OPT_SET_OWNER_VALIDATION\nGIT_OPT_GET_HOMEDIR\nGIT_OPT_SET_HOMEDIR\nGIT_OPT_SET_SERVER_CONNECT_TIMEOUT\nGIT_OPT_GET_SERVER_CONNECT_TIMEOUT\nGIT_OPT_SET_SERVER_TIMEOUT\nGIT_OPT_GET_SERVER_TIMEOUT\nGIT_OPT_SET_USER_AGENT_PRODUCT\nGIT_OPT_GET_USER_AGENT_PRODUCT", + "line": 214, + "lineto": 261, + "block": "GIT_OPT_GET_MWINDOW_SIZE\nGIT_OPT_SET_MWINDOW_SIZE\nGIT_OPT_GET_MWINDOW_MAPPED_LIMIT\nGIT_OPT_SET_MWINDOW_MAPPED_LIMIT\nGIT_OPT_GET_SEARCH_PATH\nGIT_OPT_SET_SEARCH_PATH\nGIT_OPT_SET_CACHE_OBJECT_LIMIT\nGIT_OPT_SET_CACHE_MAX_SIZE\nGIT_OPT_ENABLE_CACHING\nGIT_OPT_GET_CACHED_MEMORY\nGIT_OPT_GET_TEMPLATE_PATH\nGIT_OPT_SET_TEMPLATE_PATH\nGIT_OPT_SET_SSL_CERT_LOCATIONS\nGIT_OPT_SET_USER_AGENT\nGIT_OPT_ENABLE_STRICT_OBJECT_CREATION\nGIT_OPT_ENABLE_STRICT_SYMBOLIC_REF_CREATION\nGIT_OPT_SET_SSL_CIPHERS\nGIT_OPT_GET_USER_AGENT\nGIT_OPT_ENABLE_OFS_DELTA\nGIT_OPT_ENABLE_FSYNC_GITDIR\nGIT_OPT_GET_WINDOWS_SHAREMODE\nGIT_OPT_SET_WINDOWS_SHAREMODE\nGIT_OPT_ENABLE_STRICT_HASH_VERIFICATION\nGIT_OPT_SET_ALLOCATOR\nGIT_OPT_ENABLE_UNSAVED_INDEX_SAFETY\nGIT_OPT_GET_PACK_MAX_OBJECTS\nGIT_OPT_SET_PACK_MAX_OBJECTS\nGIT_OPT_DISABLE_PACK_KEEP_FILE_CHECKS\nGIT_OPT_ENABLE_HTTP_EXPECT_CONTINUE\nGIT_OPT_GET_MWINDOW_FILE_LIMIT\nGIT_OPT_SET_MWINDOW_FILE_LIMIT\nGIT_OPT_SET_ODB_PACKED_PRIORITY\nGIT_OPT_SET_ODB_LOOSE_PRIORITY\nGIT_OPT_GET_EXTENSIONS\nGIT_OPT_SET_EXTENSIONS\nGIT_OPT_GET_OWNER_VALIDATION\nGIT_OPT_SET_OWNER_VALIDATION\nGIT_OPT_GET_HOMEDIR\nGIT_OPT_SET_HOMEDIR\nGIT_OPT_SET_SERVER_CONNECT_TIMEOUT\nGIT_OPT_GET_SERVER_CONNECT_TIMEOUT\nGIT_OPT_SET_SERVER_TIMEOUT\nGIT_OPT_GET_SERVER_TIMEOUT\nGIT_OPT_SET_USER_AGENT_PRODUCT\nGIT_OPT_GET_USER_AGENT_PRODUCT\nGIT_OPT_ADD_SSL_X509_CERT", "tdef": "typedef", "description": " Global library options", "comments": "These are used to select which global option to set or get and are used in git_libgit2_opts().
Set the callbacks to be called by the remote when informing the user about the progress of the network operations.
\n", @@ -33318,6 +33841,11 @@ "type": "git_url_resolve_cb", "name": "resolve_url", "comments": " Resolve URL before connecting to remote.\n The returned URL will be used to connect to the remote instead.\n\n This callback is deprecated; users should use\n git_remote_ready_cb and configure the instance URL instead." + }, + { + "type": "int (*)(const char *, const git_oid *, const git_oid *, git_refspec *, void *)", + "name": "update_refs", + "comments": "" } ], "used": { @@ -33341,8 +33869,8 @@ ], "type": "enum", "file": "git2/remote.h", - "line": 463, - "lineto": 467, + "line": 466, + "lineto": 470, "block": "GIT_REMOTE_COMPLETION_DOWNLOAD\nGIT_REMOTE_COMPLETION_INDEXING\nGIT_REMOTE_COMPLETION_ERROR\nGIT_REMOTE_COMPLETION_DOWNLOAD\nGIT_REMOTE_COMPLETION_INDEXING\nGIT_REMOTE_COMPLETION_ERROR", "tdef": "typedef", "description": " Argument to the completion callback which tells it which operation\n finished.", @@ -33383,8 +33911,8 @@ "type": "struct", "value": "git_remote_connect_options", "file": "git2/remote.h", - "line": 879, - "lineto": 897, + "line": 928, + "lineto": 946, "block": "unsigned int version\ngit_remote_callbacks callbacks\ngit_proxy_options proxy_opts\ngit_remote_redirect_t follow_redirects\ngit_strarray custom_headers", "tdef": "typedef", "description": " Remote creation options structure", @@ -33514,8 +34042,8 @@ "type": "struct", "value": "git_remote_head", "file": "git2/net.h", - "line": 40, - "lineto": 50, + "line": 41, + "lineto": 51, "block": "int local\ngit_oid oid\ngit_oid loid\nchar * name\nchar * symref_target", "tdef": null, "description": " Description of a reference advertised by a remote server, given out\n on `ls` calls.", @@ -33612,8 +34140,8 @@ "type": "struct", "value": "git_repository", "file": "git2/types.h", - "line": 118, - "lineto": 118, + "line": 123, + "lineto": 123, "tdef": "typedef", "description": " Representation of an existing git repository,\n including all its object contents", "comments": "", @@ -33646,7 +34174,6 @@ "git_attr_get_ext", "git_attr_get_many", "git_attr_get_many_ext", - "git_blame_file", "git_blob_create_from_buffer", "git_blob_create_from_disk", "git_blob_create_from_stream", @@ -33707,15 +34234,6 @@ "git_merge_commits", "git_merge_file_from_index", "git_merge_trees", - "git_note_commit_create", - "git_note_commit_read", - "git_note_commit_remove", - "git_note_create", - "git_note_default_ref", - "git_note_foreach", - "git_note_iterator_new", - "git_note_read", - "git_note_remove", "git_object_lookup", "git_object_lookup_prefix", "git_packbuilder_new", @@ -33801,6 +34319,7 @@ "git_repository_state", "git_repository_state_cleanup", "git_repository_workdir", + "git_repository_wrap_odb", "git_reset", "git_reset_default", "git_reset_from_annotated", @@ -33811,6 +34330,7 @@ "git_revparse_single", "git_revwalk_new", "git_signature_default", + "git_signature_default_from_env", "git_stash_apply", "git_stash_drop", "git_stash_foreach", @@ -33873,8 +34393,8 @@ ], "type": "enum", "file": "git2/repository.h", - "line": 236, - "lineto": 282, + "line": 249, + "lineto": 295, "block": "GIT_REPOSITORY_INIT_BARE\nGIT_REPOSITORY_INIT_NO_REINIT\nGIT_REPOSITORY_INIT_NO_DOTGIT_DIR\nGIT_REPOSITORY_INIT_MKDIR\nGIT_REPOSITORY_INIT_MKPATH\nGIT_REPOSITORY_INIT_EXTERNAL_TEMPLATE\nGIT_REPOSITORY_INIT_RELATIVE_GITLINK", "tdef": "typedef", "description": " Option flags for `git_repository_init_ext`.", @@ -33936,8 +34456,8 @@ ], "type": "enum", "file": "git2/repository.h", - "line": 291, - "lineto": 307, + "line": 304, + "lineto": 320, "block": "GIT_REPOSITORY_INIT_SHARED_UMASK\nGIT_REPOSITORY_INIT_SHARED_GROUP\nGIT_REPOSITORY_INIT_SHARED_ALL", "tdef": "typedef", "description": " Mode options for `git_repository_init_ext`.", @@ -33981,8 +34501,8 @@ "type": "struct", "value": "git_repository_init_options", "file": "git2/repository.h", - "line": 315, - "lineto": 374, + "line": 328, + "lineto": 387, "block": "unsigned int version\nuint32_t flags\nuint32_t mode\nconst char * workdir_path\nconst char * description\nconst char * template_path\nconst char * initial_head\nconst char * origin_url", "tdef": "typedef", "description": " Extended options structure for `git_repository_init_ext`.", @@ -34057,8 +34577,8 @@ ], "type": "enum", "file": "git2/repository.h", - "line": 492, - "lineto": 509, + "line": 512, + "lineto": 529, "block": "GIT_REPOSITORY_ITEM_GITDIR\nGIT_REPOSITORY_ITEM_WORKDIR\nGIT_REPOSITORY_ITEM_COMMONDIR\nGIT_REPOSITORY_ITEM_INDEX\nGIT_REPOSITORY_ITEM_OBJECTS\nGIT_REPOSITORY_ITEM_REFS\nGIT_REPOSITORY_ITEM_PACKED_REFS\nGIT_REPOSITORY_ITEM_REMOTES\nGIT_REPOSITORY_ITEM_CONFIG\nGIT_REPOSITORY_ITEM_INFO\nGIT_REPOSITORY_ITEM_HOOKS\nGIT_REPOSITORY_ITEM_LOGS\nGIT_REPOSITORY_ITEM_MODULES\nGIT_REPOSITORY_ITEM_WORKTREES\nGIT_REPOSITORY_ITEM_WORKTREE_CONFIG\nGIT_REPOSITORY_ITEM__LAST", "tdef": "typedef", "description": " List of items which belong to the git repository layout", @@ -34176,8 +34696,8 @@ ], "type": "enum", "file": "git2/repository.h", - "line": 109, - "lineto": 156, + "line": 110, + "lineto": 157, "block": "GIT_REPOSITORY_OPEN_NO_SEARCH\nGIT_REPOSITORY_OPEN_CROSS_FS\nGIT_REPOSITORY_OPEN_BARE\nGIT_REPOSITORY_OPEN_NO_DOTGIT\nGIT_REPOSITORY_OPEN_FROM_ENV", "tdef": "typedef", "description": " Option flags for `git_repository_open_ext`.", @@ -34236,8 +34756,8 @@ ], "type": "enum", "file": "git2/repository.h", - "line": 893, - "lineto": 906, + "line": 915, + "lineto": 928, "block": "GIT_REPOSITORY_STATE_NONE\nGIT_REPOSITORY_STATE_MERGE\nGIT_REPOSITORY_STATE_REVERT\nGIT_REPOSITORY_STATE_REVERT_SEQUENCE\nGIT_REPOSITORY_STATE_CHERRYPICK\nGIT_REPOSITORY_STATE_CHERRYPICK_SEQUENCE\nGIT_REPOSITORY_STATE_BISECT\nGIT_REPOSITORY_STATE_REBASE\nGIT_REPOSITORY_STATE_REBASE_INTERACTIVE\nGIT_REPOSITORY_STATE_REBASE_MERGE\nGIT_REPOSITORY_STATE_APPLY_MAILBOX\nGIT_REPOSITORY_STATE_APPLY_MAILBOX_OR_REBASE", "tdef": "typedef", "description": " Repository state", @@ -34478,8 +34998,8 @@ "type": "struct", "value": "git_revwalk", "file": "git2/types.h", - "line": 127, - "lineto": 127, + "line": 132, + "lineto": 132, "tdef": "typedef", "description": " Representation of an in-progress walk through the commits in a repo ", "comments": "", @@ -34515,8 +35035,8 @@ "type": "struct", "value": "git_signature", "file": "git2/types.h", - "line": 182, - "lineto": 186, + "line": 187, + "lineto": 191, "block": "char * name\nchar * email\ngit_time when", "tdef": "typedef", "description": " An action signature (e.g. for committers, taggers, etc) ", @@ -34542,8 +35062,6 @@ "returns": [ "git_commit_author", "git_commit_committer", - "git_note_author", - "git_note_committer", "git_reflog_entry_committer", "git_tag_tagger" ], @@ -34555,16 +35073,12 @@ "git_commit_create_buffer", "git_commit_create_cb", "git_commit_create_v", - "git_email_create_from_diff", "git_mailmap_resolve_signature", - "git_note_commit_create", - "git_note_commit_remove", - "git_note_create", - "git_note_remove", "git_rebase_commit", "git_rebase_finish", "git_reflog_append", "git_signature_default", + "git_signature_default_from_env", "git_signature_dup", "git_signature_free", "git_signature_from_buffer", @@ -34590,8 +35104,8 @@ ], "type": "enum", "file": "git2/sys/transport.h", - "line": 313, - "lineto": 318, + "line": 323, + "lineto": 328, "block": "GIT_SERVICE_UPLOADPACK_LS\nGIT_SERVICE_UPLOADPACK\nGIT_SERVICE_RECEIVEPACK_LS\nGIT_SERVICE_RECEIVEPACK", "tdef": "typedef", "description": " Actions that the smart transport can ask a subtransport to perform ", @@ -34677,8 +35191,8 @@ "decl": ["GIT_STASH_APPLY_DEFAULT", "GIT_STASH_APPLY_REINSTATE_INDEX"], "type": "enum", "file": "git2/stash.h", - "line": 129, - "lineto": 136, + "line": 137, + "lineto": 144, "block": "GIT_STASH_APPLY_DEFAULT\nGIT_STASH_APPLY_REINSTATE_INDEX", "tdef": "typedef", "description": " Stash application flags. ", @@ -34713,8 +35227,8 @@ "type": "struct", "value": "git_stash_apply_options", "file": "git2/stash.h", - "line": 180, - "lineto": 192, + "line": 192, + "lineto": 204, "block": "unsigned int version\nuint32_t flags\ngit_checkout_options checkout_options\ngit_stash_apply_progress_cb progress_cb\nvoid * progress_payload", "tdef": "typedef", "description": " Stash application options structure", @@ -34763,8 +35277,8 @@ ], "type": "enum", "file": "git2/stash.h", - "line": 139, - "lineto": 162, + "line": 147, + "lineto": 170, "block": "GIT_STASH_APPLY_PROGRESS_NONE\nGIT_STASH_APPLY_PROGRESS_LOADING_STASH\nGIT_STASH_APPLY_PROGRESS_ANALYZE_INDEX\nGIT_STASH_APPLY_PROGRESS_ANALYZE_MODIFIED\nGIT_STASH_APPLY_PROGRESS_ANALYZE_UNTRACKED\nGIT_STASH_APPLY_PROGRESS_CHECKOUT_UNTRACKED\nGIT_STASH_APPLY_PROGRESS_CHECKOUT_MODIFIED\nGIT_STASH_APPLY_PROGRESS_DONE", "tdef": "typedef", "description": " Stash apply progression states ", @@ -34834,8 +35348,8 @@ ], "type": "enum", "file": "git2/stash.h", - "line": 25, - "lineto": 53, + "line": 30, + "lineto": 58, "block": "GIT_STASH_DEFAULT\nGIT_STASH_KEEP_INDEX\nGIT_STASH_INCLUDE_UNTRACKED\nGIT_STASH_INCLUDE_IGNORED\nGIT_STASH_KEEP_ALL", "tdef": "typedef", "description": " Stash flags", @@ -34888,8 +35402,8 @@ "type": "struct", "value": "git_stash_save_options", "file": "git2/stash.h", - "line": 81, - "lineto": 95, + "line": 86, + "lineto": 100, "block": "unsigned int version\nuint32_t flags\nconst git_signature * stasher\nconst char * message\ngit_strarray paths", "tdef": "typedef", "description": " Stash save options structure", @@ -34934,8 +35448,8 @@ "type": "struct", "value": "git_status_entry", "file": "git2/status.h", - "line": 295, - "lineto": 299, + "line": 298, + "lineto": 302, "block": "git_status_t status\ngit_diff_delta * head_to_index\ngit_diff_delta * index_to_workdir", "tdef": "typedef", "description": " A status entry, providing the differences between the file as it exists\n in HEAD and the index, and providing the differences between the index\n and the working directory.", @@ -34963,8 +35477,8 @@ "type": "struct", "value": "git_status_list", "file": "git2/types.h", - "line": 201, - "lineto": 201, + "line": 217, + "lineto": 217, "tdef": "typedef", "description": " Representation of a status collection ", "comments": "", @@ -35002,8 +35516,8 @@ ], "type": "enum", "file": "git2/status.h", - "line": 101, - "lineto": 208, + "line": 100, + "lineto": 207, "block": "GIT_STATUS_OPT_INCLUDE_UNTRACKED\nGIT_STATUS_OPT_INCLUDE_IGNORED\nGIT_STATUS_OPT_INCLUDE_UNMODIFIED\nGIT_STATUS_OPT_EXCLUDE_SUBMODULES\nGIT_STATUS_OPT_RECURSE_UNTRACKED_DIRS\nGIT_STATUS_OPT_DISABLE_PATHSPEC_MATCH\nGIT_STATUS_OPT_RECURSE_IGNORED_DIRS\nGIT_STATUS_OPT_RENAMES_HEAD_TO_INDEX\nGIT_STATUS_OPT_RENAMES_INDEX_TO_WORKDIR\nGIT_STATUS_OPT_SORT_CASE_SENSITIVELY\nGIT_STATUS_OPT_SORT_CASE_INSENSITIVELY\nGIT_STATUS_OPT_RENAMES_FROM_REWRITES\nGIT_STATUS_OPT_NO_REFRESH\nGIT_STATUS_OPT_UPDATE_INDEX\nGIT_STATUS_OPT_INCLUDE_UNREADABLE\nGIT_STATUS_OPT_INCLUDE_UNREADABLE_AS_UNTRACKED", "tdef": "typedef", "description": " Flags to control status callbacks", @@ -35181,8 +35695,8 @@ ], "type": "enum", "file": "git2/status.h", - "line": 73, - "lineto": 91, + "line": 72, + "lineto": 90, "block": "GIT_STATUS_SHOW_INDEX_AND_WORKDIR\nGIT_STATUS_SHOW_INDEX_ONLY\nGIT_STATUS_SHOW_WORKDIR_ONLY", "tdef": "typedef", "description": " Select the files on which to report status.", @@ -35377,8 +35891,8 @@ "decl": ["GIT_STREAM_STANDARD", "GIT_STREAM_TLS"], "type": "enum", "file": "git2/sys/stream.h", - "line": 91, - "lineto": 97, + "line": 99, + "lineto": 105, "block": "GIT_STREAM_STANDARD\nGIT_STREAM_TLS", "tdef": "typedef", "description": " The type of stream to register.", @@ -35407,8 +35921,8 @@ "type": "struct", "value": "git_submodule", "file": "git2/types.h", - "line": 267, - "lineto": 267, + "line": 283, + "lineto": 283, "tdef": "typedef", "description": " Opaque structure representing a submodule.", "comments": "", @@ -35467,8 +35981,8 @@ ], "type": "enum", "file": "git2/types.h", - "line": 331, - "lineto": 338, + "line": 347, + "lineto": 354, "block": "GIT_SUBMODULE_IGNORE_UNSPECIFIED\nGIT_SUBMODULE_IGNORE_NONE\nGIT_SUBMODULE_IGNORE_UNTRACKED\nGIT_SUBMODULE_IGNORE_DIRTY\nGIT_SUBMODULE_IGNORE_ALL", "tdef": "typedef", "description": " Submodule ignore values", @@ -35521,8 +36035,8 @@ ], "type": "enum", "file": "git2/types.h", - "line": 350, - "lineto": 354, + "line": 366, + "lineto": 370, "block": "GIT_SUBMODULE_RECURSE_NO\nGIT_SUBMODULE_RECURSE_YES\nGIT_SUBMODULE_RECURSE_ONDEMAND", "tdef": "typedef", "description": " Options for submodule recurse.", @@ -35681,8 +36195,8 @@ "type": "struct", "value": "git_submodule_update_options", "file": "git2/submodule.h", - "line": 128, - "lineto": 153, + "line": 135, + "lineto": 158, "block": "unsigned int version\ngit_checkout_options checkout_opts\ngit_fetch_options fetch_opts\nint allow_fetch", "tdef": "typedef", "description": " Submodule update options structure", @@ -35692,7 +36206,7 @@ { "type": "git_checkout_options", "name": "checkout_opts", - "comments": " These options are passed to the checkout step. To disable\n checkout, set the `checkout_strategy` to\n `GIT_CHECKOUT_NONE`. Generally you will want the use\n GIT_CHECKOUT_SAFE to update files in the working\n directory." + "comments": " These options are passed to the checkout step. To disable\n checkout, set the `checkout_strategy` to `GIT_CHECKOUT_NONE`\n or `GIT_CHECKOUT_DRY_RUN`." }, { "type": "git_fetch_options", @@ -35727,8 +36241,8 @@ ], "type": "enum", "file": "git2/types.h", - "line": 295, - "lineto": 302, + "line": 311, + "lineto": 318, "block": "GIT_SUBMODULE_UPDATE_CHECKOUT\nGIT_SUBMODULE_UPDATE_REBASE\nGIT_SUBMODULE_UPDATE_MERGE\nGIT_SUBMODULE_UPDATE_NONE\nGIT_SUBMODULE_UPDATE_DEFAULT", "tdef": "typedef", "description": " Submodule update values", @@ -35778,8 +36292,8 @@ "type": "struct", "value": "git_tag", "file": "git2/types.h", - "line": 130, - "lineto": 130, + "line": 135, + "lineto": 135, "tdef": "typedef", "description": " Parsed representation of a tag object. ", "comments": "", @@ -35811,8 +36325,8 @@ "type": "struct", "value": "git_time", "file": "git2/types.h", - "line": 175, - "lineto": 179, + "line": 180, + "lineto": 184, "block": "git_time_t time\nint offset\nchar sign", "tdef": "typedef", "description": " Time in a signature ", @@ -35914,8 +36428,8 @@ "type": "struct", "value": "git_transaction", "file": "git2/types.h", - "line": 195, - "lineto": 195, + "line": 200, + "lineto": 200, "tdef": "typedef", "description": " Transactional interface to references ", "comments": "", @@ -35942,8 +36456,8 @@ "type": "struct", "value": "git_transport", "file": "git2/types.h", - "line": 247, - "lineto": 247, + "line": 263, + "lineto": 263, "tdef": "typedef", "description": " Interface which represents a transport to communicate with a\n remote.", "comments": "", @@ -35957,8 +36471,8 @@ "type": "struct", "value": "git_tree", "file": "git2/types.h", - "line": 142, - "lineto": 142, + "line": 147, + "lineto": 147, "tdef": "typedef", "description": " Representation of a tree object. ", "comments": "", @@ -36029,8 +36543,8 @@ "type": "struct", "value": "git_tree_entry", "file": "git2/types.h", - "line": 139, - "lineto": 139, + "line": 144, + "lineto": 144, "tdef": "typedef", "description": " Representation of each one of the entries in a tree object. ", "comments": "", @@ -36071,8 +36585,8 @@ "type": "struct", "value": "git_tree_update", "file": "git2/tree.h", - "line": 438, - "lineto": 447, + "line": 449, + "lineto": 458, "block": "git_tree_update_t action\ngit_oid id\ngit_filemode_t filemode\nconst char * path", "tdef": "typedef", "description": " An action to perform during the update of a tree", @@ -36104,8 +36618,8 @@ "decl": ["GIT_TREE_UPDATE_UPSERT", "GIT_TREE_UPDATE_REMOVE"], "type": "enum", "file": "git2/tree.h", - "line": 428, - "lineto": 433, + "line": 439, + "lineto": 444, "block": "GIT_TREE_UPDATE_UPSERT\nGIT_TREE_UPDATE_REMOVE", "tdef": "typedef", "description": " The kind of update to perform", @@ -36134,8 +36648,8 @@ "type": "struct", "value": "git_treebuilder", "file": "git2/types.h", - "line": 145, - "lineto": 145, + "line": 150, + "lineto": 150, "tdef": "typedef", "description": " Constructor for in-memory trees ", "comments": "", @@ -36162,8 +36676,8 @@ "decl": ["GIT_TREEWALK_PRE", "GIT_TREEWALK_POST"], "type": "enum", "file": "git2/tree.h", - "line": 387, - "lineto": 390, + "line": 398, + "lineto": 401, "block": "GIT_TREEWALK_PRE\nGIT_TREEWALK_POST", "tdef": "typedef", "description": " Tree traversal modes ", @@ -36192,8 +36706,8 @@ "type": "struct", "value": "git_worktree", "file": "git2/types.h", - "line": 121, - "lineto": 121, + "line": 126, + "lineto": 126, "tdef": "typedef", "description": " Representation of a working tree ", "comments": "", @@ -36274,8 +36788,8 @@ "type": "struct", "value": "git_worktree_prune_options", "file": "git2/worktree.h", - "line": 207, - "lineto": 212, + "line": 210, + "lineto": 215, "block": "unsigned int version\nuint32_t flags", "tdef": "typedef", "description": " Worktree prune options structure", @@ -36308,8 +36822,8 @@ ], "type": "enum", "file": "git2/worktree.h", - "line": 191, - "lineto": 198, + "line": 194, + "lineto": 201, "block": "GIT_WORKTREE_PRUNE_VALID\nGIT_WORKTREE_PRUNE_LOCKED\nGIT_WORKTREE_PRUNE_WORKING_TREE", "tdef": "typedef", "description": " Flags which can be passed to git_worktree_prune to alter its\n behavior.", @@ -36348,8 +36862,8 @@ "type": "struct", "value": "git_writestream", "file": "git2/types.h", - "line": 359, - "lineto": 363, + "line": 375, + "lineto": 379, "tdef": null, "description": " A type to write in a streaming fashion, for example, for filters. ", "comments": "", @@ -36418,12 +36932,16 @@ "blame", [ "git_blame_buffer", - "git_blame_file", "git_blame_free", "git_blame_get_hunk_byindex", "git_blame_get_hunk_byline", "git_blame_get_hunk_count", + "git_blame_hunk_byindex", + "git_blame_hunk_byline", + "git_blame_hunkcount", "git_blame_init_options", + "git_blame_line_byindex", + "git_blame_linecount", "git_blame_options_init" ] ], @@ -36581,6 +37099,7 @@ "git_config_set_int64", "git_config_set_multivar", "git_config_set_string", + "git_config_set_writeorder", "git_config_snapshot" ] ], @@ -36651,7 +37170,7 @@ "git_diff_tree_to_workdir_with_index" ] ], - ["email", ["git_email_create_from_commit", "git_email_create_from_diff"]], + ["email", ["git_email_create_from_commit"]], ["error", ["git_error_last"]], ["fetch", ["git_fetch_options_init"]], [ @@ -36720,6 +37239,8 @@ "git_index_iterator_free", "git_index_iterator_new", "git_index_iterator_next", + "git_index_new", + "git_index_open", "git_index_owner", "git_index_path", "git_index_read", @@ -36752,6 +37273,7 @@ [ "libgit2", [ + "git_libgit2_feature_backend", "git_libgit2_features", "git_libgit2_init", "git_libgit2_opts", @@ -36801,28 +37323,7 @@ "git_message_trailers" ] ], - [ - "note", - [ - "git_note_author", - "git_note_commit_create", - "git_note_commit_iterator_new", - "git_note_commit_read", - "git_note_commit_remove", - "git_note_committer", - "git_note_create", - "git_note_default_ref", - "git_note_foreach", - "git_note_free", - "git_note_id", - "git_note_iterator_free", - "git_note_iterator_new", - "git_note_message", - "git_note_next", - "git_note_read", - "git_note_remove" - ] - ], + ["note", ["git_note_iterator_free", "git_note_next"]], [ "object", [ @@ -36849,6 +37350,9 @@ "git_odb_add_alternate", "git_odb_add_backend", "git_odb_add_disk_alternate", + "git_odb_backend_loose", + "git_odb_backend_one_pack", + "git_odb_backend_pack", "git_odb_exists", "git_odb_exists_ext", "git_odb_exists_prefix", @@ -36856,6 +37360,9 @@ "git_odb_foreach", "git_odb_free", "git_odb_get_backend", + "git_odb_hash", + "git_odb_hashfile", + "git_odb_new", "git_odb_num_backends", "git_odb_object_data", "git_odb_object_dup", @@ -36863,6 +37370,7 @@ "git_odb_object_id", "git_odb_object_size", "git_odb_object_type", + "git_odb_open", "git_odb_open_rstream", "git_odb_open_wstream", "git_odb_read", @@ -36886,6 +37394,10 @@ "git_oid_cpy", "git_oid_equal", "git_oid_fmt", + "git_oid_fromraw", + "git_oid_fromstr", + "git_oid_fromstrn", + "git_oid_fromstrp", "git_oid_is_zero", "git_oid_ncmp", "git_oid_nfmt", @@ -37068,6 +37580,7 @@ "git_refspec_rtransform", "git_refspec_src", "git_refspec_src_matches", + "git_refspec_src_matches_negative", "git_refspec_string", "git_refspec_transform" ] @@ -37171,7 +37684,8 @@ "git_repository_set_workdir", "git_repository_state", "git_repository_state_cleanup", - "git_repository_workdir" + "git_repository_workdir", + "git_repository_wrap_odb" ] ], ["reset", ["git_reset", "git_reset_default", "git_reset_from_annotated"]], @@ -37203,6 +37717,7 @@ "signature", [ "git_signature_default", + "git_signature_default_from_env", "git_signature_dup", "git_signature_free", "git_signature_from_buffer", @@ -37385,34 +37900,34 @@ ] ], "examples": [ - ["add.c", "ex/v1.8.4/add.html"], - ["args.c", "ex/v1.8.4/args.html"], - ["blame.c", "ex/v1.8.4/blame.html"], - ["cat-file.c", "ex/v1.8.4/cat-file.html"], - ["checkout.c", "ex/v1.8.4/checkout.html"], - ["clone.c", "ex/v1.8.4/clone.html"], - ["commit.c", "ex/v1.8.4/commit.html"], - ["common.c", "ex/v1.8.4/common.html"], - ["config.c", "ex/v1.8.4/config.html"], - ["describe.c", "ex/v1.8.4/describe.html"], - ["diff.c", "ex/v1.8.4/diff.html"], - ["fetch.c", "ex/v1.8.4/fetch.html"], - ["for-each-ref.c", "ex/v1.8.4/for-each-ref.html"], - ["general.c", "ex/v1.8.4/general.html"], - ["index-pack.c", "ex/v1.8.4/index-pack.html"], - ["init.c", "ex/v1.8.4/init.html"], - ["lg2.c", "ex/v1.8.4/lg2.html"], - ["log.c", "ex/v1.8.4/log.html"], - ["ls-files.c", "ex/v1.8.4/ls-files.html"], - ["ls-remote.c", "ex/v1.8.4/ls-remote.html"], - ["merge.c", "ex/v1.8.4/merge.html"], - ["push.c", "ex/v1.8.4/push.html"], - ["remote.c", "ex/v1.8.4/remote.html"], - ["rev-list.c", "ex/v1.8.4/rev-list.html"], - ["rev-parse.c", "ex/v1.8.4/rev-parse.html"], - ["show-index.c", "ex/v1.8.4/show-index.html"], - ["stash.c", "ex/v1.8.4/stash.html"], - ["status.c", "ex/v1.8.4/status.html"], - ["tag.c", "ex/v1.8.4/tag.html"] + ["add.c", "ex/v1.9.1/add.html"], + ["args.c", "ex/v1.9.1/args.html"], + ["blame.c", "ex/v1.9.1/blame.html"], + ["cat-file.c", "ex/v1.9.1/cat-file.html"], + ["checkout.c", "ex/v1.9.1/checkout.html"], + ["clone.c", "ex/v1.9.1/clone.html"], + ["commit.c", "ex/v1.9.1/commit.html"], + ["common.c", "ex/v1.9.1/common.html"], + ["config.c", "ex/v1.9.1/config.html"], + ["describe.c", "ex/v1.9.1/describe.html"], + ["diff.c", "ex/v1.9.1/diff.html"], + ["fetch.c", "ex/v1.9.1/fetch.html"], + ["for-each-ref.c", "ex/v1.9.1/for-each-ref.html"], + ["general.c", "ex/v1.9.1/general.html"], + ["index-pack.c", "ex/v1.9.1/index-pack.html"], + ["init.c", "ex/v1.9.1/init.html"], + ["lg2.c", "ex/v1.9.1/lg2.html"], + ["log.c", "ex/v1.9.1/log.html"], + ["ls-files.c", "ex/v1.9.1/ls-files.html"], + ["ls-remote.c", "ex/v1.9.1/ls-remote.html"], + ["merge.c", "ex/v1.9.1/merge.html"], + ["push.c", "ex/v1.9.1/push.html"], + ["remote.c", "ex/v1.9.1/remote.html"], + ["rev-list.c", "ex/v1.9.1/rev-list.html"], + ["rev-parse.c", "ex/v1.9.1/rev-parse.html"], + ["show-index.c", "ex/v1.9.1/show-index.html"], + ["stash.c", "ex/v1.9.1/stash.html"], + ["status.c", "ex/v1.9.1/status.html"], + ["tag.c", "ex/v1.9.1/tag.html"] ] } diff --git a/generate/input/libgit2-supplement.json b/generate/input/libgit2-supplement.json index d94be9ba03..12ee8945b6 100644 --- a/generate/input/libgit2-supplement.json +++ b/generate/input/libgit2-supplement.json @@ -216,7 +216,7 @@ ] } }, - "new" : { + "new": { "functions": { "git_libgit2_opts": { "type": "function", @@ -226,6 +226,33 @@ "isPrototypeMethod": false, "group": "libgit2" }, + "git_blame_file": { + "type": "function", + "file": "blame.h", + "args": [ + { + "name": "out", + "type": "git_blame **" + }, + { + "name": "repo", + "type": "git_repository *" + }, + { + "name": "path", + "type": "const char *" + }, + { + "name": "options", + "type": "git_blame_options *" + } + ], + "group": "blame", + "return": { + "type": "int", + "isErrorCode": true + } + }, "git_clone": { "isManual": true, "cFile": "generate/templates/manual/clone/clone.cc", @@ -267,6 +294,54 @@ "isErrorCode": true } }, + "git_email_create_from_diff": { + "file": "sys/email.h", + "type": "function", + "isAsync": true, + "group": "email", + "args": [ + { + "name": "out", + "type": "git_buf *" + }, + { + "name": "diff", + "type": "git_diff *" + }, + { + "name": "patch_idx", + "type": "size_t" + }, + { + "name": "patch_count", + "type": "size_t" + }, + { + "name": "commit_id", + "type": "const git_oid *" + }, + { + "name": "summary", + "type": "const char *" + }, + { + "name": "body", + "type": "const char *" + }, + { + "name": "author", + "type": "const git_signature *" + }, + { + "name": "opts", + "type": "git_email_create_options *" + } + ], + "return": { + "type": "int", + "isErrorCode": true + } + }, "git_diff_get_perfdata": { "file": "sys/diff.h", "args": [ @@ -667,24 +742,399 @@ }, "group": "index_reuc_entry" }, - "git_oid_fromstrp": { + "git_note_author": { "type": "function", - "file": "oid.h", + "file": "note.h", + "args": [ + { + "name": "note", + "type": "const git_note *" + } + ], + "return": { + "type": "const git_signature *" + }, + "group": "note" + }, + "git_note_commit_create": { + "type": "function", + "file": "note.h", + "args": [ + { + "name": "notes_commit_out", + "type": "git_oid *" + }, + { + "name": "notes_blob_out", + "type": "git_oid *" + }, + { + "name": "repo", + "type": "git_repository *" + }, + { + "name": "parent", + "type": "git_commit *" + }, + { + "name": "author", + "type": "const git_signature *" + }, + { + "name": "committer", + "type": "const git_signature *" + }, + { + "name": "oid", + "type": "const git_oid *" + }, + { + "name": "note", + "type": "const char *" + }, + { + "name": "allow_note_overwrite", + "type": "int" + } + ], + "return": { + "type": "int" + }, + "group": "note" + }, + "git_note_commit_iterator_new": { + "type": "function", + "file": "note.h", "args": [ { "name": "out", + "type": "git_note_iterator **" + }, + { + "name": "notes_commit", + "type": "git_commit *" + } + ], + "return": { + "type": "int" + }, + "group": "note" + }, + "git_note_commit_read": { + "type": "function", + "file": "note.h", + "args": [ + { + "name": "out", + "type": "git_note **" + }, + { + "name": "repo", + "type": "git_repository *" + }, + { + "name": "notes_commit", + "type": "git_commit *" + }, + { + "name": "oid", + "type": "const git_oid *" + } + ], + "return": { + "type": "int" + }, + "group": "note" + }, + "git_note_commit_remove": { + "type": "function", + "file": "note.h", + "args": [ + { + "name": "notes_commit_out", "type": "git_oid *" }, { - "name": "str", + "name": "repo", + "type": "git_repository *" + }, + { + "name": "notes_commit", + "type": "git_commit *" + }, + { + "name": "author", + "type": "const git_signature *" + }, + { + "name": "committer", + "type": "const git_signature *" + }, + { + "name": "oid", + "type": "const git_oid *" + } + ], + "return": { + "type": "int" + }, + "group": "note" + }, + "git_note_committer": { + "type": "function", + "file": "note.h", + "args": [ + { + "name": "note", + "type": "const git_note *" + } + ], + "return": { + "type": "const git_signature *" + }, + "group": "note" + }, + "git_note_create": { + "type": "function", + "file": "note.h", + "args": [ + { + "name": "out", + "type": "git_oid *" + }, + { + "name": "repo", + "type": "git_repository *" + }, + { + "name": "notes_ref", + "type": "const char *" + }, + { + "name": "author", + "type": "const git_signature *" + }, + { + "name": "committer", + "type": "const git_signature *" + }, + { + "name": "oid", + "type": "const git_oid *" + }, + { + "name": "note", "type": "const char *" + }, + { + "name": "force", + "type": "int" } ], "return": { "type": "int" }, - "isAsync": false, - "group": "oid" + "group": "note" + }, + "git_note_default_ref": { + "type": "function", + "file": "note.h", + "args": [ + { + "name": "out", + "type": "git_buf *" + }, + { + "name": "repo", + "type": "git_repository *" + } + ], + "return": { + "type": "int" + }, + "group": "note" + }, + "git_note_foreach": { + "type": "function", + "file": "note.h", + "args": [ + { + "name": "repo", + "type": "git_repository *" + }, + { + "name": "notes_ref", + "type": "const char *" + }, + { + "name": "note_cb", + "type": "git_note_foreach_cb" + }, + { + "name": "payload", + "type": "void *" + } + ], + "return": { + "type": "int" + }, + "group": "note" + }, + "git_note_free": { + "type": "function", + "file": "note.h", + "args": [ + { + "name": "note", + "type": "git_note *" + } + ], + "return": { + "type": "void" + }, + "group": "note" + }, + "git_note_id": { + "type": "function", + "file": "note.h", + "args": [ + { + "name": "note", + "type": "const git_note *" + } + ], + "return": { + "type": "const git_oid *" + }, + "group": "note" + }, + "git_note_iterator_free": { + "type": "function", + "file": "note.h", + "args": [ + { + "name": "it", + "type": "git_note_iterator *" + } + ], + "return": { + "type": "void" + }, + "group": "note" + }, + "git_note_iterator_new": { + "type": "function", + "file": "note.h", + "args": [ + { + "name": "out", + "type": "git_note_iterator **" + }, + { + "name": "repo", + "type": "git_repository *" + }, + { + "name": "notes_ref", + "type": "const char *" + } + ], + "return": { + "type": "int" + }, + "group": "note" + }, + "git_note_message": { + "type": "function", + "file": "note.h", + "args": [ + { + "name": "note", + "type": "const git_note *" + } + ], + "return": { + "type": "const char *" + }, + "group": "note" + }, + "git_note_next": { + "type": "function", + "file": "note.h", + "args": [ + { + "name": "note_id", + "type": "git_oid *" + }, + { + "name": "annotated_id", + "type": "git_oid *" + }, + { + "name": "it", + "type": "git_note_iterator *" + } + ], + "return": { + "type": "int" + }, + "group": "note" + }, + "git_note_read": { + "type": "function", + "file": "note.h", + "args": [ + { + "name": "out", + "type": "git_note **" + }, + { + "name": "repo", + "type": "git_repository *" + }, + { + "name": "notes_ref", + "type": "const char *" + }, + { + "name": "oid", + "type": "const git_oid *" + } + ], + "return": { + "type": "int" + }, + "group": "note" + }, + "git_note_remove": { + "type": "function", + "file": "note.h", + "args": [ + { + "name": "repo", + "type": "git_repository *" + }, + { + "name": "notes_ref", + "type": "const char *" + }, + { + "name": "author", + "type": "const git_signature *" + }, + { + "name": "committer", + "type": "const git_signature *" + }, + { + "name": "oid", + "type": "const git_oid *" + } + ], + "return": { + "type": "int" + }, + "group": "note" }, "git_patch_convenient_from_diff": { "args": [ @@ -1171,12 +1621,6 @@ "git_merge_file_result_free" ] ], - [ - "oid", - [ - "git_oid_fromstrp" - ] - ], [ "odb_object", [ @@ -1323,6 +1767,62 @@ } } ], + [ + "git_blame_hunk", + { + "type": "struct", + "fields": [ + { + "name": "lines_in_hunk", + "type": "int" + }, + { + "name": "final_commit_id", + "type": "git_oid" + }, + { + "name": "final_start_line_number", + "type": "size_t" + }, + { + "name": "final_signature", + "type": "git_signature *" + }, + { + "name": "final_committer", + "type": "git_signature *" + }, + { + "name": "orig_commit_id", + "type": "git_oid" + }, + { + "name": "orig_path", + "type": "const char *" + }, + { + "name": "orig_start_line_number", + "type": "size_t" + }, + { + "name": "orig_signature", + "type": "git_signature *" + }, + { + "name": "orig_committer", + "type": "git_signature *" + }, + { + "name": "summary", + "type": "const char *" + }, + { + "name": "boundary", + "type": "char" + } + ] + } + ], [ "git_blob_filter_options", { @@ -1408,7 +1908,7 @@ ], [ "git_commit_create_options", - { + { "decl": [ "unsigned int version", "unsigned int allow_empty_commit : 1", @@ -1944,12 +2444,6 @@ } } ], - [ - "git_time_t", - { - "type": "enum" - } - ], [ "git_trace_level_t", { @@ -2163,5 +2657,31 @@ ] } }, - "groups": {} -} + "groups": { + "blame": [ + "git_blame_file" + ], + "email": [ + "git_email_create_from_diff" + ], + "note": [ + "git_note_author", + "git_note_commit_create", + "git_note_commit_iterator_new", + "git_note_commit_read", + "git_note_commit_remove", + "git_note_committer", + "git_note_create", + "git_note_default_ref", + "git_note_foreach", + "git_note_free", + "git_note_id", + "git_note_iterator_free", + "git_note_iterator_new", + "git_note_message", + "git_note_next", + "git_note_read", + "git_note_remove" + ] + } +} \ No newline at end of file diff --git a/generate/scripts/helpers.js b/generate/scripts/helpers.js index 15790983ff..e278e1cc05 100644 --- a/generate/scripts/helpers.js +++ b/generate/scripts/helpers.js @@ -25,7 +25,8 @@ var cTypeMappings = { "uint32_t": "Number", "uint64_t": "Number", "double": "Number", - "git_object_size_t": "Number" + "git_object_size_t": "Number", + "git_time_t": "Number", } var collisionMappings = { diff --git a/generate/templates/manual/include/configurable_class_wrapper.h b/generate/templates/manual/include/configurable_class_wrapper.h index 283eb7e44f..ff83a3176d 100644 --- a/generate/templates/manual/include/configurable_class_wrapper.h +++ b/generate/templates/manual/include/configurable_class_wrapper.h @@ -40,7 +40,7 @@ namespace nodegit { virtual ~ConfigurableClassWrapper() { if (raw != nullptr) { - delete raw; + free(raw); raw = nullptr; } } diff --git a/generate/templates/manual/repository/refresh_references.cc b/generate/templates/manual/repository/refresh_references.cc index 5ddaec57fa..5194f1c48c 100644 --- a/generate/templates/manual/repository/refresh_references.cc +++ b/generate/templates/manual/repository/refresh_references.cc @@ -244,10 +244,10 @@ class RefreshedRefModel { } ~RefreshedRefModel() { - if (fullName != NULL) { delete[] fullName; } - if (message != NULL) { delete[] message; } + if (fullName != NULL) { free(fullName); } + if (message != NULL) { free(message); } delete[] sha; - if (shorthand != NULL) { delete[] shorthand; } + if (shorthand != NULL) { free(shorthand); } if (tagOdbBuffer != NULL) { delete[] tagOdbBuffer; } } @@ -344,8 +344,8 @@ class UpstreamModel { } ~UpstreamModel() { - if (downstreamFullName != NULL) { delete[] downstreamFullName; } - if (upstreamFullName != NULL) { delete[] upstreamFullName; } + if (downstreamFullName != NULL) { free(downstreamFullName); } + if (upstreamFullName != NULL) { free(upstreamFullName); } } char *downstreamFullName; @@ -375,7 +375,7 @@ class RefreshReferencesData { delete upstreamInfo.back(); upstreamInfo.pop_back(); } - if (headRefFullName != NULL) { delete[] headRefFullName; } + if (headRefFullName != NULL) { free(headRefFullName); } if (cherrypick != NULL) { delete cherrypick; } if (merge != NULL) { delete merge; } } @@ -573,7 +573,7 @@ void GitRepository::RefreshReferencesWorker::Execute() if (isRemote) { char *remoteNameOfRef = getRemoteNameOfReference(reference); bool isFromExistingRemote = gitStrArrayContains(&remoteNames, remoteNameOfRef); - delete[] remoteNameOfRef; + free(remoteNameOfRef); if (!isFromExistingRemote) { git_reference_free(reference); continue; diff --git a/generate/templates/manual/revwalk/file_history_walk.cc b/generate/templates/manual/revwalk/file_history_walk.cc index 714d6f5db3..569bb022dc 100644 --- a/generate/templates/manual/revwalk/file_history_walk.cc +++ b/generate/templates/manual/revwalk/file_history_walk.cc @@ -31,6 +31,14 @@ class FileHistoryEvent { if (commit != NULL) { git_commit_free(commit); } + + if(from != NULL) { + free((void *)from); + } + + if(to != NULL) { + free((void *)to); + } } v8::Local