v0.19.0.json

{
  "info": {
    "version": "v0.19.0",
    "commit": "eddc1f1ed78898a4ca41480045b1d0d5b075e773"
  },
  "groups": {
    "attr": {
      "apis": {
        "GIT_ATTR_TRUE(attr)": {
          "kind": "macro",
          "name": "GIT_ATTR_TRUE(attr)",
          "location": {
            "file": "attr.h",
            "line": 33,
            "column": 9
          },
          "value": "(git_attr_value(attr) == GIT_ATTR_TRUE_T)",
          "comment": "GIT_ATTR_TRUE checks if an attribute is set on.  In core git parlance, this the value for \"Set\" attributes. For example, if the attribute file contains: *.c foo Then for file `xyz.c` looking up attribute \"foo\" gives a value for which `GIT_ATTR_TRUE(value)` is true.",
          "group": "attr"
        },
        "GIT_ATTR_FALSE(attr)": {
          "kind": "macro",
          "name": "GIT_ATTR_FALSE(attr)",
          "location": {
            "file": "attr.h",
            "line": 47,
            "column": 9
          },
          "value": "(git_attr_value(attr) == GIT_ATTR_FALSE_T)",
          "comment": "GIT_ATTR_FALSE checks if an attribute is set off.  In core git parlance, this is the value for attributes that are \"Unset\" (not to be confused with values that a \"Unspecified\"). For example, if the attribute file contains: *.h -foo Then for file `zyx.h` looking up attribute \"foo\" gives a value for which `GIT_ATTR_FALSE(value)` is true.",
          "group": "attr"
        },
        "GIT_ATTR_UNSPECIFIED(attr)": {
          "kind": "macro",
          "name": "GIT_ATTR_UNSPECIFIED(attr)",
          "location": {
            "file": "attr.h",
            "line": 65,
            "column": 9
          },
          "value": "(git_attr_value(attr) == GIT_ATTR_UNSPECIFIED_T)",
          "comment": "GIT_ATTR_UNSPECIFIED checks if an attribute is unspecified.  This may be due to the attribute not being mentioned at all or because the attribute was explicitly set unspecified via the `!` operator. For example, if the attribute file contains: *.c foo *.h -foo onefile.c !foo Then for `onefile.c` looking up attribute \"foo\" yields a value with `GIT_ATTR_UNSPECIFIED(value)` of true.  Also, looking up \"foo\" on file `onefile.rb` or looking up \"bar\" on any file will all give `GIT_ATTR_UNSPECIFIED(value)` of true.",
          "group": "attr"
        },
        "GIT_ATTR_HAS_VALUE(attr)": {
          "kind": "macro",
          "name": "GIT_ATTR_HAS_VALUE(attr)",
          "location": {
            "file": "attr.h",
            "line": 77,
            "column": 9
          },
          "value": "(git_attr_value(attr) == GIT_ATTR_VALUE_T)",
          "comment": "GIT_ATTR_HAS_VALUE checks if an attribute is set to a value (as opposed to TRUE, FALSE or UNSPECIFIED).  This would be the case if for a file with something like: *.txt eol=lf Given this, looking up \"eol\" for `onefile.txt` will give back the string \"lf\" and `GIT_ATTR_SET_TO_VALUE(attr)` will return true.",
          "group": "attr"
        },
        "git_attr_t": {
          "kind": "enum",
          "name": "git_attr_t",
          "referenceName": "git_attr_t",
          "members": [
            {
              "name": "GIT_ATTR_UNSPECIFIED_T",
              "value": "0"
            },
            {
              "name": "GIT_ATTR_TRUE_T"
            },
            {
              "name": "GIT_ATTR_FALSE_T"
            },
            {
              "name": "GIT_ATTR_VALUE_T"
            }
          ],
          "location": {
            "file": "attr.h",
            "line": 79,
            "column": 9
          },
          "group": "attr",
          "returnedBy": [
            "git_attr_value"
          ]
        },
        "git_attr_value": {
          "kind": "function",
          "name": "git_attr_value",
          "location": {
            "file": "attr.h",
            "line": 99,
            "column": 24
          },
          "returns": {
            "type": "git_attr_t"
          },
          "params": [
            {
              "name": "attr",
              "type": "const char *"
            }
          ],
          "group": "attr"
        },
        "GIT_ATTR_CHECK_FILE_THEN_INDEX": {
          "kind": "macro",
          "name": "GIT_ATTR_CHECK_FILE_THEN_INDEX",
          "location": {
            "file": "attr.h",
            "line": 114,
            "column": 9
          },
          "value": "0",
          "comment": "Check attribute flags: Reading values from index and working directory. When checking attributes, it is possible to check attribute files in both the working directory (if there is one) and the index (if there is one).  You can explicitly choose where to check and in which order using the following flags. Core git usually checks the working directory then the index, except during a checkout when it checks the index first.  It will use index only for creating archives or for a bare repo (if an index has been specified for the bare repo).",
          "group": "attr"
        },
        "GIT_ATTR_CHECK_INDEX_THEN_FILE": {
          "kind": "macro",
          "name": "GIT_ATTR_CHECK_INDEX_THEN_FILE",
          "location": {
            "file": "attr.h",
            "line": 115,
            "column": 9
          },
          "value": "1",
          "comment": "",
          "group": "attr"
        },
        "GIT_ATTR_CHECK_INDEX_ONLY": {
          "kind": "macro",
          "name": "GIT_ATTR_CHECK_INDEX_ONLY",
          "location": {
            "file": "attr.h",
            "line": 116,
            "column": 9
          },
          "value": "2",
          "comment": "",
          "group": "attr"
        },
        "GIT_ATTR_CHECK_NO_SYSTEM": {
          "kind": "macro",
          "name": "GIT_ATTR_CHECK_NO_SYSTEM",
          "location": {
            "file": "attr.h",
            "line": 125,
            "column": 9
          },
          "value": "(1 << 2)",
          "comment": "Check attribute flags: Using the system attributes file. Normally, attribute checks include looking in the /etc (or system equivalent) directory for a `gitattributes` file.  Passing this flag will cause attribute checks to ignore that file.",
          "group": "attr"
        },
        "git_attr_get": {
          "kind": "function",
          "name": "git_attr_get",
          "location": {
            "file": "attr.h",
            "line": 142,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "value_out",
              "type": "const char **",
              "direction": "in",
              "comment": "Output of the value of the attribute.  Use the GIT_ATTR_...\n             macros to test for TRUE, FALSE, UNSPECIFIED, etc. or just\n             use the string value for attributes set to a value.  You\n             should NOT modify or free this value."
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repository containing the path."
            },
            {
              "name": "flags",
              "type": "uint32_t",
              "direction": "in",
              "comment": "A combination of GIT_ATTR_CHECK... flags."
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "The path to check for attributes.  Relative paths are\n             interpreted relative to the repo root.  The file does\n             not have to exist, but if it does not, then it will be\n             treated as a plain file (not a directory)."
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "The name of the attribute to look up."
            }
          ],
          "comment": [
            "Look up the value of one git attribute for path."
          ],
          "group": "attr"
        },
        "git_attr_get_many": {
          "kind": "function",
          "name": "git_attr_get_many",
          "location": {
            "file": "attr.h",
            "line": 178,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "values_out",
              "type": "const char **",
              "direction": "in",
              "comment": "An array of num_attr entries that will have string\n             pointers written into it for the values of the attributes.\n             You should not modify or free the values that are written\n             into this array (although of course, you should free the\n             array itself if you allocated it)."
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repository containing the path."
            },
            {
              "name": "flags",
              "type": "uint32_t",
              "direction": "in",
              "comment": "A combination of GIT_ATTR_CHECK... flags."
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "The path inside the repo to check attributes.  This\n             does not have to exist, but if it does not, then\n             it will be treated as a plain file (i.e. not a directory)."
            },
            {
              "name": "num_attr",
              "type": "size_t",
              "direction": "in",
              "comment": "The number of attributes being looked up"
            },
            {
              "name": "names",
              "type": "const char **",
              "direction": "in",
              "comment": "An array of num_attr strings containing attribute names."
            }
          ],
          "comment": [
            "Look up a list of git attributes for path.",
            "Use this if you have a known list of attributes that you want to\n look up in a single call.  This is somewhat more efficient than\n calling `git_attr_get()` multiple times.",
            "For example, you might write:",
            "const char *attrs[] = { \"crlf\", \"diff\", \"foo\" };\n     const char **values[3];\n     git_attr_get_many(values, repo, 0, \"my/fun/file.c\", 3, attrs);",
            "Then you could loop through the 3 values to get the settings for\n the three attributes you asked about."
          ],
          "group": "attr"
        },
        "git_attr_foreach_cb": {
          "kind": "callback",
          "name": "git_attr_foreach_cb",
          "type": "int (*)(const char *, const char *, void *)",
          "location": {
            "file": "attr.h",
            "line": 186,
            "column": 15
          },
          "params": [
            {
              "type": "const char *"
            },
            {
              "type": "const char *"
            },
            {
              "type": "void *"
            }
          ],
          "group": "attr",
          "parameterTo": [
            "git_attr_foreach"
          ],
          "typedef": true
        },
        "git_attr_foreach": {
          "kind": "function",
          "name": "git_attr_foreach",
          "location": {
            "file": "attr.h",
            "line": 205,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repository containing the path."
            },
            {
              "name": "flags",
              "type": "uint32_t",
              "direction": "in",
              "comment": "A combination of GIT_ATTR_CHECK... flags."
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "Path inside the repo to check attributes.  This does not have\n             to exist, but if it does not, then it will be treated as a\n             plain file (i.e. not a directory)."
            },
            {
              "name": "callback",
              "type": "git_attr_foreach_cb",
              "direction": "in",
              "comment": "Function to invoke on each attribute name and value.  The\n             value may be NULL is the attribute is explicitly set to\n             UNSPECIFIED using the '!' sign.  Callback will be invoked\n             only once per attribute name, even if there are multiple\n             rules for a given file.  The highest priority rule will be\n             used.  Return a non-zero value from this to stop looping.",
              "referenceType": "int (*)(const char *, const char *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Passed on as extra parameter to callback function."
            }
          ],
          "comment": [
            "Loop over all the git attributes for a path."
          ],
          "group": "attr"
        },
        "git_attr_cache_flush": {
          "kind": "function",
          "name": "git_attr_cache_flush",
          "location": {
            "file": "attr.h",
            "line": 220,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *"
            }
          ],
          "comment": [
            "Flush the gitattributes cache.",
            "Call this if you have reason to believe that the attributes files on\n disk no longer match the cached contents of memory.  This will cause\n the attributes files to be reloaded the next time that an attribute\n access function is called."
          ],
          "group": "attr"
        },
        "git_attr_add_macro": {
          "kind": "function",
          "name": "git_attr_add_macro",
          "location": {
            "file": "attr.h",
            "line": 233,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *"
            },
            {
              "name": "name",
              "type": "const char *"
            },
            {
              "name": "values",
              "type": "const char *"
            }
          ],
          "comment": [
            "Add a macro definition.",
            "Macros will automatically be loaded from the top level `.gitattributes`\n file of the repository (plus the build-in \"binary\" macro).  This\n function allows you to add others.  For example, to add the default\n macro, you would call:",
            "git_attr_add_macro(repo, \"binary\", \"-diff -crlf\");"
          ],
          "group": "attr"
        }
      },
      "info": {
        "summary": "Git attribute management routines"
      }
    },
    "blob": {
      "apis": {
        "git_blob_lookup": {
          "kind": "function",
          "name": "git_blob_lookup",
          "location": {
            "file": "blob.h",
            "line": 32,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "blob",
              "type": "git_blob **",
              "direction": "in",
              "comment": "pointer to the looked up blob"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repo to use when locating the blob."
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "identity of the blob to locate."
            }
          ],
          "comment": [
            "Lookup a blob object from a repository."
          ],
          "group": "blob"
        },
        "git_blob_lookup_prefix": {
          "kind": "function",
          "name": "git_blob_lookup_prefix",
          "location": {
            "file": "blob.h",
            "line": 46,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "blob",
              "type": "git_blob **",
              "direction": "in",
              "comment": "pointer to the looked up blob"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repo to use when locating the blob."
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "identity of the blob to locate."
            },
            {
              "name": "len",
              "type": "size_t",
              "direction": "in",
              "comment": "the length of the short identifier"
            }
          ],
          "comment": [
            "Lookup a blob object from a repository,\n given a prefix of its identifier (short id)."
          ],
          "see": [
            "git_object_lookup_prefix"
          ],
          "group": "blob"
        },
        "git_blob_free": {
          "kind": "function",
          "name": "git_blob_free",
          "location": {
            "file": "blob.h",
            "line": 59,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "blob",
              "type": "git_blob *",
              "direction": "in",
              "comment": "the blob to close"
            }
          ],
          "comment": [
            "Close an open blob",
            "This is a wrapper around git_object_free()",
            "IMPORTANT:\n It *is* necessary to call this method when you stop\n using a blob. Failure to do so will cause a memory leak."
          ],
          "group": "blob"
        },
        "git_blob_id": {
          "kind": "function",
          "name": "git_blob_id",
          "location": {
            "file": "blob.h",
            "line": 67,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "SHA1 hash for this blob."
          },
          "params": [
            {
              "name": "blob",
              "type": "const git_blob *",
              "direction": "in",
              "comment": "a previously loaded blob."
            }
          ],
          "comment": [
            "Get the id of a blob."
          ],
          "group": "blob"
        },
        "git_blob_owner": {
          "kind": "function",
          "name": "git_blob_owner",
          "location": {
            "file": "blob.h",
            "line": 75,
            "column": 30
          },
          "returns": {
            "type": "git_repository *",
            "comment": "Repository that contains this blob."
          },
          "params": [
            {
              "name": "blob",
              "type": "const git_blob *",
              "direction": "in",
              "comment": "A previously loaded blob."
            }
          ],
          "comment": [
            "Get the repository that contains the blob."
          ],
          "group": "blob"
        },
        "git_blob_rawcontent": {
          "kind": "function",
          "name": "git_blob_rawcontent",
          "location": {
            "file": "blob.h",
            "line": 88,
            "column": 26
          },
          "returns": {
            "type": "const void *",
            "comment": "the pointer; NULL if the blob has no contents"
          },
          "params": [
            {
              "name": "blob",
              "type": "const git_blob *",
              "direction": "in",
              "comment": "pointer to the blob"
            }
          ],
          "comment": [
            "Get a read-only buffer with the raw content of a blob.",
            "A pointer to the raw content of a blob is returned;\n this pointer is owned internally by the object and shall\n not be free'd. The pointer may be invalidated at a later\n time."
          ],
          "group": "blob"
        },
        "git_blob_rawsize": {
          "kind": "function",
          "name": "git_blob_rawsize",
          "location": {
            "file": "blob.h",
            "line": 96,
            "column": 23
          },
          "returns": {
            "type": "git_off_t",
            "comment": "size on bytes"
          },
          "params": [
            {
              "name": "blob",
              "type": "const git_blob *",
              "direction": "in",
              "comment": "pointer to the blob"
            }
          ],
          "comment": [
            "Get the size in bytes of the contents of a blob"
          ],
          "group": "blob"
        },
        "git_blob_create_fromworkdir": {
          "kind": "function",
          "name": "git_blob_create_fromworkdir",
          "location": {
            "file": "blob.h",
            "line": 109,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "id",
              "type": "git_oid *",
              "direction": "in",
              "comment": "return the id of the written blob"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository where the blob will be written.\n\tthis repository cannot be bare"
            },
            {
              "name": "relative_path",
              "type": "const char *",
              "direction": "in",
              "comment": "file from which the blob will be created,\n\trelative to the repository's working dir"
            }
          ],
          "comment": [
            "Read a file from the working folder of a repository\n and write it to the Object Database as a loose blob"
          ],
          "group": "blob"
        },
        "git_blob_create_fromdisk": {
          "kind": "function",
          "name": "git_blob_create_fromdisk",
          "location": {
            "file": "blob.h",
            "line": 121,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "id",
              "type": "git_oid *",
              "direction": "in",
              "comment": "return the id of the written blob"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository where the blob will be written.\n\tthis repository can be bare or not"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "file from which the blob will be created"
            }
          ],
          "comment": [
            "Read a file from the filesystem and write its content\n to the Object Database as a loose blob"
          ],
          "group": "blob"
        },
        "git_blob_chunk_cb": {
          "kind": "callback",
          "name": "git_blob_chunk_cb",
          "type": "int (*)(char *, size_t, void *)",
          "location": {
            "file": "blob.h",
            "line": 124,
            "column": 15
          },
          "params": [
            {
              "type": "char *"
            },
            {
              "type": "size_t"
            },
            {
              "type": "void *"
            }
          ],
          "group": "blob",
          "parameterTo": [
            "git_blob_create_fromchunks"
          ],
          "typedef": true
        },
        "git_blob_create_fromchunks": {
          "kind": "function",
          "name": "git_blob_create_fromchunks",
          "location": {
            "file": "blob.h",
            "line": 162,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "id",
              "type": "git_oid *",
              "direction": "in",
              "comment": "Return the id of the written blob"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository where the blob will be written.\n This repository can be bare or not."
            },
            {
              "name": "hintpath",
              "type": "const char *",
              "direction": "in",
              "comment": "if not NULL, will help selecting the filters\n to apply onto the content of the blob to be created."
            },
            {
              "name": "callback",
              "type": "git_blob_chunk_cb",
              "referenceType": "int (*)(char *, size_t, void *)"
            },
            {
              "name": "payload",
              "type": "void *"
            }
          ],
          "comment": [
            "Write a loose blob to the Object Database from a\n provider of chunks of data.",
            "Provided the `hintpath` parameter is filled, its value\n will help to determine what git filters should be applied\n to the object before it can be placed to the object database.",
            "The implementation of the callback has to respect the\n following rules:",
            "- `content` will have to be filled by the consumer. The maximum number\n of bytes that the buffer can accept per call is defined by the\n `max_length` parameter. Allocation and freeing of the buffer will be taken\n care of by the function.",
            "- The callback is expected to return the number of bytes\n that `content` have been filled with.",
            "- When there is no more data to stream, the callback should\n return 0. This will prevent it from being invoked anymore.",
            "- When an error occurs, the callback should return -1."
          ],
          "group": "blob"
        },
        "git_blob_create_frombuffer": {
          "kind": "function",
          "name": "git_blob_create_frombuffer",
          "location": {
            "file": "blob.h",
            "line": 178,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "oid",
              "type": "git_oid *",
              "direction": "in",
              "comment": "return the oid of the written blob"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository where to blob will be written"
            },
            {
              "name": "buffer",
              "type": "const void *",
              "direction": "in",
              "comment": "data to be written into the blob"
            },
            {
              "name": "len",
              "type": "size_t",
              "direction": "in",
              "comment": "length of the data"
            }
          ],
          "comment": [
            "Write an in-memory buffer to the ODB as a blob"
          ],
          "group": "blob"
        },
        "git_blob_is_binary": {
          "kind": "function",
          "name": "git_blob_is_binary",
          "location": {
            "file": "blob.h",
            "line": 191,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if the content of the blob is detected\n as binary; 0 otherwise."
          },
          "params": [
            {
              "name": "blob",
              "type": "git_blob *",
              "direction": "in",
              "comment": "The blob which content should be analyzed"
            }
          ],
          "comment": [
            "Determine if the blob content is most certainly binary or not.",
            "The heuristic used to guess if a file is binary is taken from core git:\n Searching for NUL bytes and looking for a reasonable ratio of printable\n to non-printable characters among the first 4000 bytes."
          ],
          "group": "blob"
        },
        "git_blob": {
          "kind": "struct",
          "name": "git_blob",
          "referenceName": "struct git_blob",
          "opaque": true,
          "comment": [
            "In-memory representation of a blob object."
          ],
          "location": {
            "file": "types.h",
            "line": 117,
            "column": 25
          },
          "group": "blob",
          "parameterTo": [
            "git_blob_lookup",
            "git_blob_lookup_prefix",
            "git_blob_free",
            "git_blob_id",
            "git_blob_owner",
            "git_blob_rawcontent",
            "git_blob_rawsize",
            "git_blob_is_binary",
            "git_diff_blobs",
            "git_diff_patch_from_blobs",
            "git_diff_blob_to_buffer",
            "git_diff_patch_from_blob_and_buffer"
          ]
        }
      },
      "info": {
        "summary": "Git blob load and write routines"
      }
    },
    "branch": {
      "apis": {
        "git_branch_create": {
          "kind": "function",
          "name": "git_branch_create",
          "location": {
            "file": "branch.h",
            "line": 50,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0, GIT_EINVALIDSPEC or an error code.\n A proper reference is written in the refs/heads namespace\n pointing to the provided target commit."
          },
          "params": [
            {
              "name": "out",
              "type": "git_reference **",
              "direction": "in",
              "comment": "Pointer where to store the underlying reference."
            },
            {
              "name": "repo",
              "type": "git_repository *"
            },
            {
              "name": "branch_name",
              "type": "const char *",
              "direction": "in",
              "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 *",
              "direction": "in",
              "comment": "Commit to which this branch should point. This object\n must belong to the given `repo`."
            },
            {
              "name": "force",
              "type": "int",
              "direction": "in",
              "comment": "Overwrite existing branch."
            }
          ],
          "comment": [
            "Create a new branch pointing at a target commit",
            "A new direct reference will be created pointing to\n this target commit. If `force` is true and a reference\n already exists with the given name, it'll be replaced.",
            "The returned reference must be freed by the user.",
            "The branch name will be checked for validity.\n See `git_tag_create()` for rules about valid names."
          ],
          "group": "branch"
        },
        "git_branch_delete": {
          "kind": "function",
          "name": "git_branch_delete",
          "location": {
            "file": "branch.h",
            "line": 67,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, or an error code."
          },
          "params": [
            {
              "name": "branch",
              "type": "git_reference *",
              "direction": "in",
              "comment": "A valid reference representing a branch"
            }
          ],
          "comment": [
            "Delete an existing branch reference.",
            "If the branch is successfully deleted, the passed reference\n object will be invalidated. The reference must be freed manually\n by the user."
          ],
          "group": "branch"
        },
        "git_branch_foreach_cb": {
          "kind": "callback",
          "name": "git_branch_foreach_cb",
          "type": "int (*)(const char *, git_branch_t, void *)",
          "location": {
            "file": "branch.h",
            "line": 69,
            "column": 15
          },
          "params": [
            {
              "type": "const char *"
            },
            {
              "type": "git_branch_t"
            },
            {
              "type": "void *"
            }
          ],
          "group": "branch",
          "parameterTo": [
            "git_branch_foreach"
          ],
          "typedef": true
        },
        "git_branch_foreach": {
          "kind": "function",
          "name": "git_branch_foreach",
          "location": {
            "file": "branch.h",
            "line": 91,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where to find the branches."
            },
            {
              "name": "list_flags",
              "type": "unsigned int",
              "direction": "in",
              "comment": "Filtering flags for the branch\n listing. Valid values are GIT_BRANCH_LOCAL, GIT_BRANCH_REMOTE\n or a combination of the two."
            },
            {
              "name": "branch_cb",
              "type": "git_branch_foreach_cb",
              "direction": "in",
              "comment": "Callback to invoke per found branch.",
              "referenceType": "int (*)(const char *, git_branch_t, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Extra parameter to callback function."
            }
          ],
          "comment": [
            "Loop over all the branches and issue a callback for each one.",
            "If the callback returns a non-zero value, this will stop looping."
          ],
          "group": "branch"
        },
        "git_branch_move": {
          "kind": "function",
          "name": "git_branch_move",
          "location": {
            "file": "branch.h",
            "line": 112,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EINVALIDSPEC or an error code."
          },
          "params": [
            {
              "name": "out",
              "type": "git_reference **"
            },
            {
              "name": "branch",
              "type": "git_reference *",
              "direction": "in",
              "comment": "Current underlying reference of the branch."
            },
            {
              "name": "new_branch_name",
              "type": "const char *",
              "direction": "in",
              "comment": "Target name of the branch once the move\n is performed; this name is validated for consistency."
            },
            {
              "name": "force",
              "type": "int",
              "direction": "in",
              "comment": "Overwrite existing branch."
            }
          ],
          "comment": [
            "Move/rename an existing local branch reference.",
            "The new branch name will be checked for validity.\n See `git_tag_create()` for rules about valid names."
          ],
          "group": "branch"
        },
        "git_branch_lookup": {
          "kind": "function",
          "name": "git_branch_lookup",
          "location": {
            "file": "branch.h",
            "line": 139,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success; GIT_ENOTFOUND when no matching branch\n exists, GIT_EINVALIDSPEC, otherwise an error code."
          },
          "params": [
            {
              "name": "out",
              "type": "git_reference **",
              "direction": "in",
              "comment": "pointer to the looked-up branch reference"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository to look up the branch"
            },
            {
              "name": "branch_name",
              "type": "const char *",
              "direction": "in",
              "comment": "Name of the branch to be looked-up;\n this name is validated for consistency."
            },
            {
              "name": "branch_type",
              "type": "git_branch_t",
              "direction": "in",
              "comment": "Type of the considered branch. This should\n be valued with either GIT_BRANCH_LOCAL or GIT_BRANCH_REMOTE.",
              "referenceType": "enum git_branch_t"
            }
          ],
          "comment": [
            "Lookup a branch by its name in a repository.",
            "The generated reference must be freed by the user.",
            "The branch name will be checked for validity.\n See `git_tag_create()` for rules about valid names."
          ],
          "group": "branch"
        },
        "git_branch_name": {
          "kind": "function",
          "name": "git_branch_name",
          "location": {
            "file": "branch.h",
            "line": 160,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success; otherwise an error code (e.g., if the\n  ref is no local or remote branch)."
          },
          "params": [
            {
              "name": "out",
              "type": "const char **",
              "direction": "in",
              "comment": "where the pointer of branch name is stored;\n this is valid as long as the ref is not freed."
            },
            {
              "name": "ref",
              "type": "git_reference *",
              "direction": "in",
              "comment": "the reference ideally pointing to a branch"
            }
          ],
          "comment": [
            "Return the name of the given local or remote branch.",
            "The name of the branch matches the definition of the name\n for git_branch_lookup. That is, if the returned name is given\n to git_branch_lookup() then the reference is returned that\n was given to this function."
          ],
          "group": "branch"
        },
        "git_branch_upstream": {
          "kind": "function",
          "name": "git_branch_upstream",
          "location": {
            "file": "branch.h",
            "line": 175,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success; GIT_ENOTFOUND when no remote tracking\n reference exists, otherwise an error code."
          },
          "params": [
            {
              "name": "out",
              "type": "git_reference **",
              "direction": "in",
              "comment": "Pointer where to store the retrieved\n reference."
            },
            {
              "name": "branch",
              "type": "git_reference *",
              "direction": "in",
              "comment": "Current underlying reference of the branch."
            }
          ],
          "comment": [
            "Return the reference supporting the remote tracking branch,\n given a local branch reference."
          ],
          "group": "branch"
        },
        "git_branch_set_upstream": {
          "kind": "function",
          "name": "git_branch_set_upstream",
          "location": {
            "file": "branch.h",
            "line": 189,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "branch",
              "type": "git_reference *",
              "direction": "in",
              "comment": "the branch to configure"
            },
            {
              "name": "upstream_name",
              "type": "const char *",
              "direction": "in",
              "comment": "remote-tracking or local branch to set as\n upstream. Pass NULL to unset."
            }
          ],
          "comment": [
            "Set the upstream configuration for a given local branch"
          ],
          "group": "branch"
        },
        "git_branch_upstream_name": {
          "kind": "function",
          "name": "git_branch_upstream_name",
          "location": {
            "file": "branch.h",
            "line": 209,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "number of characters in the reference name\n     including the trailing NUL byte; GIT_ENOTFOUND when no remote tracking\n     reference exists, otherwise an error code."
          },
          "params": [
            {
              "name": "tracking_branch_name_out",
              "type": "char *",
              "direction": "in",
              "comment": "The user-allocated buffer which will be\n     filled with the name of the reference. Pass NULL if you just want to\n     get the needed size of the name of the reference as the output value."
            },
            {
              "name": "buffer_size",
              "type": "size_t",
              "direction": "in",
              "comment": "Size of the `out` buffer in bytes."
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository where the branches live"
            },
            {
              "name": "canonical_branch_name",
              "type": "const char *",
              "direction": "in",
              "comment": "name of the local branch."
            }
          ],
          "comment": [
            "Return the name of the reference supporting the remote tracking branch,\n given the name of a local branch reference."
          ],
          "group": "branch"
        },
        "git_branch_is_head": {
          "kind": "function",
          "name": "git_branch_is_head",
          "location": {
            "file": "branch.h",
            "line": 223,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if HEAD points at the branch, 0 if it isn't,\n error code otherwise."
          },
          "params": [
            {
              "name": "branch",
              "type": "git_reference *",
              "direction": "in",
              "comment": "Current underlying reference of the branch."
            }
          ],
          "comment": [
            "Determine if the current local branch is pointed at by HEAD."
          ],
          "group": "branch"
        },
        "git_branch_remote_name": {
          "kind": "function",
          "name": "git_branch_remote_name",
          "location": {
            "file": "branch.h",
            "line": 245,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "Number of characters in the reference name\n     including the trailing NUL byte; GIT_ENOTFOUND\n     when no remote matching remote was found,\n     GIT_EAMBIGUOUS when the branch maps to several remotes,\n     otherwise an error code."
          },
          "params": [
            {
              "name": "remote_name_out",
              "type": "char *",
              "direction": "in",
              "comment": "The user-allocated buffer which will be\n     filled with the name of the remote. Pass NULL if you just want to\n     get the needed size of the name of the remote as the output value."
            },
            {
              "name": "buffer_size",
              "type": "size_t",
              "direction": "in",
              "comment": "Size of the `out` buffer in bytes."
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repository where the branch lives."
            },
            {
              "name": "canonical_branch_name",
              "type": "const char *",
              "direction": "in",
              "comment": "name of the remote tracking branch."
            }
          ],
          "comment": [
            "Return the name of remote that the remote tracking branch belongs to."
          ],
          "group": "branch"
        },
        "git_branch_t": {
          "kind": "enum",
          "name": "git_branch_t",
          "referenceName": "git_branch_t",
          "members": [
            {
              "name": "GIT_BRANCH_LOCAL",
              "value": "1"
            },
            {
              "name": "GIT_BRANCH_REMOTE",
              "value": "2"
            }
          ],
          "comment": [
            "Basic type of any Git branch."
          ],
          "location": {
            "file": "types.h",
            "line": 190,
            "column": 9
          },
          "group": "branch",
          "parameterTo": [
            "git_branch_foreach_cb",
            "git_branch_lookup"
          ]
        }
      },
      "info": {
        "summary": "Git branch parsing routines"
      }
    },
    "checkout": {
      "apis": {
        "git_checkout_strategy_t": {
          "kind": "enum",
          "name": "git_checkout_strategy_t",
          "referenceName": "git_checkout_strategy_t",
          "members": [
            {
              "name": "GIT_CHECKOUT_NONE",
              "value": "0"
            },
            {
              "name": "GIT_CHECKOUT_SAFE",
              "comment": [
                "Allow safe updates that cannot overwrite uncommitted data"
              ]
            },
            {
              "name": "GIT_CHECKOUT_SAFE_CREATE",
              "comment": [
                "Allow safe updates plus creation of missing files"
              ]
            },
            {
              "name": "GIT_CHECKOUT_FORCE",
              "comment": [
                "Allow all updates to force working directory to look like index"
              ]
            },
            {
              "name": "GIT_CHECKOUT_ALLOW_CONFLICTS",
              "comment": [
                "Allow checkout to make safe updates even if conflicts are found"
              ]
            },
            {
              "name": "GIT_CHECKOUT_REMOVE_UNTRACKED",
              "comment": [
                "Remove untracked files not in index (that are not ignored)"
              ]
            },
            {
              "name": "GIT_CHECKOUT_REMOVE_IGNORED",
              "comment": [
                "Remove ignored files not in index"
              ]
            },
            {
              "name": "GIT_CHECKOUT_UPDATE_ONLY",
              "comment": [
                "Only update existing files, don't create new ones"
              ]
            },
            {
              "name": "GIT_CHECKOUT_DONT_UPDATE_INDEX",
              "comment": [
                "Normally checkout updates index entries as it goes; this stops that"
              ]
            },
            {
              "name": "GIT_CHECKOUT_NO_REFRESH",
              "comment": [
                "Don't refresh index/config/etc before doing checkout"
              ]
            },
            {
              "name": "GIT_CHECKOUT_DISABLE_PATHSPEC_MATCH",
              "comment": [
                "Treat pathspec as simple list of exact match file paths"
              ]
            },
            {
              "name": "GIT_CHECKOUT_SKIP_LOCKED_DIRECTORIES",
              "comment": [
                "Ignore directories in use, they will be left empty"
              ]
            },
            {
              "name": "GIT_CHECKOUT_SKIP_UNMERGED",
              "comment": [
                "Allow checkout to skip unmerged files (NOT IMPLEMENTED)"
              ]
            },
            {
              "name": "GIT_CHECKOUT_USE_OURS",
              "comment": [
                "For unmerged files, checkout stage 2 from index (NOT IMPLEMENTED)"
              ]
            },
            {
              "name": "GIT_CHECKOUT_USE_THEIRS",
              "comment": [
                "For unmerged files, checkout stage 3 from index (NOT IMPLEMENTED)"
              ]
            },
            {
              "name": "GIT_CHECKOUT_UPDATE_SUBMODULES",
              "comment": [
                "Recursively checkout submodules with same options (NOT IMPLEMENTED)"
              ]
            },
            {
              "name": "GIT_CHECKOUT_UPDATE_SUBMODULES_IF_CHANGED",
              "comment": [
                "Recursively checkout submodules if HEAD moved in super repo (NOT IMPLEMENTED)"
              ]
            }
          ],
          "comment": [
            "Checkout behavior flags",
            "In libgit2, checkout is used to update the working directory and index\n to match a target tree.  Unlike git checkout, it does not move the HEAD\n 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\n check out, the \"baseline\" tree of what was checked out previously, the\n working directory for actual files, and the index for staged changes.",
            "You give checkout one of four strategies for update:",
            "- `GIT_CHECKOUT_NONE` is a dry-run strategy that checks for conflicts,\n   etc., but doesn't make any actual changes.",
            "- `GIT_CHECKOUT_FORCE` is at the opposite extreme, taking any action to\n   make the working directory match the target (including potentially\n   discarding modified files).",
            "In between those are `GIT_CHECKOUT_SAFE` and `GIT_CHECKOUT_SAFE_CREATE`\n both of which only make modifications that will not lose changes.",
            "|  target == baseline   |  target != baseline  |\n ---------------------|-----------------------|----------------------|\n  workdir == baseline |       no action       |  create, update, or  |\n                      |                       |     delete file      |\n ---------------------|-----------------------|----------------------|\n  workdir exists and  |       no action       |   conflict (notify   |\n    is != baseline    | notify dirty MODIFIED | and cancel checkout) |\n ---------------------|-----------------------|----------------------|\n   workdir missing,   | create if SAFE_CREATE |     create file      |\n   baseline present   | notify dirty DELETED  |                      |\n ---------------------|-----------------------|----------------------|",
            "The only difference between SAFE and SAFE_CREATE is that SAFE_CREATE\n will cause a file to be checked out if it is missing from the working\n directory even if it is not modified between the target and baseline.",
            "To emulate `git checkout`, use `GIT_CHECKOUT_SAFE` with a checkout\n notification callback (see below) that displays information about dirty\n files.  The default behavior will cancel checkout on conflicts.",
            "To emulate `git checkout-index`, use `GIT_CHECKOUT_SAFE_CREATE` with a\n notification callback that cancels the operation if a dirty-but-existing\n file is found in the working directory.  This core git command isn't\n quite \"force\" but is sensitive about some types of changes.",
            "To emulate `git checkout -f`, use `GIT_CHECKOUT_FORCE`.",
            "To emulate `git clone` use `GIT_CHECKOUT_SAFE_CREATE` in the options.",
            "There are some additional flags to modified the behavior of checkout:",
            "- GIT_CHECKOUT_ALLOW_CONFLICTS makes SAFE mode apply safe file updates\n   even if there are conflicts (instead of cancelling the checkout).",
            "- GIT_CHECKOUT_REMOVE_UNTRACKED means remove untracked files (i.e. not\n   in target, baseline, or index, and not ignored) from the working dir.",
            "- GIT_CHECKOUT_REMOVE_IGNORED means remove ignored files (that are also\n   untracked) from the working directory as well.",
            "- GIT_CHECKOUT_UPDATE_ONLY means to only update the content of files that\n   already exist.  Files will not be created nor deleted.  This just skips\n   applying adds, deletes, and typechanges.",
            "- GIT_CHECKOUT_DONT_UPDATE_INDEX prevents checkout from writing the\n   updated files' information to the index.",
            "- Normally, checkout will reload the index and git attributes from disk\n   before any operations.  GIT_CHECKOUT_NO_REFRESH prevents this reload.",
            "- Unmerged index entries are conflicts.  GIT_CHECKOUT_SKIP_UNMERGED skips\n   files with unmerged index entries instead.  GIT_CHECKOUT_USE_OURS and\n   GIT_CHECKOUT_USE_THEIRS to proceed with the checkout using either the\n   stage 2 (\"ours\") or stage 3 (\"theirs\") version of files in the index."
          ],
          "location": {
            "file": "checkout.h",
            "line": 103,
            "column": 9
          },
          "group": "checkout"
        },
        "git_checkout_notify_t": {
          "kind": "enum",
          "name": "git_checkout_notify_t",
          "referenceName": "git_checkout_notify_t",
          "members": [
            {
              "name": "GIT_CHECKOUT_NOTIFY_NONE",
              "value": "0"
            },
            {
              "name": "GIT_CHECKOUT_NOTIFY_CONFLICT"
            },
            {
              "name": "GIT_CHECKOUT_NOTIFY_DIRTY"
            },
            {
              "name": "GIT_CHECKOUT_NOTIFY_UPDATED"
            },
            {
              "name": "GIT_CHECKOUT_NOTIFY_UNTRACKED"
            },
            {
              "name": "GIT_CHECKOUT_NOTIFY_IGNORED"
            },
            {
              "name": "GIT_CHECKOUT_NOTIFY_ALL"
            }
          ],
          "comment": [
            "Checkout notification flags",
            "Checkout will invoke an options notification callback (`notify_cb`) for\n certain cases - you pick which ones via `notify_flags`:",
            "- GIT_CHECKOUT_NOTIFY_CONFLICT invokes checkout on conflicting paths.",
            "- GIT_CHECKOUT_NOTIFY_DIRTY notifies about \"dirty\" files, i.e. those that\n   do not need an update but no longer match the baseline.  Core git\n   displays these files when checkout runs, but won't stop the checkout.",
            "- GIT_CHECKOUT_NOTIFY_UPDATED sends notification for any file changed.",
            "- GIT_CHECKOUT_NOTIFY_UNTRACKED notifies about untracked files.",
            "- GIT_CHECKOUT_NOTIFY_IGNORED notifies about ignored files.",
            "Returning a non-zero value from this callback will cancel the checkout.\n Notification callbacks are made prior to modifying any files on disk."
          ],
          "location": {
            "file": "checkout.h",
            "line": 179,
            "column": 9
          },
          "group": "checkout",
          "parameterTo": [
            "git_checkout_notify_cb"
          ]
        },
        "git_checkout_notify_cb": {
          "kind": "callback",
          "name": "git_checkout_notify_cb",
          "type": "int (*)(git_checkout_notify_t, const char *, const git_diff_file *, const git_diff_file *, const git_diff_file *, void *)",
          "comment": [
            "Checkout notification callback function"
          ],
          "location": {
            "file": "checkout.h",
            "line": 191,
            "column": 15
          },
          "params": [
            {
              "type": "git_checkout_notify_t"
            },
            {
              "type": "const char *"
            },
            {
              "type": "const git_diff_file *"
            },
            {
              "type": "const git_diff_file *"
            },
            {
              "type": "const git_diff_file *"
            },
            {
              "type": "void *"
            }
          ],
          "group": "checkout",
          "typedef": true
        },
        "git_checkout_progress_cb": {
          "kind": "callback",
          "name": "git_checkout_progress_cb",
          "type": "void (*)(const char *, size_t, size_t, void *)",
          "comment": [
            "Checkout progress notification function"
          ],
          "location": {
            "file": "checkout.h",
            "line": 200,
            "column": 16
          },
          "params": [
            {
              "type": "const char *"
            },
            {
              "type": "size_t"
            },
            {
              "type": "size_t"
            },
            {
              "type": "void *"
            }
          ],
          "returns": {
            "type": "void"
          },
          "group": "checkout",
          "typedef": true
        },
        "git_checkout_opts": {
          "kind": "struct",
          "name": "git_checkout_opts",
          "referenceName": "git_checkout_opts",
          "comment": [
            "Checkout options structure",
            "Zero out for defaults.  Initialize with `GIT_CHECKOUT_OPTS_INIT` macro to\n correctly set the `version` field.  E.g.",
            "git_checkout_opts opts = GIT_CHECKOUT_OPTS_INIT;"
          ],
          "members": [
            {
              "name": "version",
              "type": "unsigned int"
            },
            {
              "name": "checkout_strategy",
              "type": "unsigned int"
            },
            {
              "name": "disable_filters",
              "type": "int",
              "comment": [
                "default will be a dry run"
              ]
            },
            {
              "name": "dir_mode",
              "type": "unsigned int",
              "comment": [
                "don't apply filters like CRLF conversion"
              ]
            },
            {
              "name": "file_mode",
              "type": "unsigned int",
              "comment": [
                "default is 0755"
              ]
            },
            {
              "name": "file_open_flags",
              "type": "int",
              "comment": [
                "default is 0644 or 0755 as dictated by blob"
              ]
            },
            {
              "name": "notify_flags",
              "type": "unsigned int",
              "comment": [
                "default is O_CREAT | O_TRUNC | O_WRONLY"
              ]
            },
            {
              "name": "notify_cb",
              "type": "git_checkout_notify_cb",
              "comment": [
                "see `git_checkout_notify_t` above"
              ],
              "referenceType": "int (*)(git_checkout_notify_t, const char *, const git_diff_file *, const git_diff_file *, const git_diff_file *, void *)"
            },
            {
              "name": "notify_payload",
              "type": "void *"
            },
            {
              "name": "progress_cb",
              "type": "git_checkout_progress_cb",
              "referenceType": "void (*)(const char *, size_t, size_t, void *)"
            },
            {
              "name": "progress_payload",
              "type": "void *"
            },
            {
              "name": "paths",
              "type": "git_strarray",
              "comment": [
                "When not zeroed out, array of fnmatch patterns specifying which\n  paths should be taken into account, otherwise all files.  Use\n  GIT_CHECKOUT_DISABLE_PATHSPEC_MATCH to treat as simple list."
              ],
              "referenceType": "struct git_strarray"
            },
            {
              "name": "baseline",
              "type": "git_tree *"
            },
            {
              "name": "target_directory",
              "type": "const char *",
              "comment": [
                "expected content of workdir, defaults to HEAD"
              ]
            }
          ],
          "location": {
            "file": "checkout.h",
            "line": 214,
            "column": 16
          },
          "group": "checkout",
          "parameterTo": [
            "git_checkout_head",
            "git_checkout_index",
            "git_checkout_tree"
          ]
        },
        "GIT_CHECKOUT_OPTS_VERSION": {
          "kind": "macro",
          "name": "GIT_CHECKOUT_OPTS_VERSION",
          "location": {
            "file": "checkout.h",
            "line": 243,
            "column": 9
          },
          "value": "1",
          "comment": "",
          "group": "checkout"
        },
        "GIT_CHECKOUT_OPTS_INIT": {
          "kind": "macro",
          "name": "GIT_CHECKOUT_OPTS_INIT",
          "location": {
            "file": "checkout.h",
            "line": 244,
            "column": 9
          },
          "value": "{GIT_CHECKOUT_OPTS_VERSION}",
          "comment": "",
          "group": "checkout"
        },
        "git_checkout_head": {
          "kind": "function",
          "name": "git_checkout_head",
          "location": {
            "file": "checkout.h",
            "line": 256,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EORPHANEDHEAD when HEAD points to a non existing\n branch, GIT_ERROR otherwise (use giterr_last for information\n about the error)"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository to check out (must be non-bare)"
            },
            {
              "name": "opts",
              "type": "git_checkout_opts *",
              "direction": "in",
              "comment": "specifies checkout options (may be NULL)"
            }
          ],
          "comment": [
            "Updates files in the index and the working tree to match the content of\n the commit pointed at by HEAD."
          ],
          "group": "checkout"
        },
        "git_checkout_index": {
          "kind": "function",
          "name": "git_checkout_index",
          "location": {
            "file": "checkout.h",
            "line": 269,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_ERROR otherwise (use giterr_last for information\n about the error)"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository into which to check out (must be non-bare)"
            },
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "index to be checked out (or NULL to use repository index)"
            },
            {
              "name": "opts",
              "type": "git_checkout_opts *",
              "direction": "in",
              "comment": "specifies checkout options (may be NULL)"
            }
          ],
          "comment": [
            "Updates files in the working tree to match the content of the index."
          ],
          "group": "checkout"
        },
        "git_checkout_tree": {
          "kind": "function",
          "name": "git_checkout_tree",
          "location": {
            "file": "checkout.h",
            "line": 285,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_ERROR otherwise (use giterr_last for information\n about the error)"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository to check out (must be non-bare)"
            },
            {
              "name": "treeish",
              "type": "const git_object *",
              "direction": "in",
              "comment": "a commit, tag or tree which content will be used to update\n the working directory"
            },
            {
              "name": "opts",
              "type": "git_checkout_opts *",
              "direction": "in",
              "comment": "specifies checkout options (may be NULL)"
            }
          ],
          "comment": [
            "Updates files in the index and working tree to match the content of the\n tree pointed at by the treeish."
          ],
          "group": "checkout"
        }
      },
      "info": {
        "summary": "Git checkout routines"
      }
    },
    "clone": {
      "apis": {
        "git_clone_options": {
          "kind": "struct",
          "name": "git_clone_options",
          "referenceName": "git_clone_options",
          "comment": [
            "Clone options structure",
            "Use zeros to indicate default settings.  It's easiest to use the\n `GIT_CLONE_OPTIONS_INIT` macro:",
            "git_clone_options opts = GIT_CLONE_OPTIONS_INIT;",
            "- `checkout_opts` is options for the checkout step.  To disable checkout,\n   set the `checkout_strategy` to GIT_CHECKOUT_DEFAULT.\n - `bare` should be set to zero to create a standard repo, non-zero for\n   a bare repo\n - `fetch_progress_cb` is optional callback for fetch progress. Be aware that\n   this is called inline with network and indexing operations, so performance\n   may be affected.\n - `fetch_progress_payload` is payload for fetch_progress_cb",
            "** \"origin\" remote options: **\n - `remote_name` is the name given to the \"origin\" remote.  The default is\n   \"origin\".\n - `pushurl` is a URL to be used for pushing.  NULL means use the fetch url.\n - `fetch_spec` is the fetch specification to be used for fetching.  NULL\n   results in the same behavior as GIT_REMOTE_DEFAULT_FETCH.\n - `push_spec` is the fetch specification to be used for pushing.  NULL means\n   use the same spec as for fetching.\n - `cred_acquire_cb` is a callback to be used if credentials are required\n   during the initial fetch.\n - `cred_acquire_payload` is the payload for the above callback.\n - `transport_flags` is flags used to create transport if no transport is\n   provided.\n - `transport` is a custom transport to be used for the initial fetch.  NULL\n   means use the transport autodetected from the URL.\n - `remote_callbacks` may be used to specify custom progress callbacks for\n   the origin remote before the fetch is initiated.\n - `remote_autotag` may be used to specify the autotag setting before the\n   initial fetch.  The default is GIT_REMOTE_DOWNLOAD_TAGS_ALL.\n - `checkout_branch` gives the name of the branch to checkout. NULL means\n   use the remote's HEAD."
          ],
          "members": [
            {
              "name": "version",
              "type": "unsigned int"
            },
            {
              "name": "checkout_opts",
              "type": "git_checkout_opts",
              "referenceType": "struct git_checkout_opts"
            },
            {
              "name": "bare",
              "type": "int"
            },
            {
              "name": "fetch_progress_cb",
              "type": "git_transfer_progress_callback",
              "referenceType": "int (*)(const git_transfer_progress *, void *)"
            },
            {
              "name": "fetch_progress_payload",
              "type": "void *"
            },
            {
              "name": "remote_name",
              "type": "const char *"
            },
            {
              "name": "pushurl",
              "type": "const char *"
            },
            {
              "name": "fetch_spec",
              "type": "const char *"
            },
            {
              "name": "push_spec",
              "type": "const char *"
            },
            {
              "name": "cred_acquire_cb",
              "type": "git_cred_acquire_cb",
              "referenceType": "int (*)(git_cred **, const char *, const char *, unsigned int, void *)"
            },
            {
              "name": "cred_acquire_payload",
              "type": "void *"
            },
            {
              "name": "transport_flags",
              "type": "git_transport_flags_t",
              "referenceType": "enum git_transport_flags_t"
            },
            {
              "name": "transport",
              "type": "git_transport *"
            },
            {
              "name": "remote_callbacks",
              "type": "git_remote_callbacks *"
            },
            {
              "name": "remote_autotag",
              "type": "git_remote_autotag_option_t",
              "referenceType": "enum git_remote_autotag_option_t"
            },
            {
              "name": "checkout_branch",
              "type": "const char *"
            }
          ],
          "location": {
            "file": "clone.h",
            "line": 66,
            "column": 16
          },
          "group": "clone",
          "parameterTo": [
            "git_clone"
          ]
        },
        "GIT_CLONE_OPTIONS_VERSION": {
          "kind": "macro",
          "name": "GIT_CLONE_OPTIONS_VERSION",
          "location": {
            "file": "clone.h",
            "line": 87,
            "column": 9
          },
          "value": "1",
          "comment": "",
          "group": "clone"
        },
        "GIT_CLONE_OPTIONS_INIT": {
          "kind": "macro",
          "name": "GIT_CLONE_OPTIONS_INIT",
          "location": {
            "file": "clone.h",
            "line": 88,
            "column": 9
          },
          "value": "{GIT_CLONE_OPTIONS_VERSION, {GIT_CHECKOUT_OPTS_VERSION, GIT_CHECKOUT_SAFE_CREATE}}",
          "comment": "",
          "group": "clone"
        },
        "git_clone": {
          "kind": "function",
          "name": "git_clone",
          "location": {
            "file": "clone.h",
            "line": 102,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_ERROR otherwise (use giterr_last for information\n about the error)"
          },
          "params": [
            {
              "name": "out",
              "type": "git_repository **",
              "direction": "in",
              "comment": "pointer that will receive the resulting repository object"
            },
            {
              "name": "url",
              "type": "const char *",
              "direction": "in",
              "comment": "the remote repository to clone"
            },
            {
              "name": "local_path",
              "type": "const char *",
              "direction": "in",
              "comment": "local directory to clone to"
            },
            {
              "name": "options",
              "type": "const git_clone_options *",
              "direction": "in",
              "comment": "configuration options for the clone.  If NULL, the function\n works as though GIT_OPTIONS_INIT were passed."
            }
          ],
          "comment": [
            "Clone a remote repository, and checkout the branch pointed to by the remote\n HEAD."
          ],
          "group": "clone"
        }
      },
      "info": {
        "summary": "Git cloning routines"
      }
    },
    "commit": {
      "apis": {
        "git_commit_lookup": {
          "kind": "function",
          "name": "git_commit_lookup",
          "location": {
            "file": "commit.h",
            "line": 33,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "commit",
              "type": "git_commit **",
              "direction": "in",
              "comment": "pointer to the looked up commit"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repo to use when locating the commit."
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "identity of the commit to locate. If the object is\n\t\tan annotated tag it will be peeled back to the commit."
            }
          ],
          "comment": [
            "Lookup a commit object from a repository."
          ],
          "group": "commit"
        },
        "git_commit_lookup_prefix": {
          "kind": "function",
          "name": "git_commit_lookup_prefix",
          "location": {
            "file": "commit.h",
            "line": 48,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "commit",
              "type": "git_commit **",
              "direction": "in",
              "comment": "pointer to the looked up commit"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repo to use when locating the commit."
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "identity of the commit to locate. If the object is\n\t\tan annotated tag it will be peeled back to the commit."
            },
            {
              "name": "len",
              "type": "size_t",
              "direction": "in",
              "comment": "the length of the short identifier"
            }
          ],
          "comment": [
            "Lookup a commit object from a repository,\n given a prefix of its identifier (short id)."
          ],
          "see": [
            "git_object_lookup_prefix"
          ],
          "group": "commit"
        },
        "git_commit_free": {
          "kind": "function",
          "name": "git_commit_free",
          "location": {
            "file": "commit.h",
            "line": 62,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "commit",
              "type": "git_commit *",
              "direction": "in",
              "comment": "the commit to close"
            }
          ],
          "comment": [
            "Close an open commit",
            "This is a wrapper around git_object_free()",
            "IMPORTANT:\n It *is* necessary to call this method when you stop\n using a commit. Failure to do so will cause a memory leak."
          ],
          "group": "commit"
        },
        "git_commit_id": {
          "kind": "function",
          "name": "git_commit_id",
          "location": {
            "file": "commit.h",
            "line": 70,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "object identity for the commit."
          },
          "params": [
            {
              "name": "commit",
              "type": "const git_commit *",
              "direction": "in",
              "comment": "a previously loaded commit."
            }
          ],
          "comment": [
            "Get the id of a commit."
          ],
          "group": "commit"
        },
        "git_commit_owner": {
          "kind": "function",
          "name": "git_commit_owner",
          "location": {
            "file": "commit.h",
            "line": 78,
            "column": 30
          },
          "returns": {
            "type": "git_repository *",
            "comment": "Repository that contains this commit."
          },
          "params": [
            {
              "name": "commit",
              "type": "const git_commit *",
              "direction": "in",
              "comment": "A previously loaded commit."
            }
          ],
          "comment": [
            "Get the repository that contains the commit."
          ],
          "group": "commit"
        },
        "git_commit_message_encoding": {
          "kind": "function",
          "name": "git_commit_message_encoding",
          "location": {
            "file": "commit.h",
            "line": 90,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "NULL, or the encoding"
          },
          "params": [
            {
              "name": "commit",
              "type": "const git_commit *",
              "direction": "in",
              "comment": "a previously loaded commit."
            }
          ],
          "comment": [
            "Get the encoding for the message of a commit,\n as a string representing a standard encoding name.",
            "The encoding may be NULL if the `encoding` header\n in the commit is missing; in that case UTF-8 is assumed."
          ],
          "group": "commit"
        },
        "git_commit_message": {
          "kind": "function",
          "name": "git_commit_message",
          "location": {
            "file": "commit.h",
            "line": 98,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "the message of a commit"
          },
          "params": [
            {
              "name": "commit",
              "type": "const git_commit *",
              "direction": "in",
              "comment": "a previously loaded commit."
            }
          ],
          "comment": [
            "Get the full message of a commit."
          ],
          "group": "commit"
        },
        "git_commit_time": {
          "kind": "function",
          "name": "git_commit_time",
          "location": {
            "file": "commit.h",
            "line": 106,
            "column": 24
          },
          "returns": {
            "type": "git_time_t",
            "comment": "the time of a commit"
          },
          "params": [
            {
              "name": "commit",
              "type": "const git_commit *",
              "direction": "in",
              "comment": "a previously loaded commit."
            }
          ],
          "comment": [
            "Get the commit time (i.e. committer time) of a commit."
          ],
          "group": "commit"
        },
        "git_commit_time_offset": {
          "kind": "function",
          "name": "git_commit_time_offset",
          "location": {
            "file": "commit.h",
            "line": 114,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "positive or negative timezone offset, in minutes from UTC"
          },
          "params": [
            {
              "name": "commit",
              "type": "const git_commit *",
              "direction": "in",
              "comment": "a previously loaded commit."
            }
          ],
          "comment": [
            "Get the commit timezone offset (i.e. committer's preferred timezone) of a commit."
          ],
          "group": "commit"
        },
        "git_commit_committer": {
          "kind": "function",
          "name": "git_commit_committer",
          "location": {
            "file": "commit.h",
            "line": 122,
            "column": 35
          },
          "returns": {
            "type": "const git_signature *",
            "comment": "the committer of a commit"
          },
          "params": [
            {
              "name": "commit",
              "type": "const git_commit *",
              "direction": "in",
              "comment": "a previously loaded commit."
            }
          ],
          "comment": [
            "Get the committer of a commit."
          ],
          "group": "commit"
        },
        "git_commit_author": {
          "kind": "function",
          "name": "git_commit_author",
          "location": {
            "file": "commit.h",
            "line": 130,
            "column": 35
          },
          "returns": {
            "type": "const git_signature *",
            "comment": "the author of a commit"
          },
          "params": [
            {
              "name": "commit",
              "type": "const git_commit *",
              "direction": "in",
              "comment": "a previously loaded commit."
            }
          ],
          "comment": [
            "Get the author of a commit."
          ],
          "group": "commit"
        },
        "git_commit_tree": {
          "kind": "function",
          "name": "git_commit_tree",
          "location": {
            "file": "commit.h",
            "line": 139,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "tree_out",
              "type": "git_tree **",
              "direction": "in",
              "comment": "pointer where to store the tree object"
            },
            {
              "name": "commit",
              "type": "const git_commit *",
              "direction": "in",
              "comment": "a previously loaded commit."
            }
          ],
          "comment": [
            "Get the tree pointed to by a commit."
          ],
          "group": "commit"
        },
        "git_commit_tree_id": {
          "kind": "function",
          "name": "git_commit_tree_id",
          "location": {
            "file": "commit.h",
            "line": 149,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "the id of tree pointed to by commit."
          },
          "params": [
            {
              "name": "commit",
              "type": "const git_commit *",
              "direction": "in",
              "comment": "a previously loaded commit."
            }
          ],
          "comment": [
            "Get the id of the tree pointed to by a commit. This differs from\n `git_commit_tree` in that no attempts are made to fetch an object\n from the ODB."
          ],
          "group": "commit"
        },
        "git_commit_parentcount": {
          "kind": "function",
          "name": "git_commit_parentcount",
          "location": {
            "file": "commit.h",
            "line": 157,
            "column": 26
          },
          "returns": {
            "type": "unsigned int",
            "comment": "integer of count of parents"
          },
          "params": [
            {
              "name": "commit",
              "type": "const git_commit *",
              "direction": "in",
              "comment": "a previously loaded commit."
            }
          ],
          "comment": [
            "Get the number of parents of this commit"
          ],
          "group": "commit"
        },
        "git_commit_parent": {
          "kind": "function",
          "name": "git_commit_parent",
          "location": {
            "file": "commit.h",
            "line": 167,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_commit **",
              "direction": "in",
              "comment": "Pointer where to store the parent commit"
            },
            {
              "name": "commit",
              "type": "const git_commit *",
              "direction": "in",
              "comment": "a previously loaded commit."
            },
            {
              "name": "n",
              "type": "unsigned int",
              "direction": "in",
              "comment": "the position of the parent (from 0 to `parentcount`)"
            }
          ],
          "comment": [
            "Get the specified parent of the commit."
          ],
          "group": "commit"
        },
        "git_commit_parent_id": {
          "kind": "function",
          "name": "git_commit_parent_id",
          "location": {
            "file": "commit.h",
            "line": 181,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "the id of the parent, NULL on error."
          },
          "params": [
            {
              "name": "commit",
              "type": "const git_commit *",
              "direction": "in",
              "comment": "a previously loaded commit."
            },
            {
              "name": "n",
              "type": "unsigned int",
              "direction": "in",
              "comment": "the position of the parent (from 0 to `parentcount`)"
            }
          ],
          "comment": [
            "Get the oid of a specified parent for a commit. This is different from\n `git_commit_parent`, which will attempt to load the parent commit from\n the ODB."
          ],
          "group": "commit"
        },
        "git_commit_nth_gen_ancestor": {
          "kind": "function",
          "name": "git_commit_nth_gen_ancestor",
          "location": {
            "file": "commit.h",
            "line": 199,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success; GIT_ENOTFOUND if no matching ancestor exists\n or an error code"
          },
          "params": [
            {
              "name": "ancestor",
              "type": "git_commit **",
              "direction": "in",
              "comment": "Pointer where to store the ancestor commit"
            },
            {
              "name": "commit",
              "type": "const git_commit *",
              "direction": "in",
              "comment": "a previously loaded commit."
            },
            {
              "name": "n",
              "type": "unsigned int",
              "direction": "in",
              "comment": "the requested generation"
            }
          ],
          "comment": [
            "Get the commit object that is the \n<n>th generation ancestor\n of the named commit object, following only the first parents.\n The returned commit has to be freed by the caller.",
            "Passing `0` as the generation number returns another instance of the\n base commit itself."
          ],
          "group": "commit"
        },
        "git_commit_create": {
          "kind": "function",
          "name": "git_commit_create",
          "location": {
            "file": "commit.h",
            "line": 247,
            "column": 17
          },
          "returns": {
            "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"
          },
          "params": [
            {
              "name": "id",
              "type": "git_oid *",
              "direction": "in",
              "comment": "Pointer in which to store the OID of the newly created commit"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where to store the commit"
            },
            {
              "name": "update_ref",
              "type": "const char *",
              "direction": "in",
              "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."
            },
            {
              "name": "author",
              "type": "const git_signature *",
              "direction": "in",
              "comment": "Signature with author and author time of commit"
            },
            {
              "name": "committer",
              "type": "const git_signature *",
              "direction": "in",
              "comment": "Signature with committer and * commit time of commit"
            },
            {
              "name": "message_encoding",
              "type": "const char *",
              "direction": "in",
              "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 *",
              "direction": "in",
              "comment": "Full message for this commit"
            },
            {
              "name": "tree",
              "type": "const git_tree *",
              "direction": "in",
              "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`."
            },
            {
              "name": "parent_count",
              "type": "int",
              "direction": "in",
              "comment": "Number of parents for this commit"
            },
            {
              "name": "parents",
              "type": "const git_commit **",
              "direction": "in",
              "comment": "Array of `parent_count` pointers to `git_commit`\n  objects that will be used as the parents for this commit. This\n  array may be NULL if `parent_count` is 0 (root commit). All the\n  given commits must be owned by the `repo`."
            }
          ],
          "comment": [
            "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\n the `git_message_prettify()` function."
          ],
          "group": "commit"
        },
        "git_commit_create_v": {
          "kind": "function",
          "name": "git_commit_create_v",
          "location": {
            "file": "commit.h",
            "line": 273,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "id",
              "type": "git_oid *"
            },
            {
              "name": "repo",
              "type": "git_repository *"
            },
            {
              "name": "update_ref",
              "type": "const char *"
            },
            {
              "name": "author",
              "type": "const git_signature *"
            },
            {
              "name": "committer",
              "type": "const git_signature *"
            },
            {
              "name": "message_encoding",
              "type": "const char *"
            },
            {
              "name": "message",
              "type": "const char *"
            },
            {
              "name": "tree",
              "type": "const git_tree *"
            },
            {
              "name": "parent_count",
              "type": "int"
            }
          ],
          "comment": [
            "Create new commit in the repository using a variable argument list.",
            "The message will be cleaned up from excess whitespace and it will be made\n sure that the last line ends with a '\\n\n'.",
            "The parents for the commit are specified as a variable list of pointers\n to `const git_commit *`. Note that this is a convenience method which may\n not be safe to export for certain languages or compilers",
            "All other parameters remain the same at `git_commit_create()`."
          ],
          "see": [
            "git_commit_create"
          ],
          "group": "commit"
        },
        "git_commit": {
          "kind": "struct",
          "name": "git_commit",
          "referenceName": "struct git_commit",
          "opaque": true,
          "comment": [
            "Parsed representation of a commit object."
          ],
          "location": {
            "file": "types.h",
            "line": 120,
            "column": 27
          },
          "group": "commit",
          "parameterTo": [
            "git_branch_create",
            "git_commit_lookup",
            "git_commit_lookup_prefix",
            "git_commit_free",
            "git_commit_id",
            "git_commit_owner",
            "git_commit_message_encoding",
            "git_commit_message",
            "git_commit_time",
            "git_commit_time_offset",
            "git_commit_committer",
            "git_commit_author",
            "git_commit_tree",
            "git_commit_tree_id",
            "git_commit_parentcount",
            "git_commit_parent",
            "git_commit_parent_id",
            "git_commit_nth_gen_ancestor",
            "git_commit_create"
          ]
        }
      },
      "info": {
        "summary": "Git commit parsing, formatting routines"
      }
    },
    "sys/commit": {
      "apis": {
        "git_commit_create_from_oids": {
          "kind": "function",
          "name": "git_commit_create_from_oids",
          "location": {
            "file": "sys/commit.h",
            "line": 32,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "oid",
              "type": "git_oid *"
            },
            {
              "name": "repo",
              "type": "git_repository *"
            },
            {
              "name": "update_ref",
              "type": "const char *"
            },
            {
              "name": "author",
              "type": "const git_signature *"
            },
            {
              "name": "committer",
              "type": "const git_signature *"
            },
            {
              "name": "message_encoding",
              "type": "const char *"
            },
            {
              "name": "message",
              "type": "const char *"
            },
            {
              "name": "tree",
              "type": "const git_oid *"
            },
            {
              "name": "parent_count",
              "type": "int"
            },
            {
              "name": "parents",
              "type": "const git_oid **"
            }
          ],
          "comment": [
            "Create new commit in the repository from a list of `git_oid` values",
            "See documentation for `git_commit_create()` for information about the\n parameters, as the meaning is identical excepting that `tree` and\n `parents` now take `git_oid`.  This is a dangerous API in that nor\n the `tree`, neither the `parents` list of `git_oid`s are checked for\n validity."
          ],
          "group": "sys/commit"
        }
      },
      "info": {
        "summary": "Low-level Git commit creation"
      }
    },
    "common": {
      "apis": {
        "GIT_EXTERN(type)": {
          "kind": "macro",
          "name": "GIT_EXTERN(type)",
          "location": {
            "file": "common.h",
            "line": 33,
            "column": 10
          },
          "value": "extern __attribute__((visibility(\"default\"))) type",
          "comment": "Declare a public function exported for application use.",
          "group": "common"
        },
        "GIT_INLINE(type)": {
          "kind": "macro",
          "name": "GIT_INLINE(type)",
          "location": {
            "file": "common.h",
            "line": 42,
            "column": 10
          },
          "value": "static __inline type",
          "comment": "Declare a function as always inlined.",
          "group": "common"
        },
        "GIT_FORMAT_PRINTF(a,b)": {
          "kind": "macro",
          "name": "GIT_FORMAT_PRINTF(a,b)",
          "location": {
            "file": "common.h",
            "line": 49,
            "column": 10
          },
          "value": "__attribute__((format (printf, a, b)))",
          "comment": "Declare a function's takes printf style arguments.",
          "group": "common"
        },
        "GIT_PATH_LIST_SEPARATOR": {
          "kind": "macro",
          "name": "GIT_PATH_LIST_SEPARATOR",
          "location": {
            "file": "common.h",
            "line": 78,
            "column": 9
          },
          "value": "';'",
          "comment": "The separator used in path list strings (ie like in the PATH environment variable). A semi-colon \";\" is used on Windows, and a colon \":\" for all other systems.",
          "group": "common"
        },
        "GIT_PATH_MAX": {
          "kind": "macro",
          "name": "GIT_PATH_MAX",
          "location": {
            "file": "common.h",
            "line": 86,
            "column": 9
          },
          "value": "4096",
          "comment": "The maximum length of a valid git path.",
          "group": "common"
        },
        "GIT_OID_HEX_ZERO": {
          "kind": "macro",
          "name": "GIT_OID_HEX_ZERO",
          "location": {
            "file": "common.h",
            "line": 91,
            "column": 9
          },
          "value": "\"0000000000000000000000000000000000000000\"",
          "comment": "The string representation of the null object ID.",
          "group": "common"
        },
        "git_libgit2_version": {
          "kind": "function",
          "name": "git_libgit2_version",
          "location": {
            "file": "common.h",
            "line": 101,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "major",
              "type": "int *",
              "direction": "in",
              "comment": "Store the major version number"
            },
            {
              "name": "minor",
              "type": "int *",
              "direction": "in",
              "comment": "Store the minor version number"
            },
            {
              "name": "rev",
              "type": "int *",
              "direction": "in",
              "comment": "Store the revision (patch) number"
            }
          ],
          "comment": [
            "Return the version of the libgit2 library\n being currently used."
          ],
          "group": "common"
        },
        "git_cap_t": {
          "kind": "enum",
          "name": "git_cap_t",
          "referenceName": "git_cap_t",
          "members": [
            {
              "name": "GIT_CAP_THREADS",
              "value": "1"
            },
            {
              "name": "GIT_CAP_HTTPS",
              "value": "2"
            }
          ],
          "comment": [
            "Combinations of these values describe the capabilities of libgit2."
          ],
          "location": {
            "file": "common.h",
            "line": 106,
            "column": 9
          },
          "group": "common"
        },
        "git_libgit2_capabilities": {
          "kind": "function",
          "name": "git_libgit2_capabilities",
          "location": {
            "file": "common.h",
            "line": 125,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "A combination of GIT_CAP_* values."
          },
          "comment": [
            "Query compile time options for libgit2.",
            "- GIT_CAP_THREADS\n   Libgit2 was compiled with thread support. Note that thread support is\n   still to be seen as a 'work in progress' - basic object lookups are\n   believed to be threadsafe, but other operations may not be.",
            "- GIT_CAP_HTTPS\n   Libgit2 supports the https:// protocol. This requires the openssl\n   library to be found when compiling libgit2."
          ],
          "group": "common"
        },
        "git_libgit2_opt_t": {
          "kind": "enum",
          "name": "git_libgit2_opt_t",
          "referenceName": "git_libgit2_opt_t",
          "members": [
            {
              "name": "GIT_OPT_GET_MWINDOW_SIZE"
            },
            {
              "name": "GIT_OPT_SET_MWINDOW_SIZE"
            },
            {
              "name": "GIT_OPT_GET_MWINDOW_MAPPED_LIMIT"
            },
            {
              "name": "GIT_OPT_SET_MWINDOW_MAPPED_LIMIT"
            },
            {
              "name": "GIT_OPT_GET_SEARCH_PATH"
            },
            {
              "name": "GIT_OPT_SET_SEARCH_PATH"
            },
            {
              "name": "GIT_OPT_SET_CACHE_OBJECT_LIMIT"
            },
            {
              "name": "GIT_OPT_SET_CACHE_MAX_SIZE"
            },
            {
              "name": "GIT_OPT_ENABLE_CACHING"
            },
            {
              "name": "GIT_OPT_GET_CACHED_MEMORY"
            }
          ],
          "location": {
            "file": "common.h",
            "line": 128,
            "column": 9
          },
          "group": "common"
        },
        "git_libgit2_opts": {
          "kind": "function",
          "name": "git_libgit2_opts",
          "location": {
            "file": "common.h",
            "line": 216,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, \n<\n0 on failure"
          },
          "params": [
            {
              "name": "option",
              "type": "int",
              "direction": "in",
              "comment": "Option key"
            }
          ],
          "comment": [
            "Set or query a library global option",
            "Available options:",
            "* opts(GIT_OPT_GET_MWINDOW_SIZE, size_t *):",
            "> Get the maximum mmap window size",
            "* opts(GIT_OPT_SET_MWINDOW_SIZE, size_t):",
            "> Set the maximum mmap window size",
            "* opts(GIT_OPT_GET_MWINDOW_MAPPED_LIMIT, size_t *):",
            "> Get the maximum memory that will be mapped in total by the library",
            "* opts(GIT_OPT_SET_MWINDOW_MAPPED_LIMIT, size_t):",
            ">Set the maximum amount of memory that can be mapped at any time\n\t\tby the library",
            "* opts(GIT_OPT_GET_SEARCH_PATH, int level, char *out, size_t len)",
            "> Get the search path for a given level of config data.  \"level\" must\n\t\t> be one of `GIT_CONFIG_LEVEL_SYSTEM`, `GIT_CONFIG_LEVEL_GLOBAL`, or\n\t\t> `GIT_CONFIG_LEVEL_XDG`.  The search path is written to the `out`\n\t\t> buffer up to size `len`.  Returns GIT_EBUFS if buffer is too small.",
            "* opts(GIT_OPT_SET_SEARCH_PATH, int level, const char *path)",
            "> Set the search path for a level of config data.  The search path\n\t\t> applied to shared attributes and ignore files, too.\n\t\t>\n\t\t> - `path` lists directories delimited by GIT_PATH_LIST_SEPARATOR.\n\t\t>   Pass NULL to reset to the default (generally based on environment\n\t\t>   variables).  Use magic path `$PATH` to include the old value\n\t\t>   of the path (if you want to prepend or append, for instance).\n\t\t>\n\t\t> - `level` must be GIT_CONFIG_LEVEL_SYSTEM, GIT_CONFIG_LEVEL_GLOBAL,\n\t\t>   or GIT_CONFIG_LEVEL_XDG.",
            "* opts(GIT_OPT_SET_CACHE_OBJECT_LIMIT, git_otype type, size_t size)",
            "> Set the maximum data size for the given type of object to be\n\t\t> considered eligible for caching in memory.  Setting to value to\n\t\t> zero means that that type of object will not be cached.\n\t\t> Defaults to 0 for GIT_OBJ_BLOB (i.e. won't cache blobs) and 4k\n\t\t> for GIT_OBJ_COMMIT, GIT_OBJ_TREE, and GIT_OBJ_TAG.",
            "* opts(GIT_OPT_SET_CACHE_MAX_SIZE, ssize_t max_storage_bytes)",
            "> Set the maximum total data size that will be cached in memory\n\t\t> across all repositories before libgit2 starts evicting objects\n\t\t> from the cache.  This is a soft limit, in that the library might\n\t\t> briefly exceed it, but will start aggressively evicting objects\n\t\t> from cache when that happens.  The default cache size is 256Mb.",
            "* opts(GIT_OPT_ENABLE_CACHING, int enabled)",
            "> Enable or disable caching completely.\n\t\t>\n\t\t> Because caches are repository-specific, disabling the cache\n\t\t> cannot immediately clear all cached objects, but each cache will\n\t\t> be cleared on the next attempt to update anything in it.",
            "* opts(GIT_OPT_GET_CACHED_MEMORY, ssize_t *current, ssize_t *allowed)",
            "> Get the current bytes in cache and the maximum that would be\n\t\t> allowed in the cache."
          ],
          "group": "common"
        }
      },
      "info": {
        "summary": "Git common platform definitions"
      }
    },
    "config": {
      "apis": {
        "git_config_level_t": {
          "kind": "enum",
          "name": "git_config_level_t",
          "referenceName": "git_config_level_t",
          "members": [
            {
              "name": "GIT_CONFIG_LEVEL_SYSTEM",
              "value": "1",
              "comment": [
                "System-wide configuration file; /etc/gitconfig on Linux systems"
              ]
            },
            {
              "name": "GIT_CONFIG_LEVEL_XDG",
              "value": "2",
              "comment": [
                "XDG compatible configuration file; typically ~/.config/git/config"
              ]
            },
            {
              "name": "GIT_CONFIG_LEVEL_GLOBAL",
              "value": "3",
              "comment": [
                "User-specific configuration file (also called Global configuration\n file); typically ~/.gitconfig"
              ]
            },
            {
              "name": "GIT_CONFIG_LEVEL_LOCAL",
              "value": "4",
              "comment": [
                "Repository specific configuration file; $WORK_DIR/.git/config on\n non-bare repos"
              ]
            },
            {
              "name": "GIT_CONFIG_LEVEL_APP",
              "value": "5",
              "comment": [
                "Application specific configuration file; freely defined by applications"
              ]
            },
            {
              "name": "GIT_CONFIG_HIGHEST_LEVEL",
              "value": "-1",
              "comment": [
                "Represents the highest level available config file (i.e. the most\n specific config file available that actually is loaded)"
              ]
            }
          ],
          "comment": [
            "Priority level of a config file.\n These priority levels correspond to the natural escalation logic\n (from higher to lower) when searching for config entries in git.git.",
            "git_config_open_default() and git_repository_config() honor those\n priority levels as well."
          ],
          "location": {
            "file": "config.h",
            "line": 30,
            "column": 9
          },
          "group": "config",
          "parameterTo": [
            "git_config_add_file_ondisk",
            "git_config_open_level",
            "git_config_add_backend"
          ]
        },
        "git_config_entry": {
          "kind": "struct",
          "name": "git_config_entry",
          "referenceName": "git_config_entry",
          "members": [
            {
              "name": "name",
              "type": "const char *"
            },
            {
              "name": "value",
              "type": "const char *"
            },
            {
              "name": "level",
              "type": "git_config_level_t",
              "referenceType": "enum git_config_level_t"
            }
          ],
          "location": {
            "file": "config.h",
            "line": 57,
            "column": 9
          },
          "group": "config",
          "parameterTo": [
            "git_config_foreach_cb",
            "git_config_get_entry"
          ]
        },
        "git_config_foreach_cb": {
          "kind": "callback",
          "name": "git_config_foreach_cb",
          "type": "int (*)(const git_config_entry *, void *)",
          "location": {
            "file": "config.h",
            "line": 63,
            "column": 16
          },
          "params": [
            {
              "type": "const git_config_entry *"
            },
            {
              "type": "void *"
            }
          ],
          "group": "config",
          "parameterTo": [
            "git_config_get_multivar",
            "git_config_foreach",
            "git_config_foreach_match"
          ],
          "typedef": true
        },
        "git_cvar_t": {
          "kind": "enum",
          "name": "git_cvar_t",
          "referenceName": "git_cvar_t",
          "members": [
            {
              "name": "GIT_CVAR_FALSE",
              "value": "0"
            },
            {
              "name": "GIT_CVAR_TRUE",
              "value": "1"
            },
            {
              "name": "GIT_CVAR_INT32"
            },
            {
              "name": "GIT_CVAR_STRING"
            }
          ],
          "location": {
            "file": "config.h",
            "line": 65,
            "column": 9
          },
          "group": "config"
        },
        "git_cvar_map": {
          "kind": "struct",
          "name": "git_cvar_map",
          "referenceName": "git_cvar_map",
          "members": [
            {
              "name": "cvar_type",
              "type": "git_cvar_t",
              "referenceType": "enum git_cvar_t"
            },
            {
              "name": "str_match",
              "type": "const char *"
            },
            {
              "name": "map_value",
              "type": "int"
            }
          ],
          "location": {
            "file": "config.h",
            "line": 72,
            "column": 9
          },
          "group": "config",
          "parameterTo": [
            "git_config_get_mapped",
            "git_config_lookup_map_value"
          ]
        },
        "git_config_find_global": {
          "kind": "function",
          "name": "git_config_find_global",
          "location": {
            "file": "config.h",
            "line": 96,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 if a global configuration file has been found. Its path will be stored in `buffer`."
          },
          "params": [
            {
              "name": "out",
              "type": "char *",
              "direction": "in",
              "comment": "Buffer to store the path in"
            },
            {
              "name": "length",
              "type": "size_t",
              "direction": "in",
              "comment": "size of the buffer in bytes"
            }
          ],
          "comment": [
            "Locate the path to the global configuration file",
            "The user or global configuration file is usually\n located in `$HOME/.gitconfig`.",
            "This method will try to guess the full path to that\n file, if the file exists. The returned path\n may be used on any `git_config` call to load the\n global configuration file.",
            "This method will not guess the path to the xdg compatible\n config file (.config/git/config)."
          ],
          "group": "config"
        },
        "git_config_find_xdg": {
          "kind": "function",
          "name": "git_config_find_xdg",
          "location": {
            "file": "config.h",
            "line": 114,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 if a xdg compatible configuration file has been\n\tfound. Its path will be stored in `buffer`."
          },
          "params": [
            {
              "name": "out",
              "type": "char *",
              "direction": "in",
              "comment": "Buffer to store the path in"
            },
            {
              "name": "length",
              "type": "size_t",
              "direction": "in",
              "comment": "size of the buffer in bytes"
            }
          ],
          "comment": [
            "Locate the path to the global xdg compatible configuration file",
            "The xdg compatible configuration file is usually\n located in `$HOME/.config/git/config`.",
            "This method will try to guess the full path to that\n file, if the file exists. The returned path\n may be used on any `git_config` call to load the\n xdg compatible configuration file."
          ],
          "group": "config"
        },
        "git_config_find_system": {
          "kind": "function",
          "name": "git_config_find_system",
          "location": {
            "file": "config.h",
            "line": 127,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 if a system configuration file has been\n\tfound. Its path will be stored in `buffer`."
          },
          "params": [
            {
              "name": "out",
              "type": "char *",
              "direction": "in",
              "comment": "Buffer to store the path in"
            },
            {
              "name": "length",
              "type": "size_t",
              "direction": "in",
              "comment": "size of the buffer in bytes"
            }
          ],
          "comment": [
            "Locate the path to the system configuration file",
            "If /etc/gitconfig doesn't exist, it will look for\n %PROGRAMFILES%\\Git\\etc\\gitconfig\n."
          ],
          "group": "config"
        },
        "git_config_open_default": {
          "kind": "function",
          "name": "git_config_open_default",
          "location": {
            "file": "config.h",
            "line": 139,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_config **",
              "direction": "in",
              "comment": "Pointer to store the config instance"
            }
          ],
          "comment": [
            "Open the global, XDG and system configuration files",
            "Utility wrapper that finds the global, XDG and system configuration files\n and opens them into a single prioritized config object that can be\n used when accessing default config data outside a repository."
          ],
          "group": "config"
        },
        "git_config_new": {
          "kind": "function",
          "name": "git_config_new",
          "location": {
            "file": "config.h",
            "line": 150,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_config **",
              "direction": "in",
              "comment": "pointer to the new configuration"
            }
          ],
          "comment": [
            "Allocate a new configuration object",
            "This object is empty, so you have to add a file to it before you\n can do anything with it."
          ],
          "group": "config"
        },
        "git_config_add_file_ondisk": {
          "kind": "function",
          "name": "git_config_add_file_ondisk",
          "location": {
            "file": "config.h",
            "line": 174,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EEXISTS when adding more than one file\n  for a given priority level (and force_replace set to 0),\n  GIT_ENOTFOUND when the file doesn't exist or error code"
          },
          "params": [
            {
              "name": "cfg",
              "type": "git_config *",
              "direction": "in",
              "comment": "the configuration to add the file to"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "path to the configuration file to add"
            },
            {
              "name": "level",
              "type": "git_config_level_t",
              "direction": "in",
              "comment": "the priority level of the backend",
              "referenceType": "enum git_config_level_t"
            },
            {
              "name": "force",
              "type": "int",
              "direction": "in",
              "comment": "replace config file at the given priority level"
            }
          ],
          "comment": [
            "Add an on-disk config file instance to an existing config",
            "The on-disk file pointed at by `path` will be opened and\n parsed; it's expected to be a native Git config file following\n the default Git config syntax (see man git-config).",
            "Note that the configuration object will free the file\n automatically.",
            "Further queries on this config object will access each\n of the config file instances in order (instances with\n a higher priority level will be accessed first)."
          ],
          "group": "config"
        },
        "git_config_open_ondisk": {
          "kind": "function",
          "name": "git_config_open_ondisk",
          "location": {
            "file": "config.h",
            "line": 193,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_ENOTFOUND when the file doesn't exist\n or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_config **",
              "direction": "in",
              "comment": "The configuration instance to create"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "Path to the on-disk file to open"
            }
          ],
          "comment": [
            "Create a new config instance containing a single on-disk file",
            "This method is a simple utility wrapper for the following sequence\n of calls:\n\t- git_config_new\n\t- git_config_add_file_ondisk"
          ],
          "group": "config"
        },
        "git_config_open_level": {
          "kind": "function",
          "name": "git_config_open_level",
          "location": {
            "file": "config.h",
            "line": 211,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0, GIT_ENOTFOUND if the passed level cannot be found in the\n multi-level parent config, or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_config **",
              "direction": "in",
              "comment": "The configuration instance to create"
            },
            {
              "name": "parent",
              "type": "const git_config *",
              "direction": "in",
              "comment": "Multi-level config to search for the given level"
            },
            {
              "name": "level",
              "type": "git_config_level_t",
              "direction": "in",
              "comment": "Configuration level to search for",
              "referenceType": "enum git_config_level_t"
            }
          ],
          "comment": [
            "Build a single-level focused config object from a multi-level one.",
            "The returned config object can be used to perform get/set/delete operations\n on a single specific level.",
            "Getting several times the same level from the same parent multi-level config\n will return different config instances, but containing the same config_file\n instance."
          ],
          "group": "config"
        },
        "git_config_open_global": {
          "kind": "function",
          "name": "git_config_open_global",
          "location": {
            "file": "config.h",
            "line": 228,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "out",
              "type": "git_config **",
              "direction": "in",
              "comment": "pointer in which to store the config object"
            },
            {
              "name": "config",
              "type": "git_config *",
              "direction": "in",
              "comment": "the config object in which to look"
            }
          ],
          "comment": [
            "Open the global/XDG configuration file according to git's rules",
            "Git allows you to store your global configuration at\n `$HOME/.config` or `$XDG_CONFIG_HOME/git/config`. For backwards\n compatability, the XDG file shouldn't be used unless the use has\n created it explicitly. With this function you'll open the correct\n one to write to."
          ],
          "group": "config"
        },
        "git_config_refresh": {
          "kind": "function",
          "name": "git_config_refresh",
          "location": {
            "file": "config.h",
            "line": 242,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "cfg",
              "type": "git_config *",
              "direction": "in",
              "comment": "The configuration to refresh"
            }
          ],
          "comment": [
            "Reload changed config files",
            "A config file may be changed on disk out from under the in-memory\n config object.  This function causes us to look for files that have\n been modified since we last loaded them and refresh the config with\n the latest information."
          ],
          "group": "config"
        },
        "git_config_free": {
          "kind": "function",
          "name": "git_config_free",
          "location": {
            "file": "config.h",
            "line": 249,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "cfg",
              "type": "git_config *",
              "direction": "in",
              "comment": "the configuration to free"
            }
          ],
          "comment": [
            "Free the configuration and its associated memory and files"
          ],
          "group": "config"
        },
        "git_config_get_entry": {
          "kind": "function",
          "name": "git_config_get_entry",
          "location": {
            "file": "config.h",
            "line": 262,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "const git_config_entry **",
              "direction": "in",
              "comment": "pointer to the variable git_config_entry"
            },
            {
              "name": "cfg",
              "type": "const git_config *",
              "direction": "in",
              "comment": "where to look for the variable"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the variable's name"
            }
          ],
          "comment": [
            "Get the git_config_entry of a config variable.",
            "The git_config_entry is owned by the config and should not be freed by the\n user."
          ],
          "group": "config"
        },
        "git_config_get_int32": {
          "kind": "function",
          "name": "git_config_get_int32",
          "location": {
            "file": "config.h",
            "line": 279,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "int32_t *",
              "direction": "in",
              "comment": "pointer to the variable where the value should be stored"
            },
            {
              "name": "cfg",
              "type": "const git_config *",
              "direction": "in",
              "comment": "where to look for the variable"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the variable's name"
            }
          ],
          "comment": [
            "Get the value of an integer config variable.",
            "All config files will be looked into, in the order of their\n defined level. A higher level means a higher priority. The\n first occurence of the variable will be returned here."
          ],
          "group": "config"
        },
        "git_config_get_int64": {
          "kind": "function",
          "name": "git_config_get_int64",
          "location": {
            "file": "config.h",
            "line": 293,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "int64_t *",
              "direction": "in",
              "comment": "pointer to the variable where the value should be stored"
            },
            {
              "name": "cfg",
              "type": "const git_config *",
              "direction": "in",
              "comment": "where to look for the variable"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the variable's name"
            }
          ],
          "comment": [
            "Get the value of a long integer config variable.",
            "All config files will be looked into, in the order of their\n defined level. A higher level means a higher priority. The\n first occurrence of the variable will be returned here."
          ],
          "group": "config"
        },
        "git_config_get_bool": {
          "kind": "function",
          "name": "git_config_get_bool",
          "location": {
            "file": "config.h",
            "line": 310,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "int *",
              "direction": "in",
              "comment": "pointer to the variable where the value should be stored"
            },
            {
              "name": "cfg",
              "type": "const git_config *",
              "direction": "in",
              "comment": "where to look for the variable"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the variable's name"
            }
          ],
          "comment": [
            "Get the value of a boolean config variable.",
            "This function uses the usual C convention of 0 being false and\n anything else true.",
            "All config files will be looked into, in the order of their\n defined level. A higher level means a higher priority. The\n first occurrence of the variable will be returned here."
          ],
          "group": "config"
        },
        "git_config_get_string": {
          "kind": "function",
          "name": "git_config_get_string",
          "location": {
            "file": "config.h",
            "line": 327,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "const char **",
              "direction": "in",
              "comment": "pointer to the variable's value"
            },
            {
              "name": "cfg",
              "type": "const git_config *",
              "direction": "in",
              "comment": "where to look for the variable"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the variable's name"
            }
          ],
          "comment": [
            "Get the value of a string config variable.",
            "The string is owned by the variable and should not be freed by the\n user.",
            "All config files will be looked into, in the order of their\n defined level. A higher level means a higher priority. The\n first occurrence of the variable will be returned here."
          ],
          "group": "config"
        },
        "git_config_get_multivar": {
          "kind": "function",
          "name": "git_config_get_multivar",
          "location": {
            "file": "config.h",
            "line": 341,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "cfg",
              "type": "const git_config *",
              "direction": "in",
              "comment": "where to look for the variable"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the variable's name"
            },
            {
              "name": "regexp",
              "type": "const char *",
              "direction": "in",
              "comment": "regular expression to filter which variables we're\n interested in. Use NULL to indicate all"
            },
            {
              "name": "callback",
              "type": "git_config_foreach_cb",
              "direction": "in",
              "comment": "the function to be called on each value of the variable",
              "referenceType": "int (*)(const git_config_entry *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "opaque pointer to pass to the callback"
            }
          ],
          "comment": [
            "Get each value of a multivar.",
            "The callback will be called on each variable found"
          ],
          "group": "config"
        },
        "git_config_set_int32": {
          "kind": "function",
          "name": "git_config_set_int32",
          "location": {
            "file": "config.h",
            "line": 352,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "cfg",
              "type": "git_config *",
              "direction": "in",
              "comment": "where to look for the variable"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the variable's name"
            },
            {
              "name": "value",
              "type": "int32_t",
              "direction": "in",
              "comment": "Integer value for the variable"
            }
          ],
          "comment": [
            "Set the value of an integer config variable in the config file\n with the highest level (usually the local one)."
          ],
          "group": "config"
        },
        "git_config_set_int64": {
          "kind": "function",
          "name": "git_config_set_int64",
          "location": {
            "file": "config.h",
            "line": 363,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "cfg",
              "type": "git_config *",
              "direction": "in",
              "comment": "where to look for the variable"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the variable's name"
            },
            {
              "name": "value",
              "type": "int64_t",
              "direction": "in",
              "comment": "Long integer value for the variable"
            }
          ],
          "comment": [
            "Set the value of a long integer config variable in the config file\n with the highest level (usually the local one)."
          ],
          "group": "config"
        },
        "git_config_set_bool": {
          "kind": "function",
          "name": "git_config_set_bool",
          "location": {
            "file": "config.h",
            "line": 374,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "cfg",
              "type": "git_config *",
              "direction": "in",
              "comment": "where to look for the variable"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the variable's name"
            },
            {
              "name": "value",
              "type": "int",
              "direction": "in",
              "comment": "the value to store"
            }
          ],
          "comment": [
            "Set the value of a boolean config variable in the config file\n with the highest level (usually the local one)."
          ],
          "group": "config"
        },
        "git_config_set_string": {
          "kind": "function",
          "name": "git_config_set_string",
          "location": {
            "file": "config.h",
            "line": 388,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "cfg",
              "type": "git_config *",
              "direction": "in",
              "comment": "where to look for the variable"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the variable's name"
            },
            {
              "name": "value",
              "type": "const char *",
              "direction": "in",
              "comment": "the string to store."
            }
          ],
          "comment": [
            "Set the value of a string config variable in the config file\n with the highest level (usually the local one).",
            "A copy of the string is made and the user is free to use it\n afterwards."
          ],
          "group": "config"
        },
        "git_config_set_multivar": {
          "kind": "function",
          "name": "git_config_set_multivar",
          "location": {
            "file": "config.h",
            "line": 398,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "cfg",
              "type": "git_config *",
              "direction": "in",
              "comment": "where to look for the variable"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the variable's name"
            },
            {
              "name": "regexp",
              "type": "const char *",
              "direction": "in",
              "comment": "a regular expression to indicate which values to replace"
            },
            {
              "name": "value",
              "type": "const char *",
              "direction": "in",
              "comment": "the new value."
            }
          ],
          "comment": [
            "Set a multivar in the local config file."
          ],
          "group": "config"
        },
        "git_config_delete_entry": {
          "kind": "function",
          "name": "git_config_delete_entry",
          "location": {
            "file": "config.h",
            "line": 407,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "cfg",
              "type": "git_config *",
              "direction": "in",
              "comment": "the configuration"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the variable to delete"
            }
          ],
          "comment": [
            "Delete a config variable from the config file\n with the highest level (usually the local one)."
          ],
          "group": "config"
        },
        "git_config_foreach": {
          "kind": "function",
          "name": "git_config_foreach",
          "location": {
            "file": "config.h",
            "line": 422,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "cfg",
              "type": "const git_config *",
              "direction": "in",
              "comment": "where to get the variables from"
            },
            {
              "name": "callback",
              "type": "git_config_foreach_cb",
              "direction": "in",
              "comment": "the function to call on each variable",
              "referenceType": "int (*)(const git_config_entry *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "the data to pass to the callback"
            }
          ],
          "comment": [
            "Perform an operation on each config variable.",
            "The callback receives the normalized name and value of each variable\n in the config backend, and the data pointer passed to this function.\n As soon as one of the callback functions returns something other than 0,\n this function stops iterating and returns `GIT_EUSER`."
          ],
          "group": "config"
        },
        "git_config_foreach_match": {
          "kind": "function",
          "name": "git_config_foreach_match",
          "location": {
            "file": "config.h",
            "line": 440,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or the return value of the callback which didn't return 0"
          },
          "params": [
            {
              "name": "cfg",
              "type": "const git_config *",
              "direction": "in",
              "comment": "where to get the variables from"
            },
            {
              "name": "regexp",
              "type": "const char *",
              "direction": "in",
              "comment": "regular expression to match against config names"
            },
            {
              "name": "callback",
              "type": "git_config_foreach_cb",
              "direction": "in",
              "comment": "the function to call on each variable",
              "referenceType": "int (*)(const git_config_entry *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "the data to pass to the callback"
            }
          ],
          "comment": [
            "Perform an operation on each config variable matching a regular expression.",
            "This behaviors like `git_config_foreach` with an additional filter of a\n regular expression that filters which config keys are passed to the\n callback."
          ],
          "group": "config"
        },
        "git_config_get_mapped": {
          "kind": "function",
          "name": "git_config_get_mapped",
          "location": {
            "file": "config.h",
            "line": 480,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, error code otherwise"
          },
          "params": [
            {
              "name": "out",
              "type": "int *",
              "direction": "in",
              "comment": "place to store the result of the mapping"
            },
            {
              "name": "cfg",
              "type": "const git_config *",
              "direction": "in",
              "comment": "config file to get the variables from"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "name of the config variable to lookup"
            },
            {
              "name": "maps",
              "type": "const git_cvar_map *",
              "direction": "in",
              "comment": "array of `git_cvar_map` objects specifying the possible mappings"
            },
            {
              "name": "map_n",
              "type": "size_t",
              "direction": "in",
              "comment": "number of mapping objects in `maps`"
            }
          ],
          "comment": [
            "Query the value of a config variable and return it mapped to\n an integer constant.",
            "This is a helper method to easily map different possible values\n to a variable to integer constants that easily identify them.",
            "A mapping array looks as follows:",
            "git_cvar_map autocrlf_mapping[] = {\n\t\t{GIT_CVAR_FALSE, NULL, GIT_AUTO_CRLF_FALSE},\n\t\t{GIT_CVAR_TRUE, NULL, GIT_AUTO_CRLF_TRUE},\n\t\t{GIT_CVAR_STRING, \"input\", GIT_AUTO_CRLF_INPUT},\n\t\t{GIT_CVAR_STRING, \"default\", GIT_AUTO_CRLF_DEFAULT}};",
            "On any \"false\" value for the variable (e.g. \"false\", \"FALSE\", \"no\"), the\n mapping will store `GIT_AUTO_CRLF_FALSE` in the `out` parameter.",
            "The same thing applies for any \"true\" value such as \"true\", \"yes\" or \"1\", storing\n the `GIT_AUTO_CRLF_TRUE` variable.",
            "Otherwise, if the value matches the string \"input\" (with case insensitive comparison),\n the given constant will be stored in `out`, and likewise for \"default\".",
            "If not a single match can be made to store in `out`, an error code will be\n returned."
          ],
          "group": "config"
        },
        "git_config_lookup_map_value": {
          "kind": "function",
          "name": "git_config_lookup_map_value",
          "location": {
            "file": "config.h",
            "line": 495,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "out",
              "type": "int *",
              "direction": "in",
              "comment": "place to store the result of the parsing"
            },
            {
              "name": "maps",
              "type": "const git_cvar_map *",
              "direction": "in",
              "comment": "array of `git_cvar_map` objects specifying the possible mappings"
            },
            {
              "name": "map_n",
              "type": "size_t",
              "direction": "in",
              "comment": "number of mapping objects in `maps`"
            },
            {
              "name": "value",
              "type": "const char *",
              "direction": "in",
              "comment": "value to parse"
            }
          ],
          "comment": [
            "Maps a string value to an integer constant"
          ],
          "group": "config"
        },
        "git_config_parse_bool": {
          "kind": "function",
          "name": "git_config_parse_bool",
          "location": {
            "file": "config.h",
            "line": 511,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "out",
              "type": "int *",
              "direction": "in",
              "comment": "place to store the result of the parsing"
            },
            {
              "name": "value",
              "type": "const char *",
              "direction": "in",
              "comment": "value to parse"
            }
          ],
          "comment": [
            "Parse a string value as a bool.",
            "Valid values for true are: 'true', 'yes', 'on', 1 or any\n  number different from 0\n Valid values for false are: 'false', 'no', 'off', 0"
          ],
          "group": "config"
        },
        "git_config_parse_int32": {
          "kind": "function",
          "name": "git_config_parse_int32",
          "location": {
            "file": "config.h",
            "line": 523,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "out",
              "type": "int32_t *",
              "direction": "in",
              "comment": "place to store the result of the parsing"
            },
            {
              "name": "value",
              "type": "const char *",
              "direction": "in",
              "comment": "value to parse"
            }
          ],
          "comment": [
            "Parse a string value as an int32.",
            "An optional value suffix of 'k', 'm', or 'g' will\n cause the value to be multiplied by 1024, 1048576,\n or 1073741824 prior to output."
          ],
          "group": "config"
        },
        "git_config_parse_int64": {
          "kind": "function",
          "name": "git_config_parse_int64",
          "location": {
            "file": "config.h",
            "line": 535,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "out",
              "type": "int64_t *",
              "direction": "in",
              "comment": "place to store the result of the parsing"
            },
            {
              "name": "value",
              "type": "const char *",
              "direction": "in",
              "comment": "value to parse"
            }
          ],
          "comment": [
            "Parse a string value as an int64.",
            "An optional value suffix of 'k', 'm', or 'g' will\n cause the value to be multiplied by 1024, 1048576,\n or 1073741824 prior to output."
          ],
          "group": "config"
        },
        "git_config": {
          "kind": "struct",
          "name": "git_config",
          "referenceName": "struct git_config",
          "opaque": true,
          "comment": [
            "Memory representation of a set of config files"
          ],
          "location": {
            "file": "types.h",
            "line": 138,
            "column": 27
          },
          "group": "config",
          "parameterTo": [
            "git_config_open_default",
            "git_config_new",
            "git_config_add_file_ondisk",
            "git_config_open_ondisk",
            "git_config_open_level",
            "git_config_open_global",
            "git_config_refresh",
            "git_config_free",
            "git_config_get_entry",
            "git_config_get_int32",
            "git_config_get_int64",
            "git_config_get_bool",
            "git_config_get_string",
            "git_config_get_multivar",
            "git_config_set_int32",
            "git_config_set_int64",
            "git_config_set_bool",
            "git_config_set_string",
            "git_config_set_multivar",
            "git_config_delete_entry",
            "git_config_foreach",
            "git_config_foreach_match",
            "git_config_get_mapped",
            "git_repository_config",
            "git_config_add_backend",
            "git_repository_set_config"
          ]
        }
      },
      "info": {
        "summary": "Git config management routines"
      }
    },
    "sys/config": {
      "apis": {
        "git_config_backend": {
          "kind": "struct",
          "name": "git_config_backend",
          "referenceName": "struct git_config_backend",
          "comment": [
            "Generic backend that implements the interface to\n access a configuration file"
          ],
          "members": [
            {
              "name": "version",
              "type": "unsigned int"
            },
            {
              "name": "cfg",
              "type": "struct git_config *"
            },
            {
              "name": "open",
              "type": "int (*)(struct git_config_backend *, git_config_level_t)"
            },
            {
              "name": "get",
              "type": "int (*)(const struct git_config_backend *, const char *, const git_config_entry **)"
            },
            {
              "name": "get_multivar",
              "type": "int (*)(struct git_config_backend *, const char *, const char *, git_config_foreach_cb, void *)"
            },
            {
              "name": "set",
              "type": "int (*)(struct git_config_backend *, const char *, const char *)"
            },
            {
              "name": "set_multivar",
              "type": "int (*)(git_config_backend *, const char *, const char *, const char *)"
            },
            {
              "name": "del",
              "type": "int (*)(struct git_config_backend *, const char *)"
            },
            {
              "name": "foreach",
              "type": "int (*)(struct git_config_backend *, const char *, git_config_foreach_cb, void *)"
            },
            {
              "name": "refresh",
              "type": "int (*)(struct git_config_backend *)"
            },
            {
              "name": "free",
              "type": "void (*)(struct git_config_backend *)"
            }
          ],
          "location": {
            "file": "sys/config.h",
            "line": 27,
            "column": 8
          },
          "group": "sys/config",
          "parameterTo": [
            "git_config_add_backend"
          ]
        },
        "GIT_CONFIG_BACKEND_VERSION": {
          "kind": "macro",
          "name": "GIT_CONFIG_BACKEND_VERSION",
          "location": {
            "file": "sys/config.h",
            "line": 42,
            "column": 9
          },
          "value": "1",
          "comment": "",
          "group": "sys/config"
        },
        "GIT_CONFIG_BACKEND_INIT": {
          "kind": "macro",
          "name": "GIT_CONFIG_BACKEND_INIT",
          "location": {
            "file": "sys/config.h",
            "line": 43,
            "column": 9
          },
          "value": "{GIT_CONFIG_BACKEND_VERSION}",
          "comment": "",
          "group": "sys/config"
        },
        "git_config_add_backend": {
          "kind": "function",
          "name": "git_config_add_backend",
          "location": {
            "file": "sys/config.h",
            "line": 63,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EEXISTS when adding more than one file\n  for a given priority level (and force_replace set to 0), or error code"
          },
          "params": [
            {
              "name": "cfg",
              "type": "git_config *",
              "direction": "in",
              "comment": "the configuration to add the file to"
            },
            {
              "name": "file",
              "type": "git_config_backend *",
              "direction": "in",
              "comment": "the configuration file (backend) to add"
            },
            {
              "name": "level",
              "type": "git_config_level_t",
              "direction": "in",
              "comment": "the priority level of the backend",
              "referenceType": "enum git_config_level_t"
            },
            {
              "name": "force",
              "type": "int",
              "direction": "in",
              "comment": "if a config file already exists for the given\n  priority level, replace it"
            }
          ],
          "comment": [
            "Add a generic config file instance to an existing config",
            "Note that the configuration object will free the file\n automatically.",
            "Further queries on this config object will access each\n of the config file instances in order (instances with\n a higher priority level will be accessed first)."
          ],
          "group": "sys/config"
        }
      },
      "info": {
        "summary": "Git config backend routines"
      }
    },
    "cred_helpers": {
      "apis": {
        "git_cred_userpass_payload": {
          "kind": "struct",
          "name": "git_cred_userpass_payload",
          "referenceName": "git_cred_userpass_payload",
          "comment": [
            "Payload for git_cred_stock_userpass_plaintext."
          ],
          "members": [
            {
              "name": "username",
              "type": "char *"
            },
            {
              "name": "password",
              "type": "char *"
            }
          ],
          "location": {
            "file": "cred_helpers.h",
            "line": 24,
            "column": 16
          },
          "group": "cred_helpers"
        },
        "git_cred_userpass": {
          "kind": "function",
          "name": "git_cred_userpass",
          "location": {
            "file": "cred_helpers.h",
            "line": 43,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "cred",
              "type": "git_cred **",
              "direction": "in",
              "comment": "The newly created credential object."
            },
            {
              "name": "url",
              "type": "const char *",
              "direction": "in",
              "comment": "The resource for which we are demanding a credential."
            },
            {
              "name": "user_from_url",
              "type": "const char *",
              "direction": "in",
              "comment": "The username that was embedded in a \"user@host\"\n                          remote url, or NULL if not included."
            },
            {
              "name": "allowed_types",
              "type": "unsigned int",
              "direction": "in",
              "comment": "A bitmask stating which cred types are OK to return."
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "The payload provided when specifying this callback.  (This is\n        interpreted as a `git_cred_userpass_payload*`.)"
            }
          ],
          "comment": [
            "Stock callback usable as a git_cred_acquire_cb.  This calls\n git_cred_userpass_plaintext_new unless the protocol has not specified\n `GIT_CREDTYPE_USERPASS_PLAINTEXT` as an allowed type."
          ],
          "group": "cred_helpers"
        }
      },
      "info": {
        "summary": "Utility functions for credential management"
      }
    },
    "diff": {
      "apis": {
        "git_diff_option_t": {
          "kind": "enum",
          "name": "git_diff_option_t",
          "referenceName": "git_diff_option_t",
          "members": [
            {
              "name": "GIT_DIFF_NORMAL",
              "value": "0",
              "comment": [
                "Normal diff, the default"
              ]
            },
            {
              "name": "GIT_DIFF_REVERSE",
              "value": "1",
              "comment": [
                "Reverse the sides of the diff"
              ]
            },
            {
              "name": "GIT_DIFF_FORCE_TEXT",
              "value": "2",
              "comment": [
                "Treat all files as text, disabling binary attributes \n&\n detection"
              ]
            },
            {
              "name": "GIT_DIFF_IGNORE_WHITESPACE",
              "value": "4",
              "comment": [
                "Ignore all whitespace"
              ]
            },
            {
              "name": "GIT_DIFF_IGNORE_WHITESPACE_CHANGE",
              "value": "8",
              "comment": [
                "Ignore changes in amount of whitespace"
              ]
            },
            {
              "name": "GIT_DIFF_IGNORE_WHITESPACE_EOL",
              "value": "16",
              "comment": [
                "Ignore whitespace at end of line"
              ]
            },
            {
              "name": "GIT_DIFF_IGNORE_SUBMODULES",
              "value": "32",
              "comment": [
                "Exclude submodules from the diff completely"
              ]
            },
            {
              "name": "GIT_DIFF_PATIENCE",
              "value": "64",
              "comment": [
                "Use the \"patience diff\" algorithm (currently unimplemented)"
              ]
            },
            {
              "name": "GIT_DIFF_INCLUDE_IGNORED",
              "value": "128",
              "comment": [
                "Include ignored files in the diff list"
              ]
            },
            {
              "name": "GIT_DIFF_INCLUDE_UNTRACKED",
              "value": "256",
              "comment": [
                "Include untracked files in the diff list"
              ]
            },
            {
              "name": "GIT_DIFF_INCLUDE_UNMODIFIED",
              "value": "512",
              "comment": [
                "Include unmodified files in the diff list"
              ]
            },
            {
              "name": "GIT_DIFF_RECURSE_UNTRACKED_DIRS",
              "value": "1024",
              "comment": [
                "Even with GIT_DIFF_INCLUDE_UNTRACKED, an entire untracked\n  directory will be marked with only a single entry in the diff list\n  (a la what core Git does in `git status`); this flag adds *all*\n  files under untracked directories as UNTRACKED entries, too."
              ]
            },
            {
              "name": "GIT_DIFF_DISABLE_PATHSPEC_MATCH",
              "value": "2048",
              "comment": [
                "If the pathspec is set in the diff options, this flags means to\n  apply it as an exact match instead of as an fnmatch pattern."
              ]
            },
            {
              "name": "GIT_DIFF_DELTAS_ARE_ICASE",
              "value": "4096",
              "comment": [
                "Use case insensitive filename comparisons"
              ]
            },
            {
              "name": "GIT_DIFF_INCLUDE_UNTRACKED_CONTENT",
              "value": "8192",
              "comment": [
                "When generating patch text, include the content of untracked\n  files.  This automatically turns on GIT_DIFF_INCLUDE_UNTRACKED but\n  it does not turn on GIT_DIFF_RECURSE_UNTRACKED_DIRS.  Add that\n  flag if you want the content of every single UNTRACKED file."
              ]
            },
            {
              "name": "GIT_DIFF_SKIP_BINARY_CHECK",
              "value": "16384",
              "comment": [
                "Disable updating of the `binary` flag in delta records.  This is\n  useful when iterating over a diff if you don't need hunk and data\n  callbacks and want to avoid having to load file completely."
              ]
            },
            {
              "name": "GIT_DIFF_INCLUDE_TYPECHANGE",
              "value": "32768",
              "comment": [
                "Normally, a type change between files will be converted into a\n  DELETED record for the old and an ADDED record for the new; this\n  options enabled the generation of TYPECHANGE delta records."
              ]
            },
            {
              "name": "GIT_DIFF_INCLUDE_TYPECHANGE_TREES",
              "value": "65536",
              "comment": [
                "Even with GIT_DIFF_INCLUDE_TYPECHANGE, blob->tree changes still\n  generally show as a DELETED blob.  This flag tries to correctly\n  label blob->tree transitions as TYPECHANGE records with new_file's\n  mode set to tree.  Note: the tree SHA will not be available."
              ]
            },
            {
              "name": "GIT_DIFF_IGNORE_FILEMODE",
              "value": "131072",
              "comment": [
                "Ignore file mode changes"
              ]
            },
            {
              "name": "GIT_DIFF_RECURSE_IGNORED_DIRS",
              "value": "262144",
              "comment": [
                "Even with GIT_DIFF_INCLUDE_IGNORED, an entire ignored directory\n  will be marked with only a single entry in the diff list; this flag\n  adds all files under the directory as IGNORED entries, too."
              ]
            },
            {
              "name": "GIT_DIFF_FAST_UNTRACKED_DIRS",
              "value": "524288",
              "comment": [
                "Core Git scans inside untracked directories, labeling them IGNORED\n  if they are empty or only contain ignored files; a directory is\n  consider UNTRACKED only if it has an actual untracked file in it.\n  This scan is extra work for a case you often don't care about.  This\n  flag makes libgit2 immediately label an untracked directory as\n  UNTRACKED without looking inside it (which differs from core Git).\n  Of course, ignore rules are still checked for the directory itself."
              ]
            },
            {
              "name": "GIT_DIFF_FORCE_BINARY",
              "value": "1048576",
              "comment": [
                "Treat all files as binary, disabling text diffs"
              ]
            }
          ],
          "comment": [
            "Flags for diff options.  A combination of these flags can be passed\n in via the `flags` value in the `git_diff_options`."
          ],
          "location": {
            "file": "diff.h",
            "line": 68,
            "column": 9
          },
          "group": "diff"
        },
        "git_diff_list": {
          "kind": "struct",
          "name": "git_diff_list",
          "referenceName": "struct git_diff_list",
          "opaque": true,
          "comment": [
            "The diff list object that contains all individual file deltas.",
            "This is an opaque structure which will be allocated by one of the diff\n generator functions below (such as `git_diff_tree_to_tree`).  You are\n responsible for releasing the object memory when done, using the\n `git_diff_list_free()` function."
          ],
          "location": {
            "file": "diff.h",
            "line": 164,
            "column": 30
          },
          "group": "diff",
          "parameterTo": [
            "git_diff_notify_cb",
            "git_diff_list_free",
            "git_diff_tree_to_tree",
            "git_diff_tree_to_index",
            "git_diff_index_to_workdir",
            "git_diff_tree_to_workdir",
            "git_diff_merge",
            "git_diff_find_similar",
            "git_diff_foreach",
            "git_diff_print_compact",
            "git_diff_print_raw",
            "git_diff_print_patch",
            "git_diff_num_deltas",
            "git_diff_num_deltas_of_type",
            "git_diff_get_patch"
          ]
        },
        "git_diff_flag_t": {
          "kind": "enum",
          "name": "git_diff_flag_t",
          "referenceName": "git_diff_flag_t",
          "members": [
            {
              "name": "GIT_DIFF_FLAG_BINARY",
              "value": "1"
            },
            {
              "name": "GIT_DIFF_FLAG_NOT_BINARY",
              "value": "2",
              "comment": [
                "file(s) treated as binary data"
              ]
            },
            {
              "name": "GIT_DIFF_FLAG_VALID_OID",
              "value": "4",
              "comment": [
                "file(s) treated as text data"
              ]
            }
          ],
          "comment": [
            "Flags for the delta object and the file objects on each side.",
            "These flags are used for both the `flags` value of the `git_diff_delta`\n and the flags for the `git_diff_file` objects representing the old and\n new sides of the delta.  Values outside of this public range should be\n considered reserved for internal or future use."
          ],
          "location": {
            "file": "diff.h",
            "line": 174,
            "column": 9
          },
          "group": "diff"
        },
        "git_delta_t": {
          "kind": "enum",
          "name": "git_delta_t",
          "referenceName": "git_delta_t",
          "members": [
            {
              "name": "GIT_DELTA_UNMODIFIED",
              "value": "0"
            },
            {
              "name": "GIT_DELTA_ADDED",
              "value": "1",
              "comment": [
                "no changes"
              ]
            },
            {
              "name": "GIT_DELTA_DELETED",
              "value": "2",
              "comment": [
                "entry does not exist in old version"
              ]
            },
            {
              "name": "GIT_DELTA_MODIFIED",
              "value": "3",
              "comment": [
                "entry does not exist in new version"
              ]
            },
            {
              "name": "GIT_DELTA_RENAMED",
              "value": "4",
              "comment": [
                "entry content changed between old and new"
              ]
            },
            {
              "name": "GIT_DELTA_COPIED",
              "value": "5",
              "comment": [
                "entry was renamed between old and new"
              ]
            },
            {
              "name": "GIT_DELTA_IGNORED",
              "value": "6",
              "comment": [
                "entry was copied from another old entry"
              ]
            },
            {
              "name": "GIT_DELTA_UNTRACKED",
              "value": "7",
              "comment": [
                "entry is ignored item in workdir"
              ]
            },
            {
              "name": "GIT_DELTA_TYPECHANGE",
              "value": "8",
              "comment": [
                "entry is untracked item in workdir"
              ]
            }
          ],
          "comment": [
            "What type of change is described by a git_diff_delta?",
            "`GIT_DELTA_RENAMED` and `GIT_DELTA_COPIED` will only show up if you run\n `git_diff_find_similar()` on the diff list object.",
            "`GIT_DELTA_TYPECHANGE` only shows up given `GIT_DIFF_INCLUDE_TYPECHANGE`\n in the option flags (otherwise type changes will be split into ADDED /\n DELETED pairs)."
          ],
          "location": {
            "file": "diff.h",
            "line": 190,
            "column": 9
          },
          "group": "diff",
          "parameterTo": [
            "git_diff_status_char",
            "git_diff_num_deltas_of_type"
          ]
        },
        "git_diff_file": {
          "kind": "struct",
          "name": "git_diff_file",
          "referenceName": "git_diff_file",
          "comment": [
            "Description of one side of a diff entry.",
            "Although this is called a \"file\", it may actually represent a file, a\n symbolic link, a submodule commit id, or even a tree (although that only\n if you are tracking type changes or ignored/untracked directories).",
            "The `oid` is the `git_oid` of the item.  If the entry represents an\n absent side of a diff (e.g. the `old_file` of a `GIT_DELTA_ADDED` delta),\n then the oid will be zeroes.",
            "`path` is the NUL-terminated path to the entry relative to the working\n directory of the repository.",
            "`size` is the size of the entry in bytes.",
            "`flags` is a combination of the `git_diff_flag_t` types",
            "`mode` is, roughly, the stat() `st_mode` value for the item.  This will\n be restricted to one of the `git_filemode_t` values."
          ],
          "members": [
            {
              "name": "oid",
              "type": "git_oid",
              "referenceType": "struct git_oid"
            },
            {
              "name": "path",
              "type": "const char *"
            },
            {
              "name": "size",
              "type": "git_off_t",
              "referenceType": "int64_t"
            },
            {
              "name": "flags",
              "type": "uint32_t"
            },
            {
              "name": "mode",
              "type": "uint16_t"
            }
          ],
          "location": {
            "file": "diff.h",
            "line": 223,
            "column": 9
          },
          "group": "diff",
          "parameterTo": [
            "git_checkout_notify_cb"
          ]
        },
        "git_diff_delta": {
          "kind": "struct",
          "name": "git_diff_delta",
          "referenceName": "git_diff_delta",
          "comment": [
            "Description of changes to one entry.",
            "When iterating over a diff list object, this will be passed to most\n callback functions and you can use the contents to understand exactly\n what has changed.",
            "The `old_file` represents the \"from\" side of the diff and the `new_file`\n represents to \"to\" side of the diff.  What those means depend on the\n function that was used to generate the diff and will be documented below.\n You can also use the `GIT_DIFF_REVERSE` flag to flip it around.",
            "Although the two sides of the delta are named \"old_file\" and \"new_file\",\n they actually may correspond to entries that represent a file, a symbolic\n link, a submodule commit id, or even a tree (if you are tracking type\n changes or ignored/untracked directories).",
            "Under some circumstances, in the name of efficiency, not all fields will\n be filled in, but we generally try to fill in as much as possible.  One\n example is that the \"flags\" field may not have either the `BINARY` or the\n `NOT_BINARY` flag set to avoid examining file contents if you do not pass\n in hunk and/or line callbacks to the diff foreach iteration function.  It\n will just use the git attributes for those files.",
            "The similarity score is zero unless you call `git_diff_find_similar()`\n which does a similarity analysis of files in the diff.  Use that\n function to do rename and copy detection, and to split heavily modified\n files in add/delete pairs.  After that call, deltas with a status of\n GIT_DELTA_RENAMED or GIT_DELTA_COPIED will have a similarity score\n between 0 and 100 indicating how similar the old and new sides are.",
            "If you ask `git_diff_find_similar` to find heavily modified files to\n break, but to not *actually* break the records, then GIT_DELTA_MODIFIED\n records may have a non-zero similarity score if the self-similarity is\n below the split threshold.  To display this value like core Git, invert\n the score (a la `printf(\"M%03d\", 100 - delta->similarity)`)."
          ],
          "members": [
            {
              "name": "old_file",
              "type": "git_diff_file",
              "referenceType": "struct git_diff_file"
            },
            {
              "name": "new_file",
              "type": "git_diff_file",
              "referenceType": "struct git_diff_file"
            },
            {
              "name": "status",
              "type": "git_delta_t",
              "referenceType": "enum git_delta_t"
            },
            {
              "name": "similarity",
              "type": "uint32_t",
              "comment": [
                "for RENAMED and COPIED, value 0-100"
              ]
            },
            {
              "name": "flags",
              "type": "uint32_t"
            }
          ],
          "location": {
            "file": "diff.h",
            "line": 268,
            "column": 9
          },
          "group": "diff",
          "returnedBy": [
            "git_diff_patch_delta"
          ],
          "parameterTo": [
            "git_diff_notify_cb",
            "git_diff_file_cb",
            "git_diff_hunk_cb",
            "git_diff_data_cb",
            "git_diff_get_patch"
          ]
        },
        "git_diff_notify_cb": {
          "kind": "callback",
          "name": "git_diff_notify_cb",
          "type": "int (*)(const git_diff_list *, const git_diff_delta *, const char *, void *)",
          "comment": [
            "Diff notification callback function.",
            "The callback will be called for each file, just before the `git_delta_t`\n gets inserted into the diff list.",
            "When the callback:\n - returns \n<\n 0, the diff process will be aborted.\n - returns > 0, the delta will not be inserted into the diff list, but the\n\t\tdiff process continues.\n - returns 0, the delta is inserted into the diff list, and the diff process\n\t\tcontinues."
          ],
          "location": {
            "file": "diff.h",
            "line": 289,
            "column": 15
          },
          "params": [
            {
              "type": "const git_diff_list *"
            },
            {
              "type": "const git_diff_delta *"
            },
            {
              "type": "const char *"
            },
            {
              "type": "void *"
            }
          ],
          "group": "diff",
          "typedef": true
        },
        "git_diff_options": {
          "kind": "struct",
          "name": "git_diff_options",
          "referenceName": "git_diff_options",
          "comment": [
            "Structure describing options about how the diff should be executed.",
            "Setting all values of the structure to zero will yield the default\n values.  Similarly, passing NULL for the options structure will\n give the defaults.  The default values are marked below.",
            "- `flags` is a combination of the `git_diff_option_t` values above\n - `context_lines` is the number of unchanged lines that define the\n    boundary of a hunk (and to display before and after)\n - `interhunk_lines` is the maximum number of unchanged lines between\n    hunk boundaries before the hunks will be merged into a one.\n - `old_prefix` is the virtual \"directory\" to prefix to old file names\n   in hunk headers (default \"a\")\n - `new_prefix` is the virtual \"directory\" to prefix to new file names\n   in hunk headers (default \"b\")\n - `pathspec` is an array of paths / fnmatch patterns to constrain diff\n - `max_size` is a file size (in bytes) above which a blob will be marked\n   as binary automatically; pass a negative value to disable.\n - `notify_cb` is an optional callback function, notifying the consumer of\n   which files are being examined as the diff is generated\n - `notify_payload` is the payload data to pass to the `notify_cb` function"
          ],
          "members": [
            {
              "name": "version",
              "type": "unsigned int",
              "comment": [
                "version for the struct"
              ]
            },
            {
              "name": "flags",
              "type": "uint32_t",
              "comment": [
                "defaults to GIT_DIFF_NORMAL"
              ]
            },
            {
              "name": "context_lines",
              "type": "uint16_t",
              "comment": [
                "defaults to 3"
              ]
            },
            {
              "name": "interhunk_lines",
              "type": "uint16_t",
              "comment": [
                "defaults to 0"
              ]
            },
            {
              "name": "old_prefix",
              "type": "const char *",
              "comment": [
                "defaults to \"a\""
              ]
            },
            {
              "name": "new_prefix",
              "type": "const char *",
              "comment": [
                "defaults to \"b\""
              ]
            },
            {
              "name": "pathspec",
              "type": "git_strarray",
              "comment": [
                "defaults to include all paths"
              ],
              "referenceType": "struct git_strarray"
            },
            {
              "name": "max_size",
              "type": "git_off_t",
              "comment": [
                "defaults to 512MB"
              ],
              "referenceType": "int64_t"
            },
            {
              "name": "notify_cb",
              "type": "git_diff_notify_cb",
              "referenceType": "int (*)(const git_diff_list *, const git_diff_delta *, const char *, void *)"
            },
            {
              "name": "notify_payload",
              "type": "void *"
            }
          ],
          "location": {
            "file": "diff.h",
            "line": 318,
            "column": 9
          },
          "group": "diff",
          "parameterTo": [
            "git_diff_tree_to_tree",
            "git_diff_tree_to_index",
            "git_diff_index_to_workdir",
            "git_diff_tree_to_workdir",
            "git_diff_blobs",
            "git_diff_patch_from_blobs",
            "git_diff_blob_to_buffer",
            "git_diff_patch_from_blob_and_buffer"
          ]
        },
        "GIT_DIFF_OPTIONS_VERSION": {
          "kind": "macro",
          "name": "GIT_DIFF_OPTIONS_VERSION",
          "location": {
            "file": "diff.h",
            "line": 331,
            "column": 9
          },
          "value": "1",
          "comment": "",
          "group": "diff"
        },
        "GIT_DIFF_OPTIONS_INIT": {
          "kind": "macro",
          "name": "GIT_DIFF_OPTIONS_INIT",
          "location": {
            "file": "diff.h",
            "line": 332,
            "column": 9
          },
          "value": "{GIT_DIFF_OPTIONS_VERSION, GIT_DIFF_NORMAL, 3}",
          "comment": "",
          "group": "diff"
        },
        "git_diff_file_cb": {
          "kind": "callback",
          "name": "git_diff_file_cb",
          "type": "int (*)(const git_diff_delta *, float, void *)",
          "comment": [
            "When iterating over a diff, callback that will be made per file."
          ],
          "location": {
            "file": "diff.h",
            "line": 341,
            "column": 15
          },
          "params": [
            {
              "name": "delta",
              "direction": "in",
              "comment": "A pointer to the delta data for the file",
              "type": "const git_diff_delta *"
            },
            {
              "name": "progress",
              "direction": "in",
              "comment": "Goes from 0 to 1 over the diff list",
              "type": "float"
            },
            {
              "name": "payload",
              "direction": "in",
              "comment": "User-specified pointer from foreach function",
              "type": "void *"
            }
          ],
          "group": "diff",
          "parameterTo": [
            "git_diff_foreach",
            "git_diff_blobs",
            "git_diff_blob_to_buffer"
          ],
          "typedef": true
        },
        "git_diff_range": {
          "kind": "struct",
          "name": "git_diff_range",
          "referenceName": "git_diff_range",
          "comment": [
            "Structure describing a hunk of a diff."
          ],
          "members": [
            {
              "name": "old_start",
              "type": "int"
            },
            {
              "name": "old_lines",
              "type": "int",
              "comment": [
                "Starting line number in old_file"
              ]
            },
            {
              "name": "new_start",
              "type": "int",
              "comment": [
                "Number of lines in old_file"
              ]
            },
            {
              "name": "new_lines",
              "type": "int",
              "comment": [
                "Starting line number in new_file"
              ]
            }
          ],
          "location": {
            "file": "diff.h",
            "line": 349,
            "column": 9
          },
          "group": "diff",
          "parameterTo": [
            "git_diff_hunk_cb",
            "git_diff_data_cb",
            "git_diff_patch_get_hunk"
          ]
        },
        "git_diff_hunk_cb": {
          "kind": "callback",
          "name": "git_diff_hunk_cb",
          "type": "int (*)(const git_diff_delta *, const git_diff_range *, const char *, size_t, void *)",
          "comment": [
            "When iterating over a diff, callback that will be made per hunk."
          ],
          "location": {
            "file": "diff.h",
            "line": 359,
            "column": 15
          },
          "params": [
            {
              "type": "const git_diff_delta *"
            },
            {
              "type": "const git_diff_range *"
            },
            {
              "type": "const char *"
            },
            {
              "type": "size_t"
            },
            {
              "type": "void *"
            }
          ],
          "group": "diff",
          "parameterTo": [
            "git_diff_foreach",
            "git_diff_blobs",
            "git_diff_blob_to_buffer"
          ],
          "typedef": true
        },
        "git_diff_line_t": {
          "kind": "enum",
          "name": "git_diff_line_t",
          "referenceName": "git_diff_line_t",
          "members": [
            {
              "name": "GIT_DIFF_LINE_CONTEXT",
              "value": "32"
            },
            {
              "name": "GIT_DIFF_LINE_ADDITION",
              "value": "43"
            },
            {
              "name": "GIT_DIFF_LINE_DELETION",
              "value": "45"
            },
            {
              "name": "GIT_DIFF_LINE_CONTEXT_EOFNL",
              "value": "61",
              "comment": [
                "Both files have no LF at end"
              ]
            },
            {
              "name": "GIT_DIFF_LINE_ADD_EOFNL",
              "value": "62",
              "comment": [
                "Old has no LF at end, new does"
              ]
            },
            {
              "name": "GIT_DIFF_LINE_DEL_EOFNL",
              "value": "60",
              "comment": [
                "Old has LF at end, new does not"
              ]
            },
            {
              "name": "GIT_DIFF_LINE_FILE_HDR",
              "value": "70"
            },
            {
              "name": "GIT_DIFF_LINE_HUNK_HDR",
              "value": "72"
            },
            {
              "name": "GIT_DIFF_LINE_BINARY",
              "value": "66"
            }
          ],
          "comment": [
            "Line origin constants.",
            "These values describe where a line came from and will be passed to\n the git_diff_data_cb when iterating over a diff.  There are some\n special origin constants at the end that are used for the text\n output callbacks to demarcate lines that are actually part of\n the file or hunk headers."
          ],
          "location": {
            "file": "diff.h",
            "line": 375,
            "column": 9
          },
          "group": "diff"
        },
        "git_diff_data_cb": {
          "kind": "callback",
          "name": "git_diff_data_cb",
          "type": "int (*)(const git_diff_delta *, const git_diff_range *, char, const char *, size_t, void *)",
          "comment": [
            "When iterating over a diff, callback that will be made per text diff\n line. In this context, the provided range will be NULL.",
            "When printing a diff, callback that will be made to output each line\n of text.  This uses some extra GIT_DIFF_LINE_... constants for output\n of lines of file and hunk headers."
          ],
          "location": {
            "file": "diff.h",
            "line": 402,
            "column": 15
          },
          "params": [
            {
              "type": "const git_diff_delta *"
            },
            {
              "type": "const git_diff_range *"
            },
            {
              "type": "char"
            },
            {
              "type": "const char *"
            },
            {
              "type": "size_t"
            },
            {
              "type": "void *"
            }
          ],
          "group": "diff",
          "parameterTo": [
            "git_diff_foreach",
            "git_diff_print_compact",
            "git_diff_print_raw",
            "git_diff_print_patch",
            "git_diff_patch_print",
            "git_diff_blobs",
            "git_diff_blob_to_buffer"
          ],
          "typedef": true
        },
        "git_diff_patch": {
          "kind": "struct",
          "name": "git_diff_patch",
          "referenceName": "struct git_diff_patch",
          "opaque": true,
          "comment": [
            "The diff patch is used to store all the text diffs for a delta.",
            "You can easily loop over the content of patches and get information about\n them."
          ],
          "location": {
            "file": "diff.h",
            "line": 416,
            "column": 31
          },
          "group": "diff",
          "parameterTo": [
            "git_diff_get_patch",
            "git_diff_patch_free",
            "git_diff_patch_delta",
            "git_diff_patch_num_hunks",
            "git_diff_patch_line_stats",
            "git_diff_patch_get_hunk",
            "git_diff_patch_num_lines_in_hunk",
            "git_diff_patch_get_line_in_hunk",
            "git_diff_patch_print",
            "git_diff_patch_to_str",
            "git_diff_patch_from_blobs",
            "git_diff_patch_from_blob_and_buffer"
          ]
        },
        "git_diff_find_t": {
          "kind": "enum",
          "name": "git_diff_find_t",
          "referenceName": "git_diff_find_t",
          "members": [
            {
              "name": "GIT_DIFF_FIND_RENAMES",
              "value": "1",
              "comment": [
                "look for renames? (`--find-renames`)"
              ]
            },
            {
              "name": "GIT_DIFF_FIND_RENAMES_FROM_REWRITES",
              "value": "2",
              "comment": [
                "consider old side of modified for renames? (`--break-rewrites=N`)"
              ]
            },
            {
              "name": "GIT_DIFF_FIND_COPIES",
              "value": "4",
              "comment": [
                "look for copies? (a la `--find-copies`)"
              ]
            },
            {
              "name": "GIT_DIFF_FIND_COPIES_FROM_UNMODIFIED",
              "value": "8",
              "comment": [
                "consider unmodified as copy sources? (`--find-copies-harder`)"
              ]
            },
            {
              "name": "GIT_DIFF_FIND_REWRITES",
              "value": "16",
              "comment": [
                "mark large rewrites for split (`--break-rewrites=/M`)"
              ]
            },
            {
              "name": "GIT_DIFF_BREAK_REWRITES",
              "value": "32",
              "comment": [
                "actually split large rewrites into delete/add pairs"
              ]
            },
            {
              "name": "GIT_DIFF_FIND_AND_BREAK_REWRITES",
              "value": "48",
              "comment": [
                "mark rewrites for split and break into delete/add pairs"
              ]
            },
            {
              "name": "GIT_DIFF_FIND_FOR_UNTRACKED",
              "value": "64",
              "comment": [
                "find renames/copies for untracked items in working directory"
              ]
            },
            {
              "name": "GIT_DIFF_FIND_ALL",
              "value": "255",
              "comment": [
                "turn on all finding features"
              ]
            },
            {
              "name": "GIT_DIFF_FIND_IGNORE_LEADING_WHITESPACE",
              "value": "0",
              "comment": [
                "measure similarity ignoring leading whitespace (default)"
              ]
            },
            {
              "name": "GIT_DIFF_FIND_IGNORE_WHITESPACE",
              "value": "4096",
              "comment": [
                "measure similarity ignoring all whitespace"
              ]
            },
            {
              "name": "GIT_DIFF_FIND_DONT_IGNORE_WHITESPACE",
              "value": "8192",
              "comment": [
                "measure similarity including all data"
              ]
            },
            {
              "name": "GIT_DIFF_FIND_EXACT_MATCH_ONLY",
              "value": "16384",
              "comment": [
                "measure similarity only by comparing SHAs (fast and cheap)"
              ]
            }
          ],
          "comment": [
            "Flags to control the behavior of diff rename/copy detection."
          ],
          "location": {
            "file": "diff.h",
            "line": 421,
            "column": 9
          },
          "group": "diff"
        },
        "git_diff_similarity_metric": {
          "kind": "struct",
          "name": "git_diff_similarity_metric",
          "referenceName": "git_diff_similarity_metric",
          "comment": [
            "Pluggable similarity metric"
          ],
          "members": [
            {
              "name": "file_signature",
              "type": "int (*)(void **, const git_diff_file *, const char *, void *)"
            },
            {
              "name": "buffer_signature",
              "type": "int (*)(void **, const git_diff_file *, const char *, size_t, void *)"
            },
            {
              "name": "free_signature",
              "type": "void (*)(void *, void *)"
            },
            {
              "name": "similarity",
              "type": "int (*)(int *, void *, void *, void *)"
            },
            {
              "name": "payload",
              "type": "void *"
            }
          ],
          "location": {
            "file": "diff.h",
            "line": 459,
            "column": 9
          },
          "group": "diff"
        },
        "git_diff_find_options": {
          "kind": "struct",
          "name": "git_diff_find_options",
          "referenceName": "git_diff_find_options",
          "comment": [
            "Control behavior of rename and copy detection",
            "These options mostly mimic parameters that can be passed to git-diff.",
            "- `rename_threshold` is the same as the -M option with a value\n - `copy_threshold` is the same as the -C option with a value\n - `rename_from_rewrite_threshold` matches the top of the -B option\n - `break_rewrite_threshold` matches the bottom of the -B option\n - `rename_limit` is the maximum number of matches to consider for\n   a particular file.  This is a little different from the `-l` option\n   to regular Git because we will still process up to this many matches\n   before abandoning the search.",
            "The `metric` option allows you to plug in a custom similarity metric.\n Set it to NULL for the default internal metric which is based on sampling\n hashes of ranges of data in the file.  The default metric is a pretty\n good similarity approximation that should work fairly well for both text\n and binary data, and is pretty fast with fixed memory overhead."
          ],
          "members": [
            {
              "name": "version",
              "type": "unsigned int"
            },
            {
              "name": "flags",
              "type": "uint32_t",
              "comment": [
                "Combination of git_diff_find_t values (default FIND_RENAMES)"
              ]
            },
            {
              "name": "rename_threshold",
              "type": "uint16_t",
              "comment": [
                "Similarity to consider a file renamed (default 50)"
              ]
            },
            {
              "name": "rename_from_rewrite_threshold",
              "type": "uint16_t",
              "comment": [
                "Similarity of modified to be eligible rename source (default 50)"
              ]
            },
            {
              "name": "copy_threshold",
              "type": "uint16_t",
              "comment": [
                "Similarity to consider a file a copy (default 50)"
              ]
            },
            {
              "name": "break_rewrite_threshold",
              "type": "uint16_t",
              "comment": [
                "Similarity to split modify into delete/add pair (default 60)"
              ]
            },
            {
              "name": "rename_limit",
              "type": "size_t",
              "comment": [
                "Maximum similarity sources to examine for a file (somewhat like\n  git-diff's `-l` option or `diff.renameLimit` config) (default 200)"
              ]
            },
            {
              "name": "metric",
              "type": "git_diff_similarity_metric *",
              "comment": [
                "Pluggable similarity metric; pass NULL to use internal metric"
              ]
            }
          ],
          "location": {
            "file": "diff.h",
            "line": 491,
            "column": 9
          },
          "group": "diff",
          "parameterTo": [
            "git_diff_find_similar"
          ]
        },
        "GIT_DIFF_FIND_OPTIONS_VERSION": {
          "kind": "macro",
          "name": "GIT_DIFF_FIND_OPTIONS_VERSION",
          "location": {
            "file": "diff.h",
            "line": 515,
            "column": 9
          },
          "value": "1",
          "comment": "",
          "group": "diff"
        },
        "GIT_DIFF_FIND_OPTIONS_INIT": {
          "kind": "macro",
          "name": "GIT_DIFF_FIND_OPTIONS_INIT",
          "location": {
            "file": "diff.h",
            "line": 516,
            "column": 9
          },
          "value": "{GIT_DIFF_FIND_OPTIONS_VERSION}",
          "comment": "",
          "group": "diff"
        },
        "git_diff_list_free": {
          "kind": "function",
          "name": "git_diff_list_free",
          "location": {
            "file": "diff.h",
            "line": 530,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "diff",
              "type": "git_diff_list *",
              "direction": "in",
              "comment": "The previously created diff list; cannot be used after free."
            }
          ],
          "comment": [
            "Deallocate a diff list."
          ],
          "group": "diff"
        },
        "git_diff_tree_to_tree": {
          "kind": "function",
          "name": "git_diff_tree_to_tree",
          "location": {
            "file": "diff.h",
            "line": 548,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "diff",
              "type": "git_diff_list **",
              "direction": "in",
              "comment": "Output pointer to a git_diff_list pointer to be allocated."
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repository containing the trees."
            },
            {
              "name": "old_tree",
              "type": "git_tree *",
              "direction": "in",
              "comment": "A git_tree object to diff from, or NULL for empty tree."
            },
            {
              "name": "new_tree",
              "type": "git_tree *",
              "direction": "in",
              "comment": "A git_tree object to diff to, or NULL for empty tree."
            },
            {
              "name": "opts",
              "type": "const git_diff_options *",
              "direction": "in",
              "comment": "Structure with options to influence diff or NULL for defaults."
            }
          ],
          "comment": [
            "Create a diff list with the difference between two tree objects.",
            "This is equivalent to `git diff \n<old\n-tree> \n<new\n-tree>`",
            "The first tree will be used for the \"old_file\" side of the delta and the\n second tree will be used for the \"new_file\" side of the delta.  You can\n pass NULL to indicate an empty tree, although it is an error to pass\n NULL for both the `old_tree` and `new_tree`."
          ],
          "group": "diff"
        },
        "git_diff_tree_to_index": {
          "kind": "function",
          "name": "git_diff_tree_to_index",
          "location": {
            "file": "diff.h",
            "line": 570,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "diff",
              "type": "git_diff_list **",
              "direction": "in",
              "comment": "Output pointer to a git_diff_list pointer to be allocated."
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repository containing the tree and index."
            },
            {
              "name": "old_tree",
              "type": "git_tree *",
              "direction": "in",
              "comment": "A git_tree object to diff from, or NULL for empty tree."
            },
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "The index to diff with; repo index used if NULL."
            },
            {
              "name": "opts",
              "type": "const git_diff_options *",
              "direction": "in",
              "comment": "Structure with options to influence diff or NULL for defaults."
            }
          ],
          "comment": [
            "Create a diff list between a tree and repository index.",
            "This is equivalent to `git diff --cached \n<treeish>` or if you pass\n the HEAD tree, then like `git diff --cached`.",
            "The tree you pass will be used for the \"old_file\" side of the delta, and\n the index will be used for the \"new_file\" side of the delta."
          ],
          "group": "diff"
        },
        "git_diff_index_to_workdir": {
          "kind": "function",
          "name": "git_diff_index_to_workdir",
          "location": {
            "file": "diff.h",
            "line": 593,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "diff",
              "type": "git_diff_list **",
              "direction": "in",
              "comment": "Output pointer to a git_diff_list pointer to be allocated."
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repository."
            },
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "The index to diff from; repo index used if NULL."
            },
            {
              "name": "opts",
              "type": "const git_diff_options *",
              "direction": "in",
              "comment": "Structure with options to influence diff or NULL for defaults."
            }
          ],
          "comment": [
            "Create a diff list between the repository index and the workdir directory.",
            "This matches the `git diff` command.  See the note below on\n `git_diff_tree_to_workdir` for a discussion of the difference between\n `git diff` and `git diff HEAD` and how to emulate a `git diff \n<treeish>`\n using libgit2.",
            "The index will be used for the \"old_file\" side of the delta, and the\n working directory will be used for the \"new_file\" side of the delta."
          ],
          "group": "diff"
        },
        "git_diff_tree_to_workdir": {
          "kind": "function",
          "name": "git_diff_tree_to_workdir",
          "location": {
            "file": "diff.h",
            "line": 628,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "diff",
              "type": "git_diff_list **",
              "direction": "in",
              "comment": "A pointer to a git_diff_list pointer that will be allocated."
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repository containing the tree."
            },
            {
              "name": "old_tree",
              "type": "git_tree *",
              "direction": "in",
              "comment": "A git_tree object to diff from, or NULL for empty tree."
            },
            {
              "name": "opts",
              "type": "const git_diff_options *",
              "direction": "in",
              "comment": "Structure with options to influence diff or NULL for defaults."
            }
          ],
          "comment": [
            "Create a diff list between a tree and the working directory.",
            "The tree you provide will be used for the \"old_file\" side of the delta,\n and the working directory will be used for the \"new_file\" side.",
            "Please note: this is *NOT* the same as `git diff \n<treeish>`.  Running\n `git diff HEAD` or the like actually uses information from the index,\n along with the tree and working directory info.",
            "This function returns strictly the differences between the tree and the\n files contained in the working directory, regardless of the state of\n files in the index.  It may come as a surprise, but there is no direct\n equivalent in core git.",
            "To emulate `git diff \n<treeish>`, call both `git_diff_tree_to_index` and\n `git_diff_index_to_workdir`, then call `git_diff_merge` on the results.\n That will yield a `git_diff_list` that matches the git output.",
            "If this seems confusing, take the case of a file with a staged deletion\n where the file has then been put back into the working dir and modified.\n The tree-to-workdir diff for that file is 'modified', but core git would\n show status 'deleted' since there is a pending deletion in the index."
          ],
          "group": "diff"
        },
        "git_diff_merge": {
          "kind": "function",
          "name": "git_diff_merge",
          "location": {
            "file": "diff.h",
            "line": 647,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "onto",
              "type": "git_diff_list *",
              "direction": "in",
              "comment": "Diff to merge into."
            },
            {
              "name": "from",
              "type": "const git_diff_list *",
              "direction": "in",
              "comment": "Diff to merge."
            }
          ],
          "comment": [
            "Merge one diff list into another.",
            "This merges items from the \"from\" list into the \"onto\" list.  The\n resulting diff list will have all items that appear in either list.\n If an item appears in both lists, then it will be \"merged\" to appear\n as if the old version was from the \"onto\" list and the new version\n is from the \"from\" list (with the exception that if the item has a\n pending DELETE in the middle, then it will show as deleted)."
          ],
          "group": "diff"
        },
        "git_diff_find_similar": {
          "kind": "function",
          "name": "git_diff_find_similar",
          "location": {
            "file": "diff.h",
            "line": 663,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, -1 on failure"
          },
          "params": [
            {
              "name": "diff",
              "type": "git_diff_list *",
              "direction": "in",
              "comment": "Diff list to run detection algorithms on"
            },
            {
              "name": "options",
              "type": "git_diff_find_options *",
              "direction": "in",
              "comment": "Control how detection should be run, NULL for defaults"
            }
          ],
          "comment": [
            "Transform a diff list marking file renames, copies, etc.",
            "This modifies a diff list in place, replacing old entries that look\n like renames or copies with new entries reflecting those changes.\n This also will, if requested, break modified files into add/remove\n pairs if the amount of change is above a threshold."
          ],
          "group": "diff"
        },
        "git_diff_foreach": {
          "kind": "function",
          "name": "git_diff_foreach",
          "location": {
            "file": "diff.h",
            "line": 702,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "diff",
              "type": "git_diff_list *",
              "direction": "in",
              "comment": "A git_diff_list generated by one of the above functions."
            },
            {
              "name": "file_cb",
              "type": "git_diff_file_cb",
              "direction": "in",
              "comment": "Callback function to make per file in the diff.",
              "referenceType": "int (*)(const git_diff_delta *, float, void *)"
            },
            {
              "name": "hunk_cb",
              "type": "git_diff_hunk_cb",
              "direction": "in",
              "comment": "Optional callback to make per hunk of text diff.  This\n                callback is called to describe a range of lines in the\n                diff.  It will not be issued for binary files.",
              "referenceType": "int (*)(const git_diff_delta *, const git_diff_range *, const char *, size_t, void *)"
            },
            {
              "name": "line_cb",
              "type": "git_diff_data_cb",
              "direction": "in",
              "comment": "Optional callback to make per line of diff text.  This\n                same callback will be made for context lines, added, and\n                removed lines, and even for a deleted trailing newline.",
              "referenceType": "int (*)(const git_diff_delta *, const git_diff_range *, char, const char *, size_t, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Reference pointer that will be passed to your callbacks."
            }
          ],
          "comment": [
            "Loop over all deltas in a diff list issuing callbacks.",
            "This will iterate through all of the files described in a diff.  You\n should provide a file callback to learn about each file.",
            "The \"hunk\" and \"line\" callbacks are optional, and the text diff of the\n files will only be calculated if they are not NULL.  Of course, these\n callbacks will not be invoked for binary files on the diff list or for\n files whose only changed is a file mode change.",
            "Returning a non-zero value from any of the callbacks will terminate\n the iteration and cause this return `GIT_EUSER`."
          ],
          "group": "diff"
        },
        "git_diff_print_compact": {
          "kind": "function",
          "name": "git_diff_print_compact",
          "location": {
            "file": "diff.h",
            "line": 720,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "diff",
              "type": "git_diff_list *",
              "direction": "in",
              "comment": "A git_diff_list generated by one of the above functions."
            },
            {
              "name": "print_cb",
              "type": "git_diff_data_cb",
              "direction": "in",
              "comment": "Callback to make per line of diff text.",
              "referenceType": "int (*)(const git_diff_delta *, const git_diff_range *, char, const char *, size_t, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Reference pointer that will be passed to your callback."
            }
          ],
          "comment": [
            "Iterate over a diff generating text output like \"git diff --name-status\".",
            "Returning a non-zero value from the callbacks will terminate the\n iteration and cause this return `GIT_EUSER`."
          ],
          "group": "diff"
        },
        "git_diff_print_raw": {
          "kind": "function",
          "name": "git_diff_print_raw",
          "location": {
            "file": "diff.h",
            "line": 736,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "diff",
              "type": "git_diff_list *",
              "direction": "in",
              "comment": "A git_diff_list generated by one of the above functions."
            },
            {
              "name": "print_cb",
              "type": "git_diff_data_cb",
              "direction": "in",
              "comment": "Callback to make per line of diff text.",
              "referenceType": "int (*)(const git_diff_delta *, const git_diff_range *, char, const char *, size_t, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Reference pointer that will be passed to your callback."
            }
          ],
          "comment": [
            "Iterate over a diff generating text output like \"git diff --raw\".",
            "Returning a non-zero value from the callbacks will terminate the\n iteration and cause this return `GIT_EUSER`."
          ],
          "group": "diff"
        },
        "git_diff_status_char": {
          "kind": "function",
          "name": "git_diff_status_char",
          "location": {
            "file": "diff.h",
            "line": 753,
            "column": 18
          },
          "returns": {
            "type": "char",
            "comment": "The single character label for that code"
          },
          "params": [
            {
              "name": "status",
              "type": "git_delta_t",
              "direction": "in",
              "comment": "The git_delta_t value to look up",
              "referenceType": "enum git_delta_t"
            }
          ],
          "comment": [
            "Look up the single character abbreviation for a delta status code.",
            "When you call `git_diff_print_compact` it prints single letter codes into\n the output such as 'A' for added, 'D' for deleted, 'M' for modified, etc.\n It is sometimes convenient to convert a git_delta_t value into these\n letters for your own purposes.  This function does just that.  By the\n way, unmodified will return a space (i.e. ' ')."
          ],
          "group": "diff"
        },
        "git_diff_print_patch": {
          "kind": "function",
          "name": "git_diff_print_patch",
          "location": {
            "file": "diff.h",
            "line": 772,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "diff",
              "type": "git_diff_list *",
              "direction": "in",
              "comment": "A git_diff_list generated by one of the above functions."
            },
            {
              "name": "print_cb",
              "type": "git_diff_data_cb",
              "direction": "in",
              "comment": "Callback function to output lines of the diff.  This\n                 same function will be called for file headers, hunk\n                 headers, and diff lines.  Fortunately, you can probably\n                 use various GIT_DIFF_LINE constants to determine what\n                 text you are given.",
              "referenceType": "int (*)(const git_diff_delta *, const git_diff_range *, char, const char *, size_t, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Reference pointer that will be passed to your callbacks."
            }
          ],
          "comment": [
            "Iterate over a diff generating text output like \"git diff\".",
            "This is a super easy way to generate a patch from a diff.",
            "Returning a non-zero value from the callbacks will terminate the\n iteration and cause this return `GIT_EUSER`."
          ],
          "group": "diff"
        },
        "git_diff_num_deltas": {
          "kind": "function",
          "name": "git_diff_num_deltas",
          "location": {
            "file": "diff.h",
            "line": 783,
            "column": 20
          },
          "returns": {
            "type": "size_t",
            "comment": "Count of number of deltas in the list"
          },
          "params": [
            {
              "name": "diff",
              "type": "git_diff_list *",
              "direction": "in",
              "comment": "A git_diff_list generated by one of the above functions"
            }
          ],
          "comment": [
            "Query how many diff records are there in a diff list."
          ],
          "group": "diff"
        },
        "git_diff_num_deltas_of_type": {
          "kind": "function",
          "name": "git_diff_num_deltas_of_type",
          "location": {
            "file": "diff.h",
            "line": 796,
            "column": 20
          },
          "returns": {
            "type": "size_t",
            "comment": "Count of number of deltas matching delta_t type"
          },
          "params": [
            {
              "name": "diff",
              "type": "git_diff_list *",
              "direction": "in",
              "comment": "A git_diff_list generated by one of the above functions"
            },
            {
              "name": "type",
              "type": "git_delta_t",
              "direction": "in",
              "comment": "A git_delta_t value to filter the count",
              "referenceType": "enum git_delta_t"
            }
          ],
          "comment": [
            "Query how many diff deltas are there in a diff list filtered by type.",
            "This works just like `git_diff_entrycount()` with an extra parameter\n that is a `git_delta_t` and returns just the count of how many deltas\n match that particular type."
          ],
          "group": "diff"
        },
        "git_diff_get_patch": {
          "kind": "function",
          "name": "git_diff_get_patch",
          "location": {
            "file": "diff.h",
            "line": 825,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, other value \n<\n 0 on error"
          },
          "params": [
            {
              "name": "patch_out",
              "type": "git_diff_patch **",
              "direction": "in",
              "comment": "Output parameter for the delta patch object"
            },
            {
              "name": "delta_out",
              "type": "const git_diff_delta **",
              "direction": "in",
              "comment": "Output parameter for the delta object"
            },
            {
              "name": "diff",
              "type": "git_diff_list *",
              "direction": "in",
              "comment": "Diff list object"
            },
            {
              "name": "idx",
              "type": "size_t",
              "direction": "in",
              "comment": "Index into diff list"
            }
          ],
          "comment": [
            "Return the diff delta and patch for an entry in the diff list.",
            "The `git_diff_patch` is a newly created object contains the text diffs\n for the delta.  You have to call `git_diff_patch_free()` when you are\n done with it.  You can use the patch object to loop over all the hunks\n and lines in the diff of the one delta.",
            "For an unchanged file or a binary file, no `git_diff_patch` will be\n created, the output will be set to NULL, and the `binary` flag will be\n set true in the `git_diff_delta` structure.",
            "The `git_diff_delta` pointer points to internal data and you do not have\n to release it when you are done with it.  It will go away when the\n `git_diff_list` and `git_diff_patch` go away.",
            "It is okay to pass NULL for either of the output parameters; if you pass\n NULL for the `git_diff_patch`, then the text diff will not be calculated."
          ],
          "group": "diff"
        },
        "git_diff_patch_free": {
          "kind": "function",
          "name": "git_diff_patch_free",
          "location": {
            "file": "diff.h",
            "line": 834,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "patch",
              "type": "git_diff_patch *"
            }
          ],
          "comment": [
            "Free a git_diff_patch object."
          ],
          "group": "diff"
        },
        "git_diff_patch_delta": {
          "kind": "function",
          "name": "git_diff_patch_delta",
          "location": {
            "file": "diff.h",
            "line": 840,
            "column": 36
          },
          "returns": {
            "type": "const git_diff_delta *"
          },
          "params": [
            {
              "name": "patch",
              "type": "git_diff_patch *"
            }
          ],
          "comment": [
            "Get the delta associated with a patch"
          ],
          "group": "diff"
        },
        "git_diff_patch_num_hunks": {
          "kind": "function",
          "name": "git_diff_patch_num_hunks",
          "location": {
            "file": "diff.h",
            "line": 846,
            "column": 20
          },
          "returns": {
            "type": "size_t"
          },
          "params": [
            {
              "name": "patch",
              "type": "git_diff_patch *"
            }
          ],
          "comment": [
            "Get the number of hunks in a patch"
          ],
          "group": "diff"
        },
        "git_diff_patch_line_stats": {
          "kind": "function",
          "name": "git_diff_patch_line_stats",
          "location": {
            "file": "diff.h",
            "line": 865,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, \n<\n0 on error"
          },
          "params": [
            {
              "name": "total_context",
              "type": "size_t *",
              "direction": "in",
              "comment": "Count of context lines in output, can be NULL."
            },
            {
              "name": "total_additions",
              "type": "size_t *",
              "direction": "in",
              "comment": "Count of addition lines in output, can be NULL."
            },
            {
              "name": "total_deletions",
              "type": "size_t *",
              "direction": "in",
              "comment": "Count of deletion lines in output, can be NULL."
            },
            {
              "name": "patch",
              "type": "const git_diff_patch *",
              "direction": "in",
              "comment": "The git_diff_patch object"
            }
          ],
          "comment": [
            "Get line counts of each type in a patch.",
            "This helps imitate a diff --numstat type of output.  For that purpose,\n you only need the `total_additions` and `total_deletions` values, but we\n include the `total_context` line count in case you want the total number\n of lines of diff output that will be generated.",
            "All outputs are optional. Pass NULL if you don't need a particular count."
          ],
          "group": "diff"
        },
        "git_diff_patch_get_hunk": {
          "kind": "function",
          "name": "git_diff_patch_get_hunk",
          "location": {
            "file": "diff.h",
            "line": 887,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_ENOTFOUND if hunk_idx out of range, \n<\n0 on error"
          },
          "params": [
            {
              "name": "range",
              "type": "const git_diff_range **",
              "direction": "in",
              "comment": "Output pointer to git_diff_range of hunk"
            },
            {
              "name": "header",
              "type": "const char **",
              "direction": "in",
              "comment": "Output pointer to header string for hunk.  Unlike the\n               content pointer for each line, this will be NUL-terminated"
            },
            {
              "name": "header_len",
              "type": "size_t *",
              "direction": "in",
              "comment": "Output value of characters in header string"
            },
            {
              "name": "lines_in_hunk",
              "type": "size_t *",
              "direction": "in",
              "comment": "Output count of total lines in this hunk"
            },
            {
              "name": "patch",
              "type": "git_diff_patch *",
              "direction": "in",
              "comment": "Input pointer to patch object"
            },
            {
              "name": "hunk_idx",
              "type": "size_t",
              "direction": "in",
              "comment": "Input index of hunk to get information about"
            }
          ],
          "comment": [
            "Get the information about a hunk in a patch",
            "Given a patch and a hunk index into the patch, this returns detailed\n information about that hunk.  Any of the output pointers can be passed\n as NULL if you don't care about that particular piece of information."
          ],
          "group": "diff"
        },
        "git_diff_patch_num_lines_in_hunk": {
          "kind": "function",
          "name": "git_diff_patch_num_lines_in_hunk",
          "location": {
            "file": "diff.h",
            "line": 902,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "Number of lines in hunk or -1 if invalid hunk index"
          },
          "params": [
            {
              "name": "patch",
              "type": "git_diff_patch *",
              "direction": "in",
              "comment": "The git_diff_patch object"
            },
            {
              "name": "hunk_idx",
              "type": "size_t",
              "direction": "in",
              "comment": "Index of the hunk"
            }
          ],
          "comment": [
            "Get the number of lines in a hunk."
          ],
          "group": "diff"
        },
        "git_diff_patch_get_line_in_hunk": {
          "kind": "function",
          "name": "git_diff_patch_get_line_in_hunk",
          "location": {
            "file": "diff.h",
            "line": 924,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, \n<\n0 on failure"
          },
          "params": [
            {
              "name": "line_origin",
              "type": "char *",
              "direction": "in",
              "comment": "A GIT_DIFF_LINE constant from above"
            },
            {
              "name": "content",
              "type": "const char **",
              "direction": "in",
              "comment": "Pointer to content of diff line, not NUL-terminated"
            },
            {
              "name": "content_len",
              "type": "size_t *",
              "direction": "in",
              "comment": "Number of characters in content"
            },
            {
              "name": "old_lineno",
              "type": "int *",
              "direction": "in",
              "comment": "Line number in old file or -1 if line is added"
            },
            {
              "name": "new_lineno",
              "type": "int *",
              "direction": "in",
              "comment": "Line number in new file or -1 if line is deleted"
            },
            {
              "name": "patch",
              "type": "git_diff_patch *",
              "direction": "in",
              "comment": "The patch to look in"
            },
            {
              "name": "hunk_idx",
              "type": "size_t",
              "direction": "in",
              "comment": "The index of the hunk"
            },
            {
              "name": "line_of_hunk",
              "type": "size_t",
              "direction": "in",
              "comment": "The index of the line in the hunk"
            }
          ],
          "comment": [
            "Get data about a line in a hunk of a patch.",
            "Given a patch, a hunk index, and a line index in the hunk, this\n will return a lot of details about that line.  If you pass a hunk\n index larger than the number of hunks or a line index larger than\n the number of lines in the hunk, this will return -1."
          ],
          "group": "diff"
        },
        "git_diff_patch_print": {
          "kind": "function",
          "name": "git_diff_patch_print",
          "location": {
            "file": "diff.h",
            "line": 946,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "patch",
              "type": "git_diff_patch *",
              "direction": "in",
              "comment": "A git_diff_patch representing changes to one file"
            },
            {
              "name": "print_cb",
              "type": "git_diff_data_cb",
              "direction": "in",
              "comment": "Callback function to output lines of the patch.  Will be\n                 called for file headers, hunk headers, and diff lines.",
              "referenceType": "int (*)(const git_diff_delta *, const git_diff_range *, char, const char *, size_t, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Reference pointer that will be passed to your callbacks."
            }
          ],
          "comment": [
            "Serialize the patch to text via callback.",
            "Returning a non-zero value from the callback will terminate the iteration\n and cause this return `GIT_EUSER`."
          ],
          "group": "diff"
        },
        "git_diff_patch_to_str": {
          "kind": "function",
          "name": "git_diff_patch_to_str",
          "location": {
            "file": "diff.h",
            "line": 958,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, \n<\n0 on failure."
          },
          "params": [
            {
              "name": "string",
              "type": "char **",
              "direction": "in",
              "comment": "Allocated string; caller must free."
            },
            {
              "name": "patch",
              "type": "git_diff_patch *",
              "direction": "in",
              "comment": "A git_diff_patch representing changes to one file"
            }
          ],
          "comment": [
            "Get the content of a patch as a single diff text."
          ],
          "group": "diff"
        },
        "git_diff_blobs": {
          "kind": "function",
          "name": "git_diff_blobs",
          "location": {
            "file": "diff.h",
            "line": 996,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback return, or error code"
          },
          "params": [
            {
              "name": "old_blob",
              "type": "const git_blob *",
              "direction": "in",
              "comment": "Blob for old side of diff, or NULL for empty blob"
            },
            {
              "name": "old_as_path",
              "type": "const char *",
              "direction": "in",
              "comment": "Treat old blob as if it had this filename; can be NULL"
            },
            {
              "name": "new_blob",
              "type": "const git_blob *",
              "direction": "in",
              "comment": "Blob for new side of diff, or NULL for empty blob"
            },
            {
              "name": "new_as_path",
              "type": "const char *",
              "direction": "in",
              "comment": "Treat new blob as if it had this filename; can be NULL"
            },
            {
              "name": "options",
              "type": "const git_diff_options *",
              "direction": "in",
              "comment": "Options for diff, or NULL for default options"
            },
            {
              "name": "file_cb",
              "type": "git_diff_file_cb",
              "direction": "in",
              "comment": "Callback for \"file\"; made once if there is a diff; can be NULL",
              "referenceType": "int (*)(const git_diff_delta *, float, void *)"
            },
            {
              "name": "hunk_cb",
              "type": "git_diff_hunk_cb",
              "direction": "in",
              "comment": "Callback for each hunk in diff; can be NULL",
              "referenceType": "int (*)(const git_diff_delta *, const git_diff_range *, const char *, size_t, void *)"
            },
            {
              "name": "line_cb",
              "type": "git_diff_data_cb",
              "direction": "in",
              "comment": "Callback for each line in diff; can be NULL",
              "referenceType": "int (*)(const git_diff_delta *, const git_diff_range *, char, const char *, size_t, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Payload passed to each callback function"
            }
          ],
          "comment": [
            "Directly run a diff on two blobs.",
            "Compared to a file, a blob lacks some contextual information. As such,\n the `git_diff_file` given to the callback will have some fake data; i.e.\n `mode` will be 0 and `path` will be NULL.",
            "NULL is allowed for either `old_blob` or `new_blob` and will be treated\n as an empty blob, with the `oid` set to NULL in the `git_diff_file` data.\n Passing NULL for both blobs is a noop; no callbacks will be made at all.",
            "We do run a binary content check on the blob content and if either blob\n looks like binary data, the `git_diff_delta` binary attribute will be set\n to 1 and no call to the hunk_cb nor line_cb will be made (unless you pass\n `GIT_DIFF_FORCE_TEXT` of course)."
          ],
          "group": "diff"
        },
        "git_diff_patch_from_blobs": {
          "kind": "function",
          "name": "git_diff_patch_from_blobs",
          "location": {
            "file": "diff.h",
            "line": 1023,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success or error code \n<\n 0"
          },
          "params": [
            {
              "name": "out",
              "type": "git_diff_patch **",
              "direction": "in",
              "comment": "The generated patch; NULL on error"
            },
            {
              "name": "old_blob",
              "type": "const git_blob *",
              "direction": "in",
              "comment": "Blob for old side of diff, or NULL for empty blob"
            },
            {
              "name": "old_as_path",
              "type": "const char *",
              "direction": "in",
              "comment": "Treat old blob as if it had this filename; can be NULL"
            },
            {
              "name": "new_blob",
              "type": "const git_blob *",
              "direction": "in",
              "comment": "Blob for new side of diff, or NULL for empty blob"
            },
            {
              "name": "new_as_path",
              "type": "const char *",
              "direction": "in",
              "comment": "Treat new blob as if it had this filename; can be NULL"
            },
            {
              "name": "opts",
              "type": "const git_diff_options *",
              "direction": "in",
              "comment": "Options for diff, or NULL for default options"
            }
          ],
          "comment": [
            "Directly generate a patch from the difference between two blobs.",
            "This is just like `git_diff_blobs()` except it generates a patch object\n for the difference instead of directly making callbacks.  You can use the\n standard `git_diff_patch` accessor functions to read the patch data, and\n you must call `git_diff_patch_free()` on the patch when done."
          ],
          "group": "diff"
        },
        "git_diff_blob_to_buffer": {
          "kind": "function",
          "name": "git_diff_blob_to_buffer",
          "location": {
            "file": "diff.h",
            "line": 1055,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback return, or error code"
          },
          "params": [
            {
              "name": "old_blob",
              "type": "const git_blob *",
              "direction": "in",
              "comment": "Blob for old side of diff, or NULL for empty blob"
            },
            {
              "name": "old_as_path",
              "type": "const char *",
              "direction": "in",
              "comment": "Treat old blob as if it had this filename; can be NULL"
            },
            {
              "name": "buffer",
              "type": "const char *",
              "direction": "in",
              "comment": "Raw data for new side of diff, or NULL for empty"
            },
            {
              "name": "buffer_len",
              "type": "size_t",
              "direction": "in",
              "comment": "Length of raw data for new side of diff"
            },
            {
              "name": "buffer_as_path",
              "type": "const char *",
              "direction": "in",
              "comment": "Treat buffer as if it had this filename; can be NULL"
            },
            {
              "name": "options",
              "type": "const git_diff_options *",
              "direction": "in",
              "comment": "Options for diff, or NULL for default options"
            },
            {
              "name": "file_cb",
              "type": "git_diff_file_cb",
              "direction": "in",
              "comment": "Callback for \"file\"; made once if there is a diff; can be NULL",
              "referenceType": "int (*)(const git_diff_delta *, float, void *)"
            },
            {
              "name": "hunk_cb",
              "type": "git_diff_hunk_cb",
              "direction": "in",
              "comment": "Callback for each hunk in diff; can be NULL",
              "referenceType": "int (*)(const git_diff_delta *, const git_diff_range *, const char *, size_t, void *)"
            },
            {
              "name": "data_cb",
              "type": "git_diff_data_cb",
              "direction": "in",
              "comment": "Callback for each line in diff; can be NULL",
              "referenceType": "int (*)(const git_diff_delta *, const git_diff_range *, char, const char *, size_t, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Payload passed to each callback function"
            }
          ],
          "comment": [
            "Directly run a diff between a blob and a buffer.",
            "As with `git_diff_blobs`, comparing a blob and buffer lacks some context,\n so the `git_diff_file` parameters to the callbacks will be faked a la the\n rules for `git_diff_blobs()`.",
            "Passing NULL for `old_blob` will be treated as an empty blob (i.e. the\n `file_cb` will be invoked with GIT_DELTA_ADDED and the diff will be the\n entire content of the buffer added).  Passing NULL to the buffer will do\n the reverse, with GIT_DELTA_REMOVED and blob content removed."
          ],
          "group": "diff"
        },
        "git_diff_patch_from_blob_and_buffer": {
          "kind": "function",
          "name": "git_diff_patch_from_blob_and_buffer",
          "location": {
            "file": "diff.h",
            "line": 1084,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success or error code \n<\n 0"
          },
          "params": [
            {
              "name": "out",
              "type": "git_diff_patch **",
              "direction": "in",
              "comment": "The generated patch; NULL on error"
            },
            {
              "name": "old_blob",
              "type": "const git_blob *",
              "direction": "in",
              "comment": "Blob for old side of diff, or NULL for empty blob"
            },
            {
              "name": "old_as_path",
              "type": "const char *",
              "direction": "in",
              "comment": "Treat old blob as if it had this filename; can be NULL"
            },
            {
              "name": "buffer",
              "type": "const char *",
              "direction": "in",
              "comment": "Raw data for new side of diff, or NULL for empty"
            },
            {
              "name": "buffer_len",
              "type": "size_t",
              "direction": "in",
              "comment": "Length of raw data for new side of diff"
            },
            {
              "name": "buffer_as_path",
              "type": "const char *",
              "direction": "in",
              "comment": "Treat buffer as if it had this filename; can be NULL"
            },
            {
              "name": "opts",
              "type": "const git_diff_options *",
              "direction": "in",
              "comment": "Options for diff, or NULL for default options"
            }
          ],
          "comment": [
            "Directly generate a patch from the difference between a blob and a buffer.",
            "This is just like `git_diff_blob_to_buffer()` except it generates a patch\n object for the difference instead of directly making callbacks.  You can\n use the standard `git_diff_patch` accessor functions to read the patch\n data, and you must call `git_diff_patch_free()` on the patch when done."
          ],
          "group": "diff"
        }
      },
      "info": {
        "summary": "Git tree and file differencing routines.",
        "details": "Overview\n--------\nCalculating diffs is generally done in two phases: building a diff list\nthen traversing the diff list.  This makes is easier to share logic\nacross the various types of diffs (tree vs tree, workdir vs index, etc.),\nand also allows you to insert optional diff list post-processing phases,\nsuch as rename detected, in between the steps.  When you are done with a\ndiff list object, it must be freed.\nTerminology\n-----------\nTo understand the diff APIs, you should know the following terms:\n- A `diff` or `diff list` represents the cumulative list of differences\nbetween two snapshots of a repository (possibly filtered by a set of\nfile name patterns).  This is the `git_diff_list` object.\n- A `delta` is a file pair with an old and new revision.  The old version\nmay be absent if the file was just created and the new version may be\nabsent if the file was deleted.  A diff is mostly just a list of deltas.\n- A `binary` file / delta is a file (or pair) for which no text diffs\nshould be generated.  A diff list can contain delta entries that are\nbinary, but no diff content will be output for those files.  There is\na base heuristic for binary detection and you can further tune the\nbehavior with git attributes or diff flags and option settings.\n- A `hunk` is a span of modified lines in a delta along with some stable\nsurrounding context.  You can configure the amount of context and other\nproperties of how hunks are generated.  Each hunk also comes with a\nheader that described where it starts and ends in both the old and new\nversions in the delta.\n- A `line` is a range of characters inside a hunk.  It could be a context\nline (i.e. in both old and new versions), an added line (i.e. only in\nthe new version), or a removed line (i.e. only in the old version).\nUnfortunately, we don't know anything about the encoding of data in the\nfile being diffed, so we cannot tell you much about the line content.\nLine data will not be NUL-byte terminated, however, because it will be\njust a span of bytes inside the larger file."
      }
    },
    "errors": {
      "apis": {
        "git_error_code": {
          "kind": "enum",
          "name": "git_error_code",
          "referenceName": "git_error_code",
          "members": [
            {
              "name": "GIT_OK",
              "value": "0"
            },
            {
              "name": "GIT_ERROR",
              "value": "-1"
            },
            {
              "name": "GIT_ENOTFOUND",
              "value": "-3"
            },
            {
              "name": "GIT_EEXISTS",
              "value": "-4"
            },
            {
              "name": "GIT_EAMBIGUOUS",
              "value": "-5"
            },
            {
              "name": "GIT_EBUFS",
              "value": "-6"
            },
            {
              "name": "GIT_EUSER",
              "value": "-7"
            },
            {
              "name": "GIT_EBAREREPO",
              "value": "-8"
            },
            {
              "name": "GIT_EORPHANEDHEAD",
              "value": "-9"
            },
            {
              "name": "GIT_EUNMERGED",
              "value": "-10"
            },
            {
              "name": "GIT_ENONFASTFORWARD",
              "value": "-11"
            },
            {
              "name": "GIT_EINVALIDSPEC",
              "value": "-12"
            },
            {
              "name": "GIT_EMERGECONFLICT",
              "value": "-13"
            },
            {
              "name": "GIT_PASSTHROUGH",
              "value": "-30"
            },
            {
              "name": "GIT_ITEROVER",
              "value": "-31"
            }
          ],
          "comment": [
            "Generic return codes"
          ],
          "location": {
            "file": "errors.h",
            "line": 21,
            "column": 9
          },
          "group": "errors"
        },
        "git_error": {
          "kind": "struct",
          "name": "git_error",
          "referenceName": "git_error",
          "members": [
            {
              "name": "message",
              "type": "char *"
            },
            {
              "name": "klass",
              "type": "int"
            }
          ],
          "location": {
            "file": "errors.h",
            "line": 40,
            "column": 9
          },
          "group": "errors",
          "returnedBy": [
            "giterr_last"
          ]
        },
        "git_error_t": {
          "kind": "enum",
          "name": "git_error_t",
          "referenceName": "git_error_t",
          "members": [
            {
              "name": "GITERR_NOMEMORY"
            },
            {
              "name": "GITERR_OS"
            },
            {
              "name": "GITERR_INVALID"
            },
            {
              "name": "GITERR_REFERENCE"
            },
            {
              "name": "GITERR_ZLIB"
            },
            {
              "name": "GITERR_REPOSITORY"
            },
            {
              "name": "GITERR_CONFIG"
            },
            {
              "name": "GITERR_REGEX"
            },
            {
              "name": "GITERR_ODB"
            },
            {
              "name": "GITERR_INDEX"
            },
            {
              "name": "GITERR_OBJECT"
            },
            {
              "name": "GITERR_NET"
            },
            {
              "name": "GITERR_TAG"
            },
            {
              "name": "GITERR_TREE"
            },
            {
              "name": "GITERR_INDEXER"
            },
            {
              "name": "GITERR_SSL"
            },
            {
              "name": "GITERR_SUBMODULE"
            },
            {
              "name": "GITERR_THREAD"
            },
            {
              "name": "GITERR_STASH"
            },
            {
              "name": "GITERR_CHECKOUT"
            },
            {
              "name": "GITERR_FETCHHEAD"
            },
            {
              "name": "GITERR_MERGE"
            }
          ],
          "comment": [
            "Error classes"
          ],
          "location": {
            "file": "errors.h",
            "line": 46,
            "column": 9
          },
          "group": "errors"
        },
        "giterr_last": {
          "kind": "function",
          "name": "giterr_last",
          "location": {
            "file": "errors.h",
            "line": 77,
            "column": 31
          },
          "returns": {
            "type": "const git_error *",
            "comment": "A git_error object."
          },
          "comment": [
            "Return the last `git_error` object that was generated for the\n current thread or NULL if no error has occurred."
          ],
          "group": "errors"
        },
        "giterr_clear": {
          "kind": "function",
          "name": "giterr_clear",
          "location": {
            "file": "errors.h",
            "line": 82,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "comment": [
            "Clear the last library error that occurred for this thread."
          ],
          "group": "errors"
        },
        "giterr_set_str": {
          "kind": "function",
          "name": "giterr_set_str",
          "location": {
            "file": "errors.h",
            "line": 105,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "error_class",
              "type": "int",
              "direction": "in",
              "comment": "One of the `git_error_t` enum above describing the\n                    general subsystem that is responsible for the error."
            },
            {
              "name": "string",
              "type": "const char *",
              "direction": "in",
              "comment": "The formatted error message to keep"
            }
          ],
          "comment": [
            "Set the error message string for this thread.",
            "This function is public so that custom ODB backends and the like can\n relay an error message through libgit2.  Most regular users of libgit2\n will never need to call this function -- actually, calling it in most\n circumstances (for example, calling from within a callback function)\n will just end up having the value overwritten by libgit2 internals.",
            "This error message is stored in thread-local storage and only applies\n to the particular thread that this libgit2 call is made from.",
            "NOTE: Passing the `error_class` as GITERR_OS has a special behavior: we\n attempt to append the system default error message for the last OS error\n that occurred and then clear the last error.  The specific implementation\n of looking up and clearing this last OS error will vary by platform."
          ],
          "group": "errors"
        },
        "giterr_set_oom": {
          "kind": "function",
          "name": "giterr_set_oom",
          "location": {
            "file": "errors.h",
            "line": 116,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "comment": [
            "Set the error message to a special value for memory allocation failure.",
            "The normal `giterr_set_str()` function attempts to `strdup()` the string\n that is passed in.  This is not a good idea when the error in question\n is a memory allocation failure.  That circumstance has a special setter\n function that sets the error string to a known and statically allocated\n internal value."
          ],
          "group": "errors"
        }
      },
      "info": {
        "summary": "Git error handling routines and variables"
      }
    },
    "graph": {
      "apis": {
        "git_graph_ahead_behind": {
          "kind": "function",
          "name": "git_graph_ahead_behind",
          "location": {
            "file": "graph.h",
            "line": 37,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "ahead",
              "type": "size_t *",
              "direction": "in",
              "comment": "number of unique from commits in `upstream`"
            },
            {
              "name": "behind",
              "type": "size_t *",
              "direction": "in",
              "comment": "number of unique from commits in `local`"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository where the commits exist"
            },
            {
              "name": "local",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "the commit for local"
            },
            {
              "name": "upstream",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "the commit for upstream"
            }
          ],
          "comment": [
            "Count the number of unique commits between two commit objects",
            "There is no need for branches containing the commits to have any\n upstream relationship, but it helps to think of one as a branch and\n the other as its upstream, the `ahead` and `behind` values will be\n what git would report for the branches."
          ],
          "group": "graph"
        }
      },
      "info": {
        "summary": "Git graph traversal routines"
      }
    },
    "ignore": {
      "apis": {
        "git_ignore_add_rule": {
          "kind": "function",
          "name": "git_ignore_add_rule",
          "location": {
            "file": "ignore.h",
            "line": 37,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repository to add ignore rules to."
            },
            {
              "name": "rules",
              "type": "const char *",
              "direction": "in",
              "comment": "Text of rules, a la the contents of a .gitignore file.\n              It is okay to have multiple rules in the text; if so,\n              each rule should be terminated with a newline."
            }
          ],
          "comment": [
            "Add ignore rules for a repository.",
            "Excludesfile rules (i.e. .gitignore rules) are generally read from\n .gitignore files in the repository tree or from a shared system file\n only if a \"core.excludesfile\" config value is set.  The library also\n keeps a set of per-repository internal ignores that can be configured\n in-memory and will not persist.  This function allows you to add to\n that internal rules list.",
            "Example usage:",
            "error = git_ignore_add_rule(myrepo, \"*.c\\ndir/\\nFile with space\\n\");",
            "This would add three rules to the ignores."
          ],
          "group": "ignore"
        },
        "git_ignore_clear_internal_rules": {
          "kind": "function",
          "name": "git_ignore_clear_internal_rules",
          "location": {
            "file": "ignore.h",
            "line": 52,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repository to remove ignore rules from."
            }
          ],
          "comment": [
            "Clear ignore rules that were explicitly added.",
            "Resets to the default internal ignore rules.  This will not turn off\n rules in .gitignore files that actually exist in the filesystem.",
            "The default internal ignores ignore \".\", \"..\" and \".git\" entries."
          ],
          "group": "ignore"
        },
        "git_ignore_path_is_ignored": {
          "kind": "function",
          "name": "git_ignore_path_is_ignored",
          "location": {
            "file": "ignore.h",
            "line": 71,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 if ignore rules could be processed for the file (regardless\n         of whether it exists or not), or an error \n<\n 0 if they could not."
          },
          "params": [
            {
              "name": "ignored",
              "type": "int *",
              "direction": "in",
              "comment": "boolean returning 0 if the file is not ignored, 1 if it is"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "a repository object"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "the file to check ignores for, relative to the repo's workdir."
            }
          ],
          "comment": [
            "Test if the ignore rules apply to a given path.",
            "This function checks the ignore rules to see if they would apply to the\n given file.  This indicates if the file would be ignored regardless of\n whether the file is already in the index or committed to the repository.",
            "One way to think of this is if you were to do \"git add .\" on the\n directory containing the file, would it be added or not?"
          ],
          "group": "ignore"
        }
      },
      "info": {}
    },
    "index": {
      "apis": {
        "git_index_time": {
          "kind": "struct",
          "name": "git_index_time",
          "referenceName": "git_index_time",
          "comment": [
            "Time structure used in a git index entry"
          ],
          "members": [
            {
              "name": "seconds",
              "type": "git_time_t",
              "referenceType": "int64_t"
            },
            {
              "name": "nanoseconds",
              "type": "unsigned int"
            }
          ],
          "location": {
            "file": "index.h",
            "line": 26,
            "column": 9
          },
          "group": "index"
        },
        "git_index_entry": {
          "kind": "struct",
          "name": "git_index_entry",
          "referenceName": "git_index_entry",
          "comment": [
            "In-memory representation of a file entry in the index.",
            "This is a public structure that represents a file entry in the index.\n The meaning of the fields corresponds to core Git's documentation (in\n \"Documentation/technical/index-format.txt\").",
            "The `flags` field consists of a number of bit fields which can be\n accessed via the first set of `GIT_IDXENTRY_...` bitmasks below.  These\n flags are all read from and persisted to disk.",
            "The `flags_extended` field also has a number of bit fields which can be\n accessed via the later `GIT_IDXENTRY_...` bitmasks below.  Some of\n these flags are read from and written to disk, but some are set aside\n for in-memory only reference."
          ],
          "members": [
            {
              "name": "ctime",
              "type": "git_index_time",
              "referenceType": "struct git_index_time"
            },
            {
              "name": "mtime",
              "type": "git_index_time",
              "referenceType": "struct git_index_time"
            },
            {
              "name": "dev",
              "type": "unsigned int"
            },
            {
              "name": "ino",
              "type": "unsigned int"
            },
            {
              "name": "mode",
              "type": "unsigned int"
            },
            {
              "name": "uid",
              "type": "unsigned int"
            },
            {
              "name": "gid",
              "type": "unsigned int"
            },
            {
              "name": "file_size",
              "type": "git_off_t",
              "referenceType": "int64_t"
            },
            {
              "name": "oid",
              "type": "git_oid",
              "referenceType": "struct git_oid"
            },
            {
              "name": "flags",
              "type": "unsigned short"
            },
            {
              "name": "flags_extended",
              "type": "unsigned short"
            },
            {
              "name": "path",
              "type": "char *"
            }
          ],
          "location": {
            "file": "index.h",
            "line": 48,
            "column": 16
          },
          "group": "index",
          "returnedBy": [
            "git_index_get_byindex",
            "git_index_get_bypath"
          ],
          "parameterTo": [
            "git_index_add",
            "git_index_entry_stage",
            "git_index_conflict_add",
            "git_index_conflict_get",
            "git_index_conflict_next"
          ]
        },
        "GIT_IDXENTRY_NAMEMASK": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_NAMEMASK",
          "location": {
            "file": "index.h",
            "line": 74,
            "column": 9
          },
          "value": "(0x0fff)",
          "comment": "Bitmasks for on-disk fields of `git_index_entry`'s `flags` These bitmasks match the four fields in the `git_index_entry` `flags` value both in memory and on disk.  You can use them to interpret the data in the `flags`.",
          "group": "index"
        },
        "GIT_IDXENTRY_STAGEMASK": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_STAGEMASK",
          "location": {
            "file": "index.h",
            "line": 75,
            "column": 9
          },
          "value": "(0x3000)",
          "comment": "",
          "group": "index"
        },
        "GIT_IDXENTRY_EXTENDED": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_EXTENDED",
          "location": {
            "file": "index.h",
            "line": 76,
            "column": 9
          },
          "value": "(0x4000)",
          "comment": "",
          "group": "index"
        },
        "GIT_IDXENTRY_VALID": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_VALID",
          "location": {
            "file": "index.h",
            "line": 77,
            "column": 9
          },
          "value": "(0x8000)",
          "comment": "",
          "group": "index"
        },
        "GIT_IDXENTRY_STAGESHIFT": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_STAGESHIFT",
          "location": {
            "file": "index.h",
            "line": 78,
            "column": 9
          },
          "value": "12",
          "comment": "",
          "group": "index"
        },
        "GIT_IDXENTRY_STAGE(E)": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_STAGE(E)",
          "location": {
            "file": "index.h",
            "line": 80,
            "column": 9
          },
          "value": "(((E)->flags & GIT_IDXENTRY_STAGEMASK) >> GIT_IDXENTRY_STAGESHIFT)",
          "comment": "",
          "group": "index"
        },
        "GIT_IDXENTRY_INTENT_TO_ADD": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_INTENT_TO_ADD",
          "location": {
            "file": "index.h",
            "line": 94,
            "column": 9
          },
          "value": "(1 << 13)",
          "comment": "Bitmasks for on-disk fields of `git_index_entry`'s `flags_extended` In memory, the `flags_extended` fields are divided into two parts: the fields that are read from and written to disk, and other fields that in-memory only and used by libgit2.  Only the flags in `GIT_IDXENTRY_EXTENDED_FLAGS` will get saved on-disk. These bitmasks match the three fields in the `git_index_entry` `flags_extended` value that belong on disk.  You can use them to interpret the data in the `flags_extended`.",
          "group": "index"
        },
        "GIT_IDXENTRY_SKIP_WORKTREE": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_SKIP_WORKTREE",
          "location": {
            "file": "index.h",
            "line": 95,
            "column": 9
          },
          "value": "(1 << 14)",
          "comment": "",
          "group": "index"
        },
        "GIT_IDXENTRY_EXTENDED2": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_EXTENDED2",
          "location": {
            "file": "index.h",
            "line": 97,
            "column": 9
          },
          "value": "(1 << 15)",
          "comment": "",
          "group": "index"
        },
        "GIT_IDXENTRY_EXTENDED_FLAGS": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_EXTENDED_FLAGS",
          "location": {
            "file": "index.h",
            "line": 99,
            "column": 9
          },
          "value": "(GIT_IDXENTRY_INTENT_TO_ADD | GIT_IDXENTRY_SKIP_WORKTREE)",
          "comment": "",
          "group": "index"
        },
        "GIT_IDXENTRY_UPDATE": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_UPDATE",
          "location": {
            "file": "index.h",
            "line": 108,
            "column": 9
          },
          "value": "(1 << 0)",
          "comment": "Bitmasks for in-memory only fields of `git_index_entry`'s `flags_extended` These bitmasks match the other fields in the `git_index_entry` `flags_extended` value that are only used in-memory by libgit2.  You can use them to interpret the data in the `flags_extended`.",
          "group": "index"
        },
        "GIT_IDXENTRY_REMOVE": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_REMOVE",
          "location": {
            "file": "index.h",
            "line": 109,
            "column": 9
          },
          "value": "(1 << 1)",
          "comment": "",
          "group": "index"
        },
        "GIT_IDXENTRY_UPTODATE": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_UPTODATE",
          "location": {
            "file": "index.h",
            "line": 110,
            "column": 9
          },
          "value": "(1 << 2)",
          "comment": "",
          "group": "index"
        },
        "GIT_IDXENTRY_ADDED": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_ADDED",
          "location": {
            "file": "index.h",
            "line": 111,
            "column": 9
          },
          "value": "(1 << 3)",
          "comment": "",
          "group": "index"
        },
        "GIT_IDXENTRY_HASHED": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_HASHED",
          "location": {
            "file": "index.h",
            "line": 113,
            "column": 9
          },
          "value": "(1 << 4)",
          "comment": "",
          "group": "index"
        },
        "GIT_IDXENTRY_UNHASHED": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_UNHASHED",
          "location": {
            "file": "index.h",
            "line": 114,
            "column": 9
          },
          "value": "(1 << 5)",
          "comment": "",
          "group": "index"
        },
        "GIT_IDXENTRY_WT_REMOVE": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_WT_REMOVE",
          "location": {
            "file": "index.h",
            "line": 115,
            "column": 9
          },
          "value": "(1 << 6) /* remove in work directory */",
          "comment": "",
          "group": "index"
        },
        "GIT_IDXENTRY_CONFLICTED": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_CONFLICTED",
          "location": {
            "file": "index.h",
            "line": 116,
            "column": 9
          },
          "value": "(1 << 7)",
          "comment": "Bitmasks for in-memory only fields of `git_index_entry`'s `flags_extended` These bitmasks match the other fields in the `git_index_entry` `flags_extended` value that are only used in-memory by libgit2.  You can use them to interpret the data in the `flags_extended`. / #define GIT_IDXENTRY_UPDATE            (1 << 0) #define GIT_IDXENTRY_REMOVE            (1 << 1) #define GIT_IDXENTRY_UPTODATE          (1 << 2) #define GIT_IDXENTRY_ADDED             (1 << 3) #define GIT_IDXENTRY_HASHED            (1 << 4) #define GIT_IDXENTRY_UNHASHED          (1 << 5) #define GIT_IDXENTRY_WT_REMOVE         (1 << 6) /* remove in work directory",
          "group": "index"
        },
        "GIT_IDXENTRY_UNPACKED": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_UNPACKED",
          "location": {
            "file": "index.h",
            "line": 118,
            "column": 9
          },
          "value": "(1 << 8)",
          "comment": "",
          "group": "index"
        },
        "GIT_IDXENTRY_NEW_SKIP_WORKTREE": {
          "kind": "macro",
          "name": "GIT_IDXENTRY_NEW_SKIP_WORKTREE",
          "location": {
            "file": "index.h",
            "line": 119,
            "column": 9
          },
          "value": "(1 << 9)",
          "comment": "",
          "group": "index"
        },
        "git_indexcap_t": {
          "kind": "enum",
          "name": "git_indexcap_t",
          "referenceName": "git_indexcap_t",
          "members": [
            {
              "name": "GIT_INDEXCAP_IGNORE_CASE",
              "value": "1"
            },
            {
              "name": "GIT_INDEXCAP_NO_FILEMODE",
              "value": "2"
            },
            {
              "name": "GIT_INDEXCAP_NO_SYMLINKS",
              "value": "4"
            },
            {
              "name": "GIT_INDEXCAP_FROM_OWNER",
              "value": "4294967295"
            }
          ],
          "comment": [
            "Capabilities of system that affect index actions."
          ],
          "location": {
            "file": "index.h",
            "line": 122,
            "column": 9
          },
          "group": "index"
        },
        "git_index_matched_path_cb": {
          "kind": "callback",
          "name": "git_index_matched_path_cb",
          "type": "int (*)(const char *, const char *, void *)",
          "comment": [
            "Callback for APIs that add/remove/update files matching pathspec"
          ],
          "location": {
            "file": "index.h",
            "line": 130,
            "column": 15
          },
          "params": [
            {
              "type": "const char *"
            },
            {
              "type": "const char *"
            },
            {
              "type": "void *"
            }
          ],
          "group": "index",
          "parameterTo": [
            "git_index_add_all",
            "git_index_remove_all",
            "git_index_update_all"
          ],
          "typedef": true
        },
        "git_index_add_option_t": {
          "kind": "enum",
          "name": "git_index_add_option_t",
          "referenceName": "git_index_add_option_t",
          "members": [
            {
              "name": "GIT_INDEX_ADD_DEFAULT",
              "value": "0"
            },
            {
              "name": "GIT_INDEX_ADD_FORCE"
            },
            {
              "name": "GIT_INDEX_ADD_DISABLE_PATHSPEC_MATCH"
            },
            {
              "name": "GIT_INDEX_ADD_CHECK_PATHSPEC"
            }
          ],
          "comment": [
            "Flags for APIs that add files matching pathspec"
          ],
          "location": {
            "file": "index.h",
            "line": 134,
            "column": 9
          },
          "group": "index"
        },
        "git_index_open": {
          "kind": "function",
          "name": "git_index_open",
          "location": {
            "file": "index.h",
            "line": 165,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_index **",
              "direction": "in",
              "comment": "the pointer for the new index"
            },
            {
              "name": "index_path",
              "type": "const char *",
              "direction": "in",
              "comment": "the path to the index file in disk"
            }
          ],
          "comment": [
            "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.",
            "Since there is no ODB or working directory behind this index,\n any Index methods which rely on these (e.g. index_add) will\n fail with the GIT_EBAREINDEX error code.",
            "If you need to access the index of an actual repository,\n use the `git_repository_index` wrapper.",
            "The index must be freed once it's no longer in use."
          ],
          "group": "index"
        },
        "git_index_new": {
          "kind": "function",
          "name": "git_index_new",
          "location": {
            "file": "index.h",
            "line": 178,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_index **",
              "direction": "in",
              "comment": "the pointer for the new index"
            }
          ],
          "comment": [
            "Create an in-memory index object.",
            "This index object cannot be read/written to the filesystem,\n but may be used to perform in-memory index operations.",
            "The index must be freed once it's no longer in use."
          ],
          "group": "index"
        },
        "git_index_free": {
          "kind": "function",
          "name": "git_index_free",
          "location": {
            "file": "index.h",
            "line": 185,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            }
          ],
          "comment": [
            "Free an existing index object."
          ],
          "group": "index"
        },
        "git_index_owner": {
          "kind": "function",
          "name": "git_index_owner",
          "location": {
            "file": "index.h",
            "line": 193,
            "column": 30
          },
          "returns": {
            "type": "git_repository *",
            "comment": "A pointer to the repository"
          },
          "params": [
            {
              "name": "index",
              "type": "const git_index *",
              "direction": "in",
              "comment": "The index"
            }
          ],
          "comment": [
            "Get the repository this index relates to"
          ],
          "group": "index"
        },
        "git_index_caps": {
          "kind": "function",
          "name": "git_index_caps",
          "location": {
            "file": "index.h",
            "line": 201,
            "column": 26
          },
          "returns": {
            "type": "unsigned int",
            "comment": "A combination of GIT_INDEXCAP values"
          },
          "params": [
            {
              "name": "index",
              "type": "const git_index *",
              "direction": "in",
              "comment": "An existing index object"
            }
          ],
          "comment": [
            "Read index capabilities flags."
          ],
          "group": "index"
        },
        "git_index_set_caps": {
          "kind": "function",
          "name": "git_index_set_caps",
          "location": {
            "file": "index.h",
            "line": 214,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, -1 on failure"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "An existing index object"
            },
            {
              "name": "caps",
              "type": "unsigned int",
              "direction": "in",
              "comment": "A combination of GIT_INDEXCAP values"
            }
          ],
          "comment": [
            "Set index capabilities flags.",
            "If you pass `GIT_INDEXCAP_FROM_OWNER` for the caps, then the\n capabilities will be read from the config of the owner object,\n looking at `core.ignorecase`, `core.filemode`, `core.symlinks`."
          ],
          "group": "index"
        },
        "git_index_read": {
          "kind": "function",
          "name": "git_index_read",
          "location": {
            "file": "index.h",
            "line": 223,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            }
          ],
          "comment": [
            "Update the contents of an existing index object in memory\n by reading from the hard disk."
          ],
          "group": "index"
        },
        "git_index_write": {
          "kind": "function",
          "name": "git_index_write",
          "location": {
            "file": "index.h",
            "line": 232,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            }
          ],
          "comment": [
            "Write an existing index object from memory back to disk\n using an atomic file lock."
          ],
          "group": "index"
        },
        "git_index_read_tree": {
          "kind": "function",
          "name": "git_index_read_tree",
          "location": {
            "file": "index.h",
            "line": 243,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "tree",
              "type": "const git_tree *",
              "direction": "in",
              "comment": "tree to read"
            }
          ],
          "comment": [
            "Read a tree into the index file with stats",
            "The current index contents will be replaced by the specified tree."
          ],
          "group": "index"
        },
        "git_index_write_tree": {
          "kind": "function",
          "name": "git_index_write_tree",
          "location": {
            "file": "index.h",
            "line": 264,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUNMERGED when the index is not clean\n or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "Pointer where to store the OID of the written tree"
            },
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "Index to write"
            }
          ],
          "comment": [
            "Write the index as a tree",
            "This method will scan the index and write a representation\n of its current state back to disk; it recursively creates\n tree objects for each of the subtrees stored in the index,\n but only returns the OID of the root tree. This is the OID\n that can be used e.g. to create a commit.",
            "The index instance cannot be bare, and needs to be associated\n to an existing repository.",
            "The index must not contain any file in conflict."
          ],
          "group": "index"
        },
        "git_index_write_tree_to": {
          "kind": "function",
          "name": "git_index_write_tree_to",
          "location": {
            "file": "index.h",
            "line": 281,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUNMERGED when the index is not clean\n or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "Pointer where to store OID of the the written tree"
            },
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "Index to write"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where to write the tree"
            }
          ],
          "comment": [
            "Write the index as a tree to the given repository",
            "This method will do the same as `git_index_write_tree`, but\n letting the user choose the repository where the tree will\n be written.",
            "The index must not contain any file in conflict."
          ],
          "group": "index"
        },
        "git_index_entrycount": {
          "kind": "function",
          "name": "git_index_entrycount",
          "location": {
            "file": "index.h",
            "line": 300,
            "column": 20
          },
          "returns": {
            "type": "size_t",
            "comment": "integer of count of current entries"
          },
          "params": [
            {
              "name": "index",
              "type": "const git_index *",
              "direction": "in",
              "comment": "an existing index object"
            }
          ],
          "comment": [
            "Get the count of entries currently in the index"
          ],
          "group": "index"
        },
        "git_index_clear": {
          "kind": "function",
          "name": "git_index_clear",
          "location": {
            "file": "index.h",
            "line": 309,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            }
          ],
          "comment": [
            "Clear the contents (all the entries) of an index object.\n This clears the index object in memory; changes must be manually\n written to disk for them to take effect."
          ],
          "group": "index"
        },
        "git_index_get_byindex": {
          "kind": "function",
          "name": "git_index_get_byindex",
          "location": {
            "file": "index.h",
            "line": 322,
            "column": 37
          },
          "returns": {
            "type": "const git_index_entry *",
            "comment": "a pointer to the entry; NULL if out of bounds"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "n",
              "type": "size_t",
              "direction": "in",
              "comment": "the position of the entry"
            }
          ],
          "comment": [
            "Get a pointer to one of the entries in the index",
            "The entry is not modifiable and should not be freed.  Because the\n `git_index_entry` struct is a publicly defined struct, you should\n be able to make your own permanent copy of the data if necessary."
          ],
          "group": "index"
        },
        "git_index_get_bypath": {
          "kind": "function",
          "name": "git_index_get_bypath",
          "location": {
            "file": "index.h",
            "line": 337,
            "column": 37
          },
          "returns": {
            "type": "const git_index_entry *",
            "comment": "a pointer to the entry; NULL if it was not found"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "path to search"
            },
            {
              "name": "stage",
              "type": "int",
              "direction": "in",
              "comment": "stage to search"
            }
          ],
          "comment": [
            "Get a pointer to one of the entries in the index",
            "The entry is not modifiable and should not be freed.  Because the\n `git_index_entry` struct is a publicly defined struct, you should\n be able to make your own permanent copy of the data if necessary."
          ],
          "group": "index"
        },
        "git_index_remove": {
          "kind": "function",
          "name": "git_index_remove",
          "location": {
            "file": "index.h",
            "line": 348,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "path to search"
            },
            {
              "name": "stage",
              "type": "int",
              "direction": "in",
              "comment": "stage to search"
            }
          ],
          "comment": [
            "Remove an entry from the index"
          ],
          "group": "index"
        },
        "git_index_remove_directory": {
          "kind": "function",
          "name": "git_index_remove_directory",
          "location": {
            "file": "index.h",
            "line": 358,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "dir",
              "type": "const char *",
              "direction": "in",
              "comment": "container directory path"
            },
            {
              "name": "stage",
              "type": "int",
              "direction": "in",
              "comment": "stage to search"
            }
          ],
          "comment": [
            "Remove all entries from the index under a given directory"
          ],
          "group": "index"
        },
        "git_index_add": {
          "kind": "function",
          "name": "git_index_add",
          "location": {
            "file": "index.h",
            "line": 375,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "source_entry",
              "type": "const git_index_entry *",
              "direction": "in",
              "comment": "new entry object"
            }
          ],
          "comment": [
            "Add or update an index entry from an in-memory struct",
            "If a previous index entry exists that has the same path and stage\n as the given 'source_entry', it will be replaced.  Otherwise, the\n 'source_entry' will be added.",
            "A full copy (including the 'path' string) of the given\n 'source_entry' will be inserted on the index."
          ],
          "group": "index"
        },
        "git_index_entry_stage": {
          "kind": "function",
          "name": "git_index_entry_stage",
          "location": {
            "file": "index.h",
            "line": 387,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "the stage number"
          },
          "params": [
            {
              "name": "entry",
              "type": "const git_index_entry *",
              "direction": "in",
              "comment": "The entry"
            }
          ],
          "comment": [
            "Return the stage number from a git index entry",
            "This entry is calculated from the entry's flag attribute like this:",
            "(entry->flags \n&\n GIT_IDXENTRY_STAGEMASK) >> GIT_IDXENTRY_STAGESHIFT"
          ],
          "group": "index"
        },
        "git_index_add_bypath": {
          "kind": "function",
          "name": "git_index_add_bypath",
          "location": {
            "file": "index.h",
            "line": 418,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "filename to add"
            }
          ],
          "comment": [
            "Add or update an index entry from a file on disk",
            "The file `path` must be relative to the repository's\n working folder and must be readable.",
            "This method will fail in bare index instances.",
            "This forces the file to be added to the index, not looking\n at gitignore rules.  Those rules can be evaluated through\n the git_status APIs (in status.h) before calling this.",
            "If this file currently is the result of a merge conflict, this\n file will no longer be marked as conflicting.  The data about\n the conflict will be moved to the \"resolve undo\" (REUC) section."
          ],
          "group": "index"
        },
        "git_index_remove_bypath": {
          "kind": "function",
          "name": "git_index_remove_bypath",
          "location": {
            "file": "index.h",
            "line": 434,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "filename to remove"
            }
          ],
          "comment": [
            "Remove an index entry corresponding to a file on disk",
            "The file `path` must be relative to the repository's\n working folder.  It may exist.",
            "If this file currently is the result of a merge conflict, this\n file will no longer be marked as conflicting.  The data about\n the conflict will be moved to the \"resolve undo\" (REUC) section."
          ],
          "group": "index"
        },
        "git_index_add_all": {
          "kind": "function",
          "name": "git_index_add_all",
          "location": {
            "file": "index.h",
            "line": 481,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "pathspec",
              "type": "const git_strarray *",
              "direction": "in",
              "comment": "array of path patterns"
            },
            {
              "name": "flags",
              "type": "unsigned int",
              "direction": "in",
              "comment": "combination of git_index_add_option_t flags"
            },
            {
              "name": "callback",
              "type": "git_index_matched_path_cb",
              "direction": "in",
              "comment": "notification callback for each added/updated path (also\n                 gets index of matching pathspec entry); can be NULL;\n                 return 0 to add, >0 to skip, \n<\n0 to abort scan.",
              "referenceType": "int (*)(const char *, const char *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "payload passed through to callback function"
            }
          ],
          "comment": [
            "Add or update index entries matching files in the working directory.",
            "This method will fail in bare index instances.",
            "The `pathspec` is a list of file names or shell glob patterns that will\n matched against files in the repository's working directory.  Each file\n that matches will be added to the index (either updating an existing\n entry or adding a new entry).  You can disable glob expansion and force\n exact matching with the `GIT_INDEX_ADD_DISABLE_PATHSPEC_MATCH` flag.",
            "Files that are ignored will be skipped (unlike `git_index_add_bypath`).\n If a file is already tracked in the index, then it *will* be updated\n even if it is ignored.  Pass the `GIT_INDEX_ADD_FORCE` flag to\n skip the checking of ignore rules.",
            "To emulate `git add -A` and generate an error if the pathspec contains\n the exact path of an ignored file (when not using FORCE), add the\n `GIT_INDEX_ADD_CHECK_PATHSPEC` flag.  This checks that each entry\n in the `pathspec` that is an exact match to a filename on disk is\n either not ignored or already in the index.  If this check fails, the\n function will return GIT_EINVALIDSPEC.",
            "To emulate `git add -A` with the \"dry-run\" option, just use a callback\n function that always returns a positive value.  See below for details.",
            "If any files are currently the result of a merge conflict, those files\n will no longer be marked as conflicting.  The data about the conflicts\n will be moved to the \"resolve undo\" (REUC) section.",
            "If you provide a callback function, it will be invoked on each matching\n item in the working directory immediately *before* it is added to /\n updated in the index.  Returning zero will add the item to the index,\n greater than zero will skip the item, and less than zero will abort the\n scan and cause GIT_EUSER to be returned."
          ],
          "group": "index"
        },
        "git_index_remove_all": {
          "kind": "function",
          "name": "git_index_remove_all",
          "location": {
            "file": "index.h",
            "line": 503,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "An existing index object"
            },
            {
              "name": "pathspec",
              "type": "const git_strarray *",
              "direction": "in",
              "comment": "array of path patterns"
            },
            {
              "name": "callback",
              "type": "git_index_matched_path_cb",
              "direction": "in",
              "comment": "notification callback for each removed path (also\n                 gets index of matching pathspec entry); can be NULL;\n                 return 0 to add, >0 to skip, \n<\n0 to abort scan.",
              "referenceType": "int (*)(const char *, const char *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "payload passed through to callback function"
            }
          ],
          "comment": [
            "Remove all matching index entries.",
            "If you provide a callback function, it will be invoked on each matching\n item in the index immediately *before* it is removed.  Return 0 to\n remove the item, > 0 to skip the item, and \n<\n 0 to abort the scan."
          ],
          "group": "index"
        },
        "git_index_update_all": {
          "kind": "function",
          "name": "git_index_update_all",
          "location": {
            "file": "index.h",
            "line": 532,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "An existing index object"
            },
            {
              "name": "pathspec",
              "type": "const git_strarray *",
              "direction": "in",
              "comment": "array of path patterns"
            },
            {
              "name": "callback",
              "type": "git_index_matched_path_cb",
              "direction": "in",
              "comment": "notification callback for each updated path (also\n                 gets index of matching pathspec entry); can be NULL;\n                 return 0 to add, >0 to skip, \n<\n0 to abort scan.",
              "referenceType": "int (*)(const char *, const char *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "payload passed through to callback function"
            }
          ],
          "comment": [
            "Update all index entries to match the working directory",
            "This method will fail in bare index instances.",
            "This scans the existing index entries and synchronizes them with the\n working directory, deleting them if the corresponding working directory\n file no longer exists otherwise updating the information (including\n adding the latest version of file to the ODB if needed).",
            "If you provide a callback function, it will be invoked on each matching\n item in the index immediately *before* it is updated (either refreshed\n or removed depending on working directory state).  Return 0 to proceed\n with updating the item, > 0 to skip the item, and \n<\n 0 to abort the scan."
          ],
          "group": "index"
        },
        "git_index_find": {
          "kind": "function",
          "name": "git_index_find",
          "location": {
            "file": "index.h",
            "line": 548,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "a zero-based position in the index if found;\n GIT_ENOTFOUND otherwise"
          },
          "params": [
            {
              "name": "at_pos",
              "type": "size_t *",
              "direction": "in",
              "comment": "the address to which the position of the index entry is written (optional)"
            },
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "path to search"
            }
          ],
          "comment": [
            "Find the first position of any entries which point to given\n path in the Git index."
          ],
          "group": "index"
        },
        "git_index_conflict_add": {
          "kind": "function",
          "name": "git_index_conflict_add",
          "location": {
            "file": "index.h",
            "line": 572,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "ancestor_entry",
              "type": "const git_index_entry *",
              "direction": "in",
              "comment": "the entry data for the ancestor of the conflict"
            },
            {
              "name": "our_entry",
              "type": "const git_index_entry *",
              "direction": "in",
              "comment": "the entry data for our side of the merge conflict"
            },
            {
              "name": "their_entry",
              "type": "const git_index_entry *",
              "direction": "in",
              "comment": "the entry data for their side of the merge conflict"
            }
          ],
          "comment": [
            "Add or update index entries to represent a conflict",
            "The entries are the entries from the tree included in the merge.  Any\n entry may be null to indicate that that file was not present in the\n trees during the merge.  For example, ancestor_entry may be NULL to\n indicate that a file was added in both branches and must be resolved."
          ],
          "group": "index"
        },
        "git_index_conflict_get": {
          "kind": "function",
          "name": "git_index_conflict_get",
          "location": {
            "file": "index.h",
            "line": 591,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "ancestor_out",
              "type": "const git_index_entry **",
              "direction": "in",
              "comment": "Pointer to store the ancestor entry"
            },
            {
              "name": "our_out",
              "type": "const git_index_entry **",
              "direction": "in",
              "comment": "Pointer to store the our entry"
            },
            {
              "name": "their_out",
              "type": "const git_index_entry **",
              "direction": "in",
              "comment": "Pointer to store the their entry"
            },
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "path to search"
            }
          ],
          "comment": [
            "Get the index entries that represent a conflict of a single file.",
            "The entries are not modifiable and should not be freed.  Because the\n `git_index_entry` struct is a publicly defined struct, you should\n be able to make your own permanent copy of the data if necessary."
          ],
          "group": "index"
        },
        "git_index_conflict_remove": {
          "kind": "function",
          "name": "git_index_conflict_remove",
          "location": {
            "file": "index.h",
            "line": 604,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "to search"
            }
          ],
          "comment": [
            "Removes the index entries that represent a conflict of a single file."
          ],
          "group": "index"
        },
        "git_index_conflict_cleanup": {
          "kind": "function",
          "name": "git_index_conflict_cleanup",
          "location": {
            "file": "index.h",
            "line": 611,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            }
          ],
          "comment": [
            "Remove all conflicts in the index (entries with a stage greater than 0.)"
          ],
          "group": "index"
        },
        "git_index_has_conflicts": {
          "kind": "function",
          "name": "git_index_has_conflicts",
          "location": {
            "file": "index.h",
            "line": 618,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if at least one conflict is found, 0 otherwise."
          },
          "params": [
            {
              "name": "index",
              "type": "const git_index *"
            }
          ],
          "comment": [
            "Determine if the index contains entries representing file conflicts."
          ],
          "group": "index"
        },
        "git_index_conflict_iterator_new": {
          "kind": "function",
          "name": "git_index_conflict_iterator_new",
          "location": {
            "file": "index.h",
            "line": 626,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "iterator_out",
              "type": "git_index_conflict_iterator **"
            },
            {
              "name": "index",
              "type": "git_index *"
            }
          ],
          "comment": [
            "Create an iterator for the conflicts in the index.  You may not modify the\n index while iterating, the results are undefined."
          ],
          "group": "index"
        },
        "git_index_conflict_next": {
          "kind": "function",
          "name": "git_index_conflict_next",
          "location": {
            "file": "index.h",
            "line": 640,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 (no error), GIT_ITEROVER (iteration is done) or an error code\n         (negative value)"
          },
          "params": [
            {
              "name": "ancestor_out",
              "type": "const git_index_entry **",
              "direction": "in",
              "comment": "Pointer to store the ancestor side of the conflict"
            },
            {
              "name": "our_out",
              "type": "const git_index_entry **",
              "direction": "in",
              "comment": "Pointer to store our side of the conflict"
            },
            {
              "name": "their_out",
              "type": "const git_index_entry **",
              "direction": "in",
              "comment": "Pointer to store their side of the conflict"
            },
            {
              "name": "iterator",
              "type": "git_index_conflict_iterator *"
            }
          ],
          "comment": [
            "Returns the current conflict (ancestor, ours and theirs entry) and\n advance the iterator internally to the next value."
          ],
          "group": "index"
        },
        "git_index_conflict_iterator_free": {
          "kind": "function",
          "name": "git_index_conflict_iterator_free",
          "location": {
            "file": "index.h",
            "line": 651,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "iterator",
              "type": "git_index_conflict_iterator *",
              "direction": "in",
              "comment": "pointer to the iterator"
            }
          ],
          "comment": [
            "Frees a `git_index_conflict_iterator`."
          ],
          "group": "index"
        },
        "git_index": {
          "kind": "struct",
          "name": "git_index",
          "referenceName": "struct git_index",
          "opaque": true,
          "comment": [
            "Memory representation of an index file."
          ],
          "location": {
            "file": "types.h",
            "line": 132,
            "column": 26
          },
          "group": "index",
          "parameterTo": [
            "git_checkout_index",
            "git_diff_tree_to_index",
            "git_diff_index_to_workdir",
            "git_index_open",
            "git_index_new",
            "git_index_free",
            "git_index_owner",
            "git_index_caps",
            "git_index_set_caps",
            "git_index_read",
            "git_index_write",
            "git_index_read_tree",
            "git_index_write_tree",
            "git_index_write_tree_to",
            "git_index_entrycount",
            "git_index_clear",
            "git_index_get_byindex",
            "git_index_get_bypath",
            "git_index_remove",
            "git_index_remove_directory",
            "git_index_add",
            "git_index_add_bypath",
            "git_index_remove_bypath",
            "git_index_add_all",
            "git_index_remove_all",
            "git_index_update_all",
            "git_index_find",
            "git_index_conflict_add",
            "git_index_conflict_get",
            "git_index_conflict_remove",
            "git_index_conflict_cleanup",
            "git_index_has_conflicts",
            "git_index_conflict_iterator_new",
            "git_merge_trees",
            "git_repository_index",
            "git_index_name_entrycount",
            "git_index_name_get_byindex",
            "git_index_name_add",
            "git_index_name_clear",
            "git_index_reuc_entrycount",
            "git_index_reuc_find",
            "git_index_reuc_get_bypath",
            "git_index_reuc_get_byindex",
            "git_index_reuc_add",
            "git_index_reuc_remove",
            "git_index_reuc_clear",
            "git_repository_set_index"
          ]
        },
        "git_index_conflict_iterator": {
          "kind": "struct",
          "name": "git_index_conflict_iterator",
          "referenceName": "struct git_index_conflict_iterator",
          "opaque": true,
          "comment": [
            "An interator for conflicts in the index."
          ],
          "location": {
            "file": "types.h",
            "line": 135,
            "column": 44
          },
          "group": "index",
          "parameterTo": [
            "git_index_conflict_iterator_new",
            "git_index_conflict_next",
            "git_index_conflict_iterator_free"
          ]
        }
      },
      "info": {
        "summary": "Git index parsing and manipulation routines"
      }
    },
    "sys/index": {
      "apis": {
        "git_index_name_entry": {
          "kind": "struct",
          "name": "git_index_name_entry",
          "referenceName": "git_index_name_entry",
          "comment": [
            "Representation of a rename conflict entry in the index."
          ],
          "members": [
            {
              "name": "ancestor",
              "type": "char *"
            },
            {
              "name": "ours",
              "type": "char *"
            },
            {
              "name": "theirs",
              "type": "char *"
            }
          ],
          "location": {
            "file": "sys/index.h",
            "line": 20,
            "column": 16
          },
          "group": "sys/index",
          "returnedBy": [
            "git_index_name_get_byindex"
          ]
        },
        "git_index_reuc_entry": {
          "kind": "struct",
          "name": "git_index_reuc_entry",
          "referenceName": "git_index_reuc_entry",
          "comment": [
            "Representation of a resolve undo entry in the index."
          ],
          "members": [
            {
              "name": "mode",
              "type": "unsigned int[3]"
            },
            {
              "name": "oid",
              "type": "git_oid[3]"
            },
            {
              "name": "path",
              "type": "char *"
            }
          ],
          "location": {
            "file": "sys/index.h",
            "line": 27,
            "column": 16
          },
          "group": "sys/index",
          "returnedBy": [
            "git_index_reuc_get_bypath",
            "git_index_reuc_get_byindex"
          ]
        },
        "git_index_name_entrycount": {
          "kind": "function",
          "name": "git_index_name_entrycount",
          "location": {
            "file": "sys/index.h",
            "line": 45,
            "column": 26
          },
          "returns": {
            "type": "unsigned int",
            "comment": "integer of count of current filename conflict entries"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            }
          ],
          "comment": [
            "Get the count of filename conflict entries currently in the index."
          ],
          "group": "sys/index"
        },
        "git_index_name_get_byindex": {
          "kind": "function",
          "name": "git_index_name_get_byindex",
          "location": {
            "file": "sys/index.h",
            "line": 57,
            "column": 42
          },
          "returns": {
            "type": "const git_index_name_entry *",
            "comment": "a pointer to the filename conflict entry; NULL if out of bounds"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "n",
              "type": "size_t",
              "direction": "in",
              "comment": "the position of the entry"
            }
          ],
          "comment": [
            "Get a filename conflict entry from the index.",
            "The returned entry is read-only and should not be modified\n or freed by the caller."
          ],
          "group": "sys/index"
        },
        "git_index_name_add": {
          "kind": "function",
          "name": "git_index_name_add",
          "location": {
            "file": "sys/index.h",
            "line": 68,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "ancestor",
              "type": "const char *",
              "direction": "in",
              "comment": "the path of the file as it existed in the ancestor"
            },
            {
              "name": "ours",
              "type": "const char *",
              "direction": "in",
              "comment": "the path of the file as it existed in our tree"
            },
            {
              "name": "theirs",
              "type": "const char *",
              "direction": "in",
              "comment": "the path of the file as it existed in their tree"
            }
          ],
          "comment": [
            "Record the filenames involved in a rename conflict."
          ],
          "group": "sys/index"
        },
        "git_index_name_clear": {
          "kind": "function",
          "name": "git_index_name_clear",
          "location": {
            "file": "sys/index.h",
            "line": 77,
            "column": 18
          },
          "returns": {
            "type": "void",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            }
          ],
          "comment": [
            "Remove all filename conflict entries."
          ],
          "group": "sys/index"
        },
        "git_index_reuc_entrycount": {
          "kind": "function",
          "name": "git_index_reuc_entrycount",
          "location": {
            "file": "sys/index.h",
            "line": 94,
            "column": 26
          },
          "returns": {
            "type": "unsigned int",
            "comment": "integer of count of current resolve undo entries"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            }
          ],
          "comment": [
            "Get the count of resolve undo entries currently in the index."
          ],
          "group": "sys/index"
        },
        "git_index_reuc_find": {
          "kind": "function",
          "name": "git_index_reuc_find",
          "location": {
            "file": "sys/index.h",
            "line": 105,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 if found, \n<\n 0 otherwise (GIT_ENOTFOUND)"
          },
          "params": [
            {
              "name": "at_pos",
              "type": "size_t *",
              "direction": "in",
              "comment": "the address to which the position of the reuc entry is written (optional)"
            },
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "path to search"
            }
          ],
          "comment": [
            "Finds the resolve undo entry that points to the given path in the Git\n index."
          ],
          "group": "sys/index"
        },
        "git_index_reuc_get_bypath": {
          "kind": "function",
          "name": "git_index_reuc_get_bypath",
          "location": {
            "file": "sys/index.h",
            "line": 117,
            "column": 42
          },
          "returns": {
            "type": "const git_index_reuc_entry *",
            "comment": "the resolve undo entry; NULL if not found"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "path to search"
            }
          ],
          "comment": [
            "Get a resolve undo entry from the index.",
            "The returned entry is read-only and should not be modified\n or freed by the caller."
          ],
          "group": "sys/index"
        },
        "git_index_reuc_get_byindex": {
          "kind": "function",
          "name": "git_index_reuc_get_byindex",
          "location": {
            "file": "sys/index.h",
            "line": 129,
            "column": 42
          },
          "returns": {
            "type": "const git_index_reuc_entry *",
            "comment": "a pointer to the resolve undo entry; NULL if out of bounds"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "n",
              "type": "size_t",
              "direction": "in",
              "comment": "the position of the entry"
            }
          ],
          "comment": [
            "Get a resolve undo entry from the index.",
            "The returned entry is read-only and should not be modified\n or freed by the caller."
          ],
          "group": "sys/index"
        },
        "git_index_reuc_add": {
          "kind": "function",
          "name": "git_index_reuc_add",
          "location": {
            "file": "sys/index.h",
            "line": 153,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "filename to add"
            },
            {
              "name": "ancestor_mode",
              "type": "int",
              "direction": "in",
              "comment": "mode of the ancestor file"
            },
            {
              "name": "ancestor_id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "oid of the ancestor file"
            },
            {
              "name": "our_mode",
              "type": "int",
              "direction": "in",
              "comment": "mode of our file"
            },
            {
              "name": "our_id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "oid of our file"
            },
            {
              "name": "their_mode",
              "type": "int",
              "direction": "in",
              "comment": "mode of their file"
            },
            {
              "name": "their_id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "oid of their file"
            }
          ],
          "comment": [
            "Adds a resolve undo entry for a file based on the given parameters.",
            "The resolve undo entry contains the OIDs of files that were involved\n in a merge conflict after the conflict has been resolved.  This allows\n conflicts to be re-resolved later.",
            "If there exists a resolve undo entry for the given path in the index,\n it will be removed.",
            "This method will fail in bare index instances."
          ],
          "group": "sys/index"
        },
        "git_index_reuc_remove": {
          "kind": "function",
          "name": "git_index_reuc_remove",
          "location": {
            "file": "sys/index.h",
            "line": 165,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            },
            {
              "name": "n",
              "type": "size_t",
              "direction": "in",
              "comment": "position of the resolve undo entry to remove"
            }
          ],
          "comment": [
            "Remove an resolve undo entry from the index"
          ],
          "group": "sys/index"
        },
        "git_index_reuc_clear": {
          "kind": "function",
          "name": "git_index_reuc_clear",
          "location": {
            "file": "sys/index.h",
            "line": 173,
            "column": 18
          },
          "returns": {
            "type": "void",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "an existing index object"
            }
          ],
          "comment": [
            "Remove all resolve undo entries from the index"
          ],
          "group": "sys/index"
        }
      },
      "info": {
        "summary": "Low-level Git index manipulation routines"
      }
    },
    "indexer": {
      "apis": {
        "git_indexer_stream": {
          "kind": "struct",
          "name": "git_indexer_stream",
          "referenceName": "struct git_indexer_stream",
          "opaque": true,
          "location": {
            "file": "indexer.h",
            "line": 16,
            "column": 35
          },
          "group": "indexer",
          "parameterTo": [
            "git_indexer_stream_new",
            "git_indexer_stream_add",
            "git_indexer_stream_finalize",
            "git_indexer_stream_hash",
            "git_indexer_stream_free"
          ]
        },
        "git_indexer_stream_new": {
          "kind": "function",
          "name": "git_indexer_stream_new",
          "location": {
            "file": "indexer.h",
            "line": 26,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "out",
              "type": "git_indexer_stream **",
              "direction": "in",
              "comment": "where to store the indexer instance"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "to the directory where the packfile should be stored"
            },
            {
              "name": "progress_cb",
              "type": "git_transfer_progress_callback",
              "direction": "in",
              "comment": "function to call with progress information",
              "referenceType": "int (*)(const git_transfer_progress *, void *)"
            },
            {
              "name": "progress_cb_payload",
              "type": "void *",
              "direction": "in",
              "comment": "payload for the progress callback"
            }
          ],
          "comment": [
            "Create a new streaming indexer instance"
          ],
          "group": "indexer"
        },
        "git_indexer_stream_add": {
          "kind": "function",
          "name": "git_indexer_stream_add",
          "location": {
            "file": "indexer.h",
            "line": 40,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "idx",
              "type": "git_indexer_stream *",
              "direction": "in",
              "comment": "the indexer"
            },
            {
              "name": "data",
              "type": "const void *",
              "direction": "in",
              "comment": "the data to add"
            },
            {
              "name": "size",
              "type": "size_t",
              "direction": "in",
              "comment": "the size of the data in bytes"
            },
            {
              "name": "stats",
              "type": "git_transfer_progress *",
              "direction": "in",
              "comment": "stat storage"
            }
          ],
          "comment": [
            "Add data to the indexer"
          ],
          "group": "indexer"
        },
        "git_indexer_stream_finalize": {
          "kind": "function",
          "name": "git_indexer_stream_finalize",
          "location": {
            "file": "indexer.h",
            "line": 49,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "idx",
              "type": "git_indexer_stream *",
              "direction": "in",
              "comment": "the indexer"
            },
            {
              "name": "stats",
              "type": "git_transfer_progress *"
            }
          ],
          "comment": [
            "Finalize the pack and index",
            "Resolve any pending deltas and write out the index file"
          ],
          "group": "indexer"
        },
        "git_indexer_stream_hash": {
          "kind": "function",
          "name": "git_indexer_stream_hash",
          "location": {
            "file": "indexer.h",
            "line": 59,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *"
          },
          "params": [
            {
              "name": "idx",
              "type": "const git_indexer_stream *",
              "direction": "in",
              "comment": "the indexer instance"
            }
          ],
          "comment": [
            "Get the packfile's hash",
            "A packfile's name is derived from the sorted hashing of all object\n names. This is only correct after the index has been finalized."
          ],
          "group": "indexer"
        },
        "git_indexer_stream_free": {
          "kind": "function",
          "name": "git_indexer_stream_free",
          "location": {
            "file": "indexer.h",
            "line": 66,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "idx",
              "type": "git_indexer_stream *",
              "direction": "in",
              "comment": "the indexer to free"
            }
          ],
          "comment": [
            "Free the indexer and its resources"
          ],
          "group": "indexer"
        }
      },
      "info": {}
    },
    "merge": {
      "apis": {
        "git_merge_tree_flag_t": {
          "kind": "enum",
          "name": "git_merge_tree_flag_t",
          "referenceName": "git_merge_tree_flag_t",
          "members": [
            {
              "name": "GIT_MERGE_TREE_FIND_RENAMES",
              "value": "1",
              "comment": [
                "Detect renames"
              ]
            }
          ],
          "comment": [
            "Flags for `git_merge_tree` options.  A combination of these flags can be\n passed in via the `flags` value in the `git_merge_tree_opts`."
          ],
          "location": {
            "file": "merge.h",
            "line": 29,
            "column": 9
          },
          "group": "merge"
        },
        "git_merge_automerge_flags": {
          "kind": "enum",
          "name": "git_merge_automerge_flags",
          "referenceName": "git_merge_automerge_flags",
          "members": [
            {
              "name": "GIT_MERGE_AUTOMERGE_NORMAL",
              "value": "0"
            },
            {
              "name": "GIT_MERGE_AUTOMERGE_NONE",
              "value": "1"
            },
            {
              "name": "GIT_MERGE_AUTOMERGE_FAVOR_OURS",
              "value": "2"
            },
            {
              "name": "GIT_MERGE_AUTOMERGE_FAVOR_THEIRS",
              "value": "3"
            }
          ],
          "comment": [
            "Automerge options for `git_merge_trees_opts`."
          ],
          "location": {
            "file": "merge.h",
            "line": 37,
            "column": 9
          },
          "group": "merge"
        },
        "git_merge_tree_opts": {
          "kind": "struct",
          "name": "git_merge_tree_opts",
          "referenceName": "git_merge_tree_opts",
          "members": [
            {
              "name": "version",
              "type": "unsigned int"
            },
            {
              "name": "flags",
              "type": "git_merge_tree_flag_t",
              "referenceType": "enum git_merge_tree_flag_t"
            },
            {
              "name": "rename_threshold",
              "type": "unsigned int",
              "comment": [
                "Similarity to consider a file renamed (default 50)"
              ]
            },
            {
              "name": "target_limit",
              "type": "unsigned int",
              "comment": [
                "Maximum similarity sources to examine (overrides the\n `merge.renameLimit` config) (default 200)"
              ]
            },
            {
              "name": "metric",
              "type": "git_diff_similarity_metric *",
              "comment": [
                "Pluggable similarity metric; pass NULL to use internal metric"
              ]
            },
            {
              "name": "automerge_flags",
              "type": "git_merge_automerge_flags",
              "comment": [
                "Flags for automerging content."
              ],
              "referenceType": "enum git_merge_automerge_flags"
            }
          ],
          "location": {
            "file": "merge.h",
            "line": 45,
            "column": 9
          },
          "group": "merge",
          "parameterTo": [
            "git_merge_trees"
          ]
        },
        "GIT_MERGE_TREE_OPTS_VERSION": {
          "kind": "macro",
          "name": "GIT_MERGE_TREE_OPTS_VERSION",
          "location": {
            "file": "merge.h",
            "line": 64,
            "column": 9
          },
          "value": "1",
          "comment": "",
          "group": "merge"
        },
        "GIT_MERGE_TREE_OPTS_INIT": {
          "kind": "macro",
          "name": "GIT_MERGE_TREE_OPTS_INIT",
          "location": {
            "file": "merge.h",
            "line": 65,
            "column": 9
          },
          "value": "{GIT_MERGE_TREE_OPTS_VERSION}",
          "comment": "",
          "group": "merge"
        },
        "git_merge_base": {
          "kind": "function",
          "name": "git_merge_base",
          "location": {
            "file": "merge.h",
            "line": 77,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "Zero on success; GIT_ENOTFOUND or -1 on failure."
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "the OID of a merge base between 'one' and 'two'"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository where the commits exist"
            },
            {
              "name": "one",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "one of the commits"
            },
            {
              "name": "two",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "the other commit"
            }
          ],
          "comment": [
            "Find a merge base between two commits"
          ],
          "group": "merge"
        },
        "git_merge_base_many": {
          "kind": "function",
          "name": "git_merge_base_many",
          "location": {
            "file": "merge.h",
            "line": 92,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "Zero on success; GIT_ENOTFOUND or -1 on failure."
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "the OID of a merge base considering all the commits"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository where the commits exist"
            },
            {
              "name": "input_array",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "oids of the commits"
            },
            {
              "name": "length",
              "type": "size_t",
              "direction": "in",
              "comment": "The number of commits in the provided `input_array`"
            }
          ],
          "comment": [
            "Find a merge base given a list of commits"
          ],
          "group": "merge"
        },
        "git_merge_head_from_ref": {
          "kind": "function",
          "name": "git_merge_head_from_ref",
          "location": {
            "file": "merge.h",
            "line": 106,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "zero on success, -1 on failure."
          },
          "params": [
            {
              "name": "out",
              "type": "git_merge_head **",
              "direction": "in",
              "comment": "pointer to store the git_merge_head result in"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository that contains the given reference"
            },
            {
              "name": "ref",
              "type": "git_reference *",
              "direction": "in",
              "comment": "reference to use as a merge input"
            }
          ],
          "comment": [
            "Creates a `git_merge_head` from the given reference"
          ],
          "group": "merge"
        },
        "git_merge_head_from_fetchhead": {
          "kind": "function",
          "name": "git_merge_head_from_fetchhead",
          "location": {
            "file": "merge.h",
            "line": 121,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "zero on success, -1 on failure."
          },
          "params": [
            {
              "name": "out",
              "type": "git_merge_head **",
              "direction": "in",
              "comment": "pointer to store the git_merge_head result in"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository that contains the given commit"
            },
            {
              "name": "branch_name",
              "type": "const char *",
              "direction": "in",
              "comment": "name of the (remote) branch"
            },
            {
              "name": "remote_url",
              "type": "const char *",
              "direction": "in",
              "comment": "url of the remote"
            },
            {
              "name": "oid",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "the commit object id to use as a merge input"
            }
          ],
          "comment": [
            "Creates a `git_merge_head` from the given fetch head data"
          ],
          "group": "merge"
        },
        "git_merge_head_from_oid": {
          "kind": "function",
          "name": "git_merge_head_from_oid",
          "location": {
            "file": "merge.h",
            "line": 136,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "zero on success, -1 on failure."
          },
          "params": [
            {
              "name": "out",
              "type": "git_merge_head **",
              "direction": "in",
              "comment": "pointer to store the git_merge_head result in"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository that contains the given commit"
            },
            {
              "name": "oid",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "the commit object id to use as a merge input"
            }
          ],
          "comment": [
            "Creates a `git_merge_head` from the given commit id"
          ],
          "group": "merge"
        },
        "git_merge_head_free": {
          "kind": "function",
          "name": "git_merge_head_free",
          "location": {
            "file": "merge.h",
            "line": 146,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "head",
              "type": "git_merge_head *",
              "direction": "in",
              "comment": "merge head to free"
            }
          ],
          "comment": [
            "Frees a `git_merge_head`"
          ],
          "group": "merge"
        },
        "git_merge_trees": {
          "kind": "function",
          "name": "git_merge_trees",
          "location": {
            "file": "merge.h",
            "line": 163,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "zero on success, -1 on failure."
          },
          "params": [
            {
              "name": "out",
              "type": "git_index **",
              "direction": "in",
              "comment": "pointer to store the index result in"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository that contains the given trees"
            },
            {
              "name": "ancestor_tree",
              "type": "const git_tree *",
              "direction": "in",
              "comment": "the common ancestor between the trees (or null if none)"
            },
            {
              "name": "our_tree",
              "type": "const git_tree *",
              "direction": "in",
              "comment": "the tree that reflects the destination tree"
            },
            {
              "name": "their_tree",
              "type": "const git_tree *",
              "direction": "in",
              "comment": "the tree to merge in to `our_tree`"
            },
            {
              "name": "opts",
              "type": "const git_merge_tree_opts *",
              "direction": "in",
              "comment": "the merge tree options (or null for defaults)"
            }
          ],
          "comment": [
            "Merge two trees, producing a `git_index` that reflects the result of\n the merge.",
            "The returned index must be freed explicitly with `git_index_free`."
          ],
          "group": "merge"
        },
        "git_merge_head": {
          "kind": "struct",
          "name": "git_merge_head",
          "referenceName": "struct git_merge_head",
          "opaque": true,
          "comment": [
            "Merge heads, the input to merge"
          ],
          "location": {
            "file": "types.h",
            "line": 175,
            "column": 31
          },
          "group": "merge",
          "parameterTo": [
            "git_merge_head_from_ref",
            "git_merge_head_from_fetchhead",
            "git_merge_head_from_oid",
            "git_merge_head_free"
          ]
        }
      },
      "info": {
        "summary": "Git merge routines"
      }
    },
    "message": {
      "apis": {
        "git_message_prettify": {
          "kind": "function",
          "name": "git_message_prettify",
          "location": {
            "file": "message.h",
            "line": 40,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "-1 on error, else number of characters in prettified message\n     including the trailing NUL byte"
          },
          "params": [
            {
              "name": "out",
              "type": "char *",
              "direction": "in",
              "comment": "The user-allocated buffer which will be filled with the\n     cleaned up message. Pass NULL if you just want to get the needed\n     size of the prettified message as the output value."
            },
            {
              "name": "out_size",
              "type": "size_t",
              "direction": "in",
              "comment": "Size of the `out` buffer in bytes."
            },
            {
              "name": "message",
              "type": "const char *",
              "direction": "in",
              "comment": "The message to be prettified."
            },
            {
              "name": "strip_comments",
              "type": "int",
              "direction": "in",
              "comment": "Non-zero to remove lines starting with \"#\", 0 to\n     leave them in."
            }
          ],
          "comment": [
            "Clean up message from excess whitespace and make sure that the last line\n ends with a '\\n\n'.",
            "Optionally, can remove lines starting with a \"#\"."
          ],
          "group": "message"
        }
      },
      "info": {
        "summary": "Git message management routines"
      }
    },
    "net": {
      "apis": {
        "GIT_DEFAULT_PORT": {
          "kind": "macro",
          "name": "GIT_DEFAULT_PORT",
          "location": {
            "file": "net.h",
            "line": 22,
            "column": 9
          },
          "value": "\"9418\"",
          "comment": "",
          "group": "net"
        },
        "git_direction": {
          "kind": "enum",
          "name": "git_direction",
          "referenceName": "git_direction",
          "members": [
            {
              "name": "GIT_DIRECTION_FETCH",
              "value": "0"
            },
            {
              "name": "GIT_DIRECTION_PUSH",
              "value": "1"
            }
          ],
          "location": {
            "file": "net.h",
            "line": 30,
            "column": 9
          },
          "group": "net",
          "returnedBy": [
            "git_refspec_direction"
          ],
          "parameterTo": [
            "git_remote_connect"
          ]
        },
        "git_remote_head": {
          "kind": "struct",
          "name": "git_remote_head",
          "referenceName": "struct git_remote_head",
          "comment": [
            "Remote head description, given out on `ls` calls."
          ],
          "members": [
            {
              "name": "local",
              "type": "int"
            },
            {
              "name": "oid",
              "type": "git_oid",
              "referenceType": "struct git_oid"
            },
            {
              "name": "loid",
              "type": "git_oid",
              "referenceType": "struct git_oid"
            },
            {
              "name": "name",
              "type": "char *"
            }
          ],
          "location": {
            "file": "net.h",
            "line": 39,
            "column": 8
          },
          "group": "net",
          "parameterTo": [
            "git_headlist_cb"
          ]
        },
        "git_headlist_cb": {
          "kind": "callback",
          "name": "git_headlist_cb",
          "type": "int (*)(git_remote_head *, void *)",
          "comment": [
            "Callback for listing the remote heads"
          ],
          "location": {
            "file": "net.h",
            "line": 49,
            "column": 15
          },
          "params": [
            {
              "type": "git_remote_head *"
            },
            {
              "type": "void *"
            }
          ],
          "group": "net",
          "parameterTo": [
            "git_remote_ls"
          ],
          "typedef": true
        }
      },
      "info": {
        "summary": "Git networking declarations"
      }
    },
    "notes": {
      "apis": {
        "git_note_foreach_cb": {
          "kind": "callback",
          "name": "git_note_foreach_cb",
          "type": "int (*)(const git_oid *, const git_oid *, void *)",
          "comment": [
            "Callback for git_note_foreach.",
            "Receives:\n - blob_id: Oid of the blob containing the message\n - annotated_object_id: Oid of the git object being annotated\n - payload: Payload data passed to `git_note_foreach`"
          ],
          "location": {
            "file": "notes.h",
            "line": 29,
            "column": 15
          },
          "params": [
            {
              "type": "const git_oid *"
            },
            {
              "type": "const git_oid *"
            },
            {
              "type": "void *"
            }
          ],
          "group": "notes",
          "parameterTo": [
            "git_note_foreach"
          ],
          "typedef": true
        },
        "git_note_iterator": {
          "kind": "struct",
          "name": "git_note_iterator",
          "referenceName": "struct git_iterator",
          "opaque": true,
          "comment": [
            "note iterator"
          ],
          "location": {
            "file": "notes.h",
            "line": 35,
            "column": 29
          },
          "group": "notes",
          "parameterTo": [
            "git_note_iterator_new",
            "git_note_iterator_free",
            "git_note_next"
          ]
        },
        "git_note_iterator_new": {
          "kind": "function",
          "name": "git_note_iterator_new",
          "location": {
            "file": "notes.h",
            "line": 49,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_note_iterator **",
              "direction": "in",
              "comment": "pointer to the iterator"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository where to look up the note"
            },
            {
              "name": "notes_ref",
              "type": "const char *",
              "direction": "in",
              "comment": "canonical name of the reference to use (optional); defaults to\n                  \"refs/notes/commits\""
            }
          ],
          "comment": [
            "Creates a new iterator for notes",
            "The iterator must be freed manually by the user."
          ],
          "group": "notes"
        },
        "git_note_iterator_free": {
          "kind": "function",
          "name": "git_note_iterator_free",
          "location": {
            "file": "notes.h",
            "line": 59,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "it",
              "type": "git_note_iterator *",
              "direction": "in",
              "comment": "pointer to the iterator"
            }
          ],
          "comment": [
            "Frees an git_note_iterator"
          ],
          "group": "notes"
        },
        "git_note_next": {
          "kind": "function",
          "name": "git_note_next",
          "location": {
            "file": "notes.h",
            "line": 74,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 (no error), GIT_ITEROVER (iteration is done) or an error code\n         (negative value)"
          },
          "params": [
            {
              "name": "note_id",
              "type": "git_oid *",
              "direction": "in",
              "comment": "id of blob containing the message"
            },
            {
              "name": "annotated_id",
              "type": "git_oid *",
              "direction": "in",
              "comment": "id of the git object being annotated"
            },
            {
              "name": "it",
              "type": "git_note_iterator *",
              "direction": "in",
              "comment": "pointer to the iterator"
            }
          ],
          "comment": [
            "Returns the current item (note_id and annotated_id) and advance the iterator\n internally to the next value",
            "The notes must not be freed manually by the user."
          ],
          "group": "notes"
        },
        "git_note_read": {
          "kind": "function",
          "name": "git_note_read",
          "location": {
            "file": "notes.h",
            "line": 93,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_note **",
              "direction": "in",
              "comment": "pointer to the read note; NULL in case of error"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository where to look up the note"
            },
            {
              "name": "notes_ref",
              "type": "const char *",
              "direction": "in",
              "comment": "canonical name of the reference to use (optional); defaults to\n                  \"refs/notes/commits\""
            },
            {
              "name": "oid",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "OID of the git object to read the note from"
            }
          ],
          "comment": [
            "Read the note for an object",
            "The note must be freed manually by the user."
          ],
          "group": "notes"
        },
        "git_note_message": {
          "kind": "function",
          "name": "git_note_message",
          "location": {
            "file": "notes.h",
            "line": 105,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "the note message"
          },
          "params": [
            {
              "name": "note",
              "type": "const git_note *",
              "direction": "in",
              "comment": ""
            }
          ],
          "comment": [
            "Get the note message"
          ],
          "group": "notes"
        },
        "git_note_oid": {
          "kind": "function",
          "name": "git_note_oid",
          "location": {
            "file": "notes.h",
            "line": 114,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "the note object OID"
          },
          "params": [
            {
              "name": "note",
              "type": "const git_note *",
              "direction": "in",
              "comment": ""
            }
          ],
          "comment": [
            "Get the note object OID"
          ],
          "group": "notes"
        },
        "git_note_create": {
          "kind": "function",
          "name": "git_note_create",
          "location": {
            "file": "notes.h",
            "line": 131,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "pointer to store the OID (optional); NULL in case of error"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository where to store the note"
            },
            {
              "name": "author",
              "type": "const git_signature *",
              "direction": "in",
              "comment": "signature of the notes commit author"
            },
            {
              "name": "committer",
              "type": "const git_signature *",
              "direction": "in",
              "comment": "signature of the notes commit committer"
            },
            {
              "name": "notes_ref",
              "type": "const char *",
              "direction": "in",
              "comment": "canonical name of the reference to use (optional);\n\t\t\t\t\tdefaults to \"refs/notes/commits\""
            },
            {
              "name": "oid",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "OID of the git object to decorate"
            },
            {
              "name": "note",
              "type": "const char *",
              "direction": "in",
              "comment": "Content of the note to add for object oid"
            },
            {
              "name": "force",
              "type": "int",
              "direction": "in",
              "comment": "Overwrite existing note"
            }
          ],
          "comment": [
            "Add a note for an object"
          ],
          "group": "notes"
        },
        "git_note_remove": {
          "kind": "function",
          "name": "git_note_remove",
          "location": {
            "file": "notes.h",
            "line": 154,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository where the note lives"
            },
            {
              "name": "notes_ref",
              "type": "const char *",
              "direction": "in",
              "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 *",
              "direction": "in",
              "comment": "signature of the notes commit author"
            },
            {
              "name": "committer",
              "type": "const git_signature *",
              "direction": "in",
              "comment": "signature of the notes commit committer"
            },
            {
              "name": "oid",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "OID of the git object to remove the note from"
            }
          ],
          "comment": [
            "Remove the note for an object"
          ],
          "group": "notes"
        },
        "git_note_free": {
          "kind": "function",
          "name": "git_note_free",
          "location": {
            "file": "notes.h",
            "line": 166,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "note",
              "type": "git_note *",
              "direction": "in",
              "comment": "git_note object"
            }
          ],
          "comment": [
            "Free a git_note object"
          ],
          "group": "notes"
        },
        "git_note_default_ref": {
          "kind": "function",
          "name": "git_note_default_ref",
          "location": {
            "file": "notes.h",
            "line": 176,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "const char **",
              "direction": "in",
              "comment": "Pointer to the default notes reference"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The Git repository"
            }
          ],
          "comment": [
            "Get the default notes reference for a repository"
          ],
          "group": "notes"
        },
        "git_note_foreach": {
          "kind": "function",
          "name": "git_note_foreach",
          "location": {
            "file": "notes.h",
            "line": 194,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where to find the notes."
            },
            {
              "name": "notes_ref",
              "type": "const char *",
              "direction": "in",
              "comment": "Reference to read from (optional); defaults to\n        \"refs/notes/commits\"."
            },
            {
              "name": "note_cb",
              "type": "git_note_foreach_cb",
              "direction": "in",
              "comment": "Callback to invoke per found annotation.  Return non-zero\n        to stop looping.",
              "referenceType": "int (*)(const git_oid *, const git_oid *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Extra parameter to callback function."
            }
          ],
          "comment": [
            "Loop over all the notes within a specified namespace\n and issue a callback for each one."
          ],
          "group": "notes"
        },
        "git_note": {
          "kind": "struct",
          "name": "git_note",
          "referenceName": "struct git_note",
          "opaque": true,
          "comment": [
            "Representation of a git note"
          ],
          "location": {
            "file": "types.h",
            "line": 150,
            "column": 25
          },
          "group": "notes",
          "parameterTo": [
            "git_note_read",
            "git_note_message",
            "git_note_oid",
            "git_note_free"
          ]
        }
      },
      "info": {
        "summary": "Git notes management routines"
      }
    },
    "object": {
      "apis": {
        "git_object_lookup": {
          "kind": "function",
          "name": "git_object_lookup",
          "location": {
            "file": "object.h",
            "line": 41,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "a reference to the object"
          },
          "params": [
            {
              "name": "object",
              "type": "git_object **",
              "direction": "in",
              "comment": "pointer to the looked-up object"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository to look up the object"
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "the unique identifier for the object"
            },
            {
              "name": "type",
              "type": "git_otype",
              "direction": "in",
              "comment": "the type of the object",
              "referenceType": "enum git_otype"
            }
          ],
          "comment": [
            "Lookup a reference to one of the objects in a repository.",
            "The generated reference is owned by the repository and\n should be closed with the `git_object_free` method\n instead of free'd manually.",
            "The 'type' parameter must match the type of the object\n in the odb; the method will fail otherwise.\n The special value 'GIT_OBJ_ANY' may be passed to let\n the method guess the object's type."
          ],
          "group": "object"
        },
        "git_object_lookup_prefix": {
          "kind": "function",
          "name": "git_object_lookup_prefix",
          "location": {
            "file": "object.h",
            "line": 74,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "object_out",
              "type": "git_object **",
              "direction": "in",
              "comment": "pointer where to store the looked-up object"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository to look up the object"
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "a short identifier for the object"
            },
            {
              "name": "len",
              "type": "size_t",
              "direction": "in",
              "comment": "the length of the short identifier"
            },
            {
              "name": "type",
              "type": "git_otype",
              "direction": "in",
              "comment": "the type of the object",
              "referenceType": "enum git_otype"
            }
          ],
          "comment": [
            "Lookup a reference to one of the objects in a repository,\n given a prefix of its identifier (short id).",
            "The object obtained will be so that its identifier\n matches the first 'len' hexadecimal characters\n (packets of 4 bits) of the given 'id'.\n 'len' must be at least GIT_OID_MINPREFIXLEN, and\n long enough to identify a unique object matching\n the prefix; otherwise the method will fail.",
            "The generated reference is owned by the repository and\n should be closed with the `git_object_free` method\n instead of free'd manually.",
            "The 'type' parameter must match the type of the object\n in the odb; the method will fail otherwise.\n The special value 'GIT_OBJ_ANY' may be passed to let\n the method guess the object's type."
          ],
          "group": "object"
        },
        "git_object_id": {
          "kind": "function",
          "name": "git_object_id",
          "location": {
            "file": "object.h",
            "line": 87,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "the SHA1 id"
          },
          "params": [
            {
              "name": "obj",
              "type": "const git_object *",
              "direction": "in",
              "comment": "the repository object"
            }
          ],
          "comment": [
            "Get the id (SHA1) of a repository object"
          ],
          "group": "object"
        },
        "git_object_type": {
          "kind": "function",
          "name": "git_object_type",
          "location": {
            "file": "object.h",
            "line": 95,
            "column": 23
          },
          "returns": {
            "type": "git_otype",
            "comment": "the object's type"
          },
          "params": [
            {
              "name": "obj",
              "type": "const git_object *",
              "direction": "in",
              "comment": "the repository object"
            }
          ],
          "comment": [
            "Get the object type of an object"
          ],
          "group": "object"
        },
        "git_object_owner": {
          "kind": "function",
          "name": "git_object_owner",
          "location": {
            "file": "object.h",
            "line": 109,
            "column": 30
          },
          "returns": {
            "type": "git_repository *",
            "comment": "the repository who owns this object"
          },
          "params": [
            {
              "name": "obj",
              "type": "const git_object *",
              "direction": "in",
              "comment": "the object"
            }
          ],
          "comment": [
            "Get the repository that owns this object",
            "Freeing or calling `git_repository_close` on the\n returned pointer will invalidate the actual object.",
            "Any other operation may be run on the repository without\n affecting the object."
          ],
          "group": "object"
        },
        "git_object_free": {
          "kind": "function",
          "name": "git_object_free",
          "location": {
            "file": "object.h",
            "line": 126,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "object",
              "type": "git_object *",
              "direction": "in",
              "comment": "the object to close"
            }
          ],
          "comment": [
            "Close an open object",
            "This method instructs the library to close an existing\n object; note that git_objects are owned and cached by the repository\n so the object may or may not be freed after this library call,\n depending on how aggressive is the caching mechanism used\n by the repository.",
            "IMPORTANT:\n It *is* necessary to call this method when you stop using\n an object. Failure to do so will cause a memory leak."
          ],
          "group": "object"
        },
        "git_object_type2string": {
          "kind": "function",
          "name": "git_object_type2string",
          "location": {
            "file": "object.h",
            "line": 137,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "the corresponding string representation."
          },
          "params": [
            {
              "name": "type",
              "type": "git_otype",
              "direction": "in",
              "comment": "object type to convert.",
              "referenceType": "enum git_otype"
            }
          ],
          "comment": [
            "Convert an object type to it's string representation.",
            "The result is a pointer to a string in static memory and\n should not be free()'ed."
          ],
          "group": "object"
        },
        "git_object_string2type": {
          "kind": "function",
          "name": "git_object_string2type",
          "location": {
            "file": "object.h",
            "line": 145,
            "column": 23
          },
          "returns": {
            "type": "git_otype",
            "comment": "the corresponding git_otype."
          },
          "params": [
            {
              "name": "str",
              "type": "const char *",
              "direction": "in",
              "comment": "the string to convert."
            }
          ],
          "comment": [
            "Convert a string object type representation to it's git_otype."
          ],
          "group": "object"
        },
        "git_object_typeisloose": {
          "kind": "function",
          "name": "git_object_typeisloose",
          "location": {
            "file": "object.h",
            "line": 154,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "true if the type represents a valid loose object type,\n false otherwise."
          },
          "params": [
            {
              "name": "type",
              "type": "git_otype",
              "direction": "in",
              "comment": "object type to test.",
              "referenceType": "enum git_otype"
            }
          ],
          "comment": [
            "Determine if the given git_otype is a valid loose object type."
          ],
          "group": "object"
        },
        "git_object__size": {
          "kind": "function",
          "name": "git_object__size",
          "location": {
            "file": "object.h",
            "line": 168,
            "column": 20
          },
          "returns": {
            "type": "size_t",
            "comment": "size in bytes of the object"
          },
          "params": [
            {
              "name": "type",
              "type": "git_otype",
              "direction": "in",
              "comment": "object type to get its size",
              "referenceType": "enum git_otype"
            }
          ],
          "comment": [
            "Get the size in bytes for the structure which\n acts as an in-memory representation of any given\n object type.",
            "For all the core types, this would the equivalent\n of calling `sizeof(git_commit)` if the core types\n were not opaque on the external API."
          ],
          "group": "object"
        },
        "git_object_peel": {
          "kind": "function",
          "name": "git_object_peel",
          "location": {
            "file": "object.h",
            "line": 186,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EAMBIGUOUS, GIT_ENOTFOUND or an error code"
          },
          "params": [
            {
              "name": "peeled",
              "type": "git_object **",
              "direction": "in",
              "comment": "Pointer to the peeled git_object"
            },
            {
              "name": "object",
              "type": "const git_object *",
              "direction": "in",
              "comment": "The object to be processed"
            },
            {
              "name": "target_type",
              "type": "git_otype",
              "direction": "in",
              "comment": "The type of the requested object (GIT_OBJ_COMMIT,\n GIT_OBJ_TAG, GIT_OBJ_TREE, GIT_OBJ_BLOB or GIT_OBJ_ANY).",
              "referenceType": "enum git_otype"
            }
          ],
          "comment": [
            "Recursively peel an object until an object of the specified type is met.",
            "The retrieved `peeled` object is owned by the repository and should be\n closed with the `git_object_free` method.",
            "If you pass `GIT_OBJ_ANY` as the target type, then the object will be\n peeled until the type changes (e.g. a tag will be chased until the\n referenced object is no longer a tag)."
          ],
          "group": "object"
        },
        "git_object_dup": {
          "kind": "function",
          "name": "git_object_dup",
          "location": {
            "file": "object.h",
            "line": 198,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "dest",
              "type": "git_object **",
              "direction": "in",
              "comment": "Pointer to store the copy of the object"
            },
            {
              "name": "source",
              "type": "git_object *",
              "direction": "in",
              "comment": "Original object to copy"
            }
          ],
          "comment": [
            "Create an in-memory copy of a Git object. The copy must be\n explicitly free'd or it will leak."
          ],
          "group": "object"
        },
        "git_object": {
          "kind": "struct",
          "name": "git_object",
          "referenceName": "struct git_object",
          "opaque": true,
          "comment": [
            "Representation of a generic object in a repository"
          ],
          "location": {
            "file": "types.h",
            "line": 108,
            "column": 27
          },
          "group": "object",
          "parameterTo": [
            "git_checkout_tree",
            "git_object_lookup",
            "git_object_lookup_prefix",
            "git_object_id",
            "git_object_type",
            "git_object_owner",
            "git_object_free",
            "git_object_peel",
            "git_object_dup",
            "git_reference_peel",
            "git_reset",
            "git_reset_default",
            "git_revparse_single",
            "git_revparse_ext",
            "git_tag_target",
            "git_tag_create",
            "git_tag_annotation_create",
            "git_tag_create_lightweight",
            "git_tag_peel",
            "git_tree_entry_to_object"
          ]
        }
      },
      "info": {
        "summary": "Git revision object management routines"
      }
    },
    "odb": {
      "apis": {
        "git_odb_foreach_cb": {
          "kind": "callback",
          "name": "git_odb_foreach_cb",
          "type": "int (*)(const git_oid *, void *)",
          "comment": [
            "Function type for callbacks from git_odb_foreach."
          ],
          "location": {
            "file": "odb.h",
            "line": 26,
            "column": 15
          },
          "params": [
            {
              "type": "const git_oid *"
            },
            {
              "type": "void *"
            }
          ],
          "group": "odb",
          "parameterTo": [
            "git_odb_foreach"
          ],
          "typedef": true
        },
        "git_odb_new": {
          "kind": "function",
          "name": "git_odb_new",
          "location": {
            "file": "odb.h",
            "line": 38,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_odb **",
              "direction": "in",
              "comment": "location to store the database pointer, if opened.\n\t\t\tSet to NULL if the open failed."
            }
          ],
          "comment": [
            "Create a new object database with no backends.",
            "Before the ODB can be used for read/writing, a custom database\n backend must be manually added using `git_odb_add_backend()`"
          ],
          "group": "odb"
        },
        "git_odb_open": {
          "kind": "function",
          "name": "git_odb_open",
          "location": {
            "file": "odb.h",
            "line": 56,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_odb **",
              "direction": "in",
              "comment": "location to store the database pointer, if opened.\n\t\t\tSet to NULL if the open failed."
            },
            {
              "name": "objects_dir",
              "type": "const char *",
              "direction": "in",
              "comment": "path of the backends' \"objects\" directory."
            }
          ],
          "comment": [
            "Create a new object database and automatically add\n the two default backends:",
            "- git_odb_backend_loose: read and write loose object files\n\t\tfrom disk, assuming `objects_dir` as the Objects folder",
            "- git_odb_backend_pack: read objects from packfiles,\n\t\tassuming `objects_dir` as the Objects folder which\n\t\tcontains a 'pack/' folder with the corresponding data"
          ],
          "group": "odb"
        },
        "git_odb_add_disk_alternate": {
          "kind": "function",
          "name": "git_odb_add_disk_alternate",
          "location": {
            "file": "odb.h",
            "line": 73,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success; error code otherwise"
          },
          "params": [
            {
              "name": "odb",
              "type": "git_odb *",
              "direction": "in",
              "comment": "database to add the backend to"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "path to the objects folder for the alternate"
            }
          ],
          "comment": [
            "Add an on-disk alternate to an existing Object DB.",
            "Note that the added path must point to an `objects`, not\n to a full repository, to use it as an alternate store.",
            "Alternate backends are always checked for objects *after*\n all the main backends have been exhausted.",
            "Writing is disabled on alternate backends."
          ],
          "group": "odb"
        },
        "git_odb_free": {
          "kind": "function",
          "name": "git_odb_free",
          "location": {
            "file": "odb.h",
            "line": 80,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "db",
              "type": "git_odb *",
              "direction": "in",
              "comment": "database pointer to close. If NULL no action is taken."
            }
          ],
          "comment": [
            "Close an open object database."
          ],
          "group": "odb"
        },
        "git_odb_read": {
          "kind": "function",
          "name": "git_odb_read",
          "location": {
            "file": "odb.h",
            "line": 99,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "- 0 if the object was read;\n - GIT_ENOTFOUND if the object is not in the database."
          },
          "params": [
            {
              "name": "out",
              "type": "git_odb_object **",
              "direction": "in",
              "comment": "pointer where to store the read object"
            },
            {
              "name": "db",
              "type": "git_odb *",
              "direction": "in",
              "comment": "database to search for the object in."
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "identity of the object to read."
            }
          ],
          "comment": [
            "Read an object from the database.",
            "This method queries all available ODB backends\n trying to read the given OID.",
            "The returned object is reference counted and\n internally cached, so it should be closed\n by the user once it's no longer in use."
          ],
          "group": "odb"
        },
        "git_odb_read_prefix": {
          "kind": "function",
          "name": "git_odb_read_prefix",
          "location": {
            "file": "odb.h",
            "line": 128,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "- 0 if the object was read;\n - GIT_ENOTFOUND if the object is not in the database.\n - GIT_EAMBIGUOUS if the prefix is ambiguous (several objects match the prefix)"
          },
          "params": [
            {
              "name": "out",
              "type": "git_odb_object **",
              "direction": "in",
              "comment": "pointer where to store the read object"
            },
            {
              "name": "db",
              "type": "git_odb *",
              "direction": "in",
              "comment": "database to search for the object in."
            },
            {
              "name": "short_id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "a prefix of the id of the object to read."
            },
            {
              "name": "len",
              "type": "size_t",
              "direction": "in",
              "comment": "the length of the prefix"
            }
          ],
          "comment": [
            "Read an object from the database, given a prefix\n of its identifier.",
            "This method queries all available ODB backends\n trying to match the 'len' first hexadecimal\n characters of the 'short_id'.\n The remaining (GIT_OID_HEXSZ-len)*4 bits of\n 'short_id' must be 0s.\n 'len' must be at least GIT_OID_MINPREFIXLEN,\n and the prefix must be long enough to identify\n a unique object in all the backends; the\n method will fail otherwise.",
            "The returned object is reference counted and\n internally cached, so it should be closed\n by the user once it's no longer in use."
          ],
          "group": "odb"
        },
        "git_odb_read_header": {
          "kind": "function",
          "name": "git_odb_read_header",
          "location": {
            "file": "odb.h",
            "line": 148,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "- 0 if the object was read;\n - GIT_ENOTFOUND if the object is not in the database."
          },
          "params": [
            {
              "name": "len_out",
              "type": "size_t *",
              "direction": "in",
              "comment": "pointer where to store the length"
            },
            {
              "name": "type_out",
              "type": "git_otype *",
              "direction": "in",
              "comment": "pointer where to store the type"
            },
            {
              "name": "db",
              "type": "git_odb *",
              "direction": "in",
              "comment": "database to search for the object in."
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "identity of the object to read."
            }
          ],
          "comment": [
            "Read the header of an object from the database, without\n reading its full contents.",
            "The header includes the length and the type of an object.",
            "Note that most backends do not support reading only the header\n of an object, so the whole object will be read and then the\n header will be returned."
          ],
          "group": "odb"
        },
        "git_odb_exists": {
          "kind": "function",
          "name": "git_odb_exists",
          "location": {
            "file": "odb.h",
            "line": 159,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "- 1, if the object was found\n - 0, otherwise"
          },
          "params": [
            {
              "name": "db",
              "type": "git_odb *",
              "direction": "in",
              "comment": "database to be searched for the given object."
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "the object to search for."
            }
          ],
          "comment": [
            "Determine if the given object can be found in the object database."
          ],
          "group": "odb"
        },
        "git_odb_refresh": {
          "kind": "function",
          "name": "git_odb_refresh",
          "location": {
            "file": "odb.h",
            "line": 179,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, error code otherwise"
          },
          "params": [
            {
              "name": "db",
              "type": "struct git_odb *",
              "direction": "in",
              "comment": "database to refresh"
            }
          ],
          "comment": [
            "Refresh the object database to load newly added files.",
            "If the object databases have changed on disk while the library\n is running, this function will force a reload of the underlying\n indexes.",
            "Use this function when you're confident that an external\n application has tampered with the ODB.",
            "NOTE that it is not necessary to call this function at all. The\n library will automatically attempt to refresh the ODB\n when a lookup fails, to see if the looked up object exists\n on disk but hasn't been loaded yet."
          ],
          "group": "odb"
        },
        "git_odb_foreach": {
          "kind": "function",
          "name": "git_odb_foreach",
          "location": {
            "file": "odb.h",
            "line": 194,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "db",
              "type": "git_odb *",
              "direction": "in",
              "comment": "database to use"
            },
            {
              "name": "cb",
              "type": "git_odb_foreach_cb",
              "direction": "in",
              "comment": "the callback to call for each object",
              "referenceType": "int (*)(const git_oid *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "data to pass to the callback"
            }
          ],
          "comment": [
            "List all objects available in the database",
            "The callback will be called for each object available in the\n database. Note that the objects are likely to be returned in the index\n order, which would make accessing the objects in that order inefficient.\n Return a non-zero value from the callback to stop looping."
          ],
          "group": "odb"
        },
        "git_odb_write": {
          "kind": "function",
          "name": "git_odb_write",
          "location": {
            "file": "odb.h",
            "line": 214,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "pointer to store the OID result of the write"
            },
            {
              "name": "odb",
              "type": "git_odb *",
              "direction": "in",
              "comment": "object database where to store the object"
            },
            {
              "name": "data",
              "type": "const void *",
              "direction": "in",
              "comment": "buffer with the data to store"
            },
            {
              "name": "len",
              "type": "size_t",
              "direction": "in",
              "comment": "size of the buffer"
            },
            {
              "name": "type",
              "type": "git_otype",
              "direction": "in",
              "comment": "type of the data to store",
              "referenceType": "enum git_otype"
            }
          ],
          "comment": [
            "Write an object directly into the ODB",
            "This method writes a full object straight into the ODB.\n For most cases, it is preferred to write objects through a write\n stream, which is both faster and less memory intensive, specially\n for big objects.",
            "This method is provided for compatibility with custom backends\n which are not able to support streaming writes"
          ],
          "group": "odb"
        },
        "git_odb_open_wstream": {
          "kind": "function",
          "name": "git_odb_open_wstream",
          "location": {
            "file": "odb.h",
            "line": 243,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 if the stream was created; error code otherwise"
          },
          "params": [
            {
              "name": "out",
              "type": "git_odb_stream **",
              "direction": "in",
              "comment": "pointer where to store the stream"
            },
            {
              "name": "db",
              "type": "git_odb *",
              "direction": "in",
              "comment": "object database where the stream will write"
            },
            {
              "name": "size",
              "type": "size_t",
              "direction": "in",
              "comment": "final size of the object that will be written"
            },
            {
              "name": "type",
              "type": "git_otype",
              "direction": "in",
              "comment": "type of the object that will be written",
              "referenceType": "enum git_otype"
            }
          ],
          "comment": [
            "Open a stream to write an object into the ODB",
            "The type and final length of the object must be specified\n when opening the stream.",
            "The returned stream will be of type `GIT_STREAM_WRONLY` and\n will have the following methods:",
            "- stream->write: write `n` bytes into the stream\n\t\t- stream->finalize_write: close the stream and store the object in\n\t\t\tthe odb\n\t\t- stream->free: free the stream",
            "The streaming write won't be effective until `stream->finalize_write`\n is called and returns without an error",
            "The stream must always be free'd or will leak memory."
          ],
          "see": [
            "git_odb_stream"
          ],
          "group": "odb"
        },
        "git_odb_open_rstream": {
          "kind": "function",
          "name": "git_odb_open_rstream",
          "location": {
            "file": "odb.h",
            "line": 269,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 if the stream was created; error code otherwise"
          },
          "params": [
            {
              "name": "out",
              "type": "git_odb_stream **",
              "direction": "in",
              "comment": "pointer where to store the stream"
            },
            {
              "name": "db",
              "type": "git_odb *",
              "direction": "in",
              "comment": "object database where the stream will read from"
            },
            {
              "name": "oid",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "oid of the object the stream will read from"
            }
          ],
          "comment": [
            "Open a stream to read an object from the ODB",
            "Note that most backends do *not* support streaming reads\n because they store their objects as compressed/delta'ed blobs.",
            "It's recommended to use `git_odb_read` instead, which is\n assured to work on all backends.",
            "The returned stream will be of type `GIT_STREAM_RDONLY` and\n will have the following methods:",
            "- stream->read: read `n` bytes from the stream\n\t\t- stream->free: free the stream",
            "The stream must always be free'd or will leak memory."
          ],
          "see": [
            "git_odb_stream"
          ],
          "group": "odb"
        },
        "git_odb_write_pack": {
          "kind": "function",
          "name": "git_odb_write_pack",
          "location": {
            "file": "odb.h",
            "line": 289,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "out",
              "type": "git_odb_writepack **",
              "direction": "in",
              "comment": "pointer to the writepack functions"
            },
            {
              "name": "db",
              "type": "git_odb *",
              "direction": "in",
              "comment": "object database where the stream will read from"
            },
            {
              "name": "progress_cb",
              "type": "git_transfer_progress_callback",
              "direction": "in",
              "comment": "function to call with progress information.\n Be aware that this is called inline with network and indexing operations,\n so performance may be affected.",
              "referenceType": "int (*)(const git_transfer_progress *, void *)"
            },
            {
              "name": "progress_payload",
              "type": "void *",
              "direction": "in",
              "comment": "payload for the progress callback"
            }
          ],
          "comment": [
            "Open a stream for writing a pack file to the ODB.",
            "If the ODB layer understands pack files, then the given\n packfile will likely be streamed directly to disk (and a\n corresponding index created).  If the ODB layer does not\n understand pack files, the objects will be stored in whatever\n format the ODB layer uses."
          ],
          "see": [
            "git_odb_writepack"
          ],
          "group": "odb"
        },
        "git_odb_hash": {
          "kind": "function",
          "name": "git_odb_hash",
          "location": {
            "file": "odb.h",
            "line": 307,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "the resulting object-ID."
            },
            {
              "name": "data",
              "type": "const void *",
              "direction": "in",
              "comment": "data to hash"
            },
            {
              "name": "len",
              "type": "size_t",
              "direction": "in",
              "comment": "size of the data"
            },
            {
              "name": "type",
              "type": "git_otype",
              "direction": "in",
              "comment": "of the data to hash",
              "referenceType": "enum git_otype"
            }
          ],
          "comment": [
            "Determine the object-ID (sha1 hash) of a data buffer",
            "The resulting SHA-1 OID will be the identifier for the data\n buffer as if the data buffer it were to written to the ODB."
          ],
          "group": "odb"
        },
        "git_odb_hashfile": {
          "kind": "function",
          "name": "git_odb_hashfile",
          "location": {
            "file": "odb.h",
            "line": 322,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "oid structure the result is written into."
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "file to read and determine object id for"
            },
            {
              "name": "type",
              "type": "git_otype",
              "direction": "in",
              "comment": "the type of the object that will be hashed",
              "referenceType": "enum git_otype"
            }
          ],
          "comment": [
            "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."
          ],
          "group": "odb"
        },
        "git_odb_object_free": {
          "kind": "function",
          "name": "git_odb_object_free",
          "location": {
            "file": "odb.h",
            "line": 332,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "object",
              "type": "git_odb_object *",
              "direction": "in",
              "comment": "object to close"
            }
          ],
          "comment": [
            "Close an ODB object",
            "This method must always be called once a `git_odb_object` is no\n longer needed, otherwise memory will leak."
          ],
          "group": "odb"
        },
        "git_odb_object_id": {
          "kind": "function",
          "name": "git_odb_object_id",
          "location": {
            "file": "odb.h",
            "line": 342,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "a pointer to the OID"
          },
          "params": [
            {
              "name": "object",
              "type": "git_odb_object *",
              "direction": "in",
              "comment": "the object"
            }
          ],
          "comment": [
            "Return the OID of an ODB object",
            "This is the OID from which the object was read from"
          ],
          "group": "odb"
        },
        "git_odb_object_data": {
          "kind": "function",
          "name": "git_odb_object_data",
          "location": {
            "file": "odb.h",
            "line": 355,
            "column": 26
          },
          "returns": {
            "type": "const void *",
            "comment": "a pointer to the data"
          },
          "params": [
            {
              "name": "object",
              "type": "git_odb_object *",
              "direction": "in",
              "comment": "the object"
            }
          ],
          "comment": [
            "Return the data of an ODB object",
            "This is the uncompressed, raw data as read from the ODB,\n without the leading header.",
            "This pointer is owned by the object and shall not be free'd."
          ],
          "group": "odb"
        },
        "git_odb_object_size": {
          "kind": "function",
          "name": "git_odb_object_size",
          "location": {
            "file": "odb.h",
            "line": 366,
            "column": 20
          },
          "returns": {
            "type": "size_t",
            "comment": "the size"
          },
          "params": [
            {
              "name": "object",
              "type": "git_odb_object *",
              "direction": "in",
              "comment": "the object"
            }
          ],
          "comment": [
            "Return the size of an ODB object",
            "This is the real size of the `data` buffer, not the\n actual size of the object."
          ],
          "group": "odb"
        },
        "git_odb_object_type": {
          "kind": "function",
          "name": "git_odb_object_type",
          "location": {
            "file": "odb.h",
            "line": 374,
            "column": 23
          },
          "returns": {
            "type": "git_otype",
            "comment": "the type"
          },
          "params": [
            {
              "name": "object",
              "type": "git_odb_object *",
              "direction": "in",
              "comment": "the object"
            }
          ],
          "comment": [
            "Return the type of an ODB object"
          ],
          "group": "odb"
        },
        "git_odb_add_backend": {
          "kind": "function",
          "name": "git_odb_add_backend",
          "location": {
            "file": "odb.h",
            "line": 389,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success; error code otherwise"
          },
          "params": [
            {
              "name": "odb",
              "type": "git_odb *",
              "direction": "in",
              "comment": "database to add the backend to"
            },
            {
              "name": "backend",
              "type": "git_odb_backend *",
              "direction": "in",
              "comment": "pointer to a git_odb_backend instance"
            },
            {
              "name": "priority",
              "type": "int",
              "direction": "in",
              "comment": "Value for ordering the backends queue"
            }
          ],
          "comment": [
            "Add a custom backend to an existing Object DB",
            "The backends are checked in relative ordering, based on the\n value of the `priority` parameter.",
            "Read \n<odb\n_backends.h> for more information."
          ],
          "group": "odb"
        },
        "git_odb_add_alternate": {
          "kind": "function",
          "name": "git_odb_add_alternate",
          "location": {
            "file": "odb.h",
            "line": 410,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success; error code otherwise"
          },
          "params": [
            {
              "name": "odb",
              "type": "git_odb *",
              "direction": "in",
              "comment": "database to add the backend to"
            },
            {
              "name": "backend",
              "type": "git_odb_backend *",
              "direction": "in",
              "comment": "pointer to a git_odb_backend instance"
            },
            {
              "name": "priority",
              "type": "int",
              "direction": "in",
              "comment": "Value for ordering the backends queue"
            }
          ],
          "comment": [
            "Add a custom backend to an existing Object DB; this\n backend will work as an alternate.",
            "Alternate backends are always checked for objects *after*\n all the main backends have been exhausted.",
            "The backends are checked in relative ordering, based on the\n value of the `priority` parameter.",
            "Writing is disabled on alternate backends.",
            "Read \n<odb\n_backends.h> for more information."
          ],
          "group": "odb"
        },
        "git_odb_num_backends": {
          "kind": "function",
          "name": "git_odb_num_backends",
          "location": {
            "file": "odb.h",
            "line": 418,
            "column": 20
          },
          "returns": {
            "type": "size_t",
            "comment": "number of backends in the ODB"
          },
          "params": [
            {
              "name": "odb",
              "type": "git_odb *",
              "direction": "in",
              "comment": "object database"
            }
          ],
          "comment": [
            "Get the number of ODB backend objects"
          ],
          "group": "odb"
        },
        "git_odb_get_backend": {
          "kind": "function",
          "name": "git_odb_get_backend",
          "location": {
            "file": "odb.h",
            "line": 428,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success; GIT_ENOTFOUND if pos is invalid; other errors \n<\n 0"
          },
          "params": [
            {
              "name": "out",
              "type": "git_odb_backend **",
              "direction": "in",
              "comment": "output pointer to ODB backend at pos"
            },
            {
              "name": "odb",
              "type": "git_odb *",
              "direction": "in",
              "comment": "object database"
            },
            {
              "name": "pos",
              "type": "size_t",
              "direction": "in",
              "comment": "index into object database backend list"
            }
          ],
          "comment": [
            "Lookup an ODB backend object by index"
          ],
          "group": "odb"
        },
        "git_odb": {
          "kind": "struct",
          "name": "git_odb",
          "referenceName": "struct git_odb",
          "opaque": true,
          "comment": [
            "An open object database handle."
          ],
          "location": {
            "file": "types.h",
            "line": 81,
            "column": 24
          },
          "group": "odb",
          "parameterTo": [
            "git_odb_new",
            "git_odb_open",
            "git_odb_add_disk_alternate",
            "git_odb_free",
            "git_odb_read",
            "git_odb_read_prefix",
            "git_odb_read_header",
            "git_odb_exists",
            "git_odb_foreach",
            "git_odb_write",
            "git_odb_open_wstream",
            "git_odb_open_rstream",
            "git_odb_write_pack",
            "git_odb_add_backend",
            "git_odb_add_alternate",
            "git_odb_num_backends",
            "git_odb_get_backend",
            "git_repository_wrap_odb",
            "git_repository_odb",
            "git_repository_set_odb"
          ]
        },
        "git_odb_object": {
          "kind": "struct",
          "name": "git_odb_object",
          "referenceName": "struct git_odb_object",
          "opaque": true,
          "comment": [
            "An object read from the ODB"
          ],
          "location": {
            "file": "types.h",
            "line": 87,
            "column": 31
          },
          "group": "odb",
          "parameterTo": [
            "git_odb_read",
            "git_odb_read_prefix",
            "git_odb_object_free",
            "git_odb_object_id",
            "git_odb_object_data",
            "git_odb_object_size",
            "git_odb_object_type"
          ]
        }
      },
      "info": {
        "summary": "Git object database routines"
      }
    },
    "odb_backend": {
      "apis": {
        "git_odb_backend_pack": {
          "kind": "function",
          "name": "git_odb_backend_pack",
          "location": {
            "file": "odb_backend.h",
            "line": 34,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_odb_backend **",
              "direction": "in",
              "comment": "location to store the odb backend pointer"
            },
            {
              "name": "objects_dir",
              "type": "const char *",
              "direction": "in",
              "comment": "the Git repository's objects directory"
            }
          ],
          "comment": [
            "Create a backend for the packfiles."
          ],
          "group": "odb_backend"
        },
        "git_odb_backend_loose": {
          "kind": "function",
          "name": "git_odb_backend_loose",
          "location": {
            "file": "odb_backend.h",
            "line": 46,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_odb_backend **",
              "direction": "in",
              "comment": "location to store the odb backend pointer"
            },
            {
              "name": "objects_dir",
              "type": "const char *",
              "direction": "in",
              "comment": "the Git repository's objects directory"
            },
            {
              "name": "compression_level",
              "type": "int",
              "direction": "in",
              "comment": "zlib compression level to use"
            },
            {
              "name": "do_fsync",
              "type": "int",
              "direction": "in",
              "comment": "whether to do an fsync() after writing (currently ignored)"
            }
          ],
          "comment": [
            "Create a backend for loose objects"
          ],
          "group": "odb_backend"
        },
        "git_odb_backend_one_pack": {
          "kind": "function",
          "name": "git_odb_backend_one_pack",
          "location": {
            "file": "odb_backend.h",
            "line": 59,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_odb_backend **",
              "direction": "in",
              "comment": "location to store the odb backend pointer"
            },
            {
              "name": "index_file",
              "type": "const char *",
              "direction": "in",
              "comment": "path to the packfile's .idx file"
            }
          ],
          "comment": [
            "Create a backend out of a single packfile",
            "This can be useful for inspecting the contents of a single\n packfile."
          ],
          "group": "odb_backend"
        },
        "git_odb_stream_t": {
          "kind": "enum",
          "name": "git_odb_stream_t",
          "referenceName": "git_odb_stream_t",
          "members": [
            {
              "name": "GIT_STREAM_RDONLY",
              "value": "2"
            },
            {
              "name": "GIT_STREAM_WRONLY",
              "value": "4"
            },
            {
              "name": "GIT_STREAM_RW",
              "value": "6"
            }
          ],
          "comment": [
            "Streaming mode"
          ],
          "location": {
            "file": "odb_backend.h",
            "line": 62,
            "column": 9
          },
          "group": "odb_backend"
        },
        "git_odb_stream": {
          "kind": "struct",
          "name": "git_odb_stream",
          "referenceName": "struct git_odb_stream",
          "comment": [
            "A stream to read/write from a backend"
          ],
          "members": [
            {
              "name": "backend",
              "type": "git_odb_backend *"
            },
            {
              "name": "mode",
              "type": "unsigned int"
            },
            {
              "name": "read",
              "type": "int (*)(git_odb_stream *, char *, size_t)"
            },
            {
              "name": "write",
              "type": "int (*)(git_odb_stream *, const char *, size_t)"
            },
            {
              "name": "finalize_write",
              "type": "int (*)(git_oid *, git_odb_stream *)"
            },
            {
              "name": "free",
              "type": "void (*)(git_odb_stream *)"
            }
          ],
          "location": {
            "file": "odb_backend.h",
            "line": 69,
            "column": 8
          },
          "group": "odb_backend",
          "parameterTo": [
            "git_odb_open_wstream",
            "git_odb_open_rstream"
          ]
        },
        "git_odb_writepack": {
          "kind": "struct",
          "name": "git_odb_writepack",
          "referenceName": "struct git_odb_writepack",
          "comment": [
            "A stream to write a pack file to the ODB"
          ],
          "members": [
            {
              "name": "backend",
              "type": "git_odb_backend *"
            },
            {
              "name": "add",
              "type": "int (*)(git_odb_writepack *, const void *, size_t, git_transfer_progress *)"
            },
            {
              "name": "commit",
              "type": "int (*)(git_odb_writepack *, git_transfer_progress *)"
            },
            {
              "name": "free",
              "type": "void (*)(git_odb_writepack *)"
            }
          ],
          "location": {
            "file": "odb_backend.h",
            "line": 80,
            "column": 8
          },
          "group": "odb_backend",
          "parameterTo": [
            "git_odb_write_pack"
          ]
        }
      },
      "info": {
        "summary": "Git custom backend functions"
      }
    },
    "sys/odb_backend": {
      "apis": {
        "git_odb_backend": {
          "kind": "struct",
          "name": "git_odb_backend",
          "referenceName": "struct git_odb_backend",
          "comment": [
            "An instance for a custom backend"
          ],
          "members": [
            {
              "name": "version",
              "type": "unsigned int"
            },
            {
              "name": "odb",
              "type": "git_odb *"
            },
            {
              "name": "read",
              "type": "int (*)(void **, size_t *, git_otype *, git_odb_backend *, const git_oid *)"
            },
            {
              "name": "read_prefix",
              "type": "int (*)(git_oid *, void **, size_t *, git_otype *, git_odb_backend *, const git_oid *, size_t)"
            },
            {
              "name": "read_header",
              "type": "int (*)(size_t *, git_otype *, git_odb_backend *, const git_oid *)"
            },
            {
              "name": "write",
              "type": "int (*)(git_oid *, git_odb_backend *, const void *, size_t, git_otype)"
            },
            {
              "name": "writestream",
              "type": "int (*)(git_odb_stream **, git_odb_backend *, size_t, git_otype)"
            },
            {
              "name": "readstream",
              "type": "int (*)(git_odb_stream **, git_odb_backend *, const git_oid *)"
            },
            {
              "name": "exists",
              "type": "int (*)(git_odb_backend *, const git_oid *)"
            },
            {
              "name": "refresh",
              "type": "int (*)(git_odb_backend *)"
            },
            {
              "name": "foreach",
              "type": "int (*)(git_odb_backend *, git_odb_foreach_cb, void *)"
            },
            {
              "name": "writepack",
              "type": "int (*)(git_odb_writepack **, git_odb_backend *, git_transfer_progress_callback, void *)"
            },
            {
              "name": "free",
              "type": "void (*)(git_odb_backend *)"
            }
          ],
          "location": {
            "file": "sys/odb_backend.h",
            "line": 27,
            "column": 8
          },
          "group": "sys/odb_backend",
          "parameterTo": [
            "git_odb_add_backend",
            "git_odb_add_alternate",
            "git_odb_get_backend",
            "git_odb_backend_pack",
            "git_odb_backend_loose",
            "git_odb_backend_one_pack",
            "git_odb_backend_malloc"
          ]
        },
        "GIT_ODB_BACKEND_VERSION": {
          "kind": "macro",
          "name": "GIT_ODB_BACKEND_VERSION",
          "location": {
            "file": "sys/odb_backend.h",
            "line": 79,
            "column": 9
          },
          "value": "1",
          "comment": "",
          "group": "sys/odb_backend"
        },
        "GIT_ODB_BACKEND_INIT": {
          "kind": "macro",
          "name": "GIT_ODB_BACKEND_INIT",
          "location": {
            "file": "sys/odb_backend.h",
            "line": 80,
            "column": 9
          },
          "value": "{GIT_ODB_BACKEND_VERSION}",
          "comment": "",
          "group": "sys/odb_backend"
        },
        "git_odb_backend_malloc": {
          "kind": "function",
          "name": "git_odb_backend_malloc",
          "location": {
            "file": "sys/odb_backend.h",
            "line": 82,
            "column": 20
          },
          "returns": {
            "type": "void *"
          },
          "params": [
            {
              "name": "backend",
              "type": "git_odb_backend *"
            },
            {
              "name": "len",
              "type": "size_t"
            }
          ],
          "group": "sys/odb_backend"
        }
      },
      "info": {
        "summary": "Git custom backend implementors functions"
      }
    },
    "oid": {
      "apis": {
        "GIT_OID_RAWSZ": {
          "kind": "macro",
          "name": "GIT_OID_RAWSZ",
          "location": {
            "file": "oid.h",
            "line": 23,
            "column": 9
          },
          "value": "20",
          "comment": "Size (in bytes) of a raw/binary oid",
          "group": "oid"
        },
        "GIT_OID_HEXSZ": {
          "kind": "macro",
          "name": "GIT_OID_HEXSZ",
          "location": {
            "file": "oid.h",
            "line": 26,
            "column": 9
          },
          "value": "(GIT_OID_RAWSZ * 2)",
          "comment": "Size (in bytes) of a hex formatted oid",
          "group": "oid"
        },
        "GIT_OID_MINPREFIXLEN": {
          "kind": "macro",
          "name": "GIT_OID_MINPREFIXLEN",
          "location": {
            "file": "oid.h",
            "line": 30,
            "column": 9
          },
          "value": "4",
          "comment": "Minimum length (in number of hex characters, i.e. packets of 4 bits) of an oid prefix",
          "group": "oid"
        },
        "git_oid": {
          "kind": "struct",
          "name": "git_oid",
          "referenceName": "git_oid",
          "comment": [
            "Unique identity of any object (commit, tree, blob, tag)."
          ],
          "members": [
            {
              "name": "id",
              "type": "unsigned char[20]",
              "comment": [
                "raw binary formatted id"
              ]
            }
          ],
          "location": {
            "file": "oid.h",
            "line": 33,
            "column": 16
          },
          "group": "oid",
          "returnedBy": [
            "git_blob_id",
            "git_commit_id",
            "git_commit_tree_id",
            "git_commit_parent_id",
            "git_indexer_stream_hash",
            "git_note_oid",
            "git_object_id",
            "git_odb_object_id",
            "git_reflog_entry_id_old",
            "git_reflog_entry_id_new",
            "git_reference_target",
            "git_reference_target_peel",
            "git_submodule_index_id",
            "git_submodule_head_id",
            "git_submodule_wd_id",
            "git_tag_id",
            "git_tag_target_id",
            "git_tree_id",
            "git_tree_entry_id"
          ],
          "parameterTo": [
            "git_blob_lookup",
            "git_blob_lookup_prefix",
            "git_blob_create_fromworkdir",
            "git_blob_create_fromdisk",
            "git_blob_create_fromchunks",
            "git_blob_create_frombuffer",
            "git_commit_lookup",
            "git_commit_lookup_prefix",
            "git_commit_create",
            "git_commit_create_v",
            "git_graph_ahead_behind",
            "git_index_write_tree",
            "git_index_write_tree_to",
            "git_merge_base",
            "git_merge_base_many",
            "git_merge_head_from_fetchhead",
            "git_merge_head_from_oid",
            "git_note_foreach_cb",
            "git_note_next",
            "git_note_read",
            "git_note_create",
            "git_note_remove",
            "git_object_lookup",
            "git_object_lookup_prefix",
            "git_odb_foreach_cb",
            "git_odb_read",
            "git_odb_read_prefix",
            "git_odb_read_header",
            "git_odb_exists",
            "git_odb_write",
            "git_odb_open_rstream",
            "git_odb_hash",
            "git_odb_hashfile",
            "git_oid_fromstr",
            "git_oid_fromstrp",
            "git_oid_fromstrn",
            "git_oid_fromraw",
            "git_oid_fmt",
            "git_oid_nfmt",
            "git_oid_pathfmt",
            "git_oid_allocfmt",
            "git_oid_tostr",
            "git_oid_cpy",
            "git_oid_cmp",
            "git_oid_equal",
            "git_oid_ncmp",
            "git_oid_streq",
            "git_oid_strcmp",
            "git_oid_iszero",
            "git_packbuilder_insert",
            "git_packbuilder_insert_tree",
            "git_packbuilder_insert_commit",
            "git_reflog_append",
            "git_reference_name_to_id",
            "git_reference_create",
            "git_reference_set_target",
            "git_repository_fetchhead_foreach_cb",
            "git_repository_mergehead_foreach_cb",
            "git_repository_hashfile",
            "git_repository_set_head_detached",
            "git_revwalk_push",
            "git_revwalk_hide",
            "git_revwalk_next",
            "git_stash_save",
            "git_stash_cb",
            "git_tag_lookup",
            "git_tag_lookup_prefix",
            "git_tag_create",
            "git_tag_annotation_create",
            "git_tag_create_frombuffer",
            "git_tag_create_lightweight",
            "git_tag_foreach_cb",
            "git_tree_lookup",
            "git_tree_lookup_prefix",
            "git_tree_entry_byoid",
            "git_treebuilder_insert",
            "git_treebuilder_write",
            "git_commit_create_from_oids",
            "git_index_reuc_add",
            "git_reference__alloc"
          ]
        },
        "git_oid_fromstr": {
          "kind": "function",
          "name": "git_oid_fromstr",
          "location": {
            "file": "oid.h",
            "line": 47,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "oid structure the result is written into."
            },
            {
              "name": "str",
              "type": "const char *",
              "direction": "in",
              "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)."
            }
          ],
          "comment": [
            "Parse a hex formatted object id into a git_oid."
          ],
          "group": "oid"
        },
        "git_oid_fromstrp": {
          "kind": "function",
          "name": "git_oid_fromstrp",
          "location": {
            "file": "oid.h",
            "line": 57,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "oid structure the result is written into."
            },
            {
              "name": "str",
              "type": "const char *",
              "direction": "in",
              "comment": "input hex string; must be at least 4 characters\n      long and null-terminated."
            }
          ],
          "comment": [
            "Parse a hex formatted null-terminated string into a git_oid."
          ],
          "group": "oid"
        },
        "git_oid_fromstrn": {
          "kind": "function",
          "name": "git_oid_fromstrn",
          "location": {
            "file": "oid.h",
            "line": 70,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "oid structure the result is written into."
            },
            {
              "name": "str",
              "type": "const char *",
              "direction": "in",
              "comment": "input hex string of at least size `length`"
            },
            {
              "name": "length",
              "type": "size_t",
              "direction": "in",
              "comment": "length of the input string"
            }
          ],
          "comment": [
            "Parse N characters of a hex formatted object id into a git_oid",
            "If N is odd, N-1 characters will be parsed instead.\n The remaining space in the git_oid will be set to zero."
          ],
          "group": "oid"
        },
        "git_oid_fromraw": {
          "kind": "function",
          "name": "git_oid_fromraw",
          "location": {
            "file": "oid.h",
            "line": 78,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "oid structure the result is written into."
            },
            {
              "name": "raw",
              "type": "const unsigned char *",
              "direction": "in",
              "comment": "the raw input bytes to be copied."
            }
          ],
          "comment": [
            "Copy an already raw oid into a git_oid structure."
          ],
          "group": "oid"
        },
        "git_oid_fmt": {
          "kind": "function",
          "name": "git_oid_fmt",
          "location": {
            "file": "oid.h",
            "line": 90,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "out",
              "type": "char *",
              "direction": "in",
              "comment": "output 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). Only the\n\t\toid digits are written; a '\n\\\n0' terminator must be added\n\t\tby the caller if it is required."
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "oid structure to format."
            }
          ],
          "comment": [
            "Format a git_oid into a hex string."
          ],
          "group": "oid"
        },
        "git_oid_nfmt": {
          "kind": "function",
          "name": "git_oid_nfmt",
          "location": {
            "file": "oid.h",
            "line": 101,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "out",
              "type": "char *",
              "direction": "in",
              "comment": "output hex string; you say how many bytes to write.\n\t\tIf the number of bytes is > GIT_OID_HEXSZ, extra bytes\n\t\twill be zeroed; if not, a '\n\\\n0' terminator is NOT added."
            },
            {
              "name": "n",
              "type": "size_t",
              "direction": "in",
              "comment": "number of characters to write into out string"
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "oid structure to format."
            }
          ],
          "comment": [
            "Format a git_oid into a partial hex string."
          ],
          "group": "oid"
        },
        "git_oid_pathfmt": {
          "kind": "function",
          "name": "git_oid_pathfmt",
          "location": {
            "file": "oid.h",
            "line": 116,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "out",
              "type": "char *",
              "direction": "in",
              "comment": "output 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 (41 bytes). Only the\n\t\toid digits are written; a '\n\\\n0' terminator must be added\n\t\tby the caller if it is required."
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "oid structure to format."
            }
          ],
          "comment": [
            "Format a git_oid into a loose-object path string.",
            "The resulting string is \"aa/...\", where \"aa\" is the first two\n hex digits of the oid and \"...\" is the remaining 38 digits."
          ],
          "group": "oid"
        },
        "git_oid_allocfmt": {
          "kind": "function",
          "name": "git_oid_allocfmt",
          "location": {
            "file": "oid.h",
            "line": 125,
            "column": 20
          },
          "returns": {
            "type": "char *",
            "comment": "the c-string; NULL if memory is exhausted. Caller must\n\t\t\tdeallocate the string with git__free()."
          },
          "params": [
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "the oid structure to format"
            }
          ],
          "comment": [
            "Format a git_oid into a newly allocated c-string."
          ],
          "group": "oid"
        },
        "git_oid_tostr": {
          "kind": "function",
          "name": "git_oid_tostr",
          "location": {
            "file": "oid.h",
            "line": 144,
            "column": 20
          },
          "returns": {
            "type": "char *",
            "comment": "the out buffer pointer, assuming no input parameter\n\t\t\terrors, otherwise a pointer to an empty string."
          },
          "params": [
            {
              "name": "out",
              "type": "char *",
              "direction": "in",
              "comment": "the buffer into which the oid string is output."
            },
            {
              "name": "n",
              "type": "size_t",
              "direction": "in",
              "comment": "the size of the out buffer."
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "the oid structure to format."
            }
          ],
          "comment": [
            "Format a git_oid into a buffer as a hex format c-string.",
            "If the buffer is smaller than GIT_OID_HEXSZ+1, then the resulting\n oid c-string will be truncated to n-1 characters (but will still be\n NUL-byte terminated).",
            "If there are any input parameter errors (out == NULL, n == 0, oid ==\n NULL), then a pointer to an empty string is returned, so that the\n return value can always be printed."
          ],
          "group": "oid"
        },
        "git_oid_cpy": {
          "kind": "function",
          "name": "git_oid_cpy",
          "location": {
            "file": "oid.h",
            "line": 152,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "oid structure the result is written into."
            },
            {
              "name": "src",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "oid structure to copy from."
            }
          ],
          "comment": [
            "Copy an oid from one structure to another."
          ],
          "group": "oid"
        },
        "git_oid_cmp": {
          "kind": "function",
          "name": "git_oid_cmp",
          "location": {
            "file": "oid.h",
            "line": 161,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "<\n0, 0, >0 if a \n<\n b, a == b, a > b."
          },
          "params": [
            {
              "name": "a",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "first oid structure."
            },
            {
              "name": "b",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "second oid structure."
            }
          ],
          "comment": [
            "Compare two oid structures."
          ],
          "group": "oid"
        },
        "git_oid_equal": {
          "kind": "function",
          "name": "git_oid_equal",
          "location": {
            "file": "oid.h",
            "line": 170,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "true if equal, false otherwise"
          },
          "params": [
            {
              "name": "a",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "first oid structure."
            },
            {
              "name": "b",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "second oid structure."
            }
          ],
          "comment": [
            "Compare two oid structures for equality"
          ],
          "group": "oid"
        },
        "git_oid_ncmp": {
          "kind": "function",
          "name": "git_oid_ncmp",
          "location": {
            "file": "oid.h",
            "line": 184,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 in case of a match"
          },
          "params": [
            {
              "name": "a",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "first oid structure."
            },
            {
              "name": "b",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "second oid structure."
            },
            {
              "name": "len",
              "type": "size_t",
              "direction": "in",
              "comment": "the number of hex chars to compare"
            }
          ],
          "comment": [
            "Compare the first 'len' hexadecimal characters (packets of 4 bits)\n of two oid structures."
          ],
          "group": "oid"
        },
        "git_oid_streq": {
          "kind": "function",
          "name": "git_oid_streq",
          "location": {
            "file": "oid.h",
            "line": 194,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "GIT_ENOTOID if str is not a valid hex string,\n 0 in case of a match, GIT_ERROR otherwise."
          },
          "params": [
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "oid structure."
            },
            {
              "name": "str",
              "type": "const char *",
              "direction": "in",
              "comment": "input hex string of an object id."
            }
          ],
          "comment": [
            "Check if an oid equals an hex formatted object id."
          ],
          "group": "oid"
        },
        "git_oid_strcmp": {
          "kind": "function",
          "name": "git_oid_strcmp",
          "location": {
            "file": "oid.h",
            "line": 204,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "-1 if str is not valid, \n<\n0 if id sorts before str,\n         0 if id matches str, >0 if id sorts after str."
          },
          "params": [
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "oid structure."
            },
            {
              "name": "str",
              "type": "const char *",
              "direction": "in",
              "comment": "input hex string of an object id."
            }
          ],
          "comment": [
            "Compare an oid to an hex formatted object id."
          ],
          "group": "oid"
        },
        "git_oid_iszero": {
          "kind": "function",
          "name": "git_oid_iszero",
          "location": {
            "file": "oid.h",
            "line": 211,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if all zeros, 0 otherwise."
          },
          "params": [
            {
              "name": "id",
              "type": "const git_oid *"
            }
          ],
          "comment": [
            "Check is an oid is all zeros."
          ],
          "group": "oid"
        },
        "git_oid_shorten": {
          "kind": "struct",
          "name": "git_oid_shorten",
          "referenceName": "struct git_oid_shorten",
          "opaque": true,
          "comment": [
            "OID Shortener object"
          ],
          "location": {
            "file": "oid.h",
            "line": 216,
            "column": 32
          },
          "group": "oid",
          "returnedBy": [
            "git_oid_shorten_new"
          ],
          "parameterTo": [
            "git_oid_shorten_add",
            "git_oid_shorten_free"
          ]
        },
        "git_oid_shorten_new": {
          "kind": "function",
          "name": "git_oid_shorten_new",
          "location": {
            "file": "oid.h",
            "line": 232,
            "column": 31
          },
          "returns": {
            "type": "git_oid_shorten *",
            "comment": "a `git_oid_shorten` instance, NULL if OOM"
          },
          "params": [
            {
              "name": "min_length",
              "type": "size_t",
              "direction": "in",
              "comment": "The minimal length for all identifiers,\n\t\twhich will be used even if shorter OIDs would still\n\t\tbe unique."
            }
          ],
          "comment": [
            "Create a new OID shortener.",
            "The OID shortener is used to process a list of OIDs\n in text form and return the shortest length that would\n uniquely identify all of them.",
            "E.g. look at the result of `git log --abbrev`."
          ],
          "group": "oid"
        },
        "git_oid_shorten_add": {
          "kind": "function",
          "name": "git_oid_shorten_add",
          "location": {
            "file": "oid.h",
            "line": 258,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "the minimal length to uniquely identify all OIDs\n\t\tadded so far to the set; or an error code (\n<\n0) if an\n\t\terror occurs."
          },
          "params": [
            {
              "name": "os",
              "type": "git_oid_shorten *",
              "direction": "in",
              "comment": "a `git_oid_shorten` instance"
            },
            {
              "name": "text_id",
              "type": "const char *",
              "direction": "in",
              "comment": "an OID in text form"
            }
          ],
          "comment": [
            "Add a new OID to set of shortened OIDs and calculate\n the minimal length to uniquely identify all the OIDs in\n the set.",
            "The OID is expected to be a 40-char hexadecimal string.\n The OID is owned by the user and will not be modified\n or freed.",
            "For performance reasons, there is a hard-limit of how many\n OIDs can be added to a single set (around ~22000, assuming\n a mostly randomized distribution), which should be enough\n for any kind of program, and keeps the algorithm fast and\n memory-efficient.",
            "Attempting to add more than those OIDs will result in a\n GIT_ENOMEM error"
          ],
          "group": "oid"
        },
        "git_oid_shorten_free": {
          "kind": "function",
          "name": "git_oid_shorten_free",
          "location": {
            "file": "oid.h",
            "line": 265,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "os",
              "type": "git_oid_shorten *",
              "direction": "in",
              "comment": "a `git_oid_shorten` instance"
            }
          ],
          "comment": [
            "Free an OID shortener instance"
          ],
          "group": "oid"
        }
      },
      "info": {
        "summary": "Git object id routines"
      }
    },
    "pack": {
      "apis": {
        "git_packbuilder_new": {
          "kind": "function",
          "name": "git_packbuilder_new",
          "location": {
            "file": "pack.h",
            "line": 56,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_packbuilder **",
              "direction": "in",
              "comment": "The new packbuilder object"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repository"
            }
          ],
          "comment": [
            "Initialize a new packbuilder"
          ],
          "group": "pack"
        },
        "git_packbuilder_set_threads": {
          "kind": "function",
          "name": "git_packbuilder_set_threads",
          "location": {
            "file": "pack.h",
            "line": 69,
            "column": 26
          },
          "returns": {
            "type": "unsigned int",
            "comment": "number of actual threads to be used"
          },
          "params": [
            {
              "name": "pb",
              "type": "git_packbuilder *",
              "direction": "in",
              "comment": "The packbuilder"
            },
            {
              "name": "n",
              "type": "unsigned int",
              "direction": "in",
              "comment": "Number of threads to spawn"
            }
          ],
          "comment": [
            "Set number of threads to spawn",
            "By default, libgit2 won't spawn any threads at all;\n when set to 0, libgit2 will autodetect the number of\n CPUs."
          ],
          "group": "pack"
        },
        "git_packbuilder_insert": {
          "kind": "function",
          "name": "git_packbuilder_insert",
          "location": {
            "file": "pack.h",
            "line": 83,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "pb",
              "type": "git_packbuilder *",
              "direction": "in",
              "comment": "The packbuilder"
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "The oid of the commit"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "The name; might be NULL"
            }
          ],
          "comment": [
            "Insert a single object",
            "For an optimal pack it's mandatory to insert objects in recency order,\n commits followed by trees and blobs."
          ],
          "group": "pack"
        },
        "git_packbuilder_insert_tree": {
          "kind": "function",
          "name": "git_packbuilder_insert_tree",
          "location": {
            "file": "pack.h",
            "line": 95,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "pb",
              "type": "git_packbuilder *",
              "direction": "in",
              "comment": "The packbuilder"
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "The oid of the root tree"
            }
          ],
          "comment": [
            "Insert a root tree object",
            "This will add the tree as well as all referenced trees and blobs."
          ],
          "group": "pack"
        },
        "git_packbuilder_insert_commit": {
          "kind": "function",
          "name": "git_packbuilder_insert_commit",
          "location": {
            "file": "pack.h",
            "line": 107,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "pb",
              "type": "git_packbuilder *",
              "direction": "in",
              "comment": "The packbuilder"
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "The oid of the commit"
            }
          ],
          "comment": [
            "Insert a commit object",
            "This will add a commit as well as the completed referenced tree."
          ],
          "group": "pack"
        },
        "git_packbuilder_write": {
          "kind": "function",
          "name": "git_packbuilder_write",
          "location": {
            "file": "pack.h",
            "line": 119,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "pb",
              "type": "git_packbuilder *",
              "direction": "in",
              "comment": "The packbuilder"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "to the directory where the packfile and index should be stored"
            },
            {
              "name": "progress_cb",
              "type": "git_transfer_progress_callback",
              "direction": "in",
              "comment": "function to call with progress information from the indexer (optional)",
              "referenceType": "int (*)(const git_transfer_progress *, void *)"
            },
            {
              "name": "progress_cb_payload",
              "type": "void *",
              "direction": "in",
              "comment": "payload for the progress callback (optional)"
            }
          ],
          "comment": [
            "Write the new pack and corresponding index file to path."
          ],
          "group": "pack"
        },
        "git_packbuilder_foreach_cb": {
          "kind": "callback",
          "name": "git_packbuilder_foreach_cb",
          "type": "int (*)(void *, size_t, void *)",
          "location": {
            "file": "pack.h",
            "line": 125,
            "column": 15
          },
          "params": [
            {
              "type": "void *"
            },
            {
              "type": "size_t"
            },
            {
              "type": "void *"
            }
          ],
          "group": "pack",
          "parameterTo": [
            "git_packbuilder_foreach"
          ],
          "typedef": true
        },
        "git_packbuilder_foreach": {
          "kind": "function",
          "name": "git_packbuilder_foreach",
          "location": {
            "file": "pack.h",
            "line": 134,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "pb",
              "type": "git_packbuilder *",
              "direction": "in",
              "comment": "the packbuilder"
            },
            {
              "name": "cb",
              "type": "git_packbuilder_foreach_cb",
              "direction": "in",
              "comment": "the callback to call with each packed object's buffer",
              "referenceType": "int (*)(void *, size_t, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "the callback's data"
            }
          ],
          "comment": [
            "Create the new pack and pass each object to the callback"
          ],
          "group": "pack"
        },
        "git_packbuilder_object_count": {
          "kind": "function",
          "name": "git_packbuilder_object_count",
          "location": {
            "file": "pack.h",
            "line": 142,
            "column": 22
          },
          "returns": {
            "type": "uint32_t",
            "comment": ""
          },
          "params": [
            {
              "name": "pb",
              "type": "git_packbuilder *",
              "direction": "in",
              "comment": "the packbuilder"
            }
          ],
          "comment": [
            "Get the total number of objects the packbuilder will write out"
          ],
          "group": "pack"
        },
        "git_packbuilder_written": {
          "kind": "function",
          "name": "git_packbuilder_written",
          "location": {
            "file": "pack.h",
            "line": 150,
            "column": 22
          },
          "returns": {
            "type": "uint32_t",
            "comment": ""
          },
          "params": [
            {
              "name": "pb",
              "type": "git_packbuilder *",
              "direction": "in",
              "comment": "the packbuilder"
            }
          ],
          "comment": [
            "Get the number of objects the packbuilder has already written out"
          ],
          "group": "pack"
        },
        "git_packbuilder_free": {
          "kind": "function",
          "name": "git_packbuilder_free",
          "location": {
            "file": "pack.h",
            "line": 157,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "pb",
              "type": "git_packbuilder *",
              "direction": "in",
              "comment": "The packbuilder"
            }
          ],
          "comment": [
            "Free the packbuilder and all associated data"
          ],
          "group": "pack"
        },
        "git_packbuilder": {
          "kind": "struct",
          "name": "git_packbuilder",
          "referenceName": "struct git_packbuilder",
          "opaque": true,
          "comment": [
            "Representation of a git packbuilder"
          ],
          "location": {
            "file": "types.h",
            "line": 153,
            "column": 32
          },
          "group": "pack",
          "parameterTo": [
            "git_packbuilder_new",
            "git_packbuilder_set_threads",
            "git_packbuilder_insert",
            "git_packbuilder_insert_tree",
            "git_packbuilder_insert_commit",
            "git_packbuilder_write",
            "git_packbuilder_foreach",
            "git_packbuilder_object_count",
            "git_packbuilder_written",
            "git_packbuilder_free"
          ]
        }
      },
      "info": {
        "summary": "Git pack management routines",
        "details": "Packing objects\n---------------\nCreation of packfiles requires two steps:\n- First, insert all the objects you want to put into the packfile\nusing `git_packbuilder_insert` and `git_packbuilder_insert_tree`.\nIt's important to add the objects in recency order (\"in the order\nthat they are 'reachable' from head\").\n\"ANY order will give you a working pack, ... [but it is] the thing\nthat gives packs good locality. It keeps the objects close to the\nhead (whether they are old or new, but they are _reachable_ from the\nhead) at the head of the pack. So packs actually have absolutely\n_wonderful_ IO patterns.\" - Linus Torvalds\ngit.git/Documentation/technical/pack-heuristics.txt\n- Second, use `git_packbuilder_write` or `git_packbuilder_foreach` to\nwrite the resulting packfile.\nlibgit2 will take care of the delta ordering and generation.\n`git_packbuilder_set_threads` can be used to adjust the number of\nthreads used for the process.\nSee tests-clar/pack/packbuilder.c for an example."
      }
    },
    "push": {
      "apis": {
        "git_push_options": {
          "kind": "struct",
          "name": "git_push_options",
          "referenceName": "git_push_options",
          "comment": [
            "Controls the behavior of a git_push object."
          ],
          "members": [
            {
              "name": "version",
              "type": "unsigned int"
            },
            {
              "name": "pb_parallelism",
              "type": "unsigned int",
              "comment": [
                "If the transport being used to push to the remote requires the creation\n of a pack file, this controls the number of worker threads used by\n the packbuilder when creating that pack file to be sent to the remote.",
                "If set to 0, the packbuilder will auto-detect the number of threads\n to create. The default value is 1."
              ]
            }
          ],
          "location": {
            "file": "push.h",
            "line": 24,
            "column": 9
          },
          "group": "push",
          "parameterTo": [
            "git_push_set_options"
          ]
        },
        "GIT_PUSH_OPTIONS_VERSION": {
          "kind": "macro",
          "name": "GIT_PUSH_OPTIONS_VERSION",
          "location": {
            "file": "push.h",
            "line": 38,
            "column": 9
          },
          "value": "1",
          "comment": "",
          "group": "push"
        },
        "GIT_PUSH_OPTIONS_INIT": {
          "kind": "macro",
          "name": "GIT_PUSH_OPTIONS_INIT",
          "location": {
            "file": "push.h",
            "line": 39,
            "column": 9
          },
          "value": "{ GIT_PUSH_OPTIONS_VERSION }",
          "comment": "",
          "group": "push"
        },
        "git_push_new": {
          "kind": "function",
          "name": "git_push_new",
          "location": {
            "file": "push.h",
            "line": 49,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_push **",
              "direction": "in",
              "comment": "New push object"
            },
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "Remote instance"
            }
          ],
          "comment": [
            "Create a new push object"
          ],
          "group": "push"
        },
        "git_push_set_options": {
          "kind": "function",
          "name": "git_push_set_options",
          "location": {
            "file": "push.h",
            "line": 59,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "push",
              "type": "git_push *",
              "direction": "in",
              "comment": "The push object"
            },
            {
              "name": "opts",
              "type": "const git_push_options *",
              "direction": "in",
              "comment": "The options to set on the push object"
            }
          ],
          "comment": [
            "Set options on a push object"
          ],
          "group": "push"
        },
        "git_push_add_refspec": {
          "kind": "function",
          "name": "git_push_add_refspec",
          "location": {
            "file": "push.h",
            "line": 71,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "push",
              "type": "git_push *",
              "direction": "in",
              "comment": "The push object"
            },
            {
              "name": "refspec",
              "type": "const char *",
              "direction": "in",
              "comment": "Refspec string"
            }
          ],
          "comment": [
            "Add a refspec to be pushed"
          ],
          "group": "push"
        },
        "git_push_update_tips": {
          "kind": "function",
          "name": "git_push_update_tips",
          "location": {
            "file": "push.h",
            "line": 80,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "push",
              "type": "git_push *",
              "direction": "in",
              "comment": "The push object"
            }
          ],
          "comment": [
            "Update remote tips after a push"
          ],
          "group": "push"
        },
        "git_push_finish": {
          "kind": "function",
          "name": "git_push_finish",
          "location": {
            "file": "push.h",
            "line": 94,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "push",
              "type": "git_push *",
              "direction": "in",
              "comment": "The push object"
            }
          ],
          "comment": [
            "Actually push all given refspecs",
            "Note: To check if the push was successful (i.e. all remote references\n have been updated as requested), you need to call both\n `git_push_unpack_ok` and `git_push_status_foreach`. The remote\n repository might have refused to update some or all of the references."
          ],
          "group": "push"
        },
        "git_push_unpack_ok": {
          "kind": "function",
          "name": "git_push_unpack_ok",
          "location": {
            "file": "push.h",
            "line": 103,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "true if equal, false otherwise"
          },
          "params": [
            {
              "name": "push",
              "type": "git_push *",
              "direction": "in",
              "comment": "The push object"
            }
          ],
          "comment": [
            "Check if remote side successfully unpacked"
          ],
          "group": "push"
        },
        "git_push_status_foreach": {
          "kind": "function",
          "name": "git_push_status_foreach",
          "location": {
            "file": "push.h",
            "line": 118,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "push",
              "type": "git_push *",
              "direction": "in",
              "comment": "The push object"
            },
            {
              "name": "cb",
              "type": "int (*)(const char *, const char *, void *)",
              "direction": "in",
              "comment": "The callback to call on each object"
            },
            {
              "name": "data",
              "type": "void *"
            }
          ],
          "comment": [
            "Call callback `cb' on each status",
            "For each of the updated references, we receive a status report in the\n form of `ok refs/heads/master` or `ng refs/heads/master \n<msg>`.\n `msg != NULL` means the reference has not been updated for the given\n reason."
          ],
          "group": "push"
        },
        "git_push_free": {
          "kind": "function",
          "name": "git_push_free",
          "location": {
            "file": "push.h",
            "line": 127,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "push",
              "type": "git_push *",
              "direction": "in",
              "comment": "The push object"
            }
          ],
          "comment": [
            "Free the given push object"
          ],
          "group": "push"
        }
      },
      "info": {
        "summary": "Git push management functions"
      }
    },
    "refdb": {
      "apis": {
        "git_refdb_new": {
          "kind": "function",
          "name": "git_refdb_new",
          "location": {
            "file": "refdb.h",
            "line": 35,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_refdb **",
              "direction": "in",
              "comment": "location to store the database pointer, if opened.\n\t\t\tSet to NULL if the open failed."
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository"
            }
          ],
          "comment": [
            "Create a new reference database with no backends.",
            "Before the Ref DB can be used for read/writing, a custom database\n backend must be manually set using `git_refdb_set_backend()`"
          ],
          "group": "refdb"
        },
        "git_refdb_open": {
          "kind": "function",
          "name": "git_refdb_open",
          "location": {
            "file": "refdb.h",
            "line": 49,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_refdb **",
              "direction": "in",
              "comment": "location to store the database pointer, if opened.\n\t\t\tSet to NULL if the open failed."
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository"
            }
          ],
          "comment": [
            "Create a new reference database and automatically add\n the default backends:",
            "- git_refdb_dir: read and write loose and packed refs\n      from disk, assuming the repository dir as the folder"
          ],
          "group": "refdb"
        },
        "git_refdb_compress": {
          "kind": "function",
          "name": "git_refdb_compress",
          "location": {
            "file": "refdb.h",
            "line": 56,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "refdb",
              "type": "git_refdb *"
            }
          ],
          "comment": [
            "Suggests that the given refdb compress or optimize its references.\n This mechanism is implementation specific.  For on-disk reference\n databases, for example, this may pack all loose references."
          ],
          "group": "refdb"
        },
        "git_refdb_free": {
          "kind": "function",
          "name": "git_refdb_free",
          "location": {
            "file": "refdb.h",
            "line": 63,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "refdb",
              "type": "git_refdb *",
              "direction": "in",
              "comment": "reference database pointer or NULL"
            }
          ],
          "comment": [
            "Close an open reference database."
          ],
          "group": "refdb"
        },
        "git_refdb": {
          "kind": "struct",
          "name": "git_refdb",
          "referenceName": "struct git_refdb",
          "opaque": true,
          "comment": [
            "An open refs database handle."
          ],
          "location": {
            "file": "types.h",
            "line": 96,
            "column": 26
          },
          "group": "refdb",
          "parameterTo": [
            "git_refdb_new",
            "git_refdb_open",
            "git_refdb_compress",
            "git_refdb_free",
            "git_repository_refdb",
            "git_refdb_set_backend",
            "git_repository_set_refdb"
          ]
        }
      },
      "info": {
        "summary": "Git custom refs backend functions"
      }
    },
    "sys/refdb_backend": {
      "apis": {
        "git_reference_iterator": {
          "kind": "struct",
          "name": "git_reference_iterator",
          "referenceName": "struct git_reference_iterator",
          "comment": [
            "Every backend's iterator must have a pointer to itself as the first\n element, so the API can talk to it. You'd define your iterator as",
            "struct my_iterator {\n             git_reference_iterator parent;\n             ...\n     }",
            "and assign `iter->parent.backend` to your `git_refdb_backend`."
          ],
          "members": [
            {
              "name": "db",
              "type": "git_refdb *"
            },
            {
              "name": "next",
              "type": "int (*)(git_reference **, git_reference_iterator *)",
              "comment": [
                "Return the current reference and advance the iterator."
              ]
            },
            {
              "name": "next_name",
              "type": "int (*)(const char **, git_reference_iterator *)",
              "comment": [
                "Return the name of the current reference and advance the iterator"
              ]
            },
            {
              "name": "free",
              "type": "void (*)(git_reference_iterator *)",
              "comment": [
                "Free the iterator"
              ]
            }
          ],
          "location": {
            "file": "sys/refdb_backend.h",
            "line": 35,
            "column": 8
          },
          "group": "sys/refdb_backend",
          "parameterTo": [
            "git_reference_iterator_new",
            "git_reference_iterator_glob_new",
            "git_reference_next",
            "git_reference_next_name",
            "git_reference_iterator_free"
          ]
        },
        "git_refdb_backend": {
          "kind": "struct",
          "name": "git_refdb_backend",
          "referenceName": "struct git_refdb_backend",
          "comment": [
            "An instance for a custom backend"
          ],
          "members": [
            {
              "name": "version",
              "type": "unsigned int"
            },
            {
              "name": "exists",
              "type": "int (*)(int *, git_refdb_backend *, const char *)",
              "comment": [
                "Queries the refdb backend to determine if the given ref_name\n exists.  A refdb implementation must provide this function."
              ]
            },
            {
              "name": "lookup",
              "type": "int (*)(git_reference **, git_refdb_backend *, const char *)",
              "comment": [
                "Queries the refdb backend for a given reference.  A refdb\n implementation must provide this function."
              ]
            },
            {
              "name": "iterator",
              "type": "int (*)(git_reference_iterator **, struct git_refdb_backend *, const char *)",
              "comment": [
                "Allocate an iterator object for the backend.",
                "A refdb implementation must provide this function."
              ]
            },
            {
              "name": "write",
              "type": "int (*)(git_refdb_backend *, const git_reference *, int)"
            },
            {
              "name": "rename",
              "type": "int (*)(git_reference **, git_refdb_backend *, const char *, const char *, int)"
            },
            {
              "name": "delete",
              "type": "int (*)(git_refdb_backend *, const char *)",
              "comment": [
                "Deletes the given reference from the refdb.  A refdb implementation\n must provide this function."
              ]
            },
            {
              "name": "compress",
              "type": "int (*)(git_refdb_backend *)",
              "comment": [
                "Suggests that the given refdb compress or optimize its references.\n This mechanism is implementation specific.  (For on-disk reference\n databases, this may pack all loose references.)    A refdb\n implementation may provide this function; if it is not provided,\n nothing will be done."
              ]
            },
            {
              "name": "free",
              "type": "void (*)(git_refdb_backend *)",
              "comment": [
                "Frees any resources held by the refdb.  A refdb implementation may\n provide this function; if it is not provided, nothing will be done."
              ]
            }
          ],
          "location": {
            "file": "sys/refdb_backend.h",
            "line": 60,
            "column": 8
          },
          "group": "sys/refdb_backend",
          "parameterTo": [
            "git_refdb_backend_fs",
            "git_refdb_set_backend"
          ]
        },
        "GIT_ODB_BACKEND_VERSION": {
          "kind": "macro",
          "name": "GIT_ODB_BACKEND_VERSION",
          "location": {
            "file": "sys/refdb_backend.h",
            "line": 124,
            "column": 9
          },
          "value": "1",
          "comment": "",
          "group": "sys/refdb_backend"
        },
        "GIT_ODB_BACKEND_INIT": {
          "kind": "macro",
          "name": "GIT_ODB_BACKEND_INIT",
          "location": {
            "file": "sys/refdb_backend.h",
            "line": 125,
            "column": 9
          },
          "value": "{GIT_ODB_BACKEND_VERSION}",
          "comment": "",
          "group": "sys/refdb_backend"
        },
        "git_refdb_backend_fs": {
          "kind": "function",
          "name": "git_refdb_backend_fs",
          "location": {
            "file": "sys/refdb_backend.h",
            "line": 138,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, \n<\n0 error code on failure"
          },
          "params": [
            {
              "name": "backend_out",
              "type": "git_refdb_backend **",
              "direction": "in",
              "comment": "Output pointer to the git_refdb_backend object"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Git repository to access"
            }
          ],
          "comment": [
            "Constructors for default filesystem-based refdb backend",
            "Under normal usage, this is called for you when the repository is\n opened / created, but you can use this to explicitly construct a\n filesystem refdb backend for a repository."
          ],
          "group": "sys/refdb_backend"
        },
        "git_refdb_set_backend": {
          "kind": "function",
          "name": "git_refdb_set_backend",
          "location": {
            "file": "sys/refdb_backend.h",
            "line": 152,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success; error code otherwise"
          },
          "params": [
            {
              "name": "refdb",
              "type": "git_refdb *",
              "direction": "in",
              "comment": "database to add the backend to"
            },
            {
              "name": "backend",
              "type": "git_refdb_backend *",
              "direction": "in",
              "comment": "pointer to a git_refdb_backend instance"
            }
          ],
          "comment": [
            "Sets the custom backend to an existing reference DB",
            "The `git_refdb` will take ownership of the `git_refdb_backend` so you\n should NOT free it after calling this function."
          ],
          "group": "sys/refdb_backend"
        }
      },
      "info": {
        "summary": "Git custom refs backend functions"
      }
    },
    "reflog": {
      "apis": {
        "git_reflog_read": {
          "kind": "function",
          "name": "git_reflog_read",
          "location": {
            "file": "reflog.h",
            "line": 37,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_reflog **",
              "direction": "in",
              "comment": "pointer to reflog"
            },
            {
              "name": "ref",
              "type": "const git_reference *",
              "direction": "in",
              "comment": "reference to read the reflog for"
            }
          ],
          "comment": [
            "Read the reflog for the given reference",
            "If there is no reflog file for the given\n reference yet, an empty reflog object will\n be returned.",
            "The reflog must be freed manually by using\n git_reflog_free()."
          ],
          "group": "reflog"
        },
        "git_reflog_write": {
          "kind": "function",
          "name": "git_reflog_write",
          "location": {
            "file": "reflog.h",
            "line": 46,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "reflog",
              "type": "git_reflog *",
              "direction": "in",
              "comment": "an existing reflog object"
            }
          ],
          "comment": [
            "Write an existing in-memory reflog object back to disk\n using an atomic file lock."
          ],
          "group": "reflog"
        },
        "git_reflog_append": {
          "kind": "function",
          "name": "git_reflog_append",
          "location": {
            "file": "reflog.h",
            "line": 59,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "reflog",
              "type": "git_reflog *",
              "direction": "in",
              "comment": "an existing reflog object"
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "the OID the reference is now pointing to"
            },
            {
              "name": "committer",
              "type": "const git_signature *",
              "direction": "in",
              "comment": "the signature of the committer"
            },
            {
              "name": "msg",
              "type": "const char *",
              "direction": "in",
              "comment": "the reflog message"
            }
          ],
          "comment": [
            "Add a new entry to the reflog.",
            "`msg` is optional and can be NULL."
          ],
          "group": "reflog"
        },
        "git_reflog_rename": {
          "kind": "function",
          "name": "git_reflog_rename",
          "location": {
            "file": "reflog.h",
            "line": 73,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EINVALIDSPEC or an error code"
          },
          "params": [
            {
              "name": "ref",
              "type": "git_reference *",
              "direction": "in",
              "comment": "the reference"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the new name of the reference"
            }
          ],
          "comment": [
            "Rename the reflog for the given reference",
            "The reflog to be renamed is expected to already exist",
            "The new name will be checked for validity.\n See `git_reference_create_symbolic()` for rules about valid names."
          ],
          "group": "reflog"
        },
        "git_reflog_delete": {
          "kind": "function",
          "name": "git_reflog_delete",
          "location": {
            "file": "reflog.h",
            "line": 81,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "ref",
              "type": "git_reference *",
              "direction": "in",
              "comment": "the reference"
            }
          ],
          "comment": [
            "Delete the reflog for the given reference"
          ],
          "group": "reflog"
        },
        "git_reflog_entrycount": {
          "kind": "function",
          "name": "git_reflog_entrycount",
          "location": {
            "file": "reflog.h",
            "line": 89,
            "column": 20
          },
          "returns": {
            "type": "size_t",
            "comment": "the number of log entries"
          },
          "params": [
            {
              "name": "reflog",
              "type": "git_reflog *",
              "direction": "in",
              "comment": "the previously loaded reflog"
            }
          ],
          "comment": [
            "Get the number of log entries in a reflog"
          ],
          "group": "reflog"
        },
        "git_reflog_entry_byindex": {
          "kind": "function",
          "name": "git_reflog_entry_byindex",
          "location": {
            "file": "reflog.h",
            "line": 102,
            "column": 38
          },
          "returns": {
            "type": "const git_reflog_entry *",
            "comment": "the entry; NULL if not found"
          },
          "params": [
            {
              "name": "reflog",
              "type": "git_reflog *",
              "direction": "in",
              "comment": "a previously loaded reflog"
            },
            {
              "name": "idx",
              "type": "size_t",
              "direction": "in",
              "comment": "the position of the entry to lookup. Should be greater than or\n equal to 0 (zero) and less than `git_reflog_entrycount()`."
            }
          ],
          "comment": [
            "Lookup an entry by its index",
            "Requesting the reflog entry with an index of 0 (zero) will\n return the most recently created entry."
          ],
          "group": "reflog"
        },
        "git_reflog_drop": {
          "kind": "function",
          "name": "git_reflog_drop",
          "location": {
            "file": "reflog.h",
            "line": 121,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_ENOTFOUND if the entry doesn't exist\n or an error code."
          },
          "params": [
            {
              "name": "reflog",
              "type": "git_reflog *",
              "direction": "in",
              "comment": "a previously loaded reflog."
            },
            {
              "name": "idx",
              "type": "size_t",
              "direction": "in",
              "comment": "the position of the entry to remove. Should be greater than or\n equal to 0 (zero) and less than `git_reflog_entrycount()`."
            },
            {
              "name": "rewrite_previous_entry",
              "type": "int",
              "direction": "in",
              "comment": "1 to rewrite the history; 0 otherwise."
            }
          ],
          "comment": [
            "Remove an entry from the reflog by its index",
            "To ensure there's no gap in the log history, set `rewrite_previous_entry`\n param value to 1. When deleting entry `n`, member old_oid of entry `n-1`\n (if any) will be updated with the value of member new_oid of entry `n+1`."
          ],
          "group": "reflog"
        },
        "git_reflog_entry_id_old": {
          "kind": "function",
          "name": "git_reflog_entry_id_old",
          "location": {
            "file": "reflog.h",
            "line": 132,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "the old oid"
          },
          "params": [
            {
              "name": "entry",
              "type": "const git_reflog_entry *",
              "direction": "in",
              "comment": "a reflog entry"
            }
          ],
          "comment": [
            "Get the old oid"
          ],
          "group": "reflog"
        },
        "git_reflog_entry_id_new": {
          "kind": "function",
          "name": "git_reflog_entry_id_new",
          "location": {
            "file": "reflog.h",
            "line": 140,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "the new oid at this time"
          },
          "params": [
            {
              "name": "entry",
              "type": "const git_reflog_entry *",
              "direction": "in",
              "comment": "a reflog entry"
            }
          ],
          "comment": [
            "Get the new oid"
          ],
          "group": "reflog"
        },
        "git_reflog_entry_committer": {
          "kind": "function",
          "name": "git_reflog_entry_committer",
          "location": {
            "file": "reflog.h",
            "line": 148,
            "column": 35
          },
          "returns": {
            "type": "const git_signature *",
            "comment": "the committer"
          },
          "params": [
            {
              "name": "entry",
              "type": "const git_reflog_entry *",
              "direction": "in",
              "comment": "a reflog entry"
            }
          ],
          "comment": [
            "Get the committer of this entry"
          ],
          "group": "reflog"
        },
        "git_reflog_entry_message": {
          "kind": "function",
          "name": "git_reflog_entry_message",
          "location": {
            "file": "reflog.h",
            "line": 156,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "the log msg"
          },
          "params": [
            {
              "name": "entry",
              "type": "const git_reflog_entry *",
              "direction": "in",
              "comment": "a reflog entry"
            }
          ],
          "comment": [
            "Get the log message"
          ],
          "group": "reflog"
        },
        "git_reflog_free": {
          "kind": "function",
          "name": "git_reflog_free",
          "location": {
            "file": "reflog.h",
            "line": 163,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "reflog",
              "type": "git_reflog *",
              "direction": "in",
              "comment": "reflog to free"
            }
          ],
          "comment": [
            "Free the reflog"
          ],
          "group": "reflog"
        },
        "git_reflog_entry": {
          "kind": "struct",
          "name": "git_reflog_entry",
          "referenceName": "struct git_reflog_entry",
          "opaque": true,
          "comment": [
            "Representation of a reference log entry"
          ],
          "location": {
            "file": "types.h",
            "line": 144,
            "column": 33
          },
          "group": "reflog",
          "returnedBy": [
            "git_reflog_entry_byindex"
          ],
          "parameterTo": [
            "git_reflog_entry_id_old",
            "git_reflog_entry_id_new",
            "git_reflog_entry_committer",
            "git_reflog_entry_message"
          ]
        },
        "git_reflog": {
          "kind": "struct",
          "name": "git_reflog",
          "referenceName": "struct git_reflog",
          "opaque": true,
          "comment": [
            "Representation of a reference log"
          ],
          "location": {
            "file": "types.h",
            "line": 147,
            "column": 27
          },
          "group": "reflog",
          "parameterTo": [
            "git_reflog_read",
            "git_reflog_write",
            "git_reflog_append",
            "git_reflog_entrycount",
            "git_reflog_entry_byindex",
            "git_reflog_drop",
            "git_reflog_free"
          ]
        }
      },
      "info": {
        "summary": "Git reflog management routines"
      }
    },
    "refs": {
      "apis": {
        "git_reference_lookup": {
          "kind": "function",
          "name": "git_reference_lookup",
          "location": {
            "file": "refs.h",
            "line": 37,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, ENOTFOUND, EINVALIDSPEC or an error code."
          },
          "params": [
            {
              "name": "out",
              "type": "git_reference **",
              "direction": "in",
              "comment": "pointer to the looked-up reference"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository to look up the reference"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the long name for the reference (e.g. HEAD, refs/heads/master, refs/tags/v0.1.0, ...)"
            }
          ],
          "comment": [
            "Lookup a reference by name in a repository.",
            "The returned reference must be freed by the user.",
            "The name will be checked for validity.\n See `git_reference_create_symbolic()` for rules about valid names."
          ],
          "group": "refs"
        },
        "git_reference_name_to_id": {
          "kind": "function",
          "name": "git_reference_name_to_id",
          "location": {
            "file": "refs.h",
            "line": 54,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, ENOTFOUND, EINVALIDSPEC or an error code."
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "Pointer to oid to be filled in"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repository in which to look up the reference"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "The long name for the reference (e.g. HEAD, refs/heads/master, refs/tags/v0.1.0, ...)"
            }
          ],
          "comment": [
            "Lookup a reference by name and resolve immediately to OID.",
            "This function provides a quick way to resolve a reference name straight\n through to the object id that it refers to.  This avoids having to\n allocate or free any `git_reference` objects for simple situations.",
            "The name will be checked for validity.\n See `git_reference_symbolic_create()` for rules about valid names."
          ],
          "group": "refs"
        },
        "git_reference_dwim": {
          "kind": "function",
          "name": "git_reference_dwim",
          "location": {
            "file": "refs.h",
            "line": 68,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_reference **",
              "direction": "in",
              "comment": "pointer in which to store the reference"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository in which to look"
            },
            {
              "name": "shorthand",
              "type": "const char *",
              "direction": "in",
              "comment": "the short name for the reference"
            }
          ],
          "comment": [
            "Lookup a reference by DWIMing its short name",
            "Apply the git precendence rules to the given shorthand to determine\n which reference the user is refering to."
          ],
          "group": "refs"
        },
        "git_reference_symbolic_create": {
          "kind": "function",
          "name": "git_reference_symbolic_create",
          "location": {
            "file": "refs.h",
            "line": 99,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, EEXISTS, EINVALIDSPEC or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_reference **",
              "direction": "in",
              "comment": "Pointer to the newly created reference"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where that reference will live"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "The name of the reference"
            },
            {
              "name": "target",
              "type": "const char *",
              "direction": "in",
              "comment": "The target of the reference"
            },
            {
              "name": "force",
              "type": "int",
              "direction": "in",
              "comment": "Overwrite existing references"
            }
          ],
          "comment": [
            "Create a new symbolic reference.",
            "A symbolic reference is a reference name that refers to another\n reference name.  If the other name moves, the symbolic name will move,\n too.  As a simple example, the \"HEAD\" reference might refer to\n \"refs/heads/master\" while on the \"master\" branch of a repository.",
            "The symbolic reference will be created in the repository and written to\n the disk.  The generated reference object must be freed by the user.",
            "Valid reference names must follow one of two patterns:",
            "1. Top-level names must contain only capital letters and underscores,\n    and must begin and end with a letter. (e.g. \"HEAD\", \"ORIG_HEAD\").\n 2. Names prefixed with \"refs/\" can be almost anything.  You must avoid\n    the characters '~', '^', ':', '\n\\\n', '?', '[', and '*', and the\n    sequences \"..\" and \"@{\" which have special meaning to revparse.",
            "This function will return an error if a reference already exists with the\n given name unless `force` is true, in which case it will be overwritten."
          ],
          "group": "refs"
        },
        "git_reference_create": {
          "kind": "function",
          "name": "git_reference_create",
          "location": {
            "file": "refs.h",
            "line": 131,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, EEXISTS, EINVALIDSPEC or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_reference **",
              "direction": "in",
              "comment": "Pointer to the newly created reference"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where that reference will live"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "The name of the reference"
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "The object id pointed to by the reference."
            },
            {
              "name": "force",
              "type": "int",
              "direction": "in",
              "comment": "Overwrite existing references"
            }
          ],
          "comment": [
            "Create a new direct reference.",
            "A direct reference (also called an object id reference) refers directly\n to a specific object id (a.k.a. OID or SHA) in the repository.  The id\n permanently refers to the object (although the reference itself can be\n moved).  For example, in libgit2 the direct ref \"refs/tags/v0.17.0\"\n refers to OID 5b9fac39d8a76b9139667c26a63e6b3f204b3977.",
            "The direct reference will be created in the repository and written to\n the disk.  The generated reference object must be freed by the user.",
            "Valid reference names must follow one of two patterns:",
            "1. Top-level names must contain only capital letters and underscores,\n    and must begin and end with a letter. (e.g. \"HEAD\", \"ORIG_HEAD\").\n 2. Names prefixed with \"refs/\" can be almost anything.  You must avoid\n    the characters '~', '^', ':', '\n\\\n', '?', '[', and '*', and the\n    sequences \"..\" and \"@{\" which have special meaning to revparse.",
            "This function will return an error if a reference already exists with the\n given name unless `force` is true, in which case it will be overwritten."
          ],
          "group": "refs"
        },
        "git_reference_target": {
          "kind": "function",
          "name": "git_reference_target",
          "location": {
            "file": "refs.h",
            "line": 146,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "a pointer to the oid if available, NULL otherwise"
          },
          "params": [
            {
              "name": "ref",
              "type": "const git_reference *",
              "direction": "in",
              "comment": "The reference"
            }
          ],
          "comment": [
            "Get the OID pointed to by a direct reference.",
            "Only available if the reference is direct (i.e. an object id reference,\n not a symbolic one).",
            "To find the OID of a symbolic ref, call `git_reference_resolve()` and\n then this function (or maybe use `git_reference_name_to_id()` to\n directly resolve a reference name all the way through to an OID)."
          ],
          "group": "refs"
        },
        "git_reference_target_peel": {
          "kind": "function",
          "name": "git_reference_target_peel",
          "location": {
            "file": "refs.h",
            "line": 157,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "a pointer to the oid if available, NULL otherwise"
          },
          "params": [
            {
              "name": "ref",
              "type": "const git_reference *",
              "direction": "in",
              "comment": "The reference"
            }
          ],
          "comment": [
            "Return the peeled OID target of this reference.",
            "This peeled OID only applies to direct references that point to\n a hard Tag object: it is the result of peeling such Tag."
          ],
          "group": "refs"
        },
        "git_reference_symbolic_target": {
          "kind": "function",
          "name": "git_reference_symbolic_target",
          "location": {
            "file": "refs.h",
            "line": 167,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "a pointer to the name if available, NULL otherwise"
          },
          "params": [
            {
              "name": "ref",
              "type": "const git_reference *",
              "direction": "in",
              "comment": "The reference"
            }
          ],
          "comment": [
            "Get full name to the reference pointed to by a symbolic reference.",
            "Only available if the reference is symbolic."
          ],
          "group": "refs"
        },
        "git_reference_type": {
          "kind": "function",
          "name": "git_reference_type",
          "location": {
            "file": "refs.h",
            "line": 177,
            "column": 23
          },
          "returns": {
            "type": "git_ref_t",
            "comment": "the type"
          },
          "params": [
            {
              "name": "ref",
              "type": "const git_reference *",
              "direction": "in",
              "comment": "The reference"
            }
          ],
          "comment": [
            "Get the type of a reference.",
            "Either direct (GIT_REF_OID) or symbolic (GIT_REF_SYMBOLIC)"
          ],
          "group": "refs"
        },
        "git_reference_name": {
          "kind": "function",
          "name": "git_reference_name",
          "location": {
            "file": "refs.h",
            "line": 187,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "the full name for the ref"
          },
          "params": [
            {
              "name": "ref",
              "type": "const git_reference *",
              "direction": "in",
              "comment": "The reference"
            }
          ],
          "comment": [
            "Get the full name of a reference.",
            "See `git_reference_create_symbolic()` for rules about valid names."
          ],
          "group": "refs"
        },
        "git_reference_resolve": {
          "kind": "function",
          "name": "git_reference_resolve",
          "location": {
            "file": "refs.h",
            "line": 205,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_reference **",
              "direction": "in",
              "comment": "Pointer to the peeled reference"
            },
            {
              "name": "ref",
              "type": "const git_reference *",
              "direction": "in",
              "comment": "The reference"
            }
          ],
          "comment": [
            "Resolve a symbolic reference to a direct reference.",
            "This method iteratively peels a symbolic reference until it resolves to\n a direct reference to an OID.",
            "The peeled reference is returned in the `resolved_ref` argument, and\n must be freed manually once it's no longer needed.",
            "If a direct reference is passed as an argument, a copy of that\n reference is returned. This copy must be manually freed too."
          ],
          "group": "refs"
        },
        "git_reference_owner": {
          "kind": "function",
          "name": "git_reference_owner",
          "location": {
            "file": "refs.h",
            "line": 213,
            "column": 30
          },
          "returns": {
            "type": "git_repository *",
            "comment": "a pointer to the repo"
          },
          "params": [
            {
              "name": "ref",
              "type": "const git_reference *",
              "direction": "in",
              "comment": "The reference"
            }
          ],
          "comment": [
            "Get the repository where a reference resides."
          ],
          "group": "refs"
        },
        "git_reference_symbolic_set_target": {
          "kind": "function",
          "name": "git_reference_symbolic_set_target",
          "location": {
            "file": "refs.h",
            "line": 230,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, EINVALIDSPEC or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_reference **",
              "direction": "in",
              "comment": "Pointer to the newly created reference"
            },
            {
              "name": "ref",
              "type": "git_reference *",
              "direction": "in",
              "comment": "The reference"
            },
            {
              "name": "target",
              "type": "const char *",
              "direction": "in",
              "comment": "The new target for the reference"
            }
          ],
          "comment": [
            "Create a new reference with the same name as the given reference but a\n different symbolic target. The reference must be a symbolic reference,\n otherwise this will fail.",
            "The new reference will be written to disk, overwriting the given reference.",
            "The target name will be checked for validity.\n See `git_reference_create_symbolic()` for rules about valid names."
          ],
          "group": "refs"
        },
        "git_reference_set_target": {
          "kind": "function",
          "name": "git_reference_set_target",
          "location": {
            "file": "refs.h",
            "line": 247,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_reference **",
              "direction": "in",
              "comment": "Pointer to the newly created reference"
            },
            {
              "name": "ref",
              "type": "git_reference *",
              "direction": "in",
              "comment": "The reference"
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "The new target OID for the reference"
            }
          ],
          "comment": [
            "Create a new reference with the same name as the given reference but a\n different OID target. The reference must be a direct reference, otherwise\n this will fail.",
            "The new reference will be written to disk, overwriting the given reference."
          ],
          "group": "refs"
        },
        "git_reference_rename": {
          "kind": "function",
          "name": "git_reference_rename",
          "location": {
            "file": "refs.h",
            "line": 274,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, EINVALIDSPEC, EEXISTS or an error code"
          },
          "params": [
            {
              "name": "new_ref",
              "type": "git_reference **"
            },
            {
              "name": "ref",
              "type": "git_reference *",
              "direction": "in",
              "comment": "The reference to rename"
            },
            {
              "name": "new_name",
              "type": "const char *",
              "direction": "in",
              "comment": "The new name for the reference"
            },
            {
              "name": "force",
              "type": "int",
              "direction": "in",
              "comment": "Overwrite an existing reference"
            }
          ],
          "comment": [
            "Rename an existing reference.",
            "This method works for both direct and symbolic references.",
            "The new name will be checked for validity.\n See `git_reference_create_symbolic()` for rules about valid names.",
            "If the `force` flag is not enabled, and there's already\n a reference with the given name, the renaming will fail.",
            "IMPORTANT:\n The user needs to write a proper reflog entry if the\n reflog is enabled for the repository. We only rename\n the reflog if it exists."
          ],
          "group": "refs"
        },
        "git_reference_delete": {
          "kind": "function",
          "name": "git_reference_delete",
          "location": {
            "file": "refs.h",
            "line": 290,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "ref",
              "type": "git_reference *",
              "direction": "in",
              "comment": "The reference to remove"
            }
          ],
          "comment": [
            "Delete an existing reference.",
            "This method works for both direct and symbolic references.  The reference\n will be immediately removed on disk but the memory will not be freed.\n Callers must call `git_reference_free`."
          ],
          "group": "refs"
        },
        "git_reference_list": {
          "kind": "function",
          "name": "git_reference_list",
          "location": {
            "file": "refs.h",
            "line": 304,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "array",
              "type": "git_strarray *",
              "direction": "in",
              "comment": "Pointer to a git_strarray structure where\n\t\tthe reference names will be stored"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where to find the refs"
            }
          ],
          "comment": [
            "Fill a list with all the references that can be found in a repository.",
            "The string array will be filled with the names of all references; these\n values are owned by the user and should be free'd manually when no\n longer needed, using `git_strarray_free()`."
          ],
          "group": "refs"
        },
        "git_reference_foreach_cb": {
          "kind": "callback",
          "name": "git_reference_foreach_cb",
          "type": "int (*)(git_reference *, void *)",
          "location": {
            "file": "refs.h",
            "line": 306,
            "column": 15
          },
          "params": [
            {
              "type": "git_reference *"
            },
            {
              "type": "void *"
            }
          ],
          "group": "refs",
          "parameterTo": [
            "git_reference_foreach"
          ],
          "typedef": true
        },
        "git_reference_foreach_name_cb": {
          "kind": "callback",
          "name": "git_reference_foreach_name_cb",
          "type": "int (*)(const char *, void *)",
          "location": {
            "file": "refs.h",
            "line": 307,
            "column": 15
          },
          "params": [
            {
              "type": "const char *"
            },
            {
              "type": "void *"
            }
          ],
          "group": "refs",
          "parameterTo": [
            "git_reference_foreach_name",
            "git_reference_foreach_glob"
          ],
          "typedef": true
        },
        "git_reference_foreach": {
          "kind": "function",
          "name": "git_reference_foreach",
          "location": {
            "file": "refs.h",
            "line": 322,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where to find the refs"
            },
            {
              "name": "callback",
              "type": "git_reference_foreach_cb",
              "direction": "in",
              "comment": "Function which will be called for every listed ref",
              "referenceType": "int (*)(git_reference *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Additional data to pass to the callback"
            }
          ],
          "comment": [
            "Perform a callback on each reference in the repository.",
            "The `callback` function will be called for each reference in the\n repository, receiving the name of the reference and the `payload` value\n passed to this method.  Returning a non-zero value from the callback\n will terminate the iteration."
          ],
          "group": "refs"
        },
        "git_reference_foreach_name": {
          "kind": "function",
          "name": "git_reference_foreach_name",
          "location": {
            "file": "refs.h",
            "line": 327,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *"
            },
            {
              "name": "callback",
              "type": "git_reference_foreach_name_cb",
              "referenceType": "int (*)(const char *, void *)"
            },
            {
              "name": "payload",
              "type": "void *"
            }
          ],
          "group": "refs"
        },
        "git_reference_free": {
          "kind": "function",
          "name": "git_reference_free",
          "location": {
            "file": "refs.h",
            "line": 337,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "ref",
              "type": "git_reference *",
              "direction": "in",
              "comment": "git_reference"
            }
          ],
          "comment": [
            "Free the given reference."
          ],
          "group": "refs"
        },
        "git_reference_cmp": {
          "kind": "function",
          "name": "git_reference_cmp",
          "location": {
            "file": "refs.h",
            "line": 346,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 if the same, else a stable but meaningless ordering."
          },
          "params": [
            {
              "name": "ref1",
              "type": "git_reference *",
              "direction": "in",
              "comment": "The first git_reference"
            },
            {
              "name": "ref2",
              "type": "git_reference *",
              "direction": "in",
              "comment": "The second git_reference"
            }
          ],
          "comment": [
            "Compare two references."
          ],
          "group": "refs"
        },
        "git_reference_iterator_new": {
          "kind": "function",
          "name": "git_reference_iterator_new",
          "location": {
            "file": "refs.h",
            "line": 355,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_reference_iterator **",
              "direction": "in",
              "comment": "pointer in which to store the iterator"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository"
            }
          ],
          "comment": [
            "Create an iterator for the repo's references"
          ],
          "group": "refs"
        },
        "git_reference_iterator_glob_new": {
          "kind": "function",
          "name": "git_reference_iterator_glob_new",
          "location": {
            "file": "refs.h",
            "line": 368,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_reference_iterator **",
              "direction": "in",
              "comment": "pointer in which to store the iterator"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository"
            },
            {
              "name": "glob",
              "type": "const char *",
              "direction": "in",
              "comment": "the glob to match against the reference names"
            }
          ],
          "comment": [
            "Create an iterator for the repo's references that match the\n specified glob"
          ],
          "group": "refs"
        },
        "git_reference_next": {
          "kind": "function",
          "name": "git_reference_next",
          "location": {
            "file": "refs.h",
            "line": 380,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0, GIT_ITEROVER if there are no more; or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_reference **",
              "direction": "in",
              "comment": "pointer in which to store the reference"
            },
            {
              "name": "iter",
              "type": "git_reference_iterator *",
              "direction": "in",
              "comment": "the iterator"
            }
          ],
          "comment": [
            "Get the next reference"
          ],
          "group": "refs"
        },
        "git_reference_next_name": {
          "kind": "function",
          "name": "git_reference_next_name",
          "location": {
            "file": "refs.h",
            "line": 382,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "out",
              "type": "const char **"
            },
            {
              "name": "iter",
              "type": "git_reference_iterator *"
            }
          ],
          "group": "refs"
        },
        "git_reference_iterator_free": {
          "kind": "function",
          "name": "git_reference_iterator_free",
          "location": {
            "file": "refs.h",
            "line": 389,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "iter",
              "type": "git_reference_iterator *",
              "direction": "in",
              "comment": "the iterator to free"
            }
          ],
          "comment": [
            "Free the iterator and its associated resources"
          ],
          "group": "refs"
        },
        "git_reference_foreach_glob": {
          "kind": "function",
          "name": "git_reference_foreach_glob",
          "location": {
            "file": "refs.h",
            "line": 409,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where to find the refs"
            },
            {
              "name": "glob",
              "type": "const char *",
              "direction": "in",
              "comment": "Pattern to match (fnmatch-style) against reference name."
            },
            {
              "name": "callback",
              "type": "git_reference_foreach_name_cb",
              "direction": "in",
              "comment": "Function which will be called for every listed ref",
              "referenceType": "int (*)(const char *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Additional data to pass to the callback"
            }
          ],
          "comment": [
            "Perform a callback on each reference in the repository whose name\n matches the given pattern.",
            "This function acts like `git_reference_foreach()` with an additional\n pattern match being applied to the reference name before issuing the\n callback function.  See that function for more information.",
            "The pattern is matched using fnmatch or \"glob\" style where a '*' matches\n any sequence of letters, a '?' matches any letter, and square brackets\n can be used to define character ranges (such as \"[0-9]\" for digits)."
          ],
          "group": "refs"
        },
        "git_reference_has_log": {
          "kind": "function",
          "name": "git_reference_has_log",
          "location": {
            "file": "refs.h",
            "line": 423,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 when no reflog can be found, 1 when it exists;\n otherwise an error code."
          },
          "params": [
            {
              "name": "ref",
              "type": "git_reference *",
              "direction": "in",
              "comment": "A git reference"
            }
          ],
          "comment": [
            "Check if a reflog exists for the specified reference."
          ],
          "group": "refs"
        },
        "git_reference_is_branch": {
          "kind": "function",
          "name": "git_reference_is_branch",
          "location": {
            "file": "refs.h",
            "line": 433,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 when the reference lives in the refs/heads\n namespace; 0 otherwise."
          },
          "params": [
            {
              "name": "ref",
              "type": "git_reference *",
              "direction": "in",
              "comment": "A git reference"
            }
          ],
          "comment": [
            "Check if a reference is a local branch."
          ],
          "group": "refs"
        },
        "git_reference_is_remote": {
          "kind": "function",
          "name": "git_reference_is_remote",
          "location": {
            "file": "refs.h",
            "line": 443,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 when the reference lives in the refs/remotes\n namespace; 0 otherwise."
          },
          "params": [
            {
              "name": "ref",
              "type": "git_reference *",
              "direction": "in",
              "comment": "A git reference"
            }
          ],
          "comment": [
            "Check if a reference is a remote tracking branch"
          ],
          "group": "refs"
        },
        "git_reference_normalize_t": {
          "kind": "enum",
          "name": "git_reference_normalize_t",
          "referenceName": "git_reference_normalize_t",
          "members": [
            {
              "name": "GIT_REF_FORMAT_NORMAL",
              "value": "0"
            },
            {
              "name": "GIT_REF_FORMAT_ALLOW_ONELEVEL",
              "value": "1",
              "comment": [
                "Control whether one-level refnames are accepted\n (i.e., refnames that do not contain multiple /-separated\n components). Those are expected to be written only using\n uppercase letters and underscore (FETCH_HEAD, ...)"
              ]
            },
            {
              "name": "GIT_REF_FORMAT_REFSPEC_PATTERN",
              "value": "2",
              "comment": [
                "Interpret the provided name as a reference pattern for a\n refspec (as used with remote repositories). If this option\n is enabled, the name is allowed to contain a single * (\n<star>)\n in place of a one full pathname component\n (e.g., foo/\n<star>/bar but not foo/bar\n<star>)."
              ]
            },
            {
              "name": "GIT_REF_FORMAT_REFSPEC_SHORTHAND",
              "value": "4",
              "comment": [
                "Interpret the name as part of a refspec in shorthand form\n so the `ONELEVEL` naming rules aren't enforced and 'master'\n becomes a valid name."
              ]
            }
          ],
          "location": {
            "file": "refs.h",
            "line": 446,
            "column": 9
          },
          "group": "refs"
        },
        "git_reference_normalize_name": {
          "kind": "function",
          "name": "git_reference_normalize_name",
          "location": {
            "file": "refs.h",
            "line": 494,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EBUFS if buffer is too small, EINVALIDSPEC\n or an error code."
          },
          "params": [
            {
              "name": "buffer_out",
              "type": "char *",
              "direction": "in",
              "comment": "User allocated buffer to store normalized name"
            },
            {
              "name": "buffer_size",
              "type": "size_t",
              "direction": "in",
              "comment": "Size of buffer_out"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "Reference name to be checked."
            },
            {
              "name": "flags",
              "type": "unsigned int",
              "direction": "in",
              "comment": "Flags to constrain name validation rules - see the\n              GIT_REF_FORMAT constants above."
            }
          ],
          "comment": [
            "Normalize reference name and check validity.",
            "This will normalize the reference name by removing any leading slash\n '/' characters and collapsing runs of adjacent slashes between name\n components into a single slash.",
            "Once normalized, if the reference name is valid, it will be returned in\n the user allocated buffer.",
            "See `git_reference_create_symbolic()` for rules about valid names."
          ],
          "group": "refs"
        },
        "git_reference_peel": {
          "kind": "function",
          "name": "git_reference_peel",
          "location": {
            "file": "refs.h",
            "line": 515,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EAMBIGUOUS, GIT_ENOTFOUND or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_object **",
              "direction": "in",
              "comment": "Pointer to the peeled git_object"
            },
            {
              "name": "ref",
              "type": "git_reference *",
              "direction": "in",
              "comment": "The reference to be processed"
            },
            {
              "name": "type",
              "type": "git_otype",
              "direction": "in",
              "comment": "The type of the requested object (GIT_OBJ_COMMIT,\n GIT_OBJ_TAG, GIT_OBJ_TREE, GIT_OBJ_BLOB or GIT_OBJ_ANY).",
              "referenceType": "enum git_otype"
            }
          ],
          "comment": [
            "Recursively peel reference until object of the specified type is found.",
            "The retrieved `peeled` object is owned by the repository\n and should be closed with the `git_object_free` method.",
            "If you pass `GIT_OBJ_ANY` as the target type, then the object\n will be peeled until a non-tag object is met."
          ],
          "group": "refs"
        },
        "git_reference_is_valid_name": {
          "kind": "function",
          "name": "git_reference_is_valid_name",
          "location": {
            "file": "refs.h",
            "line": 534,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if the reference name is acceptable; 0 if it isn't"
          },
          "params": [
            {
              "name": "refname",
              "type": "const char *",
              "direction": "in",
              "comment": "name to be checked."
            }
          ],
          "comment": [
            "Ensure the reference name is well-formed.",
            "Valid reference names must follow one of two patterns:",
            "1. Top-level names must contain only capital letters and underscores,\n    and must begin and end with a letter. (e.g. \"HEAD\", \"ORIG_HEAD\").\n 2. Names prefixed with \"refs/\" can be almost anything.  You must avoid\n    the characters '~', '^', ':', '\n\\\n', '?', '[', and '*', and the\n    sequences \"..\" and \"@{\" which have special meaning to revparse."
          ],
          "group": "refs"
        },
        "git_reference_shorthand": {
          "kind": "function",
          "name": "git_reference_shorthand",
          "location": {
            "file": "refs.h",
            "line": 548,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "the human-readable version of the name"
          },
          "params": [
            {
              "name": "ref",
              "type": "git_reference *",
              "direction": "in",
              "comment": "a reference"
            }
          ],
          "comment": [
            "Get the reference's short name",
            "This will transform the reference name into a name \"human-readable\"\n version. If no shortname is appropriate, it will return the full\n name.",
            "The memory is owned by the reference and must not be freed."
          ],
          "group": "refs"
        },
        "git_reference": {
          "kind": "struct",
          "name": "git_reference",
          "referenceName": "struct git_reference",
          "opaque": true,
          "comment": [
            "In-memory representation of a reference."
          ],
          "location": {
            "file": "types.h",
            "line": 169,
            "column": 30
          },
          "group": "refs",
          "returnedBy": [
            "git_reference__alloc",
            "git_reference__alloc_symbolic"
          ],
          "parameterTo": [
            "git_branch_create",
            "git_branch_delete",
            "git_branch_move",
            "git_branch_lookup",
            "git_branch_name",
            "git_branch_upstream",
            "git_branch_set_upstream",
            "git_branch_is_head",
            "git_merge_head_from_ref",
            "git_reflog_read",
            "git_reflog_rename",
            "git_reflog_delete",
            "git_reference_lookup",
            "git_reference_dwim",
            "git_reference_symbolic_create",
            "git_reference_create",
            "git_reference_target",
            "git_reference_target_peel",
            "git_reference_symbolic_target",
            "git_reference_type",
            "git_reference_name",
            "git_reference_resolve",
            "git_reference_owner",
            "git_reference_symbolic_set_target",
            "git_reference_set_target",
            "git_reference_rename",
            "git_reference_delete",
            "git_reference_foreach_cb",
            "git_reference_free",
            "git_reference_cmp",
            "git_reference_next",
            "git_reference_has_log",
            "git_reference_is_branch",
            "git_reference_is_remote",
            "git_reference_peel",
            "git_reference_shorthand",
            "git_repository_head",
            "git_revparse_ext"
          ]
        }
      },
      "info": {
        "summary": "Git reference management routines"
      }
    },
    "sys/refs": {
      "apis": {
        "git_reference__alloc": {
          "kind": "function",
          "name": "git_reference__alloc",
          "location": {
            "file": "sys/refs.h",
            "line": 22,
            "column": 29
          },
          "returns": {
            "type": "git_reference *",
            "comment": "the created git_reference or NULL on error"
          },
          "params": [
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the reference name"
            },
            {
              "name": "oid",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "the object id for a direct reference"
            },
            {
              "name": "peel",
              "type": "const git_oid *"
            }
          ],
          "comment": [
            "Create a new direct reference from an OID."
          ],
          "group": "sys/refs"
        },
        "git_reference__alloc_symbolic": {
          "kind": "function",
          "name": "git_reference__alloc_symbolic",
          "location": {
            "file": "sys/refs.h",
            "line": 34,
            "column": 29
          },
          "returns": {
            "type": "git_reference *",
            "comment": "the created git_reference or NULL on error"
          },
          "params": [
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the reference name"
            },
            {
              "name": "target",
              "type": "const char *"
            }
          ],
          "comment": [
            "Create a new symbolic reference."
          ],
          "group": "sys/refs"
        }
      },
      "info": {}
    },
    "refspec": {
      "apis": {
        "git_refspec_src": {
          "kind": "function",
          "name": "git_refspec_src",
          "location": {
            "file": "refspec.h",
            "line": 29,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "the refspec's source specifier"
          },
          "params": [
            {
              "name": "refspec",
              "type": "const git_refspec *",
              "direction": "in",
              "comment": "the refspec"
            }
          ],
          "comment": [
            "Get the source specifier"
          ],
          "group": "refspec"
        },
        "git_refspec_dst": {
          "kind": "function",
          "name": "git_refspec_dst",
          "location": {
            "file": "refspec.h",
            "line": 37,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "the refspec's destination specifier"
          },
          "params": [
            {
              "name": "refspec",
              "type": "const git_refspec *",
              "direction": "in",
              "comment": "the refspec"
            }
          ],
          "comment": [
            "Get the destination specifier"
          ],
          "group": "refspec"
        },
        "git_refspec_string": {
          "kind": "function",
          "name": "git_refspec_string",
          "location": {
            "file": "refspec.h",
            "line": 45,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "the refspec's original string"
          },
          "params": [
            {
              "name": "refspec",
              "type": "const git_refspec *",
              "direction": "in",
              "comment": "the refspec"
            }
          ],
          "comment": [
            "Get the refspec's string"
          ],
          "group": "refspec"
        },
        "git_refspec_force": {
          "kind": "function",
          "name": "git_refspec_force",
          "location": {
            "file": "refspec.h",
            "line": 53,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if force update has been set, 0 otherwise"
          },
          "params": [
            {
              "name": "refspec",
              "type": "const git_refspec *",
              "direction": "in",
              "comment": "the refspec"
            }
          ],
          "comment": [
            "Get the force update setting"
          ],
          "group": "refspec"
        },
        "git_refspec_direction": {
          "kind": "function",
          "name": "git_refspec_direction",
          "location": {
            "file": "refspec.h",
            "line": 61,
            "column": 27
          },
          "returns": {
            "type": "git_direction",
            "comment": "GIT_DIRECTION_FETCH or GIT_DIRECTION_PUSH"
          },
          "params": [
            {
              "name": "spec",
              "type": "const git_refspec *",
              "direction": "in",
              "comment": "refspec"
            }
          ],
          "comment": [
            "Get the refspec's direction."
          ],
          "group": "refspec"
        },
        "git_refspec_src_matches": {
          "kind": "function",
          "name": "git_refspec_src_matches",
          "location": {
            "file": "refspec.h",
            "line": 70,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if the refspec matches, 0 otherwise"
          },
          "params": [
            {
              "name": "refspec",
              "type": "const git_refspec *",
              "direction": "in",
              "comment": "the refspec"
            },
            {
              "name": "refname",
              "type": "const char *",
              "direction": "in",
              "comment": "the name of the reference to check"
            }
          ],
          "comment": [
            "Check if a refspec's source descriptor matches a reference"
          ],
          "group": "refspec"
        },
        "git_refspec_dst_matches": {
          "kind": "function",
          "name": "git_refspec_dst_matches",
          "location": {
            "file": "refspec.h",
            "line": 79,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if the refspec matches, 0 otherwise"
          },
          "params": [
            {
              "name": "refspec",
              "type": "const git_refspec *",
              "direction": "in",
              "comment": "the refspec"
            },
            {
              "name": "refname",
              "type": "const char *",
              "direction": "in",
              "comment": "the name of the reference to check"
            }
          ],
          "comment": [
            "Check if a refspec's destination descriptor matches a reference"
          ],
          "group": "refspec"
        },
        "git_refspec_transform": {
          "kind": "function",
          "name": "git_refspec_transform",
          "location": {
            "file": "refspec.h",
            "line": 90,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0, GIT_EBUFS or another error"
          },
          "params": [
            {
              "name": "out",
              "type": "char *",
              "direction": "in",
              "comment": "where to store the target name"
            },
            {
              "name": "outlen",
              "type": "size_t",
              "direction": "in",
              "comment": "the size of the `out` buffer"
            },
            {
              "name": "spec",
              "type": "const git_refspec *",
              "direction": "in",
              "comment": "the refspec"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the name of the reference to transform"
            }
          ],
          "comment": [
            "Transform a reference to its target following the refspec's rules"
          ],
          "group": "refspec"
        },
        "git_refspec_rtransform": {
          "kind": "function",
          "name": "git_refspec_rtransform",
          "location": {
            "file": "refspec.h",
            "line": 101,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0, GIT_EBUFS or another error"
          },
          "params": [
            {
              "name": "out",
              "type": "char *",
              "direction": "in",
              "comment": "where to store the source reference name"
            },
            {
              "name": "outlen",
              "type": "size_t",
              "direction": "in",
              "comment": "the size of the `out` buffer"
            },
            {
              "name": "spec",
              "type": "const git_refspec *",
              "direction": "in",
              "comment": "the refspec"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the name of the reference to transform"
            }
          ],
          "comment": [
            "Transform a target reference to its source reference following the refspec's rules"
          ],
          "group": "refspec"
        },
        "git_refspec": {
          "kind": "struct",
          "name": "git_refspec",
          "referenceName": "struct git_refspec",
          "opaque": true,
          "location": {
            "file": "types.h",
            "line": 205,
            "column": 28
          },
          "group": "refspec",
          "returnedBy": [
            "git_remote_get_refspec"
          ],
          "parameterTo": [
            "git_refspec_src",
            "git_refspec_dst",
            "git_refspec_string",
            "git_refspec_force",
            "git_refspec_direction",
            "git_refspec_src_matches",
            "git_refspec_dst_matches",
            "git_refspec_transform",
            "git_refspec_rtransform"
          ]
        }
      },
      "info": {
        "summary": "Git refspec attributes"
      }
    },
    "remote": {
      "apis": {
        "git_remote_rename_problem_cb": {
          "kind": "callback",
          "name": "git_remote_rename_problem_cb",
          "type": "int (*)(const char *, void *)",
          "comment": [
            "git2/remote.h",
            "git_remote remote management functions",
            "Git",
            "@\n{"
          ],
          "location": {
            "file": "remote.h",
            "line": 27,
            "column": 15
          },
          "params": [
            {
              "type": "const char *"
            },
            {
              "type": "void *"
            }
          ],
          "group": "remote",
          "parameterTo": [
            "git_remote_rename"
          ],
          "typedef": true
        },
        "git_remote_create": {
          "kind": "function",
          "name": "git_remote_create",
          "location": {
            "file": "remote.h",
            "line": 46,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0, GIT_EINVALIDSPEC, GIT_EEXISTS or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_remote **",
              "direction": "in",
              "comment": "the resulting remote"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository in which to create the remote"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the remote's name"
            },
            {
              "name": "url",
              "type": "const char *",
              "direction": "in",
              "comment": "the remote's url"
            }
          ],
          "comment": [
            "Add a remote with the default fetch refspec to the repository's configuration.  This\n calls git_remote_save before returning."
          ],
          "group": "remote"
        },
        "git_remote_create_inmemory": {
          "kind": "function",
          "name": "git_remote_create_inmemory",
          "location": {
            "file": "remote.h",
            "line": 68,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_remote **",
              "direction": "in",
              "comment": "pointer to the new remote object"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the associated repository"
            },
            {
              "name": "fetch",
              "type": "const char *",
              "direction": "in",
              "comment": "the fetch refspec to use for this remote. May be NULL for defaults."
            },
            {
              "name": "url",
              "type": "const char *",
              "direction": "in",
              "comment": "the remote repository's URL"
            }
          ],
          "comment": [
            "Create a remote in memory",
            "Create a remote with the given refspec in memory. You can use\n this when you have a URL instead of a remote's name.  Note that in-memory\n remotes cannot be converted to persisted remotes.",
            "The name, when provided, will be checked for validity.\n See `git_tag_create()` for rules about valid names."
          ],
          "group": "remote"
        },
        "git_remote_load": {
          "kind": "function",
          "name": "git_remote_load",
          "location": {
            "file": "remote.h",
            "line": 85,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0, GIT_ENOTFOUND, GIT_EINVALIDSPEC or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_remote **",
              "direction": "in",
              "comment": "pointer to the new remote object"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the associated repository"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "the remote's name"
            }
          ],
          "comment": [
            "Get the information for a particular remote",
            "The name will be checked for validity.\n See `git_tag_create()` for rules about valid names."
          ],
          "group": "remote"
        },
        "git_remote_save": {
          "kind": "function",
          "name": "git_remote_save",
          "location": {
            "file": "remote.h",
            "line": 96,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0, GIT_EINVALIDSPEC or an error code"
          },
          "params": [
            {
              "name": "remote",
              "type": "const git_remote *",
              "direction": "in",
              "comment": "the remote to save to config"
            }
          ],
          "comment": [
            "Save a remote to its repository's configuration",
            "One can't save a in-memory remote. Doing so will\n result in a GIT_EINVALIDSPEC being returned."
          ],
          "group": "remote"
        },
        "git_remote_name": {
          "kind": "function",
          "name": "git_remote_name",
          "location": {
            "file": "remote.h",
            "line": 104,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "a pointer to the name or NULL for in-memory remotes"
          },
          "params": [
            {
              "name": "remote",
              "type": "const git_remote *",
              "direction": "in",
              "comment": "the remote"
            }
          ],
          "comment": [
            "Get the remote's name"
          ],
          "group": "remote"
        },
        "git_remote_url": {
          "kind": "function",
          "name": "git_remote_url",
          "location": {
            "file": "remote.h",
            "line": 112,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "a pointer to the url"
          },
          "params": [
            {
              "name": "remote",
              "type": "const git_remote *",
              "direction": "in",
              "comment": "the remote"
            }
          ],
          "comment": [
            "Get the remote's url"
          ],
          "group": "remote"
        },
        "git_remote_pushurl": {
          "kind": "function",
          "name": "git_remote_pushurl",
          "location": {
            "file": "remote.h",
            "line": 120,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "a pointer to the url or NULL if no special url for pushing is set"
          },
          "params": [
            {
              "name": "remote",
              "type": "const git_remote *",
              "direction": "in",
              "comment": "the remote"
            }
          ],
          "comment": [
            "Get the remote's url for pushing"
          ],
          "group": "remote"
        },
        "git_remote_set_url": {
          "kind": "function",
          "name": "git_remote_set_url",
          "location": {
            "file": "remote.h",
            "line": 131,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error value"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote"
            },
            {
              "name": "url",
              "type": "const char *",
              "direction": "in",
              "comment": "the url to set"
            }
          ],
          "comment": [
            "Set the remote's url",
            "Existing connections will not be updated."
          ],
          "group": "remote"
        },
        "git_remote_set_pushurl": {
          "kind": "function",
          "name": "git_remote_set_pushurl",
          "location": {
            "file": "remote.h",
            "line": 142,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error value"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote"
            },
            {
              "name": "url",
              "type": "const char *",
              "direction": "in",
              "comment": "the url to set or NULL to clear the pushurl"
            }
          ],
          "comment": [
            "Set the remote's url for pushing",
            "Existing connections will not be updated."
          ],
          "group": "remote"
        },
        "git_remote_add_fetch": {
          "kind": "function",
          "name": "git_remote_add_fetch",
          "location": {
            "file": "remote.h",
            "line": 151,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error value"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote\n \\apram\n refspec the new fetch refspec"
            },
            {
              "name": "refspec",
              "type": "const char *"
            }
          ],
          "comment": [
            "Add a fetch refspec to the remote"
          ],
          "group": "remote"
        },
        "git_remote_get_fetch_refspecs": {
          "kind": "function",
          "name": "git_remote_get_fetch_refspecs",
          "location": {
            "file": "remote.h",
            "line": 162,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "array",
              "type": "git_strarray *",
              "direction": "in",
              "comment": "pointer to the array in which to store the strings"
            },
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to query"
            }
          ],
          "comment": [
            "Get the remote's list of fetch refspecs",
            "The memory is owned by the user and should be freed with\n `git_strarray_free`."
          ],
          "group": "remote"
        },
        "git_remote_add_push": {
          "kind": "function",
          "name": "git_remote_add_push",
          "location": {
            "file": "remote.h",
            "line": 171,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error value"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote"
            },
            {
              "name": "refspec",
              "type": "const char *",
              "direction": "in",
              "comment": "the new push refspec"
            }
          ],
          "comment": [
            "Add a push refspec to the remote"
          ],
          "group": "remote"
        },
        "git_remote_get_push_refspecs": {
          "kind": "function",
          "name": "git_remote_get_push_refspecs",
          "location": {
            "file": "remote.h",
            "line": 182,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "array",
              "type": "git_strarray *",
              "direction": "in",
              "comment": "pointer to the array in which to store the strings"
            },
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to query"
            }
          ],
          "comment": [
            "Get the remote's list of push refspecs",
            "The memory is owned by the user and should be freed with\n `git_strarray_free`."
          ],
          "group": "remote"
        },
        "git_remote_clear_refspecs": {
          "kind": "function",
          "name": "git_remote_clear_refspecs",
          "location": {
            "file": "remote.h",
            "line": 191,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote"
            }
          ],
          "comment": [
            "Clear the refspecs",
            "Remove all configured fetch and push refspecs from the remote."
          ],
          "group": "remote"
        },
        "git_remote_refspec_count": {
          "kind": "function",
          "name": "git_remote_refspec_count",
          "location": {
            "file": "remote.h",
            "line": 199,
            "column": 20
          },
          "returns": {
            "type": "size_t",
            "comment": "the amount of refspecs configured in this remote"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote"
            }
          ],
          "comment": [
            "Get the number of refspecs for a remote"
          ],
          "group": "remote"
        },
        "git_remote_get_refspec": {
          "kind": "function",
          "name": "git_remote_get_refspec",
          "location": {
            "file": "remote.h",
            "line": 208,
            "column": 32
          },
          "returns": {
            "type": "const git_refspec *",
            "comment": "the nth refspec"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to query"
            },
            {
              "name": "n",
              "type": "size_t",
              "direction": "in",
              "comment": "the refspec to get"
            }
          ],
          "comment": [
            "Get a refspec from the remote"
          ],
          "group": "remote"
        },
        "git_remote_remove_refspec": {
          "kind": "function",
          "name": "git_remote_remove_refspec",
          "location": {
            "file": "remote.h",
            "line": 217,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or GIT_ENOTFOUND"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to query"
            },
            {
              "name": "n",
              "type": "size_t",
              "direction": "in",
              "comment": "the refspec to remove"
            }
          ],
          "comment": [
            "Remove a refspec from the remote"
          ],
          "group": "remote"
        },
        "git_remote_connect": {
          "kind": "function",
          "name": "git_remote_connect",
          "location": {
            "file": "remote.h",
            "line": 231,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to connect to"
            },
            {
              "name": "direction",
              "type": "git_direction",
              "direction": "in",
              "comment": "GIT_DIRECTION_FETCH if you want to fetch or\n GIT_DIRECTION_PUSH if you want to push",
              "referenceType": "enum git_direction"
            }
          ],
          "comment": [
            "Open a connection to a remote",
            "The transport is selected based on the URL. The direction argument\n is due to a limitation of the git protocol (over TCP or SSH) which\n starts up a specific binary which can only do the one or the other."
          ],
          "group": "remote"
        },
        "git_remote_ls": {
          "kind": "function",
          "name": "git_remote_ls",
          "location": {
            "file": "remote.h",
            "line": 247,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote"
            },
            {
              "name": "list_cb",
              "type": "git_headlist_cb",
              "direction": "in",
              "comment": "function to call with each ref discovered at the remote",
              "referenceType": "int (*)(git_remote_head *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "additional data to pass to the callback"
            }
          ],
          "comment": [
            "Get a list of refs at the remote",
            "The remote (or more exactly its transport) must be connected. The\n memory belongs to the remote.",
            "If you a return a non-zero value from the callback, this will stop\n looping over the refs."
          ],
          "group": "remote"
        },
        "git_remote_download": {
          "kind": "function",
          "name": "git_remote_download",
          "location": {
            "file": "remote.h",
            "line": 265,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to download from"
            },
            {
              "name": "progress_cb",
              "type": "git_transfer_progress_callback",
              "direction": "in",
              "comment": "function to call with progress information.  Be aware that\n this is called inline with network and indexing operations, so performance\n may be affected.",
              "referenceType": "int (*)(const git_transfer_progress *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "payload for the progress callback"
            }
          ],
          "comment": [
            "Download the packfile",
            "Negotiate what objects should be downloaded and download the\n packfile with those objects. The packfile is downloaded with a\n temporary filename, as it's final name is not known yet. If there\n was no packfile needed (all the objects were available locally),\n filename will be NULL and the function will return success."
          ],
          "group": "remote"
        },
        "git_remote_connected": {
          "kind": "function",
          "name": "git_remote_connected",
          "location": {
            "file": "remote.h",
            "line": 279,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if it's connected, 0 otherwise."
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote"
            }
          ],
          "comment": [
            "Check whether the remote is connected",
            "Check whether the remote's underlying transport is connected to the\n remote host."
          ],
          "group": "remote"
        },
        "git_remote_stop": {
          "kind": "function",
          "name": "git_remote_stop",
          "location": {
            "file": "remote.h",
            "line": 289,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote"
            }
          ],
          "comment": [
            "Cancel the operation",
            "At certain points in its operation, the network code checks whether\n the operation has been cancelled and if so stops the operation."
          ],
          "group": "remote"
        },
        "git_remote_disconnect": {
          "kind": "function",
          "name": "git_remote_disconnect",
          "location": {
            "file": "remote.h",
            "line": 299,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to disconnect from"
            }
          ],
          "comment": [
            "Disconnect from the remote",
            "Close the connection to the remote and free the underlying\n transport."
          ],
          "group": "remote"
        },
        "git_remote_free": {
          "kind": "function",
          "name": "git_remote_free",
          "location": {
            "file": "remote.h",
            "line": 309,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to free"
            }
          ],
          "comment": [
            "Free the memory associated with a remote",
            "This also disconnects from the remote, if the connection\n has not been closed yet (using git_remote_disconnect)."
          ],
          "group": "remote"
        },
        "git_remote_update_tips": {
          "kind": "function",
          "name": "git_remote_update_tips",
          "location": {
            "file": "remote.h",
            "line": 317,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to update"
            }
          ],
          "comment": [
            "Update the tips to the new state"
          ],
          "group": "remote"
        },
        "git_remote_valid_url": {
          "kind": "function",
          "name": "git_remote_valid_url",
          "location": {
            "file": "remote.h",
            "line": 325,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if the url is valid, 0 otherwise"
          },
          "params": [
            {
              "name": "url",
              "type": "const char *",
              "direction": "in",
              "comment": "the url to check"
            }
          ],
          "comment": [
            "Return whether a string is a valid remote URL"
          ],
          "group": "remote"
        },
        "git_remote_supported_url": {
          "kind": "function",
          "name": "git_remote_supported_url",
          "location": {
            "file": "remote.h",
            "line": 333,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if the url is supported, 0 otherwise"
          },
          "params": [
            {
              "name": "url",
              "type": "const char *",
              "direction": "in",
              "comment": "the url to check"
            }
          ],
          "comment": [
            "Return whether the passed URL is supported by this version of the library."
          ],
          "group": "remote"
        },
        "git_remote_list": {
          "kind": "function",
          "name": "git_remote_list",
          "location": {
            "file": "remote.h",
            "line": 344,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_strarray *",
              "direction": "in",
              "comment": "a string array which receives the names of the remotes"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository to query"
            }
          ],
          "comment": [
            "Get a list of the configured remotes for a repo",
            "The string array must be freed by the user."
          ],
          "group": "remote"
        },
        "git_remote_check_cert": {
          "kind": "function",
          "name": "git_remote_check_cert",
          "location": {
            "file": "remote.h",
            "line": 352,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to configure"
            },
            {
              "name": "check",
              "type": "int",
              "direction": "in",
              "comment": "whether to check the server's certificate (defaults to yes)"
            }
          ],
          "comment": [
            "Choose whether to check the server's certificate (applies to HTTPS only)"
          ],
          "group": "remote"
        },
        "git_remote_set_cred_acquire_cb": {
          "kind": "function",
          "name": "git_remote_set_cred_acquire_cb",
          "location": {
            "file": "remote.h",
            "line": 364,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to configure"
            },
            {
              "name": "cred_acquire_cb",
              "type": "git_cred_acquire_cb",
              "direction": "in",
              "comment": "The credentials acquisition callback to use (defaults\n to NULL)",
              "referenceType": "int (*)(git_cred **, const char *, const char *, unsigned int, void *)"
            },
            {
              "name": "payload",
              "type": "void *"
            }
          ],
          "comment": [
            "Set a credentials acquisition callback for this remote. If the remote is\n not available for anonymous access, then you must set this callback in order\n to provide credentials to the transport at the time of authentication\n failure so that retry can be performed."
          ],
          "group": "remote"
        },
        "git_remote_set_transport": {
          "kind": "function",
          "name": "git_remote_set_transport",
          "location": {
            "file": "remote.h",
            "line": 381,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to configure"
            },
            {
              "name": "transport",
              "type": "git_transport *",
              "direction": "in",
              "comment": "the transport object for the remote to use"
            }
          ],
          "comment": [
            "Sets a custom transport for the remote. The caller can use this function\n to bypass the automatic discovery of a transport by URL scheme (i.e.\n http://, https://, git://) and supply their own transport to be used\n instead. After providing the transport to a remote using this function,\n the transport object belongs exclusively to that remote, and the remote will\n free it when it is freed with git_remote_free."
          ],
          "group": "remote"
        },
        "git_remote_completion_type": {
          "kind": "enum",
          "name": "git_remote_completion_type",
          "referenceName": "git_remote_completion_type",
          "members": [
            {
              "name": "GIT_REMOTE_COMPLETION_DOWNLOAD"
            },
            {
              "name": "GIT_REMOTE_COMPLETION_INDEXING"
            },
            {
              "name": "GIT_REMOTE_COMPLETION_ERROR"
            }
          ],
          "comment": [
            "Argument to the completion callback which tells it which operation\n finished."
          ],
          "location": {
            "file": "remote.h",
            "line": 389,
            "column": 14
          },
          "group": "remote"
        },
        "git_remote_callbacks": {
          "kind": "struct",
          "name": "git_remote_callbacks",
          "referenceName": "struct git_remote_callbacks",
          "comment": [
            "The callback settings structure",
            "Set the calbacks to be called by the remote."
          ],
          "members": [
            {
              "name": "version",
              "type": "unsigned int"
            },
            {
              "name": "progress",
              "type": "void (*)(const char *, int, void *)"
            },
            {
              "name": "completion",
              "type": "int (*)(git_remote_completion_type, void *)"
            },
            {
              "name": "update_tips",
              "type": "int (*)(const char *, const git_oid *, const git_oid *, void *)"
            },
            {
              "name": "payload",
              "type": "void *"
            }
          ],
          "location": {
            "file": "remote.h",
            "line": 400,
            "column": 8
          },
          "group": "remote",
          "parameterTo": [
            "git_remote_set_callbacks"
          ]
        },
        "GIT_REMOTE_CALLBACKS_VERSION": {
          "kind": "macro",
          "name": "GIT_REMOTE_CALLBACKS_VERSION",
          "location": {
            "file": "remote.h",
            "line": 408,
            "column": 9
          },
          "value": "1",
          "comment": "",
          "group": "remote"
        },
        "GIT_REMOTE_CALLBACKS_INIT": {
          "kind": "macro",
          "name": "GIT_REMOTE_CALLBACKS_INIT",
          "location": {
            "file": "remote.h",
            "line": 409,
            "column": 9
          },
          "value": "{GIT_REMOTE_CALLBACKS_VERSION}",
          "comment": "",
          "group": "remote"
        },
        "git_remote_set_callbacks": {
          "kind": "function",
          "name": "git_remote_set_callbacks",
          "location": {
            "file": "remote.h",
            "line": 421,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to configure"
            },
            {
              "name": "callbacks",
              "type": "git_remote_callbacks *",
              "direction": "in",
              "comment": "a pointer to the user's callback settings"
            }
          ],
          "comment": [
            "Set the callbacks for a remote",
            "Note that the remote keeps its own copy of the data and you need to\n call this function again if you want to change the callbacks."
          ],
          "group": "remote"
        },
        "git_remote_stats": {
          "kind": "function",
          "name": "git_remote_stats",
          "location": {
            "file": "remote.h",
            "line": 426,
            "column": 43
          },
          "returns": {
            "type": "const git_transfer_progress *"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *"
            }
          ],
          "comment": [
            "Get the statistics structure that is filled in by the fetch operation."
          ],
          "group": "remote"
        },
        "git_remote_autotag_option_t": {
          "kind": "enum",
          "name": "git_remote_autotag_option_t",
          "referenceName": "git_remote_autotag_option_t",
          "members": [
            {
              "name": "GIT_REMOTE_DOWNLOAD_TAGS_AUTO",
              "value": "0"
            },
            {
              "name": "GIT_REMOTE_DOWNLOAD_TAGS_NONE",
              "value": "1"
            },
            {
              "name": "GIT_REMOTE_DOWNLOAD_TAGS_ALL",
              "value": "2"
            }
          ],
          "location": {
            "file": "remote.h",
            "line": 428,
            "column": 9
          },
          "group": "remote",
          "returnedBy": [
            "git_remote_autotag"
          ],
          "parameterTo": [
            "git_remote_set_autotag"
          ]
        },
        "git_remote_autotag": {
          "kind": "function",
          "name": "git_remote_autotag",
          "location": {
            "file": "remote.h",
            "line": 440,
            "column": 41
          },
          "returns": {
            "type": "git_remote_autotag_option_t",
            "comment": "the auto-follow setting"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to query"
            }
          ],
          "comment": [
            "Retrieve the tag auto-follow setting"
          ],
          "group": "remote"
        },
        "git_remote_set_autotag": {
          "kind": "function",
          "name": "git_remote_set_autotag",
          "location": {
            "file": "remote.h",
            "line": 448,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to configure"
            },
            {
              "name": "value",
              "type": "git_remote_autotag_option_t",
              "direction": "in",
              "comment": "a GIT_REMOTE_DOWNLOAD_TAGS value",
              "referenceType": "enum git_remote_autotag_option_t"
            }
          ],
          "comment": [
            "Set the tag auto-follow setting"
          ],
          "group": "remote"
        },
        "git_remote_rename": {
          "kind": "function",
          "name": "git_remote_rename",
          "location": {
            "file": "remote.h",
            "line": 470,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0, GIT_EINVALIDSPEC, GIT_EEXISTS or an error code"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to rename"
            },
            {
              "name": "new_name",
              "type": "const char *",
              "direction": "in",
              "comment": "the new name the remote should bear"
            },
            {
              "name": "callback",
              "type": "git_remote_rename_problem_cb",
              "direction": "in",
              "comment": "Optional callback to notify the consumer of fetch refspecs\n that haven't been automatically updated and need potential manual tweaking.",
              "referenceType": "int (*)(const char *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Additional data to pass to the callback"
            }
          ],
          "comment": [
            "Give the remote a new name",
            "All remote-tracking branches and configuration settings\n for the remote are updated.",
            "The new name will be checked for validity.\n See `git_tag_create()` for rules about valid names.",
            "A temporary in-memory remote cannot be given a name with this method."
          ],
          "group": "remote"
        },
        "git_remote_update_fetchhead": {
          "kind": "function",
          "name": "git_remote_update_fetchhead",
          "location": {
            "file": "remote.h",
            "line": 482,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "the update FETCH_HEAD setting"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to query"
            }
          ],
          "comment": [
            "Retrieve the update FETCH_HEAD setting."
          ],
          "group": "remote"
        },
        "git_remote_set_update_fetchhead": {
          "kind": "function",
          "name": "git_remote_set_update_fetchhead",
          "location": {
            "file": "remote.h",
            "line": 491,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "remote",
              "type": "git_remote *",
              "direction": "in",
              "comment": "the remote to configure"
            },
            {
              "name": "value",
              "type": "int",
              "direction": "in",
              "comment": "0 to disable updating FETCH_HEAD"
            }
          ],
          "comment": [
            "Sets the update FETCH_HEAD setting.  By default, FETCH_HEAD will be\n updated on every fetch.  Set to 0 to disable."
          ],
          "group": "remote"
        },
        "git_remote_is_valid_name": {
          "kind": "function",
          "name": "git_remote_is_valid_name",
          "location": {
            "file": "remote.h",
            "line": 499,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if the reference name is acceptable; 0 if it isn't"
          },
          "params": [
            {
              "name": "remote_name",
              "type": "const char *",
              "direction": "in",
              "comment": "name to be checked."
            }
          ],
          "comment": [
            "Ensure the remote name is well-formed."
          ],
          "group": "remote"
        },
        "git_remote": {
          "kind": "struct",
          "name": "git_remote",
          "referenceName": "struct git_remote",
          "opaque": true,
          "location": {
            "file": "types.h",
            "line": 206,
            "column": 27
          },
          "group": "remote",
          "parameterTo": [
            "git_push_new",
            "git_remote_create",
            "git_remote_create_inmemory",
            "git_remote_load",
            "git_remote_save",
            "git_remote_name",
            "git_remote_url",
            "git_remote_pushurl",
            "git_remote_set_url",
            "git_remote_set_pushurl",
            "git_remote_add_fetch",
            "git_remote_get_fetch_refspecs",
            "git_remote_add_push",
            "git_remote_get_push_refspecs",
            "git_remote_clear_refspecs",
            "git_remote_refspec_count",
            "git_remote_get_refspec",
            "git_remote_remove_refspec",
            "git_remote_connect",
            "git_remote_ls",
            "git_remote_download",
            "git_remote_connected",
            "git_remote_stop",
            "git_remote_disconnect",
            "git_remote_free",
            "git_remote_update_tips",
            "git_remote_check_cert",
            "git_remote_set_cred_acquire_cb",
            "git_remote_set_transport",
            "git_remote_set_callbacks",
            "git_remote_stats",
            "git_remote_autotag",
            "git_remote_set_autotag",
            "git_remote_rename",
            "git_remote_update_fetchhead",
            "git_remote_set_update_fetchhead",
            "git_transport_new",
            "git_transport_cb",
            "git_transport_dummy",
            "git_transport_local",
            "git_transport_smart"
          ]
        },
        "git_push": {
          "kind": "struct",
          "name": "git_push",
          "referenceName": "struct git_push",
          "opaque": true,
          "location": {
            "file": "types.h",
            "line": 207,
            "column": 25
          },
          "group": "remote",
          "parameterTo": [
            "git_push_new",
            "git_push_set_options",
            "git_push_add_refspec",
            "git_push_update_tips",
            "git_push_finish",
            "git_push_unpack_ok",
            "git_push_status_foreach",
            "git_push_free"
          ]
        }
      },
      "info": {
        "summary": "Git remote management functions"
      }
    },
    "repository": {
      "apis": {
        "git_repository_open": {
          "kind": "function",
          "name": "git_repository_open",
          "location": {
            "file": "repository.h",
            "line": 36,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_repository **",
              "direction": "in",
              "comment": "pointer to the repo which will be opened"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "the path to the repository"
            }
          ],
          "comment": [
            "Open a git repository.",
            "The 'path' argument must point to either a git repository\n folder, or an existing work dir.",
            "The method will automatically detect if 'path' is a normal\n or bare repository or fail is 'path' is neither."
          ],
          "group": "repository"
        },
        "git_repository_wrap_odb": {
          "kind": "function",
          "name": "git_repository_wrap_odb",
          "location": {
            "file": "repository.h",
            "line": 49,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_repository **",
              "direction": "in",
              "comment": "pointer to the repo"
            },
            {
              "name": "odb",
              "type": "git_odb *",
              "direction": "in",
              "comment": "the object database to wrap"
            }
          ],
          "comment": [
            "Create a \"fake\" repository to wrap an object database",
            "Create a repository object to wrap an object database to be used\n with the API when all you have is an object database. This doesn't\n have any paths associated with it, so use with care."
          ],
          "group": "repository"
        },
        "git_repository_discover": {
          "kind": "function",
          "name": "git_repository_discover",
          "location": {
            "file": "repository.h",
            "line": 79,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "path_out",
              "type": "char *",
              "direction": "in",
              "comment": "The user allocated buffer which will\n contain the found path."
            },
            {
              "name": "path_size",
              "type": "size_t",
              "direction": "in",
              "comment": "repository_path size"
            },
            {
              "name": "start_path",
              "type": "const char *",
              "direction": "in",
              "comment": "The base path where the lookup starts."
            },
            {
              "name": "across_fs",
              "type": "int",
              "direction": "in",
              "comment": "If true, then the lookup will not stop when a\n filesystem device change is detected while exploring parent directories."
            },
            {
              "name": "ceiling_dirs",
              "type": "const char *",
              "direction": "in",
              "comment": "A GIT_PATH_LIST_SEPARATOR separated list of\n absolute symbolic link free paths. The lookup will stop when any\n of this paths is reached. Note that the lookup always performs on\n start_path no matter start_path appears in ceiling_dirs ceiling_dirs\n might be NULL (which is equivalent to an empty string)"
            }
          ],
          "comment": [
            "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).",
            "The method will automatically detect if the repository is bare\n (if there is a repository)."
          ],
          "group": "repository"
        },
        "git_repository_open_flag_t": {
          "kind": "enum",
          "name": "git_repository_open_flag_t",
          "referenceName": "git_repository_open_flag_t",
          "members": [
            {
              "name": "GIT_REPOSITORY_OPEN_NO_SEARCH",
              "value": "1"
            },
            {
              "name": "GIT_REPOSITORY_OPEN_CROSS_FS",
              "value": "2"
            }
          ],
          "comment": [
            "Option flags for `git_repository_open_ext`.",
            "* GIT_REPOSITORY_OPEN_NO_SEARCH - Only open the repository if it can be\n   immediately found in the start_path.  Do not walk up from the\n   start_path looking at parent directories.\n * GIT_REPOSITORY_OPEN_CROSS_FS - Unless this flag is set, open will not\n   continue searching across filesystem boundaries (i.e. when `st_dev`\n   changes from the `stat` system call).  (E.g. Searching in a user's home\n   directory \"/home/user/source/\" will not return \"/.git/\" as the found\n   repo if \"/\" is a different filesystem than \"/home\".)"
          ],
          "location": {
            "file": "repository.h",
            "line": 98,
            "column": 9
          },
          "group": "repository"
        },
        "git_repository_open_ext": {
          "kind": "function",
          "name": "git_repository_open_ext",
          "location": {
            "file": "repository.h",
            "line": 120,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_ENOTFOUND if no repository could be found,\n        or -1 if there was a repository but open failed for some reason\n        (such as repo corruption or system errors)."
          },
          "params": [
            {
              "name": "out",
              "type": "git_repository **",
              "direction": "in",
              "comment": "Pointer to the repo which will be opened.  This can\n        actually be NULL if you only want to use the error code to\n        see if a repo at this path could be opened."
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "Path to open as git repository.  If the flags\n        permit \"searching\", then this can be a path to a subdirectory\n        inside the working directory of the repository."
            },
            {
              "name": "flags",
              "type": "unsigned int",
              "direction": "in",
              "comment": "A combination of the GIT_REPOSITORY_OPEN flags above."
            },
            {
              "name": "ceiling_dirs",
              "type": "const char *",
              "direction": "in",
              "comment": "A GIT_PATH_LIST_SEPARATOR delimited list of path\n        prefixes at which the search for a containing repository should\n        terminate."
            }
          ],
          "comment": [
            "Find and open a repository with extended controls."
          ],
          "group": "repository"
        },
        "git_repository_open_bare": {
          "kind": "function",
          "name": "git_repository_open_bare",
          "location": {
            "file": "repository.h",
            "line": 137,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_repository **",
              "direction": "in",
              "comment": "Pointer to the repo which will be opened."
            },
            {
              "name": "bare_path",
              "type": "const char *",
              "direction": "in",
              "comment": "Direct path to the bare repository"
            }
          ],
          "comment": [
            "Open a bare repository on the serverside.",
            "This is a fast open for bare repositories that will come in handy\n if you're e.g. hosting git repositories and need to access them\n efficiently"
          ],
          "group": "repository"
        },
        "git_repository_free": {
          "kind": "function",
          "name": "git_repository_free",
          "location": {
            "file": "repository.h",
            "line": 150,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository handle to close. If NULL nothing occurs."
            }
          ],
          "comment": [
            "Free a previously allocated repository",
            "Note that after a repository is free'd, all the objects it has spawned\n will still exist until they are manually closed by the user\n with `git_object_free`, but accessing any of the attributes of\n an object without a backing repository will result in undefined\n behavior"
          ],
          "group": "repository"
        },
        "git_repository_init": {
          "kind": "function",
          "name": "git_repository_init",
          "location": {
            "file": "repository.h",
            "line": 167,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_repository **",
              "direction": "in",
              "comment": "pointer to the repo which will be created or reinitialized"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "the path to the repository"
            },
            {
              "name": "is_bare",
              "type": "unsigned int",
              "direction": "in",
              "comment": "if true, a Git repository without a working directory is\n\t\tcreated at the pointed path. If false, provided path will be\n\t\tconsidered as the working directory into which the .git directory\n\t\twill be created."
            }
          ],
          "comment": [
            "Creates a new Git repository in the given folder.",
            "TODO:\n\t- Reinit the repository"
          ],
          "group": "repository"
        },
        "git_repository_init_flag_t": {
          "kind": "enum",
          "name": "git_repository_init_flag_t",
          "referenceName": "git_repository_init_flag_t",
          "members": [
            {
              "name": "GIT_REPOSITORY_INIT_BARE"
            },
            {
              "name": "GIT_REPOSITORY_INIT_NO_REINIT"
            },
            {
              "name": "GIT_REPOSITORY_INIT_NO_DOTGIT_DIR"
            },
            {
              "name": "GIT_REPOSITORY_INIT_MKDIR"
            },
            {
              "name": "GIT_REPOSITORY_INIT_MKPATH"
            },
            {
              "name": "GIT_REPOSITORY_INIT_EXTERNAL_TEMPLATE"
            }
          ],
          "comment": [
            "Option flags for `git_repository_init_ext`.",
            "These flags configure extra behaviors to `git_repository_init_ext`.\n In every case, the default behavior is the zero value (i.e. flag is\n not set).  Just OR the flag values together for the `flags` parameter\n when initializing a new repo.  Details of individual values are:",
            "* BARE   - Create a bare repository with no working directory.\n * NO_REINIT - Return an EEXISTS error if the repo_path appears to\n        already be an git repository.\n * NO_DOTGIT_DIR - Normally a \"/.git/\" will be appended to the repo\n        path for non-bare repos (if it is not already there), but\n        passing this flag prevents that behavior.\n * MKDIR  - Make the repo_path (and workdir_path) as needed.  Init is\n        always willing to create the \".git\" directory even without this\n        flag.  This flag tells init to create the trailing component of\n        the repo and workdir paths as needed.\n * MKPATH - Recursively make all components of the repo and workdir\n        paths as necessary.\n * EXTERNAL_TEMPLATE - libgit2 normally uses internal templates to\n        initialize a new repo.  This flags enables external templates,\n        looking the \"template_path\" from the options if set, or the\n        `init.templatedir` global config if not, or falling back on\n        \"/usr/share/git-core/templates\" if it exists."
          ],
          "location": {
            "file": "repository.h",
            "line": 198,
            "column": 9
          },
          "group": "repository"
        },
        "git_repository_init_mode_t": {
          "kind": "enum",
          "name": "git_repository_init_mode_t",
          "referenceName": "git_repository_init_mode_t",
          "members": [
            {
              "name": "GIT_REPOSITORY_INIT_SHARED_UMASK",
              "value": "0"
            },
            {
              "name": "GIT_REPOSITORY_INIT_SHARED_GROUP",
              "value": "1533"
            },
            {
              "name": "GIT_REPOSITORY_INIT_SHARED_ALL",
              "value": "1535"
            }
          ],
          "comment": [
            "Mode options for `git_repository_init_ext`.",
            "Set the mode field of the `git_repository_init_options` structure\n either to the custom mode that you would like, or to one of the\n following modes:",
            "* SHARED_UMASK - Use permissions configured by umask - the default.\n * SHARED_GROUP - Use \"--shared=group\" behavior, chmod'ing the new repo\n        to be group writable and \"g+sx\" for sticky group assignment.\n * SHARED_ALL - Use \"--shared=all\" behavior, adding world readability.\n * Anything else - Set to custom value."
          ],
          "location": {
            "file": "repository.h",
            "line": 220,
            "column": 9
          },
          "group": "repository"
        },
        "git_repository_init_options": {
          "kind": "struct",
          "name": "git_repository_init_options",
          "referenceName": "git_repository_init_options",
          "comment": [
            "Extended options structure for `git_repository_init_ext`.",
            "This contains extra options for `git_repository_init_ext` that enable\n additional initialization features.  The fields are:",
            "* flags - Combination of GIT_REPOSITORY_INIT flags above.\n * mode  - Set to one of the standard GIT_REPOSITORY_INIT_SHARED_...\n        constants above, or to a custom value that you would like.\n * workdir_path - The path to the working dir or NULL for default (i.e.\n        repo_path parent on non-bare repos).  IF THIS IS RELATIVE PATH,\n        IT WILL BE EVALUATED RELATIVE TO THE REPO_PATH.  If this is not\n        the \"natural\" working directory, a .git gitlink file will be\n        created here linking to the repo_path.\n * description - If set, this will be used to initialize the \"description\"\n        file in the repository, instead of using the template content.\n * template_path - When GIT_REPOSITORY_INIT_EXTERNAL_TEMPLATE is set,\n        this contains the path to use for the template directory.  If\n        this is NULL, the config or default directory options will be\n        used instead.\n * initial_head - The name of the head to point HEAD at.  If NULL, then\n        this will be treated as \"master\" and the HEAD ref will be set\n        to \"refs/heads/master\".  If this begins with \"refs/\" it will be\n        used verbatim; otherwise \"refs/heads/\" will be prefixed.\n * origin_url - If this is non-NULL, then after the rest of the\n        repository initialization is completed, an \"origin\" remote\n        will be added pointing to this URL."
          ],
          "members": [
            {
              "name": "version",
              "type": "unsigned int"
            },
            {
              "name": "flags",
              "type": "uint32_t"
            },
            {
              "name": "mode",
              "type": "uint32_t"
            },
            {
              "name": "workdir_path",
              "type": "const char *"
            },
            {
              "name": "description",
              "type": "const char *"
            },
            {
              "name": "template_path",
              "type": "const char *"
            },
            {
              "name": "initial_head",
              "type": "const char *"
            },
            {
              "name": "origin_url",
              "type": "const char *"
            }
          ],
          "location": {
            "file": "repository.h",
            "line": 254,
            "column": 9
          },
          "group": "repository",
          "parameterTo": [
            "git_repository_init_ext"
          ]
        },
        "GIT_REPOSITORY_INIT_OPTIONS_VERSION": {
          "kind": "macro",
          "name": "GIT_REPOSITORY_INIT_OPTIONS_VERSION",
          "location": {
            "file": "repository.h",
            "line": 265,
            "column": 9
          },
          "value": "1",
          "comment": "",
          "group": "repository"
        },
        "GIT_REPOSITORY_INIT_OPTIONS_INIT": {
          "kind": "macro",
          "name": "GIT_REPOSITORY_INIT_OPTIONS_INIT",
          "location": {
            "file": "repository.h",
            "line": 266,
            "column": 9
          },
          "value": "{GIT_REPOSITORY_INIT_OPTIONS_VERSION}",
          "comment": "",
          "group": "repository"
        },
        "git_repository_init_ext": {
          "kind": "function",
          "name": "git_repository_init_ext",
          "location": {
            "file": "repository.h",
            "line": 281,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code on failure."
          },
          "params": [
            {
              "name": "out",
              "type": "git_repository **",
              "direction": "in",
              "comment": "Pointer to the repo which will be created or reinitialized."
            },
            {
              "name": "repo_path",
              "type": "const char *",
              "direction": "in",
              "comment": "The path to the repository."
            },
            {
              "name": "opts",
              "type": "git_repository_init_options *",
              "direction": "in",
              "comment": "Pointer to git_repository_init_options struct."
            }
          ],
          "comment": [
            "Create a new Git repository in the given folder with extended controls.",
            "This will initialize a new git repository (creating the repo_path\n if requested by flags) and working directory as needed.  It will\n auto-detect the case sensitivity of the file system and if the\n file system supports file mode bits correctly."
          ],
          "group": "repository"
        },
        "git_repository_head": {
          "kind": "function",
          "name": "git_repository_head",
          "location": {
            "file": "repository.h",
            "line": 299,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EORPHANEDHEAD when HEAD points to a non existing\n branch, GIT_ENOTFOUND when HEAD is missing; an error code otherwise"
          },
          "params": [
            {
              "name": "out",
              "type": "git_reference **",
              "direction": "in",
              "comment": "pointer to the reference which will be retrieved"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "a repository object"
            }
          ],
          "comment": [
            "Retrieve and resolve the reference pointed at by HEAD.",
            "The returned `git_reference` will be owned by caller and\n `git_reference_free()` must be called when done with it to release the\n allocated memory and prevent a leak."
          ],
          "group": "repository"
        },
        "git_repository_head_detached": {
          "kind": "function",
          "name": "git_repository_head_detached",
          "location": {
            "file": "repository.h",
            "line": 311,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if HEAD is detached, 0 if it's not; error code if there\n was an error."
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repo to test"
            }
          ],
          "comment": [
            "Check if a repository's HEAD is detached",
            "A repository's HEAD is detached when it points directly to a commit\n instead of a branch."
          ],
          "group": "repository"
        },
        "git_repository_head_orphan": {
          "kind": "function",
          "name": "git_repository_head_orphan",
          "location": {
            "file": "repository.h",
            "line": 323,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if the current branch is an orphan, 0 if it's not; error\n code if there was an error"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repo to test"
            }
          ],
          "comment": [
            "Check if the current branch is an orphan",
            "An orphan branch is one named from HEAD but which doesn't exist in\n the refs namespace, because it doesn't have any commit to point to."
          ],
          "group": "repository"
        },
        "git_repository_is_empty": {
          "kind": "function",
          "name": "git_repository_is_empty",
          "location": {
            "file": "repository.h",
            "line": 335,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if the repository is empty, 0 if it isn't, error code\n if the repository is corrupted"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repo to test"
            }
          ],
          "comment": [
            "Check if a repository is empty",
            "An empty repository has just been initialized and contains\n no references."
          ],
          "group": "repository"
        },
        "git_repository_path": {
          "kind": "function",
          "name": "git_repository_path",
          "location": {
            "file": "repository.h",
            "line": 346,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "the path to the repository"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            }
          ],
          "comment": [
            "Get the path of this repository",
            "This is the path of the `.git` folder for normal repositories,\n or of the repository itself for bare repositories."
          ],
          "group": "repository"
        },
        "git_repository_workdir": {
          "kind": "function",
          "name": "git_repository_workdir",
          "location": {
            "file": "repository.h",
            "line": 357,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "the path to the working dir, if it exists"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            }
          ],
          "comment": [
            "Get the path of the working directory for this repository",
            "If the repository is bare, this function will always return\n NULL."
          ],
          "group": "repository"
        },
        "git_repository_set_workdir": {
          "kind": "function",
          "name": "git_repository_set_workdir",
          "location": {
            "file": "repository.h",
            "line": 376,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0, or an error code"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            },
            {
              "name": "workdir",
              "type": "const char *",
              "direction": "in",
              "comment": "The path to a working directory"
            },
            {
              "name": "update_gitlink",
              "type": "int",
              "direction": "in",
              "comment": "Create/update gitlink in workdir and set config\n        \"core.worktree\" (if workdir is not the parent of the .git directory)"
            }
          ],
          "comment": [
            "Set the path to the working directory for this repository",
            "The working directory doesn't need to be the same one\n that contains the `.git` folder for this repository.",
            "If this repository is bare, setting its working directory\n will turn it into a normal repository, capable of performing\n all the common workdir operations (checkout, status, index\n manipulation, etc)."
          ],
          "group": "repository"
        },
        "git_repository_is_bare": {
          "kind": "function",
          "name": "git_repository_is_bare",
          "location": {
            "file": "repository.h",
            "line": 385,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if the repository is bare, 0 otherwise."
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repo to test"
            }
          ],
          "comment": [
            "Check if a repository is bare"
          ],
          "group": "repository"
        },
        "git_repository_config": {
          "kind": "function",
          "name": "git_repository_config",
          "location": {
            "file": "repository.h",
            "line": 401,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0, or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_config **",
              "direction": "in",
              "comment": "Pointer to store the loaded config file"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            }
          ],
          "comment": [
            "Get the configuration file for this repository.",
            "If a configuration file has not been set, the default\n config set for the repository will be returned, including\n global and system configurations (if they are available).",
            "The configuration file must be freed once it's no longer\n being used by the user."
          ],
          "group": "repository"
        },
        "git_repository_odb": {
          "kind": "function",
          "name": "git_repository_odb",
          "location": {
            "file": "repository.h",
            "line": 417,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0, or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_odb **",
              "direction": "in",
              "comment": "Pointer to store the loaded ODB"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            }
          ],
          "comment": [
            "Get the Object Database for this repository.",
            "If a custom ODB has not been set, the default\n database for the repository will be returned (the one\n located in `.git/objects`).",
            "The ODB must be freed once it's no longer being used by\n the user."
          ],
          "group": "repository"
        },
        "git_repository_refdb": {
          "kind": "function",
          "name": "git_repository_refdb",
          "location": {
            "file": "repository.h",
            "line": 433,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0, or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_refdb **",
              "direction": "in",
              "comment": "Pointer to store the loaded refdb"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            }
          ],
          "comment": [
            "Get the Reference Database Backend for this repository.",
            "If a custom refsdb has not been set, the default database for\n the repository will be returned (the one that manipulates loose\n and packed references in the `.git` directory).",
            "The refdb must be freed once it's no longer being used by\n the user."
          ],
          "group": "repository"
        },
        "git_repository_index": {
          "kind": "function",
          "name": "git_repository_index",
          "location": {
            "file": "repository.h",
            "line": 449,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0, or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_index **",
              "direction": "in",
              "comment": "Pointer to store the loaded index"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            }
          ],
          "comment": [
            "Get the Index file for this repository.",
            "If a custom index has not been set, the default\n index for the repository will be returned (the one\n located in `.git/index`).",
            "The index must be freed once it's no longer being used by\n the user."
          ],
          "group": "repository"
        },
        "git_repository_message": {
          "kind": "function",
          "name": "git_repository_message",
          "location": {
            "file": "repository.h",
            "line": 477,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "GIT_ENOUTFOUND if no message exists, other value \n<\n 0 for other\n         errors, or total bytes in message (may be > `len`) on success"
          },
          "params": [
            {
              "name": "out",
              "type": "char *",
              "direction": "in",
              "comment": "Buffer to write data into or NULL to just read required size"
            },
            {
              "name": "len",
              "type": "size_t",
              "direction": "in",
              "comment": "Length of `out` buffer in bytes"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository to read prepared message from"
            }
          ],
          "comment": [
            "Retrieve git's prepared message",
            "Operations such as git revert/cherry-pick/merge with the -n option\n stop just short of creating a commit with the changes and save\n their prepared message in .git/MERGE_MSG so the next git-commit\n execution can present it to the user for them to amend if they\n wish.",
            "Use this function to get the contents of this file. Don't forget to\n remove the file after you create the commit.",
            "If the repository message exists and there are no errors reading it, this\n returns the bytes needed to store the message in memory (i.e. message\n file size plus one terminating NUL byte).  That value is returned even if\n `out` is NULL or `len` is shorter than the necessary size.",
            "The `out` buffer will *always* be NUL terminated, even if truncation\n occurs."
          ],
          "group": "repository"
        },
        "git_repository_message_remove": {
          "kind": "function",
          "name": "git_repository_message_remove",
          "location": {
            "file": "repository.h",
            "line": 484,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *"
            }
          ],
          "comment": [
            "Remove git's prepared message.",
            "Remove the message that `git_repository_message` retrieves."
          ],
          "group": "repository"
        },
        "git_repository_merge_cleanup": {
          "kind": "function",
          "name": "git_repository_merge_cleanup",
          "location": {
            "file": "repository.h",
            "line": 493,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, or error"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            }
          ],
          "comment": [
            "Remove all the metadata associated with an ongoing git merge, including\n MERGE_HEAD, MERGE_MSG, etc."
          ],
          "group": "repository"
        },
        "git_repository_fetchhead_foreach_cb": {
          "kind": "callback",
          "name": "git_repository_fetchhead_foreach_cb",
          "type": "int (*)(const char *, const char *, const git_oid *, unsigned int, void *)",
          "location": {
            "file": "repository.h",
            "line": 495,
            "column": 15
          },
          "params": [
            {
              "type": "const char *"
            },
            {
              "type": "const char *"
            },
            {
              "type": "const git_oid *"
            },
            {
              "type": "unsigned int"
            },
            {
              "type": "void *"
            }
          ],
          "group": "repository",
          "parameterTo": [
            "git_repository_fetchhead_foreach"
          ],
          "typedef": true
        },
        "git_repository_fetchhead_foreach": {
          "kind": "function",
          "name": "git_repository_fetchhead_foreach",
          "location": {
            "file": "repository.h",
            "line": 509,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_ENOTFOUND, GIT_EUSER or error"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            },
            {
              "name": "callback",
              "type": "git_repository_fetchhead_foreach_cb",
              "direction": "in",
              "comment": "Callback function",
              "referenceType": "int (*)(const char *, const char *, const git_oid *, unsigned int, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Pointer to callback data (optional)"
            }
          ],
          "comment": [
            "Call callback 'callback' for each entry in the given FETCH_HEAD file."
          ],
          "group": "repository"
        },
        "git_repository_mergehead_foreach_cb": {
          "kind": "callback",
          "name": "git_repository_mergehead_foreach_cb",
          "type": "int (*)(const git_oid *, void *)",
          "location": {
            "file": "repository.h",
            "line": 513,
            "column": 15
          },
          "params": [
            {
              "type": "const git_oid *"
            },
            {
              "type": "void *"
            }
          ],
          "group": "repository",
          "parameterTo": [
            "git_repository_mergehead_foreach"
          ],
          "typedef": true
        },
        "git_repository_mergehead_foreach": {
          "kind": "function",
          "name": "git_repository_mergehead_foreach",
          "location": {
            "file": "repository.h",
            "line": 525,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_ENOTFOUND, GIT_EUSER or error"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            },
            {
              "name": "callback",
              "type": "git_repository_mergehead_foreach_cb",
              "direction": "in",
              "comment": "Callback function",
              "referenceType": "int (*)(const git_oid *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Pointer to callback data (optional)"
            }
          ],
          "comment": [
            "If a merge is in progress, call callback 'cb' for each commit ID in the\n MERGE_HEAD file."
          ],
          "group": "repository"
        },
        "git_repository_hashfile": {
          "kind": "function",
          "name": "git_repository_hashfile",
          "location": {
            "file": "repository.h",
            "line": 547,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "Output value of calculated SHA"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository pointer"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "Path to file on disk whose contents should be hashed. If the\n             repository is not NULL, this can be a relative path."
            },
            {
              "name": "type",
              "type": "git_otype",
              "direction": "in",
              "comment": "The object type to hash as (e.g. GIT_OBJ_BLOB)",
              "referenceType": "enum git_otype"
            },
            {
              "name": "as_path",
              "type": "const char *",
              "direction": "in",
              "comment": "The path to use to look up filtering rules. If this is\n             NULL, then the `path` parameter will be used instead. If\n             this is passed as the empty string, then no filters will be\n             applied when calculating the hash."
            }
          ],
          "comment": [
            "Calculate hash of file using repository filtering rules.",
            "If you simply want to calculate the hash of a file on disk with no filters,\n you can just use the `git_odb_hashfile()` API.  However, if you want to\n hash a file in the repository and you want to apply filtering rules (e.g.\n crlf filters) before generating the SHA, then use this function."
          ],
          "group": "repository"
        },
        "git_repository_set_head": {
          "kind": "function",
          "name": "git_repository_set_head",
          "location": {
            "file": "repository.h",
            "line": 572,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, or an error code"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository pointer"
            },
            {
              "name": "refname",
              "type": "const char *",
              "direction": "in",
              "comment": "Canonical name of the reference the HEAD should point at"
            }
          ],
          "comment": [
            "Make the repository HEAD point to the specified reference.",
            "If the provided reference points to a Tree or a Blob, the HEAD is\n unaltered and -1 is returned.",
            "If the provided reference points to a branch, the HEAD will point\n to that branch, staying attached, or become attached if it isn't yet.\n If the branch doesn't exist yet, no error will be return. The HEAD\n will then be attached to an unborn branch.",
            "Otherwise, the HEAD will be detached and will directly point to\n the Commit."
          ],
          "group": "repository"
        },
        "git_repository_set_head_detached": {
          "kind": "function",
          "name": "git_repository_set_head_detached",
          "location": {
            "file": "repository.h",
            "line": 592,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, or an error code"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository pointer"
            },
            {
              "name": "commitish",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "Object id of the Commit the HEAD should point to"
            }
          ],
          "comment": [
            "Make the repository HEAD directly point to the Commit.",
            "If the provided committish cannot be found in the repository, the HEAD\n is unaltered and GIT_ENOTFOUND is returned.",
            "If the provided commitish cannot be peeled into a commit, the HEAD\n is unaltered and -1 is returned.",
            "Otherwise, the HEAD will eventually be detached and will directly point to\n the peeled Commit."
          ],
          "group": "repository"
        },
        "git_repository_detach_head": {
          "kind": "function",
          "name": "git_repository_detach_head",
          "location": {
            "file": "repository.h",
            "line": 613,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EORPHANEDHEAD when HEAD points to a non existing\n branch or an error code"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository pointer"
            }
          ],
          "comment": [
            "Detach the HEAD.",
            "If the HEAD is already detached and points to a Commit, 0 is returned.",
            "If the HEAD is already detached and points to a Tag, the HEAD is\n updated into making it point to the peeled Commit, and 0 is returned.",
            "If the HEAD is already detached and points to a non commitish, the HEAD is \n unaltered, and -1 is returned.",
            "Otherwise, the HEAD will be detached and point to the peeled Commit."
          ],
          "group": "repository"
        },
        "git_repository_state_t": {
          "kind": "enum",
          "name": "git_repository_state_t",
          "referenceName": "git_repository_state_t",
          "members": [
            {
              "name": "GIT_REPOSITORY_STATE_NONE"
            },
            {
              "name": "GIT_REPOSITORY_STATE_MERGE"
            },
            {
              "name": "GIT_REPOSITORY_STATE_REVERT"
            },
            {
              "name": "GIT_REPOSITORY_STATE_CHERRY_PICK"
            },
            {
              "name": "GIT_REPOSITORY_STATE_BISECT"
            },
            {
              "name": "GIT_REPOSITORY_STATE_REBASE"
            },
            {
              "name": "GIT_REPOSITORY_STATE_REBASE_INTERACTIVE"
            },
            {
              "name": "GIT_REPOSITORY_STATE_REBASE_MERGE"
            },
            {
              "name": "GIT_REPOSITORY_STATE_APPLY_MAILBOX"
            },
            {
              "name": "GIT_REPOSITORY_STATE_APPLY_MAILBOX_OR_REBASE"
            }
          ],
          "location": {
            "file": "repository.h",
            "line": 616,
            "column": 9
          },
          "group": "repository"
        },
        "git_repository_state": {
          "kind": "function",
          "name": "git_repository_state",
          "location": {
            "file": "repository.h",
            "line": 636,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "The state of the repository"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository pointer"
            }
          ],
          "comment": [
            "Determines the status of a git repository - ie, whether an operation\n (merge, cherry-pick, etc) is in progress."
          ],
          "group": "repository"
        },
        "git_repository_set_namespace": {
          "kind": "function",
          "name": "git_repository_set_namespace",
          "location": {
            "file": "repository.h",
            "line": 650,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, -1 on error"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repo"
            },
            {
              "name": "nmspace",
              "type": "const char *",
              "direction": "in",
              "comment": "The namespace. This should not include the refs\n\tfolder, e.g. to namespace all references under `refs/namespaces/foo/`,\n\tuse `foo` as the namespace."
            }
          ],
          "comment": [
            "Sets the active namespace for this Git Repository",
            "This namespace affects all reference operations for the repo.\n See `man gitnamespaces`"
          ],
          "group": "repository"
        },
        "git_repository_get_namespace": {
          "kind": "function",
          "name": "git_repository_get_namespace",
          "location": {
            "file": "repository.h",
            "line": 658,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "the active namespace, or NULL if there isn't one"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repo"
            }
          ],
          "comment": [
            "Get the currently active namespace for this repository"
          ],
          "group": "repository"
        },
        "git_repository_is_shallow": {
          "kind": "function",
          "name": "git_repository_is_shallow",
          "location": {
            "file": "repository.h",
            "line": 667,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "1 if shallow, zero if not"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repository"
            }
          ],
          "comment": [
            "Determine if the repository was a shallow clone"
          ],
          "group": "repository"
        },
        "git_repository": {
          "kind": "struct",
          "name": "git_repository",
          "referenceName": "struct git_repository",
          "opaque": true,
          "comment": [
            "Representation of an existing git repository,\n including all its object contents"
          ],
          "location": {
            "file": "types.h",
            "line": 105,
            "column": 31
          },
          "group": "repository",
          "returnedBy": [
            "git_blob_owner",
            "git_commit_owner",
            "git_index_owner",
            "git_object_owner",
            "git_reference_owner",
            "git_revwalk_repository",
            "git_submodule_owner",
            "git_tag_owner",
            "git_tree_owner"
          ],
          "parameterTo": [
            "git_attr_get",
            "git_attr_get_many",
            "git_attr_foreach",
            "git_attr_cache_flush",
            "git_attr_add_macro",
            "git_blob_lookup",
            "git_blob_lookup_prefix",
            "git_blob_create_fromworkdir",
            "git_blob_create_fromdisk",
            "git_blob_create_fromchunks",
            "git_blob_create_frombuffer",
            "git_branch_create",
            "git_branch_foreach",
            "git_branch_lookup",
            "git_branch_upstream_name",
            "git_branch_remote_name",
            "git_checkout_head",
            "git_checkout_index",
            "git_checkout_tree",
            "git_clone",
            "git_commit_lookup",
            "git_commit_lookup_prefix",
            "git_commit_create",
            "git_commit_create_v",
            "git_diff_tree_to_tree",
            "git_diff_tree_to_index",
            "git_diff_index_to_workdir",
            "git_diff_tree_to_workdir",
            "git_graph_ahead_behind",
            "git_ignore_add_rule",
            "git_ignore_clear_internal_rules",
            "git_ignore_path_is_ignored",
            "git_index_write_tree_to",
            "git_merge_base",
            "git_merge_base_many",
            "git_merge_head_from_ref",
            "git_merge_head_from_fetchhead",
            "git_merge_head_from_oid",
            "git_merge_trees",
            "git_note_iterator_new",
            "git_note_read",
            "git_note_create",
            "git_note_remove",
            "git_note_default_ref",
            "git_note_foreach",
            "git_object_lookup",
            "git_object_lookup_prefix",
            "git_packbuilder_new",
            "git_refdb_new",
            "git_refdb_open",
            "git_reference_lookup",
            "git_reference_name_to_id",
            "git_reference_dwim",
            "git_reference_symbolic_create",
            "git_reference_create",
            "git_reference_list",
            "git_reference_foreach",
            "git_reference_foreach_name",
            "git_reference_iterator_new",
            "git_reference_iterator_glob_new",
            "git_reference_foreach_glob",
            "git_remote_create",
            "git_remote_create_inmemory",
            "git_remote_load",
            "git_remote_list",
            "git_repository_open",
            "git_repository_wrap_odb",
            "git_repository_open_ext",
            "git_repository_open_bare",
            "git_repository_free",
            "git_repository_init",
            "git_repository_init_ext",
            "git_repository_head",
            "git_repository_head_detached",
            "git_repository_head_orphan",
            "git_repository_is_empty",
            "git_repository_path",
            "git_repository_workdir",
            "git_repository_set_workdir",
            "git_repository_is_bare",
            "git_repository_config",
            "git_repository_odb",
            "git_repository_refdb",
            "git_repository_index",
            "git_repository_message",
            "git_repository_message_remove",
            "git_repository_merge_cleanup",
            "git_repository_fetchhead_foreach",
            "git_repository_mergehead_foreach",
            "git_repository_hashfile",
            "git_repository_set_head",
            "git_repository_set_head_detached",
            "git_repository_detach_head",
            "git_repository_state",
            "git_repository_set_namespace",
            "git_repository_get_namespace",
            "git_repository_is_shallow",
            "git_reset",
            "git_reset_default",
            "git_revparse_single",
            "git_revparse_ext",
            "git_revparse",
            "git_revwalk_new",
            "git_stash_save",
            "git_stash_foreach",
            "git_stash_drop",
            "git_status_foreach",
            "git_status_foreach_ext",
            "git_status_file",
            "git_status_list_new",
            "git_status_should_ignore",
            "git_submodule_lookup",
            "git_submodule_foreach",
            "git_submodule_add_setup",
            "git_submodule_open",
            "git_submodule_reload_all",
            "git_tag_lookup",
            "git_tag_lookup_prefix",
            "git_tag_create",
            "git_tag_annotation_create",
            "git_tag_create_frombuffer",
            "git_tag_create_lightweight",
            "git_tag_delete",
            "git_tag_list",
            "git_tag_list_match",
            "git_tag_foreach",
            "git_tree_lookup",
            "git_tree_lookup_prefix",
            "git_tree_entry_to_object",
            "git_treebuilder_write",
            "git_commit_create_from_oids",
            "git_refdb_backend_fs",
            "git_repository_new",
            "git_repository__cleanup",
            "git_repository_set_config",
            "git_repository_set_odb",
            "git_repository_set_refdb",
            "git_repository_set_index"
          ]
        }
      },
      "info": {
        "summary": "Git repository management routines"
      }
    },
    "sys/repository": {
      "apis": {
        "git_repository_new": {
          "kind": "function",
          "name": "git_repository_new",
          "location": {
            "file": "sys/repository.h",
            "line": 28,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_repository **",
              "direction": "in",
              "comment": "The blank repository"
            }
          ],
          "comment": [
            "Create a new repository with neither backends nor config object",
            "Note that this is only useful if you wish to associate the repository\n with a non-filesystem-backed object database and config store."
          ],
          "group": "sys/repository"
        },
        "git_repository__cleanup": {
          "kind": "function",
          "name": "git_repository__cleanup",
          "location": {
            "file": "sys/repository.h",
            "line": 42,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *"
            }
          ],
          "comment": [
            "Reset all the internal state in a repository.",
            "This will free all the mapped memory and internal objects\n of the repository and leave it in a \"blank\" state.",
            "There's no need to call this function directly unless you're\n trying to aggressively cleanup the repo before its\n deallocation. `git_repository_free` already performs this operation\n before deallocation the repo."
          ],
          "group": "sys/repository"
        },
        "git_repository_set_config": {
          "kind": "function",
          "name": "git_repository_set_config",
          "location": {
            "file": "sys/repository.h",
            "line": 57,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            },
            {
              "name": "config",
              "type": "git_config *",
              "direction": "in",
              "comment": "A Config object"
            }
          ],
          "comment": [
            "Set the configuration file for this repository",
            "This configuration file will be used for all configuration\n queries involving this repository.",
            "The repository will keep a reference to the config file;\n the user must still free the config after setting it\n to the repository, or it will leak."
          ],
          "group": "sys/repository"
        },
        "git_repository_set_odb": {
          "kind": "function",
          "name": "git_repository_set_odb",
          "location": {
            "file": "sys/repository.h",
            "line": 72,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            },
            {
              "name": "odb",
              "type": "git_odb *",
              "direction": "in",
              "comment": "An ODB object"
            }
          ],
          "comment": [
            "Set the Object Database for this repository",
            "The ODB will be used for all object-related operations\n involving this repository.",
            "The repository will keep a reference to the ODB; the user\n must still free the ODB object after setting it to the\n repository, or it will leak."
          ],
          "group": "sys/repository"
        },
        "git_repository_set_refdb": {
          "kind": "function",
          "name": "git_repository_set_refdb",
          "location": {
            "file": "sys/repository.h",
            "line": 87,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            },
            {
              "name": "refdb",
              "type": "git_refdb *",
              "direction": "in",
              "comment": "An refdb object"
            }
          ],
          "comment": [
            "Set the Reference Database Backend for this repository",
            "The refdb will be used for all reference related operations\n involving this repository.",
            "The repository will keep a reference to the refdb; the user\n must still free the refdb object after setting it to the\n repository, or it will leak."
          ],
          "group": "sys/repository"
        },
        "git_repository_set_index": {
          "kind": "function",
          "name": "git_repository_set_index",
          "location": {
            "file": "sys/repository.h",
            "line": 102,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            },
            {
              "name": "index",
              "type": "git_index *",
              "direction": "in",
              "comment": "An index object"
            }
          ],
          "comment": [
            "Set the index file for this repository",
            "This index will be used for all index-related operations\n involving this repository.",
            "The repository will keep a reference to the index file;\n the user must still free the index after setting it\n to the repository, or it will leak."
          ],
          "group": "sys/repository"
        }
      },
      "info": {
        "summary": "Git repository custom implementation routines"
      }
    },
    "reset": {
      "apis": {
        "git_reset_t": {
          "kind": "enum",
          "name": "git_reset_t",
          "referenceName": "git_reset_t",
          "members": [
            {
              "name": "GIT_RESET_SOFT",
              "value": "1"
            },
            {
              "name": "GIT_RESET_MIXED",
              "value": "2",
              "comment": [
                "Move the head to the given commit"
              ]
            },
            {
              "name": "GIT_RESET_HARD",
              "value": "3",
              "comment": [
                "SOFT plus reset index to the commit"
              ]
            }
          ],
          "comment": [
            "Kinds of reset operation"
          ],
          "location": {
            "file": "reset.h",
            "line": 21,
            "column": 9
          },
          "group": "reset",
          "parameterTo": [
            "git_reset"
          ]
        },
        "git_reset": {
          "kind": "function",
          "name": "git_reset",
          "location": {
            "file": "reset.h",
            "line": 53,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success or an error code"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where to perform the reset operation."
            },
            {
              "name": "target",
              "type": "git_object *",
              "direction": "in",
              "comment": "Committish to which the Head should be moved to. This object\n must belong to the given `repo` and can either be a git_commit or a\n git_tag. When a git_tag is being passed, it should be dereferencable\n to a git_commit which oid will be used as the target of the branch."
            },
            {
              "name": "reset_type",
              "type": "git_reset_t",
              "direction": "in",
              "comment": "Kind of reset operation to perform.",
              "referenceType": "enum git_reset_t"
            }
          ],
          "comment": [
            "Sets the current head to the specified commit oid and optionally\n resets the index and working tree to match.",
            "SOFT reset means the Head will be moved to the commit.",
            "MIXED reset will trigger a SOFT reset, plus the index will be replaced\n with the content of the commit tree.",
            "HARD reset will trigger a MIXED reset and the working directory will be\n replaced with the content of the index.  (Untracked and ignored files\n will be left alone, however.)",
            "TODO: Implement remaining kinds of resets."
          ],
          "group": "reset"
        },
        "git_reset_default": {
          "kind": "function",
          "name": "git_reset_default",
          "location": {
            "file": "reset.h",
            "line": 74,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success or an error code \n<\n 0"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where to perform the reset operation."
            },
            {
              "name": "target",
              "type": "git_object *",
              "direction": "in",
              "comment": "The committish which content will be used to reset the content\n of the index."
            },
            {
              "name": "pathspecs",
              "type": "git_strarray *",
              "direction": "in",
              "comment": "List of pathspecs to operate on."
            }
          ],
          "comment": [
            "Updates some entries in the index from the target commit tree.",
            "The scope of the updated entries is determined by the paths\n being passed in the `pathspec` parameters.",
            "Passing a NULL `target` will result in removing\n entries in the index matching the provided pathspecs."
          ],
          "group": "reset"
        }
      },
      "info": {
        "summary": "Git reset management routines"
      }
    },
    "revparse": {
      "apis": {
        "git_revparse_single": {
          "kind": "function",
          "name": "git_revparse_single",
          "location": {
            "file": "revparse.h",
            "line": 33,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_ENOTFOUND, GIT_EAMBIGUOUS, GIT_EINVALIDSPEC or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_object **",
              "direction": "in",
              "comment": "pointer to output object"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository to search in"
            },
            {
              "name": "spec",
              "type": "const char *",
              "direction": "in",
              "comment": "the textual specification for an object"
            }
          ],
          "comment": [
            "Find a single object, as specified by a revision string. See `man gitrevisions`,\n or http://git-scm.com/docs/git-rev-parse.html#_specifying_revisions for\n information on the syntax accepted."
          ],
          "group": "revparse"
        },
        "git_revparse_ext": {
          "kind": "function",
          "name": "git_revparse_ext",
          "location": {
            "file": "revparse.h",
            "line": 52,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_ENOTFOUND, GIT_EAMBIGUOUS, GIT_EINVALIDSPEC\n or an error code"
          },
          "params": [
            {
              "name": "object_out",
              "type": "git_object **",
              "direction": "in",
              "comment": "pointer to output object"
            },
            {
              "name": "reference_out",
              "type": "git_reference **",
              "direction": "in",
              "comment": "pointer to output reference or NULL"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository to search in"
            },
            {
              "name": "spec",
              "type": "const char *",
              "direction": "in",
              "comment": "the textual specification for an object"
            }
          ],
          "comment": [
            "Find a single object, as specified by a revision string.\n See `man gitrevisions`,\n or http://git-scm.com/docs/git-rev-parse.html#_specifying_revisions for\n information on the syntax accepted.",
            "In some cases (`\n@\n{\n<\n-n>}` or `\n<branchname>\n@\n{upstream}`), the expression may\n point to an intermediate reference. When such expressions are being passed\n in, `reference_out` will be valued as well."
          ],
          "group": "revparse"
        },
        "git_revparse_mode_t": {
          "kind": "enum",
          "name": "git_revparse_mode_t",
          "referenceName": "git_revparse_mode_t",
          "members": [
            {
              "name": "GIT_REVPARSE_SINGLE",
              "value": "1",
              "comment": [
                "The spec targeted a single object."
              ]
            },
            {
              "name": "GIT_REVPARSE_RANGE",
              "value": "2",
              "comment": [
                "The spec targeted a range of commits."
              ]
            },
            {
              "name": "GIT_REVPARSE_MERGE_BASE",
              "value": "4",
              "comment": [
                "The spec used the '...' operator, which invokes special semantics."
              ]
            }
          ],
          "comment": [
            "Revparse flags.  These indicate the intended behavior of the spec passed to\n git_revparse."
          ],
          "location": {
            "file": "revparse.h",
            "line": 62,
            "column": 9
          },
          "group": "revparse"
        },
        "git_revspec": {
          "kind": "struct",
          "name": "git_revspec",
          "referenceName": "git_revspec",
          "comment": [
            "Git Revision Spec: output of a `git_revparse` operation"
          ],
          "members": [
            {
              "name": "from",
              "type": "git_object *",
              "comment": [
                "The left element of the revspec; must be freed by the user"
              ]
            },
            {
              "name": "to",
              "type": "git_object *",
              "comment": [
                "The right element of the revspec; must be freed by the user"
              ]
            },
            {
              "name": "flags",
              "type": "unsigned int",
              "comment": [
                "The intent of the revspec"
              ]
            }
          ],
          "location": {
            "file": "revparse.h",
            "line": 74,
            "column": 9
          },
          "group": "revparse",
          "parameterTo": [
            "git_revparse"
          ]
        },
        "git_revparse": {
          "kind": "function",
          "name": "git_revparse",
          "location": {
            "file": "revparse.h",
            "line": 94,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_INVALIDSPEC, GIT_ENOTFOUND, GIT_EAMBIGUOUS or an error code"
          },
          "params": [
            {
              "name": "revspec",
              "type": "git_revspec *",
              "direction": "in",
              "comment": "Pointer to an user-allocated git_revspec struct where the result\n\tof the rev-parse will be stored"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repository to search in"
            },
            {
              "name": "spec",
              "type": "const char *",
              "direction": "in",
              "comment": "the rev-parse spec to parse"
            }
          ],
          "comment": [
            "Parse a revision string for `from`, `to`, and intent. See `man gitrevisions` or\n http://git-scm.com/docs/git-rev-parse.html#_specifying_revisions for information\n on the syntax accepted."
          ],
          "group": "revparse"
        }
      },
      "info": {
        "summary": "Git revision parsing routines"
      }
    },
    "revwalk": {
      "apis": {
        "GIT_SORT_NONE": {
          "kind": "macro",
          "name": "GIT_SORT_NONE",
          "location": {
            "file": "revwalk.h",
            "line": 29,
            "column": 9
          },
          "value": "(0)",
          "comment": "Sort the repository contents in no particular ordering; this sorting is arbitrary, implementation-specific and subject to change at any time. This is the default sorting for new walkers.",
          "group": "revwalk"
        },
        "GIT_SORT_TOPOLOGICAL": {
          "kind": "macro",
          "name": "GIT_SORT_TOPOLOGICAL",
          "location": {
            "file": "revwalk.h",
            "line": 36,
            "column": 9
          },
          "value": "(1 << 0)",
          "comment": "Sort the repository contents in topological order (parents before children); this sorting mode can be combined with time sorting.",
          "group": "revwalk"
        },
        "GIT_SORT_TIME": {
          "kind": "macro",
          "name": "GIT_SORT_TIME",
          "location": {
            "file": "revwalk.h",
            "line": 43,
            "column": 9
          },
          "value": "(1 << 1)",
          "comment": "Sort the repository contents by commit time; this sorting mode can be combined with topological sorting.",
          "group": "revwalk"
        },
        "GIT_SORT_REVERSE": {
          "kind": "macro",
          "name": "GIT_SORT_REVERSE",
          "location": {
            "file": "revwalk.h",
            "line": 50,
            "column": 9
          },
          "value": "(1 << 2)",
          "comment": "Iterate through the repository contents in reverse order; this sorting mode can be combined with any of the above.",
          "group": "revwalk"
        },
        "git_revwalk_new": {
          "kind": "function",
          "name": "git_revwalk_new",
          "location": {
            "file": "revwalk.h",
            "line": 70,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_revwalk **",
              "direction": "in",
              "comment": "pointer to the new revision walker"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repo to walk through"
            }
          ],
          "comment": [
            "Allocate a new revision walker to iterate through a repo.",
            "This revision walker uses a custom memory pool and an internal\n commit cache, so it is relatively expensive to allocate.",
            "For maximum performance, this revision walker should be\n reused for different walks.",
            "This revision walker is *not* thread safe: it may only be\n used to walk a repository on a single thread; however,\n it is possible to have several revision walkers in\n several different threads walking the same repository."
          ],
          "group": "revwalk"
        },
        "git_revwalk_reset": {
          "kind": "function",
          "name": "git_revwalk_reset",
          "location": {
            "file": "revwalk.h",
            "line": 85,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "walker",
              "type": "git_revwalk *",
              "direction": "in",
              "comment": "handle to reset."
            }
          ],
          "comment": [
            "Reset the revision walker for reuse.",
            "This will clear all the pushed and hidden commits, and\n leave the walker in a blank state (just like at\n creation) ready to receive new commit pushes and\n start a new walk.",
            "The revision walk is automatically reset when a walk\n is over."
          ],
          "group": "revwalk"
        },
        "git_revwalk_push": {
          "kind": "function",
          "name": "git_revwalk_push",
          "location": {
            "file": "revwalk.h",
            "line": 102,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "walk",
              "type": "git_revwalk *",
              "direction": "in",
              "comment": "the walker being used for the traversal."
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "the oid of the commit to start from."
            }
          ],
          "comment": [
            "Mark a commit to start traversal from.",
            "The given OID must belong to a commit on the walked\n repository.",
            "The given commit will be used as one of the roots\n when starting the revision walk. At least one commit\n must be pushed onto the walker before a walk can\n be started."
          ],
          "group": "revwalk"
        },
        "git_revwalk_push_glob": {
          "kind": "function",
          "name": "git_revwalk_push_glob",
          "location": {
            "file": "revwalk.h",
            "line": 117,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "walk",
              "type": "git_revwalk *",
              "direction": "in",
              "comment": "the walker being used for the traversal"
            },
            {
              "name": "glob",
              "type": "const char *",
              "direction": "in",
              "comment": "the glob pattern references should match"
            }
          ],
          "comment": [
            "Push matching references",
            "The OIDs pointed to by the references that match the given glob\n pattern will be pushed to the revision walker.",
            "A leading 'refs/' is implied if not present as well as a trailing\n '/ *' if the glob lacks '?', '*' or '['."
          ],
          "group": "revwalk"
        },
        "git_revwalk_push_head": {
          "kind": "function",
          "name": "git_revwalk_push_head",
          "location": {
            "file": "revwalk.h",
            "line": 125,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "walk",
              "type": "git_revwalk *",
              "direction": "in",
              "comment": "the walker being used for the traversal"
            }
          ],
          "comment": [
            "Push the repository's HEAD"
          ],
          "group": "revwalk"
        },
        "git_revwalk_hide": {
          "kind": "function",
          "name": "git_revwalk_hide",
          "location": {
            "file": "revwalk.h",
            "line": 140,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "walk",
              "type": "git_revwalk *",
              "direction": "in",
              "comment": "the walker being used for the traversal."
            },
            {
              "name": "commit_id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "the oid of commit that will be ignored during the traversal"
            }
          ],
          "comment": [
            "Mark a commit (and its ancestors) uninteresting for the output.",
            "The given OID must belong to a commit on the walked\n repository.",
            "The resolved commit and all its parents will be hidden from the\n output on the revision walk."
          ],
          "group": "revwalk"
        },
        "git_revwalk_hide_glob": {
          "kind": "function",
          "name": "git_revwalk_hide_glob",
          "location": {
            "file": "revwalk.h",
            "line": 156,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "walk",
              "type": "git_revwalk *",
              "direction": "in",
              "comment": "the walker being used for the traversal"
            },
            {
              "name": "glob",
              "type": "const char *",
              "direction": "in",
              "comment": "the glob pattern references should match"
            }
          ],
          "comment": [
            "Hide matching references.",
            "The OIDs pointed to by the references that match the given glob\n pattern and their ancestors will be hidden from the output on the\n revision walk.",
            "A leading 'refs/' is implied if not present as well as a trailing\n '/ *' if the glob lacks '?', '*' or '['."
          ],
          "group": "revwalk"
        },
        "git_revwalk_hide_head": {
          "kind": "function",
          "name": "git_revwalk_hide_head",
          "location": {
            "file": "revwalk.h",
            "line": 164,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "walk",
              "type": "git_revwalk *",
              "direction": "in",
              "comment": "the walker being used for the traversal"
            }
          ],
          "comment": [
            "Hide the repository's HEAD"
          ],
          "group": "revwalk"
        },
        "git_revwalk_push_ref": {
          "kind": "function",
          "name": "git_revwalk_push_ref",
          "location": {
            "file": "revwalk.h",
            "line": 175,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "walk",
              "type": "git_revwalk *",
              "direction": "in",
              "comment": "the walker being used for the traversal"
            },
            {
              "name": "refname",
              "type": "const char *",
              "direction": "in",
              "comment": "the reference to push"
            }
          ],
          "comment": [
            "Push the OID pointed to by a reference",
            "The reference must point to a commit."
          ],
          "group": "revwalk"
        },
        "git_revwalk_hide_ref": {
          "kind": "function",
          "name": "git_revwalk_hide_ref",
          "location": {
            "file": "revwalk.h",
            "line": 186,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "walk",
              "type": "git_revwalk *",
              "direction": "in",
              "comment": "the walker being used for the traversal"
            },
            {
              "name": "refname",
              "type": "const char *",
              "direction": "in",
              "comment": "the reference to hide"
            }
          ],
          "comment": [
            "Hide the OID pointed to by a reference",
            "The reference must point to a commit."
          ],
          "group": "revwalk"
        },
        "git_revwalk_next": {
          "kind": "function",
          "name": "git_revwalk_next",
          "location": {
            "file": "revwalk.h",
            "line": 206,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 if the next commit was found;\n\tGIT_ITEROVER if there are no commits left to iterate"
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "Pointer where to store the oid of the next commit"
            },
            {
              "name": "walk",
              "type": "git_revwalk *",
              "direction": "in",
              "comment": "the walker to pop the commit from."
            }
          ],
          "comment": [
            "Get the next commit from the revision walk.",
            "The initial call to this method is *not* blocking when\n iterating through a repo with a time-sorting mode.",
            "Iterating with Topological or inverted modes makes the initial\n call blocking to preprocess the commit list, but this block should be\n mostly unnoticeable on most repositories (topological preprocessing\n times at 0.3s on the git.git repo).",
            "The revision walker is reset when the walk is over."
          ],
          "group": "revwalk"
        },
        "git_revwalk_sorting": {
          "kind": "function",
          "name": "git_revwalk_sorting",
          "location": {
            "file": "revwalk.h",
            "line": 217,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "walk",
              "type": "git_revwalk *",
              "direction": "in",
              "comment": "the walker being used for the traversal."
            },
            {
              "name": "sort_mode",
              "type": "unsigned int",
              "direction": "in",
              "comment": "combination of GIT_SORT_XXX flags"
            }
          ],
          "comment": [
            "Change the sorting mode when iterating through the\n repository's contents.",
            "Changing the sorting mode resets the walker."
          ],
          "group": "revwalk"
        },
        "git_revwalk_push_range": {
          "kind": "function",
          "name": "git_revwalk_push_range",
          "location": {
            "file": "revwalk.h",
            "line": 232,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "walk",
              "type": "git_revwalk *",
              "direction": "in",
              "comment": "the walker being used for the traversal"
            },
            {
              "name": "range",
              "type": "const char *",
              "direction": "in",
              "comment": "the range"
            }
          ],
          "comment": [
            "Push and hide the respective endpoints of the given range.",
            "The range should be of the form\n   \n<commit>..\n<commit>\n where each \n<commit> is in the form accepted by 'git_revparse_single'.\n The left-hand commit will be hidden and the right-hand commit pushed."
          ],
          "group": "revwalk"
        },
        "git_revwalk_free": {
          "kind": "function",
          "name": "git_revwalk_free",
          "location": {
            "file": "revwalk.h",
            "line": 239,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "walk",
              "type": "git_revwalk *",
              "direction": "in",
              "comment": "traversal handle to close. If NULL nothing occurs."
            }
          ],
          "comment": [
            "Free a revision walker previously allocated."
          ],
          "group": "revwalk"
        },
        "git_revwalk_repository": {
          "kind": "function",
          "name": "git_revwalk_repository",
          "location": {
            "file": "revwalk.h",
            "line": 248,
            "column": 30
          },
          "returns": {
            "type": "git_repository *",
            "comment": "the repository being walked"
          },
          "params": [
            {
              "name": "walk",
              "type": "git_revwalk *",
              "direction": "in",
              "comment": "the revision walker"
            }
          ],
          "comment": [
            "Return the repository on which this walker\n is operating."
          ],
          "group": "revwalk"
        },
        "git_revwalk": {
          "kind": "struct",
          "name": "git_revwalk",
          "referenceName": "struct git_revwalk",
          "opaque": true,
          "comment": [
            "Representation of an in-progress walk through the commits in a repo"
          ],
          "location": {
            "file": "types.h",
            "line": 111,
            "column": 28
          },
          "group": "revwalk",
          "parameterTo": [
            "git_revwalk_new",
            "git_revwalk_reset",
            "git_revwalk_push",
            "git_revwalk_push_glob",
            "git_revwalk_push_head",
            "git_revwalk_hide",
            "git_revwalk_hide_glob",
            "git_revwalk_hide_head",
            "git_revwalk_push_ref",
            "git_revwalk_hide_ref",
            "git_revwalk_next",
            "git_revwalk_sorting",
            "git_revwalk_push_range",
            "git_revwalk_free",
            "git_revwalk_repository"
          ]
        }
      },
      "info": {
        "summary": "Git revision traversal routines"
      }
    },
    "signature": {
      "apis": {
        "git_signature_new": {
          "kind": "function",
          "name": "git_signature_new",
          "location": {
            "file": "signature.h",
            "line": 37,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_signature **",
              "direction": "in",
              "comment": "new signature, in case of error NULL"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "name of the person"
            },
            {
              "name": "email",
              "type": "const char *",
              "direction": "in",
              "comment": "email of the person"
            },
            {
              "name": "time",
              "type": "git_time_t",
              "direction": "in",
              "comment": "time when the action happened",
              "referenceType": "int64_t"
            },
            {
              "name": "offset",
              "type": "int",
              "direction": "in",
              "comment": "timezone offset in minutes for the time"
            }
          ],
          "comment": [
            "Create a new action signature.",
            "Call `git_signature_free()` to free the data.",
            "Note: angle brackets ('\n<\n' and '>') characters are not allowed\n to be used in either the `name` or the `email` parameter."
          ],
          "group": "signature"
        },
        "git_signature_now": {
          "kind": "function",
          "name": "git_signature_now",
          "location": {
            "file": "signature.h",
            "line": 49,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_signature **",
              "direction": "in",
              "comment": "new signature, in case of error NULL"
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "name of the person"
            },
            {
              "name": "email",
              "type": "const char *",
              "direction": "in",
              "comment": "email of the person"
            }
          ],
          "comment": [
            "Create a new action signature with a timestamp of 'now'.",
            "Call `git_signature_free()` to free the data."
          ],
          "group": "signature"
        },
        "git_signature_dup": {
          "kind": "function",
          "name": "git_signature_dup",
          "location": {
            "file": "signature.h",
            "line": 61,
            "column": 29
          },
          "returns": {
            "type": "git_signature *",
            "comment": "a copy of sig, NULL on out of memory"
          },
          "params": [
            {
              "name": "sig",
              "type": "const git_signature *",
              "direction": "in",
              "comment": "signature to duplicated"
            }
          ],
          "comment": [
            "Create a copy of an existing signature.  All internal strings are also\n duplicated.",
            "Call `git_signature_free()` to free the data."
          ],
          "group": "signature"
        },
        "git_signature_free": {
          "kind": "function",
          "name": "git_signature_free",
          "location": {
            "file": "signature.h",
            "line": 72,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "sig",
              "type": "git_signature *",
              "direction": "in",
              "comment": "signature to free"
            }
          ],
          "comment": [
            "Free an existing signature.",
            "Because the signature is not an opaque structure, it is legal to free it\n manually, but be sure to free the \"name\" and \"email\" strings in addition\n to the structure itself."
          ],
          "group": "signature"
        },
        "git_signature": {
          "kind": "struct",
          "name": "git_signature",
          "referenceName": "git_signature",
          "comment": [
            "An action signature (e.g. for committers, taggers, etc)"
          ],
          "members": [
            {
              "name": "name",
              "type": "char *"
            },
            {
              "name": "email",
              "type": "char *",
              "comment": [
                "full name of the author"
              ]
            },
            {
              "name": "when",
              "type": "git_time",
              "comment": [
                "email of the author"
              ],
              "referenceType": "struct git_time"
            }
          ],
          "location": {
            "file": "types.h",
            "line": 162,
            "column": 16
          },
          "group": "signature",
          "returnedBy": [
            "git_commit_committer",
            "git_commit_author",
            "git_reflog_entry_committer",
            "git_signature_dup",
            "git_tag_tagger"
          ],
          "parameterTo": [
            "git_commit_create",
            "git_commit_create_v",
            "git_note_create",
            "git_note_remove",
            "git_reflog_append",
            "git_signature_new",
            "git_signature_now",
            "git_signature_dup",
            "git_signature_free",
            "git_stash_save",
            "git_tag_create",
            "git_tag_annotation_create",
            "git_commit_create_from_oids"
          ]
        }
      },
      "info": {
        "summary": "Git signature creation"
      }
    },
    "stash": {
      "apis": {
        "git_stash_flags": {
          "kind": "enum",
          "name": "git_stash_flags",
          "referenceName": "git_stash_flags",
          "members": [
            {
              "name": "GIT_STASH_DEFAULT",
              "value": "0"
            },
            {
              "name": "GIT_STASH_KEEP_INDEX",
              "value": "1"
            },
            {
              "name": "GIT_STASH_INCLUDE_UNTRACKED",
              "value": "2"
            },
            {
              "name": "GIT_STASH_INCLUDE_IGNORED",
              "value": "4"
            }
          ],
          "location": {
            "file": "stash.h",
            "line": 21,
            "column": 9
          },
          "group": "stash"
        },
        "git_stash_save": {
          "kind": "function",
          "name": "git_stash_save",
          "location": {
            "file": "stash.h",
            "line": 57,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_ENOTFOUND where there's nothing to stash,\n or error code."
          },
          "params": [
            {
              "name": "out",
              "type": "git_oid *",
              "direction": "in",
              "comment": "Object id of the commit containing the stashed state.\n This commit is also the target of the direct reference refs/stash."
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The owning repository."
            },
            {
              "name": "stasher",
              "type": "git_signature *",
              "direction": "in",
              "comment": "The identity of the person performing the stashing."
            },
            {
              "name": "message",
              "type": "const char *",
              "direction": "in",
              "comment": "Optional description along with the stashed state."
            },
            {
              "name": "flags",
              "type": "unsigned int",
              "direction": "in",
              "comment": "Flags to control the stashing process. (see GIT_STASH_* above)"
            }
          ],
          "comment": [
            "Save the local modifications to a new stash."
          ],
          "group": "stash"
        },
        "git_stash_cb": {
          "kind": "callback",
          "name": "git_stash_cb",
          "type": "int (*)(size_t, const char *, const git_oid *, void *)",
          "comment": [
            "When iterating over all the stashed states, callback that will be\n issued per entry."
          ],
          "location": {
            "file": "stash.h",
            "line": 79,
            "column": 15
          },
          "params": [
            {
              "name": "index",
              "direction": "in",
              "comment": "The position within the stash list. 0 points to the\n most recent stashed state.",
              "type": "size_t"
            },
            {
              "name": "message",
              "direction": "in",
              "comment": "The stash message.",
              "type": "const char *"
            },
            {
              "name": "stash_id",
              "direction": "in",
              "comment": "The commit oid of the stashed state.",
              "type": "const git_oid *"
            },
            {
              "name": "payload",
              "direction": "in",
              "comment": "Extra parameter to callback function.",
              "type": "void *"
            }
          ],
          "returns": {
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code",
            "type": "int"
          },
          "group": "stash",
          "parameterTo": [
            "git_stash_foreach"
          ],
          "typedef": true
        },
        "git_stash_foreach": {
          "kind": "function",
          "name": "git_stash_foreach",
          "location": {
            "file": "stash.h",
            "line": 99,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where to find the stash."
            },
            {
              "name": "callback",
              "type": "git_stash_cb",
              "direction": "in",
              "comment": "Callback to invoke per found stashed state. The most recent\n stash state will be enumerated first.",
              "referenceType": "int (*)(size_t, const char *, const git_oid *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Extra parameter to callback function."
            }
          ],
          "comment": [
            "Loop over all the stashed states and issue a callback for each one.",
            "If the callback returns a non-zero value, this will stop looping."
          ],
          "group": "stash"
        },
        "git_stash_drop": {
          "kind": "function",
          "name": "git_stash_drop",
          "location": {
            "file": "stash.h",
            "line": 115,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, or error code"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The owning repository."
            },
            {
              "name": "index",
              "type": "size_t",
              "direction": "in",
              "comment": "The position within the stash list. 0 points to the\n most recent stashed state."
            }
          ],
          "comment": [
            "Remove a single stashed state from the stash list."
          ],
          "group": "stash"
        }
      },
      "info": {
        "summary": "Git stash management routines"
      }
    },
    "status": {
      "apis": {
        "git_status_t": {
          "kind": "enum",
          "name": "git_status_t",
          "referenceName": "git_status_t",
          "members": [
            {
              "name": "GIT_STATUS_CURRENT",
              "value": "0"
            },
            {
              "name": "GIT_STATUS_INDEX_NEW"
            },
            {
              "name": "GIT_STATUS_INDEX_MODIFIED"
            },
            {
              "name": "GIT_STATUS_INDEX_DELETED"
            },
            {
              "name": "GIT_STATUS_INDEX_RENAMED"
            },
            {
              "name": "GIT_STATUS_INDEX_TYPECHANGE"
            },
            {
              "name": "GIT_STATUS_WT_NEW"
            },
            {
              "name": "GIT_STATUS_WT_MODIFIED"
            },
            {
              "name": "GIT_STATUS_WT_DELETED"
            },
            {
              "name": "GIT_STATUS_WT_TYPECHANGE"
            },
            {
              "name": "GIT_STATUS_WT_RENAMED"
            },
            {
              "name": "GIT_STATUS_IGNORED"
            }
          ],
          "comment": [
            "Status flags for a single file.",
            "A combination of these values will be returned to indicate the status of\n a file.  Status compares the working directory, the index, and the\n current HEAD of the repository.  The `GIT_STATUS_INDEX` set of flags\n represents the status of file in the index relative to the HEAD, and the\n `GIT_STATUS_WT` set of flags represent the status of the file in the\n working directory relative to the index."
          ],
          "location": {
            "file": "status.h",
            "line": 32,
            "column": 9
          },
          "group": "status"
        },
        "git_status_cb": {
          "kind": "callback",
          "name": "git_status_cb",
          "type": "int (*)(const char *, unsigned int, void *)",
          "comment": [
            "Function pointer to receive status on individual files",
            "`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."
          ],
          "location": {
            "file": "status.h",
            "line": 59,
            "column": 15
          },
          "params": [
            {
              "type": "const char *"
            },
            {
              "type": "unsigned int"
            },
            {
              "type": "void *"
            }
          ],
          "group": "status",
          "parameterTo": [
            "git_status_foreach",
            "git_status_foreach_ext"
          ],
          "typedef": true
        },
        "git_status_show_t": {
          "kind": "enum",
          "name": "git_status_show_t",
          "referenceName": "git_status_show_t",
          "members": [
            {
              "name": "GIT_STATUS_SHOW_INDEX_AND_WORKDIR",
              "value": "0"
            },
            {
              "name": "GIT_STATUS_SHOW_INDEX_ONLY",
              "value": "1"
            },
            {
              "name": "GIT_STATUS_SHOW_WORKDIR_ONLY",
              "value": "2"
            },
            {
              "name": "GIT_STATUS_SHOW_INDEX_THEN_WORKDIR",
              "value": "3"
            }
          ],
          "comment": [
            "For extended status, select the files on which to report status.",
            "- GIT_STATUS_SHOW_INDEX_AND_WORKDIR is the default.  This roughly\n   matches `git status --porcelain` where each file gets a callback\n   indicating its status in the index and in the working directory.\n - GIT_STATUS_SHOW_INDEX_ONLY only gives status based on HEAD to index\n   comparison, not looking at working directory changes.\n - GIT_STATUS_SHOW_WORKDIR_ONLY only gives status based on index to\n   working directory comparison, not comparing the index to the HEAD.\n - GIT_STATUS_SHOW_INDEX_THEN_WORKDIR runs index-only then workdir-only,\n   issuing (up to) two callbacks per file (first index, then workdir).\n   This is slightly more efficient than separate calls and can make it\n   easier to emulate plain `git status` text output."
          ],
          "location": {
            "file": "status.h",
            "line": 77,
            "column": 9
          },
          "group": "status"
        },
        "git_status_opt_t": {
          "kind": "enum",
          "name": "git_status_opt_t",
          "referenceName": "git_status_opt_t",
          "members": [
            {
              "name": "GIT_STATUS_OPT_INCLUDE_UNTRACKED"
            },
            {
              "name": "GIT_STATUS_OPT_INCLUDE_IGNORED"
            },
            {
              "name": "GIT_STATUS_OPT_INCLUDE_UNMODIFIED"
            },
            {
              "name": "GIT_STATUS_OPT_EXCLUDE_SUBMODULES"
            },
            {
              "name": "GIT_STATUS_OPT_RECURSE_UNTRACKED_DIRS"
            },
            {
              "name": "GIT_STATUS_OPT_DISABLE_PATHSPEC_MATCH"
            },
            {
              "name": "GIT_STATUS_OPT_RECURSE_IGNORED_DIRS"
            },
            {
              "name": "GIT_STATUS_OPT_RENAMES_HEAD_TO_INDEX"
            },
            {
              "name": "GIT_STATUS_OPT_RENAMES_INDEX_TO_WORKDIR"
            },
            {
              "name": "GIT_STATUS_OPT_SORT_CASE_SENSITIVELY"
            },
            {
              "name": "GIT_STATUS_OPT_SORT_CASE_INSENSITIVELY"
            }
          ],
          "comment": [
            "Flags to control status callbacks",
            "- GIT_STATUS_OPT_INCLUDE_UNTRACKED says that callbacks should be made\n   on untracked files.  These will only be made if the workdir files are\n   included in the status \"show\" option.\n - GIT_STATUS_OPT_INCLUDE_IGNORED says that ignored files get callbacks.\n   Again, these callbacks will only be made if the workdir files are\n   included in the status \"show\" option.\n - GIT_STATUS_OPT_INCLUDE_UNMODIFIED indicates that callback should be\n   made even on unmodified files.\n - GIT_STATUS_OPT_EXCLUDE_SUBMODULES indicates that submodules should be\n   skipped.  This only applies if there are no pending typechanges to\n   the submodule (either from or to another type).\n - GIT_STATUS_OPT_RECURSE_UNTRACKED_DIRS indicates that all files in\n   untracked directories should be included.  Normally if an entire\n   directory is new, then just the top-level directory is included (with\n   a trailing slash on the entry name).  This flag says to include all\n   of the individual files in the directory instead.\n - GIT_STATUS_OPT_DISABLE_PATHSPEC_MATCH indicates that the given path\n   should be treated as a literal path, and not as a pathspec pattern.\n - GIT_STATUS_OPT_RECURSE_IGNORED_DIRS indicates that the contents of\n   ignored directories should be included in the status.  This is like\n   doing `git ls-files -o -i --exclude-standard` with core git.\n - GIT_STATUS_OPT_RENAMES_HEAD_TO_INDEX indicates that rename detection\n   should be processed between the head and the index and enables\n   the GIT_STATUS_INDEX_RENAMED as a possible status flag.\n - GIT_STATUS_OPT_RENAMES_INDEX_TO_WORKDIR indicates tha rename\n   detection should be run between the index and the working directory\n   and enabled GIT_STATUS_WT_RENAMED as a possible status flag.\n - GIT_STATUS_OPT_SORT_CASE_SENSITIVELY overrides the native case\n   sensitivity for the file system and forces the output to be in\n   case-sensitive order\n - GIT_STATUS_OPT_SORT_CASE_INSENSITIVELY overrides the native case\n   sensitivity for the file system and forces the output to be in\n   case-insensitive order",
            "Calling `git_status_foreach()` is like calling the extended version\n with: GIT_STATUS_OPT_INCLUDE_IGNORED, GIT_STATUS_OPT_INCLUDE_UNTRACKED,\n and GIT_STATUS_OPT_RECURSE_UNTRACKED_DIRS.  Those options are bundled\n together as `GIT_STATUS_OPT_DEFAULTS` if you want them as a baseline."
          ],
          "location": {
            "file": "status.h",
            "line": 126,
            "column": 9
          },
          "group": "status"
        },
        "GIT_STATUS_OPT_DEFAULTS": {
          "kind": "macro",
          "name": "GIT_STATUS_OPT_DEFAULTS",
          "location": {
            "file": "status.h",
            "line": 143,
            "column": 9
          },
          "value": " (GIT_STATUS_OPT_INCLUDE_IGNORED | GIT_STATUS_OPT_INCLUDE_UNTRACKED | GIT_STATUS_OPT_RECURSE_UNTRACKED_DIRS)",
          "comment": "",
          "group": "status"
        },
        "git_status_options": {
          "kind": "struct",
          "name": "git_status_options",
          "referenceName": "git_status_options",
          "comment": [
            "Options to control how `git_status_foreach_ext()` will issue callbacks.",
            "This structure is set so that zeroing it out will give you relatively\n sane defaults.",
            "The `show` value is one of the `git_status_show_t` constants that\n control which files to scan and in what order.",
            "The `flags` value is an OR'ed combination of the `git_status_opt_t`\n values above.",
            "The `pathspec` is an array of path patterns to match (using\n fnmatch-style matching), or just an array of paths to match exactly if\n `GIT_STATUS_OPT_DISABLE_PATHSPEC_MATCH` is specified in the flags."
          ],
          "members": [
            {
              "name": "version",
              "type": "unsigned int"
            },
            {
              "name": "show",
              "type": "git_status_show_t",
              "referenceType": "enum git_status_show_t"
            },
            {
              "name": "flags",
              "type": "unsigned int"
            },
            {
              "name": "pathspec",
              "type": "git_strarray",
              "referenceType": "struct git_strarray"
            }
          ],
          "location": {
            "file": "status.h",
            "line": 161,
            "column": 9
          },
          "group": "status",
          "parameterTo": [
            "git_status_foreach_ext",
            "git_status_list_new"
          ]
        },
        "GIT_STATUS_OPTIONS_VERSION": {
          "kind": "macro",
          "name": "GIT_STATUS_OPTIONS_VERSION",
          "location": {
            "file": "status.h",
            "line": 168,
            "column": 9
          },
          "value": "1",
          "comment": "",
          "group": "status"
        },
        "GIT_STATUS_OPTIONS_INIT": {
          "kind": "macro",
          "name": "GIT_STATUS_OPTIONS_INIT",
          "location": {
            "file": "status.h",
            "line": 169,
            "column": 9
          },
          "value": "{GIT_STATUS_OPTIONS_VERSION}",
          "comment": "",
          "group": "status"
        },
        "git_status_entry": {
          "kind": "struct",
          "name": "git_status_entry",
          "referenceName": "git_status_entry",
          "comment": [
            "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.",
            "The `status` value provides the status flags for this file.",
            "The `head_to_index` value provides detailed information about the\n differences between the file in HEAD and the file in the index.",
            "The `index_to_workdir` value provides detailed information about the\n differences between the file in the index and the file in the\n working directory."
          ],
          "members": [
            {
              "name": "status",
              "type": "git_status_t",
              "referenceType": "enum git_status_t"
            },
            {
              "name": "head_to_index",
              "type": "git_diff_delta *"
            },
            {
              "name": "index_to_workdir",
              "type": "git_diff_delta *"
            }
          ],
          "location": {
            "file": "status.h",
            "line": 185,
            "column": 9
          },
          "group": "status",
          "returnedBy": [
            "git_status_byindex"
          ]
        },
        "git_status_foreach": {
          "kind": "function",
          "name": "git_status_foreach",
          "location": {
            "file": "status.h",
            "line": 207,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            },
            {
              "name": "callback",
              "type": "git_status_cb",
              "direction": "in",
              "comment": "The function to call on each file",
              "referenceType": "int (*)(const char *, unsigned int, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Pointer to pass through to callback function"
            }
          ],
          "comment": [
            "Gather file statuses and run a callback for each one.",
            "The callback is passed the path of the file, the status (a combination of\n the `git_status_t` values above) and the `payload` data pointer passed\n into this function.",
            "If the callback returns a non-zero value, this function will stop looping\n and return GIT_EUSER."
          ],
          "group": "status"
        },
        "git_status_foreach_ext": {
          "kind": "function",
          "name": "git_status_foreach_ext",
          "location": {
            "file": "status.h",
            "line": 226,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EUSER on non-zero callback, or error code"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository object"
            },
            {
              "name": "opts",
              "type": "const git_status_options *",
              "direction": "in",
              "comment": "Status options structure"
            },
            {
              "name": "callback",
              "type": "git_status_cb",
              "direction": "in",
              "comment": "The function to call on each file",
              "referenceType": "int (*)(const char *, unsigned int, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Pointer to pass through to callback function"
            }
          ],
          "comment": [
            "Gather file status information and run callbacks as requested.",
            "This is an extended version of the `git_status_foreach()` API that\n allows for more granular control over which paths will be processed and\n in what order.  See the `git_status_options` structure for details\n about the additional controls that this makes available."
          ],
          "group": "status"
        },
        "git_status_file": {
          "kind": "function",
          "name": "git_status_file",
          "location": {
            "file": "status.h",
            "line": 245,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_ENOTFOUND if the file is not found in the HEAD,\n      index, and work tree, GIT_EINVALIDPATH if `path` points at a folder,\n      GIT_EAMBIGUOUS if \"path\" matches multiple files, -1 on other error."
          },
          "params": [
            {
              "name": "status_flags",
              "type": "unsigned int *",
              "direction": "in",
              "comment": "The status value for the file"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "The file to retrieve status for, rooted at the repo's workdir"
            }
          ],
          "comment": [
            "Get file status for a single file.",
            "This is not quite the same as calling `git_status_foreach_ext()` with\n the pathspec set to the specified path."
          ],
          "group": "status"
        },
        "git_status_list_new": {
          "kind": "function",
          "name": "git_status_list_new",
          "location": {
            "file": "status.h",
            "line": 258,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success or error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_status_list **",
              "direction": "in",
              "comment": "Pointer to store the status results in"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository object"
            },
            {
              "name": "opts",
              "type": "const git_status_options *",
              "direction": "in",
              "comment": "Status options structure"
            }
          ],
          "comment": [
            "Gather file status information and populate the `git_status_list`."
          ],
          "group": "status"
        },
        "git_status_list_entrycount": {
          "kind": "function",
          "name": "git_status_list_entrycount",
          "location": {
            "file": "status.h",
            "line": 269,
            "column": 20
          },
          "returns": {
            "type": "size_t",
            "comment": "the number of status entries"
          },
          "params": [
            {
              "name": "statuslist",
              "type": "git_status_list *",
              "direction": "in",
              "comment": "Existing status list object"
            }
          ],
          "comment": [
            "Gets the count of status entries in this list."
          ],
          "group": "status"
        },
        "git_status_byindex": {
          "kind": "function",
          "name": "git_status_byindex",
          "location": {
            "file": "status.h",
            "line": 281,
            "column": 38
          },
          "returns": {
            "type": "const git_status_entry *",
            "comment": "Pointer to the entry; NULL if out of bounds"
          },
          "params": [
            {
              "name": "statuslist",
              "type": "git_status_list *",
              "direction": "in",
              "comment": "Existing status list object"
            },
            {
              "name": "idx",
              "type": "size_t",
              "direction": "in",
              "comment": "Position of the entry"
            }
          ],
          "comment": [
            "Get a pointer to one of the entries in the status list.",
            "The entry is not modifiable and should not be freed."
          ],
          "group": "status"
        },
        "git_status_list_free": {
          "kind": "function",
          "name": "git_status_list_free",
          "location": {
            "file": "status.h",
            "line": 290,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "statuslist",
              "type": "git_status_list *",
              "direction": "in",
              "comment": "Existing status list object"
            }
          ],
          "comment": [
            "Free an existing status list"
          ],
          "group": "status"
        },
        "git_status_should_ignore": {
          "kind": "function",
          "name": "git_status_should_ignore",
          "location": {
            "file": "status.h",
            "line": 309,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 if ignore rules could be processed for the file (regardless\n         of whether it exists or not), or an error \n<\n 0 if they could not."
          },
          "params": [
            {
              "name": "ignored",
              "type": "int *",
              "direction": "in",
              "comment": "Boolean returning 0 if the file is not ignored, 1 if it is"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "A repository object"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "The file to check ignores for, rooted at the repo's workdir."
            }
          ],
          "comment": [
            "Test if the ignore rules apply to a given file.",
            "This function checks the ignore rules to see if they would apply to the\n given file.  This indicates if the file would be ignored regardless of\n whether the file is already in the index or committed to the repository.",
            "One way to think of this is if you were to do \"git add .\" on the\n directory containing the file, would it be added or not?"
          ],
          "group": "status"
        },
        "git_status_list": {
          "kind": "struct",
          "name": "git_status_list",
          "referenceName": "struct git_status_list",
          "opaque": true,
          "comment": [
            "Representation of a status collection"
          ],
          "location": {
            "file": "types.h",
            "line": 178,
            "column": 32
          },
          "group": "status",
          "parameterTo": [
            "git_status_list_new",
            "git_status_list_entrycount",
            "git_status_byindex",
            "git_status_list_free"
          ]
        }
      },
      "info": {
        "summary": "Git file status routines"
      }
    },
    "strarray": {
      "apis": {
        "git_strarray": {
          "kind": "struct",
          "name": "git_strarray",
          "referenceName": "git_strarray",
          "comment": [
            "Array of strings"
          ],
          "members": [
            {
              "name": "strings",
              "type": "char **"
            },
            {
              "name": "count",
              "type": "size_t"
            }
          ],
          "location": {
            "file": "strarray.h",
            "line": 22,
            "column": 16
          },
          "group": "strarray",
          "parameterTo": [
            "git_index_add_all",
            "git_index_remove_all",
            "git_index_update_all",
            "git_reference_list",
            "git_remote_get_fetch_refspecs",
            "git_remote_get_push_refspecs",
            "git_remote_list",
            "git_reset_default",
            "git_strarray_free",
            "git_strarray_copy",
            "git_tag_list",
            "git_tag_list_match"
          ]
        },
        "git_strarray_free": {
          "kind": "function",
          "name": "git_strarray_free",
          "location": {
            "file": "strarray.h",
            "line": 41,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "array",
              "type": "git_strarray *",
              "direction": "in",
              "comment": "git_strarray from which to free string data"
            }
          ],
          "comment": [
            "Close a string array object",
            "This method should be called on `git_strarray` objects where the strings\n array is allocated and contains allocated strings, such as what you\n would get from `git_strarray_copy()`.  Not doing so, will result in a\n memory leak.",
            "This does not free the `git_strarray` itself, since the library will\n never allocate that object directly itself (it is more commonly embedded\n inside another struct or created on the stack)."
          ],
          "group": "strarray"
        },
        "git_strarray_copy": {
          "kind": "function",
          "name": "git_strarray_copy",
          "location": {
            "file": "strarray.h",
            "line": 53,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, \n<\n 0 on allocation failure"
          },
          "params": [
            {
              "name": "tgt",
              "type": "git_strarray *",
              "direction": "in",
              "comment": "target"
            },
            {
              "name": "src",
              "type": "const git_strarray *",
              "direction": "in",
              "comment": "source"
            }
          ],
          "comment": [
            "Copy a string array object from source to target.",
            "Note: target is overwritten and hence should be empty, otherwise its\n contents are leaked.  Call git_strarray_free() if necessary."
          ],
          "group": "strarray"
        }
      },
      "info": {
        "summary": "Git string array routines"
      }
    },
    "submodule": {
      "apis": {
        "git_submodule": {
          "kind": "struct",
          "name": "git_submodule",
          "referenceName": "struct git_submodule",
          "opaque": true,
          "comment": [
            "Opaque structure representing a submodule.",
            "Submodule support in libgit2 builds a list of known submodules and keeps\n it in the repository.  The list is built from the .gitmodules file, the\n .git/config file, the index, and the HEAD tree.  Items in the working\n directory that look like submodules (i.e. a git repo) but are not\n mentioned in those places won't be tracked."
          ],
          "location": {
            "file": "submodule.h",
            "line": 32,
            "column": 30
          },
          "group": "submodule",
          "parameterTo": [
            "git_submodule_lookup",
            "git_submodule_add_setup",
            "git_submodule_add_finalize",
            "git_submodule_add_to_index",
            "git_submodule_save",
            "git_submodule_owner",
            "git_submodule_name",
            "git_submodule_path",
            "git_submodule_url",
            "git_submodule_set_url",
            "git_submodule_index_id",
            "git_submodule_head_id",
            "git_submodule_wd_id",
            "git_submodule_ignore",
            "git_submodule_set_ignore",
            "git_submodule_update",
            "git_submodule_set_update",
            "git_submodule_fetch_recurse_submodules",
            "git_submodule_set_fetch_recurse_submodules",
            "git_submodule_init",
            "git_submodule_sync",
            "git_submodule_open",
            "git_submodule_reload",
            "git_submodule_status",
            "git_submodule_location"
          ]
        },
        "git_submodule_update_t": {
          "kind": "enum",
          "name": "git_submodule_update_t",
          "referenceName": "git_submodule_update_t",
          "members": [
            {
              "name": "GIT_SUBMODULE_UPDATE_DEFAULT",
              "value": "-1"
            },
            {
              "name": "GIT_SUBMODULE_UPDATE_CHECKOUT",
              "value": "0"
            },
            {
              "name": "GIT_SUBMODULE_UPDATE_REBASE",
              "value": "1"
            },
            {
              "name": "GIT_SUBMODULE_UPDATE_MERGE",
              "value": "2"
            },
            {
              "name": "GIT_SUBMODULE_UPDATE_NONE",
              "value": "3"
            }
          ],
          "comment": [
            "Values that could be specified for the update rule of a submodule.",
            "Use the DEFAULT value if you have altered the update value via\n `git_submodule_set_update()` and wish to reset to the original default."
          ],
          "location": {
            "file": "submodule.h",
            "line": 40,
            "column": 9
          },
          "group": "submodule",
          "returnedBy": [
            "git_submodule_update",
            "git_submodule_set_update"
          ],
          "parameterTo": [
            "git_submodule_set_update"
          ]
        },
        "git_submodule_ignore_t": {
          "kind": "enum",
          "name": "git_submodule_ignore_t",
          "referenceName": "git_submodule_ignore_t",
          "members": [
            {
              "name": "GIT_SUBMODULE_IGNORE_DEFAULT",
              "value": "-1"
            },
            {
              "name": "GIT_SUBMODULE_IGNORE_NONE",
              "value": "0"
            },
            {
              "name": "GIT_SUBMODULE_IGNORE_UNTRACKED",
              "value": "1"
            },
            {
              "name": "GIT_SUBMODULE_IGNORE_DIRTY",
              "value": "2"
            },
            {
              "name": "GIT_SUBMODULE_IGNORE_ALL",
              "value": "3"
            }
          ],
          "comment": [
            "Values that could be specified for how closely to examine the\n working directory when getting submodule status.",
            "Use the DEFUALT value if you have altered the ignore value via\n `git_submodule_set_ignore()` and wish to reset to the original value."
          ],
          "location": {
            "file": "submodule.h",
            "line": 55,
            "column": 9
          },
          "group": "submodule",
          "returnedBy": [
            "git_submodule_ignore",
            "git_submodule_set_ignore"
          ],
          "parameterTo": [
            "git_submodule_set_ignore"
          ]
        },
        "git_submodule_status_t": {
          "kind": "enum",
          "name": "git_submodule_status_t",
          "referenceName": "git_submodule_status_t",
          "members": [
            {
              "name": "GIT_SUBMODULE_STATUS_IN_HEAD"
            },
            {
              "name": "GIT_SUBMODULE_STATUS_IN_INDEX"
            },
            {
              "name": "GIT_SUBMODULE_STATUS_IN_CONFIG"
            },
            {
              "name": "GIT_SUBMODULE_STATUS_IN_WD"
            },
            {
              "name": "GIT_SUBMODULE_STATUS_INDEX_ADDED"
            },
            {
              "name": "GIT_SUBMODULE_STATUS_INDEX_DELETED"
            },
            {
              "name": "GIT_SUBMODULE_STATUS_INDEX_MODIFIED"
            },
            {
              "name": "GIT_SUBMODULE_STATUS_WD_UNINITIALIZED"
            },
            {
              "name": "GIT_SUBMODULE_STATUS_WD_ADDED"
            },
            {
              "name": "GIT_SUBMODULE_STATUS_WD_DELETED"
            },
            {
              "name": "GIT_SUBMODULE_STATUS_WD_MODIFIED"
            },
            {
              "name": "GIT_SUBMODULE_STATUS_WD_INDEX_MODIFIED"
            },
            {
              "name": "GIT_SUBMODULE_STATUS_WD_WD_MODIFIED"
            },
            {
              "name": "GIT_SUBMODULE_STATUS_WD_UNTRACKED"
            }
          ],
          "comment": [
            "Return codes for submodule status.",
            "A combination of these flags will be returned to describe the status of a\n submodule.  Depending on the \"ignore\" property of the submodule, some of\n the flags may never be returned because they indicate changes that are\n supposed to be ignored.",
            "Submodule info is contained in 4 places: the HEAD tree, the index, config\n files (both .git/config and .gitmodules), and the working directory.  Any\n or all of those places might be missing information about the submodule\n depending on what state the repo is in.  We consider all four places to\n build the combination of status flags.",
            "There are four values that are not really status, but give basic info\n about what sources of submodule data are available.  These will be\n returned even if ignore is set to \"ALL\".",
            "* IN_HEAD   - superproject head contains submodule\n * IN_INDEX  - superproject index contains submodule\n * IN_CONFIG - superproject gitmodules has submodule\n * IN_WD     - superproject workdir has submodule",
            "The following values will be returned so long as ignore is not \"ALL\".",
            "* INDEX_ADDED       - in index, not in head\n * INDEX_DELETED     - in head, not in index\n * INDEX_MODIFIED    - index and head don't match\n * WD_UNINITIALIZED  - workdir contains empty directory\n * WD_ADDED          - in workdir, not index\n * WD_DELETED        - in index, not workdir\n * WD_MODIFIED       - index and workdir head don't match",
            "The following can only be returned if ignore is \"NONE\" or \"UNTRACKED\".",
            "* WD_INDEX_MODIFIED - submodule workdir index is dirty\n * WD_WD_MODIFIED    - submodule workdir has modified files",
            "Lastly, the following will only be returned for ignore \"NONE\".",
            "* WD_UNTRACKED      - wd contains untracked files"
          ],
          "location": {
            "file": "submodule.h",
            "line": 105,
            "column": 9
          },
          "group": "submodule"
        },
        "GIT_SUBMODULE_STATUS__IN_FLAGS": {
          "kind": "macro",
          "name": "GIT_SUBMODULE_STATUS__IN_FLAGS",
          "location": {
            "file": "submodule.h",
            "line": 126,
            "column": 9
          },
          "value": " (GIT_SUBMODULE_STATUS_IN_HEAD | GIT_SUBMODULE_STATUS_IN_INDEX | GIT_SUBMODULE_STATUS_IN_CONFIG | GIT_SUBMODULE_STATUS_IN_WD)",
          "comment": "",
          "group": "submodule"
        },
        "GIT_SUBMODULE_STATUS__INDEX_FLAGS": {
          "kind": "macro",
          "name": "GIT_SUBMODULE_STATUS__INDEX_FLAGS",
          "location": {
            "file": "submodule.h",
            "line": 131,
            "column": 9
          },
          "value": " (GIT_SUBMODULE_STATUS_INDEX_ADDED | GIT_SUBMODULE_STATUS_INDEX_DELETED | GIT_SUBMODULE_STATUS_INDEX_MODIFIED)",
          "comment": "",
          "group": "submodule"
        },
        "GIT_SUBMODULE_STATUS__WD_FLAGS": {
          "kind": "macro",
          "name": "GIT_SUBMODULE_STATUS__WD_FLAGS",
          "location": {
            "file": "submodule.h",
            "line": 134,
            "column": 9
          },
          "value": " ~(GIT_SUBMODULE_STATUS__IN_FLAGS | GIT_SUBMODULE_STATUS__INDEX_FLAGS)",
          "comment": "",
          "group": "submodule"
        },
        "GIT_SUBMODULE_STATUS_IS_UNMODIFIED(S)": {
          "kind": "macro",
          "name": "GIT_SUBMODULE_STATUS_IS_UNMODIFIED(S)",
          "location": {
            "file": "submodule.h",
            "line": 137,
            "column": 9
          },
          "value": " (((S) & ~GIT_SUBMODULE_STATUS__IN_FLAGS) == 0)",
          "comment": "",
          "group": "submodule"
        },
        "GIT_SUBMODULE_STATUS_IS_INDEX_UNMODIFIED(S)": {
          "kind": "macro",
          "name": "GIT_SUBMODULE_STATUS_IS_INDEX_UNMODIFIED(S)",
          "location": {
            "file": "submodule.h",
            "line": 140,
            "column": 9
          },
          "value": " (((S) & GIT_SUBMODULE_STATUS__INDEX_FLAGS) == 0)",
          "comment": "",
          "group": "submodule"
        },
        "GIT_SUBMODULE_STATUS_IS_WD_UNMODIFIED(S)": {
          "kind": "macro",
          "name": "GIT_SUBMODULE_STATUS_IS_WD_UNMODIFIED(S)",
          "location": {
            "file": "submodule.h",
            "line": 143,
            "column": 9
          },
          "value": " (((S) & GIT_SUBMODULE_STATUS__WD_FLAGS) == 0)",
          "comment": "",
          "group": "submodule"
        },
        "GIT_SUBMODULE_STATUS_IS_WD_DIRTY(S)": {
          "kind": "macro",
          "name": "GIT_SUBMODULE_STATUS_IS_WD_DIRTY(S)",
          "location": {
            "file": "submodule.h",
            "line": 148,
            "column": 9
          },
          "value": " (((S) & (GIT_SUBMODULE_STATUS_WD_INDEX_MODIFIED | GIT_SUBMODULE_STATUS_WD_WD_MODIFIED | GIT_SUBMODULE_STATUS_WD_UNTRACKED)) != 0)",
          "comment": "",
          "group": "submodule"
        },
        "git_submodule_lookup": {
          "kind": "function",
          "name": "git_submodule_lookup",
          "location": {
            "file": "submodule.h",
            "line": 178,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_ENOTFOUND if submodule does not exist,\n         GIT_EEXISTS if submodule exists in working directory only, -1 on\n         other errors."
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule **",
              "direction": "in",
              "comment": "Pointer to submodule description object pointer.."
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repository."
            },
            {
              "name": "name",
              "type": "const char *",
              "direction": "in",
              "comment": "The name of the submodule.  Trailing slashes will be ignored."
            }
          ],
          "comment": [
            "Lookup submodule information by name or path.",
            "Given either the submodule name or path (they are usually the same), this\n returns a structure describing the submodule.",
            "There are two expected error scenarios:",
            "- The submodule is not mentioned in the HEAD, the index, and the config,\n   but does \"exist\" in the working directory (i.e. there is a subdirectory\n   that is a valid self-contained git repo).  In this case, this function\n   returns GIT_EEXISTS to indicate the the submodule exists but not in a\n   state where a git_submodule can be instantiated.\n - The submodule is not mentioned in the HEAD, index, or config and the\n   working directory doesn't contain a value git repo at that path.\n   There may or may not be anything else at that path, but nothing that\n   looks like a submodule.  In this case, this returns GIT_ENOTFOUND.",
            "The submodule object is owned by the containing repo and will be freed\n when the repo is freed.  The caller need not free the submodule."
          ],
          "group": "submodule"
        },
        "git_submodule_foreach": {
          "kind": "function",
          "name": "git_submodule_foreach",
          "location": {
            "file": "submodule.h",
            "line": 201,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, -1 on error, or non-zero return value of callback"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repository"
            },
            {
              "name": "callback",
              "type": "int (*)(git_submodule *, const char *, void *)",
              "direction": "in",
              "comment": "Function to be called with the name of each submodule.\n        Return a non-zero value to terminate the iteration."
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Extra data to pass to callback"
            }
          ],
          "comment": [
            "Iterate over all tracked submodules of a repository.",
            "See the note on `git_submodule` above.  This iterates over the tracked\n submodules as decribed therein.",
            "If you are concerned about items in the working directory that look like\n submodules but are not tracked, the diff API will generate a diff record\n for workdir items that look like submodules but are not tracked, showing\n them as added in the workdir.  Also, the status API will treat the entire\n subdirectory of a contained git repo as a single GIT_STATUS_WT_NEW item."
          ],
          "group": "submodule"
        },
        "git_submodule_add_setup": {
          "kind": "function",
          "name": "git_submodule_add_setup",
          "location": {
            "file": "submodule.h",
            "line": 229,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EEXISTS if submodule already exists,\n         -1 on other errors."
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule **",
              "direction": "in",
              "comment": "The newly created submodule ready to open for clone"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Superproject repository to contain the new submodule"
            },
            {
              "name": "url",
              "type": "const char *",
              "direction": "in",
              "comment": "URL for the submodules remote"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "Path at which the submodule should be created"
            },
            {
              "name": "use_gitlink",
              "type": "int",
              "direction": "in",
              "comment": "Should workdir contain a gitlink to the repo in\n        .git/modules vs. repo directly in workdir."
            }
          ],
          "comment": [
            "Set up a new git submodule for checkout.",
            "This does \"git submodule add\" up to the fetch and checkout of the\n submodule contents.  It preps a new submodule, creates an entry in\n .gitmodules and creates an empty initialized repository either at the\n given path in the working directory or in .git/modules with a gitlink\n from the working directory to the new repo.",
            "To fully emulate \"git submodule add\" call this function, then open the\n submodule repo and perform the clone step as needed.  Lastly, call\n `git_submodule_add_finalize()` to wrap up adding the new submodule and\n .gitmodules to the index to be ready to commit."
          ],
          "group": "submodule"
        },
        "git_submodule_add_finalize": {
          "kind": "function",
          "name": "git_submodule_add_finalize",
          "location": {
            "file": "submodule.h",
            "line": 246,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *",
              "direction": "in",
              "comment": "The submodule to finish adding."
            }
          ],
          "comment": [
            "Resolve the setup of a new git submodule.",
            "This should be called on a submodule once you have called add setup\n and done the clone of the submodule.  This adds the .gitmodules file\n and the newly cloned submodule to the index to be ready to be committed\n (but doesn't actually do the commit)."
          ],
          "group": "submodule"
        },
        "git_submodule_add_to_index": {
          "kind": "function",
          "name": "git_submodule_add_to_index",
          "location": {
            "file": "submodule.h",
            "line": 258,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, \n<\n0 on failure"
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *",
              "direction": "in",
              "comment": "The submodule to add to the index"
            },
            {
              "name": "write_index",
              "type": "int",
              "direction": "in",
              "comment": "Boolean if this should immediately write the index\n            file.  If you pass this as false, you will have to get the\n            git_index and explicitly call `git_index_write()` on it to\n            save the change."
            }
          ],
          "comment": [
            "Add current submodule HEAD commit to index of superproject."
          ],
          "group": "submodule"
        },
        "git_submodule_save": {
          "kind": "function",
          "name": "git_submodule_save",
          "location": {
            "file": "submodule.h",
            "line": 274,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, \n<\n0 on failure."
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *",
              "direction": "in",
              "comment": "The submodule to write."
            }
          ],
          "comment": [
            "Write submodule settings to .gitmodules file.",
            "This commits any in-memory changes to the submodule to the gitmodules\n file on disk.  You may also be interested in `git_submodule_init()` which\n writes submodule info to \".git/config\" (which is better for local changes\n to submodule settings) and/or `git_submodule_sync()` which writes\n settings about remotes to the actual submodule repository."
          ],
          "group": "submodule"
        },
        "git_submodule_owner": {
          "kind": "function",
          "name": "git_submodule_owner",
          "location": {
            "file": "submodule.h",
            "line": 287,
            "column": 30
          },
          "returns": {
            "type": "git_repository *",
            "comment": "Pointer to `git_repository`"
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *",
              "direction": "in",
              "comment": "Pointer to submodule object"
            }
          ],
          "comment": [
            "Get the containing repository for a submodule.",
            "This returns a pointer to the repository that contains the submodule.\n This is a just a reference to the repository that was passed to the\n original `git_submodule_lookup()` call, so if that repository has been\n freed, then this may be a dangling reference."
          ],
          "group": "submodule"
        },
        "git_submodule_name": {
          "kind": "function",
          "name": "git_submodule_name",
          "location": {
            "file": "submodule.h",
            "line": 295,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "Pointer to the submodule name"
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *",
              "direction": "in",
              "comment": "Pointer to submodule object"
            }
          ],
          "comment": [
            "Get the name of submodule."
          ],
          "group": "submodule"
        },
        "git_submodule_path": {
          "kind": "function",
          "name": "git_submodule_path",
          "location": {
            "file": "submodule.h",
            "line": 306,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "Pointer to the submodule path"
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *",
              "direction": "in",
              "comment": "Pointer to submodule object"
            }
          ],
          "comment": [
            "Get the path to the submodule.",
            "The path is almost always the same as the submodule name, but the\n two are actually not required to match."
          ],
          "group": "submodule"
        },
        "git_submodule_url": {
          "kind": "function",
          "name": "git_submodule_url",
          "location": {
            "file": "submodule.h",
            "line": 314,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "Pointer to the submodule url"
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *",
              "direction": "in",
              "comment": "Pointer to submodule object"
            }
          ],
          "comment": [
            "Get the URL for the submodule."
          ],
          "group": "submodule"
        },
        "git_submodule_set_url": {
          "kind": "function",
          "name": "git_submodule_set_url",
          "location": {
            "file": "submodule.h",
            "line": 330,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, \n<\n0 on failure"
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *",
              "direction": "in",
              "comment": "Pointer to the submodule object"
            },
            {
              "name": "url",
              "type": "const char *",
              "direction": "in",
              "comment": "URL that should be used for the submodule"
            }
          ],
          "comment": [
            "Set the URL for the submodule.",
            "This sets the URL in memory for the submodule. This will be used for\n any following submodule actions while this submodule data is in memory.",
            "After calling this, you may wish to call `git_submodule_save()` to write\n the changes back to the \".gitmodules\" file and `git_submodule_sync()` to\n write the changes to the checked out submodule repository."
          ],
          "group": "submodule"
        },
        "git_submodule_index_id": {
          "kind": "function",
          "name": "git_submodule_index_id",
          "location": {
            "file": "submodule.h",
            "line": 338,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "Pointer to git_oid or NULL if submodule is not in index."
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *",
              "direction": "in",
              "comment": "Pointer to submodule object"
            }
          ],
          "comment": [
            "Get the OID for the submodule in the index."
          ],
          "group": "submodule"
        },
        "git_submodule_head_id": {
          "kind": "function",
          "name": "git_submodule_head_id",
          "location": {
            "file": "submodule.h",
            "line": 346,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "Pointer to git_oid or NULL if submodule is not in the HEAD."
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *",
              "direction": "in",
              "comment": "Pointer to submodule object"
            }
          ],
          "comment": [
            "Get the OID for the submodule in the current HEAD tree."
          ],
          "group": "submodule"
        },
        "git_submodule_wd_id": {
          "kind": "function",
          "name": "git_submodule_wd_id",
          "location": {
            "file": "submodule.h",
            "line": 359,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "Pointer to git_oid or NULL if submodule is not checked out."
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *",
              "direction": "in",
              "comment": "Pointer to submodule object"
            }
          ],
          "comment": [
            "Get the OID for the submodule in the current working directory.",
            "This returns the OID that corresponds to looking up 'HEAD' in the checked\n out submodule.  If there are pending changes in the index or anything\n else, this won't notice that.  You should call `git_submodule_status()`\n for a more complete picture about the state of the working directory."
          ],
          "group": "submodule"
        },
        "git_submodule_ignore": {
          "kind": "function",
          "name": "git_submodule_ignore",
          "location": {
            "file": "submodule.h",
            "line": 379,
            "column": 36
          },
          "returns": {
            "type": "git_submodule_ignore_t"
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *"
            }
          ],
          "comment": [
            "Get the ignore rule for the submodule.",
            "There are four ignore values:",
            "- **GIT_SUBMODULE_IGNORE_NONE** will consider any change to the contents\n    of the submodule from a clean checkout to be dirty, including the\n    addition of untracked files.  This is the default if unspecified.\n  - **GIT_SUBMODULE_IGNORE_UNTRACKED** examines the contents of the\n    working tree (i.e. call `git_status_foreach()` on the submodule) but\n    UNTRACKED files will not count as making the submodule dirty.\n  - **GIT_SUBMODULE_IGNORE_DIRTY** means to only check if the HEAD of the\n    submodule has moved for status.  This is fast since it does not need to\n    scan the working tree of the submodule at all.\n  - **GIT_SUBMODULE_IGNORE_ALL** means not to open the submodule repo.\n    The working directory will be consider clean so long as there is a\n    checked out version present."
          ],
          "group": "submodule"
        },
        "git_submodule_set_ignore": {
          "kind": "function",
          "name": "git_submodule_set_ignore",
          "location": {
            "file": "submodule.h",
            "line": 396,
            "column": 36
          },
          "returns": {
            "type": "git_submodule_ignore_t",
            "comment": "old value for ignore"
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *"
            },
            {
              "name": "ignore",
              "type": "git_submodule_ignore_t",
              "referenceType": "enum git_submodule_ignore_t"
            }
          ],
          "comment": [
            "Set the ignore rule for the submodule.",
            "This sets the ignore rule in memory for the submodule.  This will be used\n for any following actions (such as `git_submodule_status()`) while the\n submodule is in memory.  You should call `git_submodule_save()` if you\n want to persist the new ignore role.",
            "Calling this again with GIT_SUBMODULE_IGNORE_DEFAULT or calling\n `git_submodule_reload()` will revert the rule to the value that was in the\n original config."
          ],
          "group": "submodule"
        },
        "git_submodule_update": {
          "kind": "function",
          "name": "git_submodule_update",
          "location": {
            "file": "submodule.h",
            "line": 403,
            "column": 36
          },
          "returns": {
            "type": "git_submodule_update_t"
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *"
            }
          ],
          "comment": [
            "Get the update rule for the submodule."
          ],
          "group": "submodule"
        },
        "git_submodule_set_update": {
          "kind": "function",
          "name": "git_submodule_set_update",
          "location": {
            "file": "submodule.h",
            "line": 418,
            "column": 36
          },
          "returns": {
            "type": "git_submodule_update_t",
            "comment": "old value for update"
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *"
            },
            {
              "name": "update",
              "type": "git_submodule_update_t",
              "referenceType": "enum git_submodule_update_t"
            }
          ],
          "comment": [
            "Set the update rule for the submodule.",
            "This sets the update rule in memory for the submodule.  You should call\n `git_submodule_save()` if you want to persist the new update rule.",
            "Calling this again with GIT_SUBMODULE_UPDATE_DEFAULT or calling\n `git_submodule_reload()` will revert the rule to the value that was in the\n original config."
          ],
          "group": "submodule"
        },
        "git_submodule_fetch_recurse_submodules": {
          "kind": "function",
          "name": "git_submodule_fetch_recurse_submodules",
          "location": {
            "file": "submodule.h",
            "line": 433,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 if fetchRecurseSubmodules is false, 1 if true"
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *"
            }
          ],
          "comment": [
            "Read the fetchRecurseSubmodules rule for a submodule.",
            "This accesses the submodule.\n<name>.fetchRecurseSubmodules value for\n the submodule that controls fetching behavior for the submodule.",
            "Note that at this time, libgit2 does not honor this setting and the\n fetch functionality current ignores submodules."
          ],
          "group": "submodule"
        },
        "git_submodule_set_fetch_recurse_submodules": {
          "kind": "function",
          "name": "git_submodule_set_fetch_recurse_submodules",
          "location": {
            "file": "submodule.h",
            "line": 447,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "old value for fetchRecurseSubmodules"
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *",
              "direction": "in",
              "comment": "The submodule to modify"
            },
            {
              "name": "fetch_recurse_submodules",
              "type": "int",
              "direction": "in",
              "comment": "Boolean value"
            }
          ],
          "comment": [
            "Set the fetchRecurseSubmodules rule for a submodule.",
            "This sets the submodule.\n<name>.fetchRecurseSubmodules value for\n the submodule.  You should call `git_submodule_save()` if you want\n to persist the new value."
          ],
          "group": "submodule"
        },
        "git_submodule_init": {
          "kind": "function",
          "name": "git_submodule_init",
          "location": {
            "file": "submodule.h",
            "line": 464,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, \n<\n0 on failure."
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *",
              "direction": "in",
              "comment": "The submodule to write into the superproject config"
            },
            {
              "name": "overwrite",
              "type": "int",
              "direction": "in",
              "comment": "By default, existing entries will not be overwritten,\n                  but setting this to true forces them to be updated."
            }
          ],
          "comment": [
            "Copy submodule info into \".git/config\" file.",
            "Just like \"git submodule init\", this copies information about the\n submodule into \".git/config\".  You can use the accessor functions\n above to alter the in-memory git_submodule object and control what\n is written to the config, overriding what is in .gitmodules."
          ],
          "group": "submodule"
        },
        "git_submodule_sync": {
          "kind": "function",
          "name": "git_submodule_sync",
          "location": {
            "file": "submodule.h",
            "line": 474,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *"
            }
          ],
          "comment": [
            "Copy submodule remote info into submodule repo.",
            "This copies the information about the submodules URL into the checked out\n submodule config, acting like \"git submodule sync\".  This is useful if\n you have altered the URL for the submodule (or it has been altered by a\n fetch of upstream changes) and you need to update your local repo."
          ],
          "group": "submodule"
        },
        "git_submodule_open": {
          "kind": "function",
          "name": "git_submodule_open",
          "location": {
            "file": "submodule.h",
            "line": 488,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, \n<\n0 if submodule repo could not be opened."
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository **",
              "direction": "in",
              "comment": "Pointer to the submodule repo which was opened"
            },
            {
              "name": "submodule",
              "type": "git_submodule *",
              "direction": "in",
              "comment": "Submodule to be opened"
            }
          ],
          "comment": [
            "Open the repository for a submodule.",
            "This is a newly opened repository object.  The caller is responsible for\n calling `git_repository_free()` on it when done.  Multiple calls to this\n function will return distinct `git_repository` objects.  This will only\n work if the submodule is checked out into the working directory."
          ],
          "group": "submodule"
        },
        "git_submodule_reload": {
          "kind": "function",
          "name": "git_submodule_reload",
          "location": {
            "file": "submodule.h",
            "line": 498,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "submodule",
              "type": "git_submodule *"
            }
          ],
          "comment": [
            "Reread submodule info from config, index, and HEAD.",
            "Call this to reread cached submodule information for this submodule if\n you have reason to believe that it has changed."
          ],
          "group": "submodule"
        },
        "git_submodule_reload_all": {
          "kind": "function",
          "name": "git_submodule_reload_all",
          "location": {
            "file": "submodule.h",
            "line": 505,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *"
            }
          ],
          "comment": [
            "Reread all submodule info.",
            "Call this to reload all cached submodule information for the repo."
          ],
          "group": "submodule"
        },
        "git_submodule_status": {
          "kind": "function",
          "name": "git_submodule_status",
          "location": {
            "file": "submodule.h",
            "line": 520,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, \n<\n0 on error"
          },
          "params": [
            {
              "name": "status",
              "type": "unsigned int *",
              "direction": "in",
              "comment": "Combination of `GIT_SUBMODULE_STATUS` flags"
            },
            {
              "name": "submodule",
              "type": "git_submodule *",
              "direction": "in",
              "comment": "Submodule for which to get status"
            }
          ],
          "comment": [
            "Get the status for a submodule.",
            "This looks at a submodule and tries to determine the status.  It\n will return a combination of the `GIT_SUBMODULE_STATUS` values above.\n How deeply it examines the working directory to do this will depend\n on the `git_submodule_ignore_t` value for the submodule - which can be\n set either temporarily or permanently with `git_submodule_set_ignore()`."
          ],
          "group": "submodule"
        },
        "git_submodule_location": {
          "kind": "function",
          "name": "git_submodule_location",
          "location": {
            "file": "submodule.h",
            "line": 538,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, \n<\n0 on error"
          },
          "params": [
            {
              "name": "location_status",
              "type": "unsigned int *",
              "direction": "in",
              "comment": "Combination of first four `GIT_SUBMODULE_STATUS` flags"
            },
            {
              "name": "submodule",
              "type": "git_submodule *",
              "direction": "in",
              "comment": "Submodule for which to get status"
            }
          ],
          "comment": [
            "Get the locations of submodule information.",
            "This is a bit like a very lightweight version of `git_submodule_status`.\n It just returns a made of the first four submodule status values (i.e.\n the ones like GIT_SUBMODULE_STATUS_IN_HEAD, etc) that tell you where the\n submodule data comes from (i.e. the HEAD commit, gitmodules file, etc.).\n This can be useful if you want to know if the submodule is present in the\n working directory at this point in time, etc."
          ],
          "group": "submodule"
        }
      },
      "info": {
        "summary": "Git submodule management utilities"
      }
    },
    "tag": {
      "apis": {
        "git_tag_lookup": {
          "kind": "function",
          "name": "git_tag_lookup",
          "location": {
            "file": "tag.h",
            "line": 33,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_tag **",
              "direction": "in",
              "comment": "pointer to the looked up tag"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repo to use when locating the tag."
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "identity of the tag to locate."
            }
          ],
          "comment": [
            "Lookup a tag object from the repository."
          ],
          "group": "tag"
        },
        "git_tag_lookup_prefix": {
          "kind": "function",
          "name": "git_tag_lookup_prefix",
          "location": {
            "file": "tag.h",
            "line": 48,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_tag **",
              "direction": "in",
              "comment": "pointer to the looked up tag"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repo to use when locating the tag."
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "identity of the tag to locate."
            },
            {
              "name": "len",
              "type": "size_t",
              "direction": "in",
              "comment": "the length of the short identifier"
            }
          ],
          "comment": [
            "Lookup a tag object from the repository,\n given a prefix of its identifier (short id)."
          ],
          "see": [
            "git_object_lookup_prefix"
          ],
          "group": "tag"
        },
        "git_tag_free": {
          "kind": "function",
          "name": "git_tag_free",
          "location": {
            "file": "tag.h",
            "line": 61,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "tag",
              "type": "git_tag *",
              "direction": "in",
              "comment": "the tag to close"
            }
          ],
          "comment": [
            "Close an open tag",
            "You can no longer use the git_tag pointer after this call.",
            "IMPORTANT: You MUST call this method when you are through with a tag to\n release memory. Failure to do so will cause a memory leak."
          ],
          "group": "tag"
        },
        "git_tag_id": {
          "kind": "function",
          "name": "git_tag_id",
          "location": {
            "file": "tag.h",
            "line": 69,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "object identity for the tag."
          },
          "params": [
            {
              "name": "tag",
              "type": "const git_tag *",
              "direction": "in",
              "comment": "a previously loaded tag."
            }
          ],
          "comment": [
            "Get the id of a tag."
          ],
          "group": "tag"
        },
        "git_tag_owner": {
          "kind": "function",
          "name": "git_tag_owner",
          "location": {
            "file": "tag.h",
            "line": 77,
            "column": 30
          },
          "returns": {
            "type": "git_repository *",
            "comment": "Repository that contains this tag."
          },
          "params": [
            {
              "name": "tag",
              "type": "const git_tag *",
              "direction": "in",
              "comment": "A previously loaded tag."
            }
          ],
          "comment": [
            "Get the repository that contains the tag."
          ],
          "group": "tag"
        },
        "git_tag_target": {
          "kind": "function",
          "name": "git_tag_target",
          "location": {
            "file": "tag.h",
            "line": 89,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "target_out",
              "type": "git_object **",
              "direction": "in",
              "comment": "pointer where to store the target"
            },
            {
              "name": "tag",
              "type": "const git_tag *",
              "direction": "in",
              "comment": "a previously loaded tag."
            }
          ],
          "comment": [
            "Get the tagged object of a tag",
            "This method performs a repository lookup for the\n given object and returns it"
          ],
          "group": "tag"
        },
        "git_tag_target_id": {
          "kind": "function",
          "name": "git_tag_target_id",
          "location": {
            "file": "tag.h",
            "line": 97,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "pointer to the OID"
          },
          "params": [
            {
              "name": "tag",
              "type": "const git_tag *",
              "direction": "in",
              "comment": "a previously loaded tag."
            }
          ],
          "comment": [
            "Get the OID of the tagged object of a tag"
          ],
          "group": "tag"
        },
        "git_tag_target_type": {
          "kind": "function",
          "name": "git_tag_target_type",
          "location": {
            "file": "tag.h",
            "line": 105,
            "column": 23
          },
          "returns": {
            "type": "git_otype",
            "comment": "type of the tagged object"
          },
          "params": [
            {
              "name": "tag",
              "type": "const git_tag *",
              "direction": "in",
              "comment": "a previously loaded tag."
            }
          ],
          "comment": [
            "Get the type of a tag's tagged object"
          ],
          "group": "tag"
        },
        "git_tag_name": {
          "kind": "function",
          "name": "git_tag_name",
          "location": {
            "file": "tag.h",
            "line": 113,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "name of the tag"
          },
          "params": [
            {
              "name": "tag",
              "type": "const git_tag *",
              "direction": "in",
              "comment": "a previously loaded tag."
            }
          ],
          "comment": [
            "Get the name of a tag"
          ],
          "group": "tag"
        },
        "git_tag_tagger": {
          "kind": "function",
          "name": "git_tag_tagger",
          "location": {
            "file": "tag.h",
            "line": 121,
            "column": 35
          },
          "returns": {
            "type": "const git_signature *",
            "comment": "reference to the tag's author or NULL when unspecified"
          },
          "params": [
            {
              "name": "tag",
              "type": "const git_tag *",
              "direction": "in",
              "comment": "a previously loaded tag."
            }
          ],
          "comment": [
            "Get the tagger (author) of a tag"
          ],
          "group": "tag"
        },
        "git_tag_message": {
          "kind": "function",
          "name": "git_tag_message",
          "location": {
            "file": "tag.h",
            "line": 129,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "message of the tag or NULL when unspecified"
          },
          "params": [
            {
              "name": "tag",
              "type": "const git_tag *",
              "direction": "in",
              "comment": "a previously loaded tag."
            }
          ],
          "comment": [
            "Get the message of a tag"
          ],
          "group": "tag"
        },
        "git_tag_create": {
          "kind": "function",
          "name": "git_tag_create",
          "location": {
            "file": "tag.h",
            "line": 171,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EINVALIDSPEC or an error code\n\tA tag object is written to the ODB, and a proper reference\n\tis written in the /refs/tags folder, pointing to it"
          },
          "params": [
            {
              "name": "oid",
              "type": "git_oid *",
              "direction": "in",
              "comment": "Pointer where to store the OID of the\n newly created tag. If the tag already exists, this parameter\n will be the oid of the existing tag, and the function will\n return a GIT_EEXISTS error code."
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where to store the tag"
            },
            {
              "name": "tag_name",
              "type": "const char *",
              "direction": "in",
              "comment": "Name for the tag; this name is validated\n for consistency. It should also not conflict with an\n already existing tag name"
            },
            {
              "name": "target",
              "type": "const git_object *",
              "direction": "in",
              "comment": "Object to which this tag points. This object\n must belong to the given `repo`."
            },
            {
              "name": "tagger",
              "type": "const git_signature *",
              "direction": "in",
              "comment": "Signature of the tagger for this tag, and\n of the tagging time"
            },
            {
              "name": "message",
              "type": "const char *",
              "direction": "in",
              "comment": "Full message for this tag"
            },
            {
              "name": "force",
              "type": "int",
              "direction": "in",
              "comment": "Overwrite existing references"
            }
          ],
          "comment": [
            "Create a new tag in the repository from an object",
            "A new reference will also be created pointing to\n this tag object. If `force` is true and a reference\n already exists with the given name, it'll be replaced.",
            "The message will not be cleaned up. This can be achieved\n through `git_message_prettify()`.",
            "The tag name will be checked for validity. You must avoid\n the characters '~', '^', ':', '\n\\\n', '?', '[', and '*', and the\n sequences \"..\" and \"@{\" which have special meaning to revparse."
          ],
          "group": "tag"
        },
        "git_tag_annotation_create": {
          "kind": "function",
          "name": "git_tag_annotation_create",
          "location": {
            "file": "tag.h",
            "line": 203,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success or an error code"
          },
          "params": [
            {
              "name": "oid",
              "type": "git_oid *",
              "direction": "in",
              "comment": "Pointer where to store the OID of the\n newly created tag"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where to store the tag"
            },
            {
              "name": "tag_name",
              "type": "const char *",
              "direction": "in",
              "comment": "Name for the tag"
            },
            {
              "name": "target",
              "type": "const git_object *",
              "direction": "in",
              "comment": "Object to which this tag points. This object\n must belong to the given `repo`."
            },
            {
              "name": "tagger",
              "type": "const git_signature *",
              "direction": "in",
              "comment": "Signature of the tagger for this tag, and\n of the tagging time"
            },
            {
              "name": "message",
              "type": "const char *",
              "direction": "in",
              "comment": "Full message for this tag"
            }
          ],
          "comment": [
            "Create a new tag in the object database pointing to a git_object",
            "The message will not be cleaned up. This can be achieved\n through `git_message_prettify()`."
          ],
          "group": "tag"
        },
        "git_tag_create_frombuffer": {
          "kind": "function",
          "name": "git_tag_create_frombuffer",
          "location": {
            "file": "tag.h",
            "line": 220,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success; error code otherwise"
          },
          "params": [
            {
              "name": "oid",
              "type": "git_oid *",
              "direction": "in",
              "comment": "Pointer where to store the OID of the newly created tag"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where to store the tag"
            },
            {
              "name": "buffer",
              "type": "const char *",
              "direction": "in",
              "comment": "Raw tag data"
            },
            {
              "name": "force",
              "type": "int",
              "direction": "in",
              "comment": "Overwrite existing tags"
            }
          ],
          "comment": [
            "Create a new tag in the repository from a buffer"
          ],
          "group": "tag"
        },
        "git_tag_create_lightweight": {
          "kind": "function",
          "name": "git_tag_create_lightweight",
          "location": {
            "file": "tag.h",
            "line": 256,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EINVALIDSPEC or an error code\n\tA proper reference is written in the /refs/tags folder,\n pointing to the provided target object"
          },
          "params": [
            {
              "name": "oid",
              "type": "git_oid *",
              "direction": "in",
              "comment": "Pointer where to store the OID of the provided\n target object. If the tag already exists, this parameter\n will be filled with the oid of the existing pointed object\n and the function will return a GIT_EEXISTS error code."
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where to store the lightweight tag"
            },
            {
              "name": "tag_name",
              "type": "const char *",
              "direction": "in",
              "comment": "Name for the tag; this name is validated\n for consistency. It should also not conflict with an\n already existing tag name"
            },
            {
              "name": "target",
              "type": "const git_object *",
              "direction": "in",
              "comment": "Object to which this tag points. This object\n must belong to the given `repo`."
            },
            {
              "name": "force",
              "type": "int",
              "direction": "in",
              "comment": "Overwrite existing references"
            }
          ],
          "comment": [
            "Create a new lightweight tag pointing at a target object",
            "A new direct reference will be created pointing to\n this target object. If `force` is true and a reference\n already exists with the given name, it'll be replaced.",
            "The tag name will be checked for validity.\n See `git_tag_create()` for rules about valid names."
          ],
          "group": "tag"
        },
        "git_tag_delete": {
          "kind": "function",
          "name": "git_tag_delete",
          "location": {
            "file": "tag.h",
            "line": 276,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success, GIT_EINVALIDSPEC or an error code"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where lives the tag"
            },
            {
              "name": "tag_name",
              "type": "const char *",
              "direction": "in",
              "comment": "Name of the tag to be deleted;\n this name is validated for consistency."
            }
          ],
          "comment": [
            "Delete an existing tag reference.",
            "The tag name will be checked for validity.\n See `git_tag_create()` for rules about valid names."
          ],
          "group": "tag"
        },
        "git_tag_list": {
          "kind": "function",
          "name": "git_tag_list",
          "location": {
            "file": "tag.h",
            "line": 293,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "tag_names",
              "type": "git_strarray *",
              "direction": "in",
              "comment": "Pointer to a git_strarray structure where\n\t\tthe tag names will be stored"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where to find the tags"
            }
          ],
          "comment": [
            "Fill a list with all the tags in the Repository",
            "The string array will be filled with the names of the\n matching tags; these values are owned by the user and\n should be free'd manually when no longer needed, using\n `git_strarray_free`."
          ],
          "group": "tag"
        },
        "git_tag_list_match": {
          "kind": "function",
          "name": "git_tag_list_match",
          "location": {
            "file": "tag.h",
            "line": 315,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "tag_names",
              "type": "git_strarray *",
              "direction": "in",
              "comment": "Pointer to a git_strarray structure where\n\t\tthe tag names will be stored"
            },
            {
              "name": "pattern",
              "type": "const char *",
              "direction": "in",
              "comment": "Standard fnmatch pattern"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository where to find the tags"
            }
          ],
          "comment": [
            "Fill a list with all the tags in the Repository\n which name match a defined pattern",
            "If an empty pattern is provided, all the tags\n will be returned.",
            "The string array will be filled with the names of the\n matching tags; these values are owned by the user and\n should be free'd manually when no longer needed, using\n `git_strarray_free`."
          ],
          "group": "tag"
        },
        "git_tag_foreach_cb": {
          "kind": "callback",
          "name": "git_tag_foreach_cb",
          "type": "int (*)(const char *, git_oid *, void *)",
          "location": {
            "file": "tag.h",
            "line": 321,
            "column": 15
          },
          "params": [
            {
              "type": "const char *"
            },
            {
              "type": "git_oid *"
            },
            {
              "type": "void *"
            }
          ],
          "group": "tag",
          "parameterTo": [
            "git_tag_foreach"
          ],
          "typedef": true
        },
        "git_tag_foreach": {
          "kind": "function",
          "name": "git_tag_foreach",
          "location": {
            "file": "tag.h",
            "line": 330,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository"
            },
            {
              "name": "callback",
              "type": "git_tag_foreach_cb",
              "direction": "in",
              "comment": "Callback function",
              "referenceType": "int (*)(const char *, git_oid *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Pointer to callback data (optional)"
            }
          ],
          "comment": [
            "Call callback `cb' for each tag in the repository"
          ],
          "group": "tag"
        },
        "git_tag_peel": {
          "kind": "function",
          "name": "git_tag_peel",
          "location": {
            "file": "tag.h",
            "line": 346,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "tag_target_out",
              "type": "git_object **",
              "direction": "in",
              "comment": "Pointer to the peeled git_object"
            },
            {
              "name": "tag",
              "type": "const git_tag *",
              "direction": "in",
              "comment": "The tag to be processed"
            }
          ],
          "comment": [
            "Recursively peel a tag until a non tag git_object is found",
            "The retrieved `tag_target` object is owned by the repository\n and should be closed with the `git_object_free` method."
          ],
          "group": "tag"
        },
        "git_tag": {
          "kind": "struct",
          "name": "git_tag",
          "referenceName": "struct git_tag",
          "opaque": true,
          "comment": [
            "Parsed representation of a tag object."
          ],
          "location": {
            "file": "types.h",
            "line": 114,
            "column": 24
          },
          "group": "tag",
          "parameterTo": [
            "git_tag_lookup",
            "git_tag_lookup_prefix",
            "git_tag_free",
            "git_tag_id",
            "git_tag_owner",
            "git_tag_target",
            "git_tag_target_id",
            "git_tag_target_type",
            "git_tag_name",
            "git_tag_tagger",
            "git_tag_message",
            "git_tag_peel"
          ]
        }
      },
      "info": {
        "summary": "Git tag parsing routines"
      }
    },
    "threads": {
      "apis": {
        "git_threads_init": {
          "kind": "function",
          "name": "git_threads_init",
          "location": {
            "file": "threads.h",
            "line": 33,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "comment": [
            "Init the threading system.",
            "If libgit2 has been built with GIT_THREADS\n on, this function must be called once before\n any other library functions.",
            "If libgit2 has been built without GIT_THREADS\n support, this function is a no-op."
          ],
          "group": "threads"
        },
        "git_threads_shutdown": {
          "kind": "function",
          "name": "git_threads_shutdown",
          "location": {
            "file": "threads.h",
            "line": 45,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "comment": [
            "Shutdown the threading system.",
            "If libgit2 has been built with GIT_THREADS\n on, this function must be called before shutting\n down the library.",
            "If libgit2 has been built without GIT_THREADS\n support, this function is a no-op."
          ],
          "group": "threads"
        }
      },
      "info": {
        "summary": "Library level thread functions"
      }
    },
    "trace": {
      "apis": {
        "git_trace_level_t": {
          "kind": "enum",
          "name": "git_trace_level_t",
          "referenceName": "git_trace_level_t",
          "members": [
            {
              "name": "GIT_TRACE_NONE",
              "value": "0",
              "comment": [
                "No tracing will be performed."
              ]
            },
            {
              "name": "GIT_TRACE_FATAL",
              "value": "1",
              "comment": [
                "Severe errors that may impact the program's execution"
              ]
            },
            {
              "name": "GIT_TRACE_ERROR",
              "value": "2",
              "comment": [
                "Errors that do not impact the program's execution"
              ]
            },
            {
              "name": "GIT_TRACE_WARN",
              "value": "3",
              "comment": [
                "Warnings that suggest abnormal data"
              ]
            },
            {
              "name": "GIT_TRACE_INFO",
              "value": "4",
              "comment": [
                "Informational messages about program execution"
              ]
            },
            {
              "name": "GIT_TRACE_DEBUG",
              "value": "5",
              "comment": [
                "Detailed data that allows for debugging"
              ]
            },
            {
              "name": "GIT_TRACE_TRACE",
              "value": "6",
              "comment": [
                "Exceptionally detailed debugging data"
              ]
            }
          ],
          "comment": [
            "Available tracing levels.  When tracing is set to a particular level,\n callers will be provided tracing at the given level and all lower levels."
          ],
          "location": {
            "file": "trace.h",
            "line": 26,
            "column": 9
          },
          "group": "trace",
          "parameterTo": [
            "git_trace_callback",
            "git_trace_set"
          ]
        },
        "git_trace_callback": {
          "kind": "callback",
          "name": "git_trace_callback",
          "type": "void (*)(git_trace_level_t, const char *)",
          "comment": [
            "An instance for a tracing function"
          ],
          "location": {
            "file": "trace.h",
            "line": 52,
            "column": 16
          },
          "params": [
            {
              "type": "git_trace_level_t"
            },
            {
              "type": "const char *"
            }
          ],
          "returns": {
            "type": "void"
          },
          "group": "trace",
          "parameterTo": [
            "git_trace_set"
          ],
          "typedef": true
        },
        "git_trace_set": {
          "kind": "function",
          "name": "git_trace_set",
          "location": {
            "file": "trace.h",
            "line": 63,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "level",
              "type": "git_trace_level_t",
              "direction": "in",
              "comment": "Level to set tracing to",
              "referenceType": "enum git_trace_level_t"
            },
            {
              "name": "cb",
              "type": "git_trace_callback",
              "direction": "in",
              "comment": "Function to call with trace data",
              "referenceType": "void (*)(git_trace_level_t, const char *)"
            }
          ],
          "comment": [
            "Sets the system tracing configuration to the specified level with the\n specified callback.  When system events occur at a level equal to, or\n lower than, the given level they will be reported to the given callback."
          ],
          "group": "trace"
        }
      },
      "info": {
        "summary": "Git tracing configuration routines"
      }
    },
    "transport": {
      "apis": {
        "git_credtype_t": {
          "kind": "enum",
          "name": "git_credtype_t",
          "referenceName": "git_credtype_t",
          "members": [
            {
              "name": "GIT_CREDTYPE_USERPASS_PLAINTEXT",
              "value": "1"
            },
            {
              "name": "GIT_CREDTYPE_SSH_KEYFILE_PASSPHRASE",
              "value": "2"
            },
            {
              "name": "GIT_CREDTYPE_SSH_PUBLICKEY",
              "value": "3"
            }
          ],
          "location": {
            "file": "transport.h",
            "line": 31,
            "column": 9
          },
          "group": "transport"
        },
        "git_cred": {
          "kind": "struct",
          "name": "git_cred",
          "referenceName": "git_cred",
          "members": [
            {
              "name": "credtype",
              "type": "git_credtype_t",
              "referenceType": "enum git_credtype_t"
            },
            {
              "name": "free",
              "type": "void (*)(struct git_cred *)"
            }
          ],
          "location": {
            "file": "transport.h",
            "line": 39,
            "column": 16
          },
          "group": "transport",
          "parameterTo": [
            "git_cred_userpass",
            "git_cred_userpass_plaintext_new",
            "git_cred_acquire_cb"
          ]
        },
        "git_cred_userpass_plaintext": {
          "kind": "struct",
          "name": "git_cred_userpass_plaintext",
          "referenceName": "git_cred_userpass_plaintext",
          "members": [
            {
              "name": "parent",
              "type": "git_cred",
              "referenceType": "struct git_cred"
            },
            {
              "name": "username",
              "type": "char *"
            },
            {
              "name": "password",
              "type": "char *"
            }
          ],
          "location": {
            "file": "transport.h",
            "line": 46,
            "column": 16
          },
          "group": "transport"
        },
        "git_cred_userpass_plaintext_new": {
          "kind": "function",
          "name": "git_cred_userpass_plaintext_new",
          "location": {
            "file": "transport.h",
            "line": 82,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 for success or an error code for failure"
          },
          "params": [
            {
              "name": "out",
              "type": "git_cred **",
              "direction": "in",
              "comment": "The newly created credential object."
            },
            {
              "name": "username",
              "type": "const char *",
              "direction": "in",
              "comment": "The username of the credential."
            },
            {
              "name": "password",
              "type": "const char *",
              "direction": "in",
              "comment": "The password of the credential."
            }
          ],
          "comment": [
            "Creates a new plain-text username and password credential object.\n The supplied credential parameter will be internally duplicated."
          ],
          "group": "transport"
        },
        "git_cred_acquire_cb": {
          "kind": "callback",
          "name": "git_cred_acquire_cb",
          "type": "int (*)(git_cred **, const char *, const char *, unsigned int, void *)",
          "comment": [
            "Signature of a function which acquires a credential object."
          ],
          "location": {
            "file": "transport.h",
            "line": 134,
            "column": 15
          },
          "params": [
            {
              "name": "cred",
              "direction": "in",
              "comment": "The newly created credential object.",
              "type": "git_cred **"
            },
            {
              "name": "url",
              "direction": "in",
              "comment": "The resource for which we are demanding a credential.",
              "type": "const char *"
            },
            {
              "name": "username_from_url",
              "direction": "in",
              "comment": "The username that was embedded in a \"user@host\"\n                          remote url, or NULL if not included.",
              "type": "const char *"
            },
            {
              "name": "allowed_types",
              "direction": "in",
              "comment": "A bitmask stating which cred types are OK to return.",
              "type": "unsigned int"
            },
            {
              "name": "payload",
              "direction": "in",
              "comment": "The payload provided when specifying this callback.",
              "type": "void *"
            }
          ],
          "returns": {
            "comment": "0 for success or an error code for failure",
            "type": "int"
          },
          "group": "transport",
          "parameterTo": [
            "git_remote_set_cred_acquire_cb"
          ],
          "typedef": true
        },
        "git_transport_flags_t": {
          "kind": "enum",
          "name": "git_transport_flags_t",
          "referenceName": "git_transport_flags_t",
          "members": [
            {
              "name": "GIT_TRANSPORTFLAGS_NONE",
              "value": "0"
            },
            {
              "name": "GIT_TRANSPORTFLAGS_NO_CHECK_CERT",
              "value": "1"
            }
          ],
          "location": {
            "file": "transport.h",
            "line": 146,
            "column": 9
          },
          "group": "transport"
        },
        "git_transport_message_cb": {
          "kind": "callback",
          "name": "git_transport_message_cb",
          "type": "void (*)(const char *, int, void *)",
          "location": {
            "file": "transport.h",
            "line": 153,
            "column": 16
          },
          "params": [
            {
              "type": "const char *"
            },
            {
              "type": "int"
            },
            {
              "type": "void *"
            }
          ],
          "returns": {
            "type": "void"
          },
          "group": "transport",
          "typedef": true
        },
        "git_transport": {
          "kind": "struct",
          "name": "git_transport",
          "referenceName": "git_transport",
          "members": [
            {
              "name": "version",
              "type": "unsigned int"
            },
            {
              "name": "set_callbacks",
              "type": "int (*)(struct git_transport *, git_transport_message_cb, git_transport_message_cb, void *)"
            },
            {
              "name": "connect",
              "type": "int (*)(struct git_transport *, const char *, git_cred_acquire_cb, void *, int, int)"
            },
            {
              "name": "ls",
              "type": "int (*)(struct git_transport *, git_headlist_cb, void *)"
            },
            {
              "name": "push",
              "type": "int (*)(struct git_transport *, git_push *)"
            },
            {
              "name": "negotiate_fetch",
              "type": "int (*)(struct git_transport *, git_repository *, const git_remote_head *const *, size_t)"
            },
            {
              "name": "download_pack",
              "type": "int (*)(struct git_transport *, git_repository *, git_transfer_progress *, git_transfer_progress_callback, void *)"
            },
            {
              "name": "is_connected",
              "type": "int (*)(struct git_transport *)"
            },
            {
              "name": "read_flags",
              "type": "int (*)(struct git_transport *, int *)"
            },
            {
              "name": "cancel",
              "type": "void (*)(struct git_transport *)"
            },
            {
              "name": "close",
              "type": "int (*)(struct git_transport *)"
            },
            {
              "name": "free",
              "type": "void (*)(struct git_transport *)"
            }
          ],
          "location": {
            "file": "transport.h",
            "line": 155,
            "column": 16
          },
          "group": "transport",
          "parameterTo": [
            "git_remote_set_transport",
            "git_transport_new",
            "git_transport_cb",
            "git_transport_dummy",
            "git_transport_local",
            "git_transport_smart",
            "git_smart_subtransport_cb",
            "git_smart_subtransport_http",
            "git_smart_subtransport_git",
            "git_smart_subtransport_ssh"
          ]
        },
        "GIT_TRANSPORT_VERSION": {
          "kind": "macro",
          "name": "GIT_TRANSPORT_VERSION",
          "location": {
            "file": "transport.h",
            "line": 216,
            "column": 9
          },
          "value": "1",
          "comment": "",
          "group": "transport"
        },
        "GIT_TRANSPORT_INIT": {
          "kind": "macro",
          "name": "GIT_TRANSPORT_INIT",
          "location": {
            "file": "transport.h",
            "line": 217,
            "column": 9
          },
          "value": "{GIT_TRANSPORT_VERSION}",
          "comment": "",
          "group": "transport"
        },
        "git_transport_new": {
          "kind": "function",
          "name": "git_transport_new",
          "location": {
            "file": "transport.h",
            "line": 229,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_transport **",
              "direction": "in",
              "comment": "The newly created transport (out)"
            },
            {
              "name": "owner",
              "type": "git_remote *",
              "direction": "in",
              "comment": "The git_remote which will own this transport"
            },
            {
              "name": "url",
              "type": "const char *",
              "direction": "in",
              "comment": "The URL to connect to"
            }
          ],
          "comment": [
            "Function to use to create a transport from a URL. The transport database\n is scanned to find a transport that implements the scheme of the URI (i.e.\n git:// or http://) and a transport object is returned to the caller."
          ],
          "group": "transport"
        },
        "git_transport_cb": {
          "kind": "callback",
          "name": "git_transport_cb",
          "type": "int (*)(git_transport **, git_remote *, void *)",
          "location": {
            "file": "transport.h",
            "line": 232,
            "column": 15
          },
          "params": [
            {
              "type": "git_transport **"
            },
            {
              "type": "git_remote *"
            },
            {
              "type": "void *"
            }
          ],
          "group": "transport",
          "typedef": true
        },
        "git_transport_dummy": {
          "kind": "function",
          "name": "git_transport_dummy",
          "location": {
            "file": "transport.h",
            "line": 245,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_transport **",
              "direction": "in",
              "comment": "The newly created transport (out)"
            },
            {
              "name": "owner",
              "type": "git_remote *",
              "direction": "in",
              "comment": "The git_remote which will own this transport"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "You must pass NULL for this parameter."
            }
          ],
          "comment": [
            "Create an instance of the dummy transport."
          ],
          "group": "transport"
        },
        "git_transport_local": {
          "kind": "function",
          "name": "git_transport_local",
          "location": {
            "file": "transport.h",
            "line": 258,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_transport **",
              "direction": "in",
              "comment": "The newly created transport (out)"
            },
            {
              "name": "owner",
              "type": "git_remote *",
              "direction": "in",
              "comment": "The git_remote which will own this transport"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "You must pass NULL for this parameter."
            }
          ],
          "comment": [
            "Create an instance of the local transport."
          ],
          "group": "transport"
        },
        "git_transport_smart": {
          "kind": "function",
          "name": "git_transport_smart",
          "location": {
            "file": "transport.h",
            "line": 271,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_transport **",
              "direction": "in",
              "comment": "The newly created transport (out)"
            },
            {
              "name": "owner",
              "type": "git_remote *",
              "direction": "in",
              "comment": "The git_remote which will own this transport"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "A pointer to a git_smart_subtransport_definition"
            }
          ],
          "comment": [
            "Create an instance of the smart transport."
          ],
          "group": "transport"
        },
        "git_smart_service_t": {
          "kind": "enum",
          "name": "git_smart_service_t",
          "referenceName": "git_smart_service_t",
          "members": [
            {
              "name": "GIT_SERVICE_UPLOADPACK_LS",
              "value": "1"
            },
            {
              "name": "GIT_SERVICE_UPLOADPACK",
              "value": "2"
            },
            {
              "name": "GIT_SERVICE_RECEIVEPACK_LS",
              "value": "3"
            },
            {
              "name": "GIT_SERVICE_RECEIVEPACK",
              "value": "4"
            }
          ],
          "location": {
            "file": "transport.h",
            "line": 295,
            "column": 9
          },
          "group": "transport"
        },
        "git_smart_subtransport_stream": {
          "kind": "struct",
          "name": "git_smart_subtransport_stream",
          "referenceName": "git_smart_subtransport_stream",
          "members": [
            {
              "name": "subtransport",
              "type": "struct git_smart_subtransport *"
            },
            {
              "name": "read",
              "type": "int (*)(struct git_smart_subtransport_stream *, char *, size_t, size_t *)"
            },
            {
              "name": "write",
              "type": "int (*)(struct git_smart_subtransport_stream *, const char *, size_t)"
            },
            {
              "name": "free",
              "type": "void (*)(struct git_smart_subtransport_stream *)"
            }
          ],
          "location": {
            "file": "transport.h",
            "line": 306,
            "column": 16
          },
          "group": "transport"
        },
        "git_smart_subtransport": {
          "kind": "struct",
          "name": "git_smart_subtransport",
          "referenceName": "git_smart_subtransport",
          "members": [
            {
              "name": "action",
              "type": "int (*)(git_smart_subtransport_stream **, struct git_smart_subtransport *, const char *, git_smart_service_t)"
            },
            {
              "name": "close",
              "type": "int (*)(struct git_smart_subtransport *)"
            },
            {
              "name": "free",
              "type": "void (*)(struct git_smart_subtransport *)"
            }
          ],
          "location": {
            "file": "transport.h",
            "line": 327,
            "column": 16
          },
          "group": "transport",
          "parameterTo": [
            "git_smart_subtransport_cb",
            "git_smart_subtransport_http",
            "git_smart_subtransport_git",
            "git_smart_subtransport_ssh"
          ]
        },
        "git_smart_subtransport_cb": {
          "kind": "callback",
          "name": "git_smart_subtransport_cb",
          "type": "int (*)(git_smart_subtransport **, git_transport *)",
          "location": {
            "file": "transport.h",
            "line": 346,
            "column": 15
          },
          "params": [
            {
              "type": "git_smart_subtransport **"
            },
            {
              "type": "git_transport *"
            }
          ],
          "group": "transport",
          "typedef": true
        },
        "git_smart_subtransport_definition": {
          "kind": "struct",
          "name": "git_smart_subtransport_definition",
          "referenceName": "git_smart_subtransport_definition",
          "members": [
            {
              "name": "callback",
              "type": "git_smart_subtransport_cb",
              "referenceType": "int (*)(git_smart_subtransport **, git_transport *)"
            },
            {
              "name": "rpc",
              "type": "unsigned int"
            }
          ],
          "location": {
            "file": "transport.h",
            "line": 350,
            "column": 16
          },
          "group": "transport"
        },
        "git_smart_subtransport_http": {
          "kind": "function",
          "name": "git_smart_subtransport_http",
          "location": {
            "file": "transport.h",
            "line": 370,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_smart_subtransport **",
              "direction": "in",
              "comment": "The newly created subtransport"
            },
            {
              "name": "owner",
              "type": "git_transport *",
              "direction": "in",
              "comment": "The smart transport to own this subtransport"
            }
          ],
          "comment": [
            "Create an instance of the http subtransport. This subtransport\n also supports https. On Win32, this subtransport may be implemented\n using the WinHTTP library."
          ],
          "group": "transport"
        },
        "git_smart_subtransport_git": {
          "kind": "function",
          "name": "git_smart_subtransport_git",
          "location": {
            "file": "transport.h",
            "line": 381,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_smart_subtransport **",
              "direction": "in",
              "comment": "The newly created subtransport"
            },
            {
              "name": "owner",
              "type": "git_transport *",
              "direction": "in",
              "comment": "The smart transport to own this subtransport"
            }
          ],
          "comment": [
            "Create an instance of the git subtransport."
          ],
          "group": "transport"
        },
        "git_smart_subtransport_ssh": {
          "kind": "function",
          "name": "git_smart_subtransport_ssh",
          "location": {
            "file": "transport.h",
            "line": 392,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_smart_subtransport **",
              "direction": "in",
              "comment": "The newly created subtransport"
            },
            {
              "name": "owner",
              "type": "git_transport *",
              "direction": "in",
              "comment": "The smart transport to own this subtransport"
            }
          ],
          "comment": [
            "Create an instance of the ssh subtransport."
          ],
          "group": "transport"
        }
      },
      "info": {
        "summary": "Git transport interfaces and functions"
      }
    },
    "tree": {
      "apis": {
        "git_tree_lookup": {
          "kind": "function",
          "name": "git_tree_lookup",
          "location": {
            "file": "tree.h",
            "line": 32,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_tree **",
              "direction": "in",
              "comment": "Pointer to the looked up tree"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "The repo to use when locating the tree."
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "Identity of the tree to locate."
            }
          ],
          "comment": [
            "Lookup a tree object from the repository."
          ],
          "group": "tree"
        },
        "git_tree_lookup_prefix": {
          "kind": "function",
          "name": "git_tree_lookup_prefix",
          "location": {
            "file": "tree.h",
            "line": 47,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "git_tree **",
              "direction": "in",
              "comment": "pointer to the looked up tree"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "the repo to use when locating the tree."
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "identity of the tree to locate."
            },
            {
              "name": "len",
              "type": "size_t",
              "direction": "in",
              "comment": "the length of the short identifier"
            }
          ],
          "comment": [
            "Lookup a tree object from the repository,\n given a prefix of its identifier (short id)."
          ],
          "see": [
            "git_object_lookup_prefix"
          ],
          "group": "tree"
        },
        "git_tree_free": {
          "kind": "function",
          "name": "git_tree_free",
          "location": {
            "file": "tree.h",
            "line": 63,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "tree",
              "type": "git_tree *",
              "direction": "in",
              "comment": "The tree to close"
            }
          ],
          "comment": [
            "Close an open tree",
            "You can no longer use the git_tree pointer after this call.",
            "IMPORTANT: You MUST call this method when you stop using a tree to\n release memory. Failure to do so will cause a memory leak."
          ],
          "group": "tree"
        },
        "git_tree_id": {
          "kind": "function",
          "name": "git_tree_id",
          "location": {
            "file": "tree.h",
            "line": 71,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "object identity for the tree."
          },
          "params": [
            {
              "name": "tree",
              "type": "const git_tree *",
              "direction": "in",
              "comment": "a previously loaded tree."
            }
          ],
          "comment": [
            "Get the id of a tree."
          ],
          "group": "tree"
        },
        "git_tree_owner": {
          "kind": "function",
          "name": "git_tree_owner",
          "location": {
            "file": "tree.h",
            "line": 79,
            "column": 30
          },
          "returns": {
            "type": "git_repository *",
            "comment": "Repository that contains this tree."
          },
          "params": [
            {
              "name": "tree",
              "type": "const git_tree *",
              "direction": "in",
              "comment": "A previously loaded tree."
            }
          ],
          "comment": [
            "Get the repository that contains the tree."
          ],
          "group": "tree"
        },
        "git_tree_entrycount": {
          "kind": "function",
          "name": "git_tree_entrycount",
          "location": {
            "file": "tree.h",
            "line": 87,
            "column": 20
          },
          "returns": {
            "type": "size_t",
            "comment": "the number of entries in the tree"
          },
          "params": [
            {
              "name": "tree",
              "type": "const git_tree *",
              "direction": "in",
              "comment": "a previously loaded tree."
            }
          ],
          "comment": [
            "Get the number of entries listed in a tree"
          ],
          "group": "tree"
        },
        "git_tree_entry_byname": {
          "kind": "function",
          "name": "git_tree_entry_byname",
          "location": {
            "file": "tree.h",
            "line": 99,
            "column": 36
          },
          "returns": {
            "type": "const git_tree_entry *",
            "comment": "the tree entry; NULL if not found"
          },
          "params": [
            {
              "name": "tree",
              "type": "const git_tree *",
              "direction": "in",
              "comment": "a previously loaded tree."
            },
            {
              "name": "filename",
              "type": "const char *",
              "direction": "in",
              "comment": "the filename of the desired entry"
            }
          ],
          "comment": [
            "Lookup a tree entry by its filename",
            "This returns a git_tree_entry that is owned by the git_tree.  You don't\n have to free it, but you must not use it after the git_tree is released."
          ],
          "group": "tree"
        },
        "git_tree_entry_byindex": {
          "kind": "function",
          "name": "git_tree_entry_byindex",
          "location": {
            "file": "tree.h",
            "line": 112,
            "column": 36
          },
          "returns": {
            "type": "const git_tree_entry *",
            "comment": "the tree entry; NULL if not found"
          },
          "params": [
            {
              "name": "tree",
              "type": "const git_tree *",
              "direction": "in",
              "comment": "a previously loaded tree."
            },
            {
              "name": "idx",
              "type": "size_t",
              "direction": "in",
              "comment": "the position in the entry list"
            }
          ],
          "comment": [
            "Lookup a tree entry by its position in the tree",
            "This returns a git_tree_entry that is owned by the git_tree.  You don't\n have to free it, but you must not use it after the git_tree is released."
          ],
          "group": "tree"
        },
        "git_tree_entry_byoid": {
          "kind": "function",
          "name": "git_tree_entry_byoid",
          "location": {
            "file": "tree.h",
            "line": 127,
            "column": 36
          },
          "returns": {
            "type": "const git_tree_entry *",
            "comment": "the tree entry; NULL if not found"
          },
          "params": [
            {
              "name": "tree",
              "type": "const git_tree *",
              "direction": "in",
              "comment": "a previously loaded tree."
            },
            {
              "name": "oid",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "the sha being looked for"
            }
          ],
          "comment": [
            "Lookup a tree entry by SHA value.",
            "This returns a git_tree_entry that is owned by the git_tree.  You don't\n have to free it, but you must not use it after the git_tree is released.",
            "Warning: this must examine every entry in the tree, so it is not fast."
          ],
          "group": "tree"
        },
        "git_tree_entry_bypath": {
          "kind": "function",
          "name": "git_tree_entry_bypath",
          "location": {
            "file": "tree.h",
            "line": 142,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success; GIT_ENOTFOUND if the path does not exist"
          },
          "params": [
            {
              "name": "out",
              "type": "git_tree_entry **",
              "direction": "in",
              "comment": "Pointer where to store the tree entry"
            },
            {
              "name": "root",
              "type": "const git_tree *",
              "direction": "in",
              "comment": "Previously loaded tree which is the root of the relative path"
            },
            {
              "name": "path",
              "type": "const char *",
              "direction": "in",
              "comment": "Path to the contained entry"
            }
          ],
          "comment": [
            "Retrieve a tree entry contained in a tree or in any of its subtrees,\n given its relative path.",
            "Unlike the other lookup functions, the returned tree entry is owned by\n the user and must be freed explicitly with `git_tree_entry_free()`."
          ],
          "group": "tree"
        },
        "git_tree_entry_dup": {
          "kind": "function",
          "name": "git_tree_entry_dup",
          "location": {
            "file": "tree.h",
            "line": 156,
            "column": 30
          },
          "returns": {
            "type": "git_tree_entry *",
            "comment": "a copy of the original entry or NULL on error (alloc failure)"
          },
          "params": [
            {
              "name": "entry",
              "type": "const git_tree_entry *",
              "direction": "in",
              "comment": "A tree entry to duplicate"
            }
          ],
          "comment": [
            "Duplicate a tree entry",
            "Create a copy of a tree entry. The returned copy is owned by the user,\n and must be freed explicitly with `git_tree_entry_free()`."
          ],
          "group": "tree"
        },
        "git_tree_entry_free": {
          "kind": "function",
          "name": "git_tree_entry_free",
          "location": {
            "file": "tree.h",
            "line": 167,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "entry",
              "type": "git_tree_entry *",
              "direction": "in",
              "comment": "The entry to free"
            }
          ],
          "comment": [
            "Free a user-owned tree entry",
            "IMPORTANT: This function is only needed for tree entries owned by the\n user, such as the ones returned by `git_tree_entry_dup()` or\n `git_tree_entry_bypath()`."
          ],
          "group": "tree"
        },
        "git_tree_entry_name": {
          "kind": "function",
          "name": "git_tree_entry_name",
          "location": {
            "file": "tree.h",
            "line": 175,
            "column": 26
          },
          "returns": {
            "type": "const char *",
            "comment": "the name of the file"
          },
          "params": [
            {
              "name": "entry",
              "type": "const git_tree_entry *",
              "direction": "in",
              "comment": "a tree entry"
            }
          ],
          "comment": [
            "Get the filename of a tree entry"
          ],
          "group": "tree"
        },
        "git_tree_entry_id": {
          "kind": "function",
          "name": "git_tree_entry_id",
          "location": {
            "file": "tree.h",
            "line": 183,
            "column": 29
          },
          "returns": {
            "type": "const git_oid *",
            "comment": "the oid of the object"
          },
          "params": [
            {
              "name": "entry",
              "type": "const git_tree_entry *",
              "direction": "in",
              "comment": "a tree entry"
            }
          ],
          "comment": [
            "Get the id of the object pointed by the entry"
          ],
          "group": "tree"
        },
        "git_tree_entry_type": {
          "kind": "function",
          "name": "git_tree_entry_type",
          "location": {
            "file": "tree.h",
            "line": 191,
            "column": 23
          },
          "returns": {
            "type": "git_otype",
            "comment": "the type of the pointed object"
          },
          "params": [
            {
              "name": "entry",
              "type": "const git_tree_entry *",
              "direction": "in",
              "comment": "a tree entry"
            }
          ],
          "comment": [
            "Get the type of the object pointed by the entry"
          ],
          "group": "tree"
        },
        "git_tree_entry_filemode": {
          "kind": "function",
          "name": "git_tree_entry_filemode",
          "location": {
            "file": "tree.h",
            "line": 199,
            "column": 28
          },
          "returns": {
            "type": "git_filemode_t",
            "comment": "filemode as an integer"
          },
          "params": [
            {
              "name": "entry",
              "type": "const git_tree_entry *",
              "direction": "in",
              "comment": "a tree entry"
            }
          ],
          "comment": [
            "Get the UNIX file attributes of a tree entry"
          ],
          "group": "tree"
        },
        "git_tree_entry_cmp": {
          "kind": "function",
          "name": "git_tree_entry_cmp",
          "location": {
            "file": "tree.h",
            "line": 208,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "<\n0 if e1 is before e2, 0 if e1 == e2, >0 if e1 is after e2"
          },
          "params": [
            {
              "name": "e1",
              "type": "const git_tree_entry *",
              "direction": "in",
              "comment": "first tree entry"
            },
            {
              "name": "e2",
              "type": "const git_tree_entry *",
              "direction": "in",
              "comment": "second tree entry"
            }
          ],
          "comment": [
            "Compare two tree entries"
          ],
          "group": "tree"
        },
        "git_tree_entry_to_object": {
          "kind": "function",
          "name": "git_tree_entry_to_object",
          "location": {
            "file": "tree.h",
            "line": 220,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "object_out",
              "type": "git_object **",
              "direction": "in",
              "comment": "pointer to the converted object"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "repository where to lookup the pointed object"
            },
            {
              "name": "entry",
              "type": "const git_tree_entry *",
              "direction": "in",
              "comment": "a tree entry"
            }
          ],
          "comment": [
            "Convert a tree entry to the git_object it points too.",
            "You must call `git_object_free()` on the object when you are done with it."
          ],
          "group": "tree"
        },
        "git_treebuilder_create": {
          "kind": "function",
          "name": "git_treebuilder_create",
          "location": {
            "file": "tree.h",
            "line": 241,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 on success; error code otherwise"
          },
          "params": [
            {
              "name": "out",
              "type": "git_treebuilder **",
              "direction": "in",
              "comment": "Pointer where to store the tree builder"
            },
            {
              "name": "source",
              "type": "const git_tree *",
              "direction": "in",
              "comment": "Source tree to initialize the builder (optional)"
            }
          ],
          "comment": [
            "Create a new tree builder.",
            "The tree builder can be used to create or modify trees in memory and\n write them as tree objects to the database.",
            "If the `source` parameter is not NULL, the tree builder will be\n initialized with the entries of the given tree.",
            "If the `source` parameter is NULL, the tree builder will start with no\n entries and will have to be filled manually."
          ],
          "group": "tree"
        },
        "git_treebuilder_clear": {
          "kind": "function",
          "name": "git_treebuilder_clear",
          "location": {
            "file": "tree.h",
            "line": 249,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "bld",
              "type": "git_treebuilder *",
              "direction": "in",
              "comment": "Builder to clear"
            }
          ],
          "comment": [
            "Clear all the entires in the builder"
          ],
          "group": "tree"
        },
        "git_treebuilder_entrycount": {
          "kind": "function",
          "name": "git_treebuilder_entrycount",
          "location": {
            "file": "tree.h",
            "line": 257,
            "column": 26
          },
          "returns": {
            "type": "unsigned int",
            "comment": "the number of entries in the treebuilder"
          },
          "params": [
            {
              "name": "bld",
              "type": "git_treebuilder *",
              "direction": "in",
              "comment": "a previously loaded treebuilder."
            }
          ],
          "comment": [
            "Get the number of entries listed in a treebuilder"
          ],
          "group": "tree"
        },
        "git_treebuilder_free": {
          "kind": "function",
          "name": "git_treebuilder_free",
          "location": {
            "file": "tree.h",
            "line": 268,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "bld",
              "type": "git_treebuilder *",
              "direction": "in",
              "comment": "Builder to free"
            }
          ],
          "comment": [
            "Free a tree builder",
            "This will clear all the entries and free to builder.\n Failing to free the builder after you're done using it\n will result in a memory leak"
          ],
          "group": "tree"
        },
        "git_treebuilder_get": {
          "kind": "function",
          "name": "git_treebuilder_get",
          "location": {
            "file": "tree.h",
            "line": 280,
            "column": 36
          },
          "returns": {
            "type": "const git_tree_entry *",
            "comment": "pointer to the entry; NULL if not found"
          },
          "params": [
            {
              "name": "bld",
              "type": "git_treebuilder *",
              "direction": "in",
              "comment": "Tree builder"
            },
            {
              "name": "filename",
              "type": "const char *",
              "direction": "in",
              "comment": "Name of the entry"
            }
          ],
          "comment": [
            "Get an entry from the builder from its filename",
            "The returned entry is owned by the builder and should\n not be freed manually."
          ],
          "group": "tree"
        },
        "git_treebuilder_insert": {
          "kind": "function",
          "name": "git_treebuilder_insert",
          "location": {
            "file": "tree.h",
            "line": 308,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "out",
              "type": "const git_tree_entry **",
              "direction": "in",
              "comment": "Pointer to store the entry (optional)"
            },
            {
              "name": "bld",
              "type": "git_treebuilder *",
              "direction": "in",
              "comment": "Tree builder"
            },
            {
              "name": "filename",
              "type": "const char *",
              "direction": "in",
              "comment": "Filename of the entry"
            },
            {
              "name": "id",
              "type": "const git_oid *",
              "direction": "in",
              "comment": "SHA1 oid of the entry"
            },
            {
              "name": "filemode",
              "type": "git_filemode_t",
              "direction": "in",
              "comment": "Folder attributes of the entry. This parameter must\n\t\t\tbe valued with one of the following entries: 0040000, 0100644,\n\t\t\t0100755, 0120000 or 0160000.",
              "referenceType": "enum git_filemode_t"
            }
          ],
          "comment": [
            "Add or update an entry to the builder",
            "Insert a new entry for `filename` in the builder with the\n given attributes.",
            "If an entry named `filename` already exists, its attributes\n will be updated with the given ones.",
            "The optional pointer `out` can be used to retrieve a pointer to\n the newly created/updated entry.  Pass NULL if you do not need it.",
            "No attempt is being made to ensure that the provided oid points\n to an existing git object in the object database, nor that the\n attributes make sense regarding the type of the pointed at object."
          ],
          "group": "tree"
        },
        "git_treebuilder_remove": {
          "kind": "function",
          "name": "git_treebuilder_remove",
          "location": {
            "file": "tree.h",
            "line": 321,
            "column": 17
          },
          "returns": {
            "type": "int"
          },
          "params": [
            {
              "name": "bld",
              "type": "git_treebuilder *",
              "direction": "in",
              "comment": "Tree builder"
            },
            {
              "name": "filename",
              "type": "const char *",
              "direction": "in",
              "comment": "Filename of the entry to remove"
            }
          ],
          "comment": [
            "Remove an entry from the builder by its filename"
          ],
          "group": "tree"
        },
        "git_treebuilder_filter_cb": {
          "kind": "callback",
          "name": "git_treebuilder_filter_cb",
          "type": "int (*)(const git_tree_entry *, void *)",
          "location": {
            "file": "tree.h",
            "line": 324,
            "column": 15
          },
          "params": [
            {
              "type": "const git_tree_entry *"
            },
            {
              "type": "void *"
            }
          ],
          "group": "tree",
          "parameterTo": [
            "git_treebuilder_filter"
          ],
          "typedef": true
        },
        "git_treebuilder_filter": {
          "kind": "function",
          "name": "git_treebuilder_filter",
          "location": {
            "file": "tree.h",
            "line": 338,
            "column": 18
          },
          "returns": {
            "type": "void"
          },
          "params": [
            {
              "name": "bld",
              "type": "git_treebuilder *",
              "direction": "in",
              "comment": "Tree builder"
            },
            {
              "name": "filter",
              "type": "git_treebuilder_filter_cb",
              "direction": "in",
              "comment": "Callback to filter entries",
              "referenceType": "int (*)(const git_tree_entry *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Extra data to pass to filter"
            }
          ],
          "comment": [
            "Filter the entries in the tree",
            "The `filter` callback will be called for each entry in the tree with a\n pointer to the entry and the provided `payload`; if the callback returns\n non-zero, the entry will be filtered (removed from the builder)."
          ],
          "group": "tree"
        },
        "git_treebuilder_write": {
          "kind": "function",
          "name": "git_treebuilder_write",
          "location": {
            "file": "tree.h",
            "line": 354,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "id",
              "type": "git_oid *",
              "direction": "in",
              "comment": "Pointer to store the OID of the newly written tree"
            },
            {
              "name": "repo",
              "type": "git_repository *",
              "direction": "in",
              "comment": "Repository in which to store the object"
            },
            {
              "name": "bld",
              "type": "git_treebuilder *",
              "direction": "in",
              "comment": "Tree builder to write"
            }
          ],
          "comment": [
            "Write the contents of the tree builder as a tree object",
            "The tree builder will be written to the given `repo`, and its\n identifying SHA1 hash will be stored in the `id` pointer."
          ],
          "group": "tree"
        },
        "git_treewalk_cb": {
          "kind": "callback",
          "name": "git_treewalk_cb",
          "type": "int (*)(const char *, const git_tree_entry *, void *)",
          "comment": [
            "Callback for the tree traversal method"
          ],
          "location": {
            "file": "tree.h",
            "line": 359,
            "column": 15
          },
          "params": [
            {
              "type": "const char *"
            },
            {
              "type": "const git_tree_entry *"
            },
            {
              "type": "void *"
            }
          ],
          "group": "tree",
          "parameterTo": [
            "git_tree_walk"
          ],
          "typedef": true
        },
        "git_treewalk_mode": {
          "kind": "enum",
          "name": "git_treewalk_mode",
          "referenceName": "git_treewalk_mode",
          "members": [
            {
              "name": "GIT_TREEWALK_PRE",
              "value": "0"
            },
            {
              "name": "GIT_TREEWALK_POST",
              "value": "1"
            }
          ],
          "comment": [
            "Tree traversal modes"
          ],
          "location": {
            "file": "tree.h",
            "line": 363,
            "column": 9
          },
          "group": "tree",
          "parameterTo": [
            "git_tree_walk"
          ]
        },
        "git_tree_walk": {
          "kind": "function",
          "name": "git_tree_walk",
          "location": {
            "file": "tree.h",
            "line": 385,
            "column": 17
          },
          "returns": {
            "type": "int",
            "comment": "0 or an error code"
          },
          "params": [
            {
              "name": "tree",
              "type": "const git_tree *",
              "direction": "in",
              "comment": "The tree to walk"
            },
            {
              "name": "mode",
              "type": "git_treewalk_mode",
              "direction": "in",
              "comment": "Traversal mode (pre or post-order)",
              "referenceType": "enum git_treewalk_mode"
            },
            {
              "name": "callback",
              "type": "git_treewalk_cb",
              "direction": "in",
              "comment": "Function to call on each tree entry",
              "referenceType": "int (*)(const char *, const git_tree_entry *, void *)"
            },
            {
              "name": "payload",
              "type": "void *",
              "direction": "in",
              "comment": "Opaque pointer to be passed on each callback"
            }
          ],
          "comment": [
            "Traverse the entries in a tree and its subtrees in post or pre order.",
            "The entries will be traversed in the specified order, children subtrees\n will be automatically loaded as required, and the `callback` will be\n called once per entry with the current (relative) root for the entry and\n the entry data itself.",
            "If the callback returns a positive value, the passed entry will be\n skipped on the traversal (in pre mode). A negative value stops the walk."
          ],
          "group": "tree"
        },
        "git_tree_entry": {
          "kind": "struct",
          "name": "git_tree_entry",
          "referenceName": "struct git_tree_entry",
          "opaque": true,
          "comment": [
            "Representation of each one of the entries in a tree object."
          ],
          "location": {
            "file": "types.h",
            "line": 123,
            "column": 31
          },
          "group": "tree",
          "returnedBy": [
            "git_tree_entry_byname",
            "git_tree_entry_byindex",
            "git_tree_entry_byoid",
            "git_tree_entry_dup",
            "git_treebuilder_get"
          ],
          "parameterTo": [
            "git_tree_entry_bypath",
            "git_tree_entry_dup",
            "git_tree_entry_free",
            "git_tree_entry_name",
            "git_tree_entry_id",
            "git_tree_entry_type",
            "git_tree_entry_filemode",
            "git_tree_entry_cmp",
            "git_tree_entry_to_object",
            "git_treebuilder_insert",
            "git_treebuilder_filter_cb",
            "git_treewalk_cb"
          ]
        },
        "git_tree": {
          "kind": "struct",
          "name": "git_tree",
          "referenceName": "struct git_tree",
          "opaque": true,
          "comment": [
            "Representation of a tree object."
          ],
          "location": {
            "file": "types.h",
            "line": 126,
            "column": 25
          },
          "group": "tree",
          "parameterTo": [
            "git_commit_tree",
            "git_commit_create",
            "git_commit_create_v",
            "git_diff_tree_to_tree",
            "git_diff_tree_to_index",
            "git_diff_tree_to_workdir",
            "git_index_read_tree",
            "git_merge_trees",
            "git_tree_lookup",
            "git_tree_lookup_prefix",
            "git_tree_free",
            "git_tree_id",
            "git_tree_owner",
            "git_tree_entrycount",
            "git_tree_entry_byname",
            "git_tree_entry_byindex",
            "git_tree_entry_byoid",
            "git_tree_entry_bypath",
            "git_treebuilder_create",
            "git_tree_walk"
          ]
        },
        "git_treebuilder": {
          "kind": "struct",
          "name": "git_treebuilder",
          "referenceName": "struct git_treebuilder",
          "opaque": true,
          "comment": [
            "Constructor for in-memory trees"
          ],
          "location": {
            "file": "types.h",
            "line": 129,
            "column": 32
          },
          "group": "tree",
          "parameterTo": [
            "git_treebuilder_create",
            "git_treebuilder_clear",
            "git_treebuilder_entrycount",
            "git_treebuilder_free",
            "git_treebuilder_get",
            "git_treebuilder_insert",
            "git_treebuilder_remove",
            "git_treebuilder_filter",
            "git_treebuilder_write"
          ]
        },
        "git_filemode_t": {
          "kind": "enum",
          "name": "git_filemode_t",
          "referenceName": "git_filemode_t",
          "members": [
            {
              "name": "GIT_FILEMODE_NEW",
              "value": "0"
            },
            {
              "name": "GIT_FILEMODE_TREE",
              "value": "16384"
            },
            {
              "name": "GIT_FILEMODE_BLOB",
              "value": "33188"
            },
            {
              "name": "GIT_FILEMODE_BLOB_EXECUTABLE",
              "value": "33261"
            },
            {
              "name": "GIT_FILEMODE_LINK",
              "value": "40960"
            },
            {
              "name": "GIT_FILEMODE_COMMIT",
              "value": "57344"
            }
          ],
          "comment": [
            "Valid modes for index and tree entries."
          ],
          "location": {
            "file": "types.h",
            "line": 196,
            "column": 9
          },
          "group": "tree",
          "returnedBy": [
            "git_tree_entry_filemode"
          ],
          "parameterTo": [
            "git_treebuilder_insert"
          ]
        }
      },
      "info": {
        "summary": "Git tree parsing, loading routines"
      }
    },
    "types": {
      "apis": {
        "git_off_t": {
          "kind": "alias",
          "name": "git_off_t",
          "type": "int64_t",
          "location": {
            "file": "types.h",
            "line": 61,
            "column": 17
          },
          "group": "types",
          "returnedBy": [
            "git_blob_rawsize"
          ],
          "typedef": true
        },
        "git_time_t": {
          "kind": "alias",
          "name": "git_time_t",
          "type": "int64_t",
          "location": {
            "file": "types.h",
            "line": 62,
            "column": 17
          },
          "group": "types",
          "returnedBy": [
            "git_commit_time"
          ],
          "parameterTo": [
            "git_signature_new"
          ],
          "typedef": true
        },
        "git_otype": {
          "kind": "enum",
          "name": "git_otype",
          "referenceName": "git_otype",
          "members": [
            {
              "name": "GIT_OBJ_ANY",
              "value": "-2",
              "comment": [
                "Object can be any of the following"
              ]
            },
            {
              "name": "GIT_OBJ_BAD",
              "value": "-1",
              "comment": [
                "Object is invalid."
              ]
            },
            {
              "name": "GIT_OBJ__EXT1",
              "value": "0",
              "comment": [
                "Reserved for future use."
              ]
            },
            {
              "name": "GIT_OBJ_COMMIT",
              "value": "1",
              "comment": [
                "A commit object."
              ]
            },
            {
              "name": "GIT_OBJ_TREE",
              "value": "2",
              "comment": [
                "A tree (directory listing) object."
              ]
            },
            {
              "name": "GIT_OBJ_BLOB",
              "value": "3",
              "comment": [
                "A file revision object."
              ]
            },
            {
              "name": "GIT_OBJ_TAG",
              "value": "4",
              "comment": [
                "An annotated tag object."
              ]
            },
            {
              "name": "GIT_OBJ__EXT2",
              "value": "5",
              "comment": [
                "Reserved for future use."
              ]
            },
            {
              "name": "GIT_OBJ_OFS_DELTA",
              "value": "6",
              "comment": [
                "A delta, base is given by an offset."
              ]
            },
            {
              "name": "GIT_OBJ_REF_DELTA",
              "value": "7",
              "comment": [
                "A delta, base is given by object id."
              ]
            }
          ],
          "comment": [
            "Basic type (loose or packed) of any Git object."
          ],
          "location": {
            "file": "types.h",
            "line": 67,
            "column": 9
          },
          "group": "types",
          "returnedBy": [
            "git_object_type",
            "git_object_string2type",
            "git_odb_object_type",
            "git_tag_target_type",
            "git_tree_entry_type"
          ],
          "parameterTo": [
            "git_object_lookup",
            "git_object_lookup_prefix",
            "git_object_type2string",
            "git_object_typeisloose",
            "git_object__size",
            "git_object_peel",
            "git_odb_read_header",
            "git_odb_write",
            "git_odb_open_wstream",
            "git_odb_hash",
            "git_odb_hashfile",
            "git_reference_peel",
            "git_repository_hashfile"
          ]
        },
        "git_time": {
          "kind": "struct",
          "name": "git_time",
          "referenceName": "git_time",
          "comment": [
            "Time in a signature"
          ],
          "members": [
            {
              "name": "time",
              "type": "git_time_t",
              "referenceType": "int64_t"
            },
            {
              "name": "offset",
              "type": "int",
              "comment": [
                "time in seconds from epoch"
              ]
            }
          ],
          "location": {
            "file": "types.h",
            "line": 156,
            "column": 16
          },
          "group": "types"
        },
        "git_ref_t": {
          "kind": "enum",
          "name": "git_ref_t",
          "referenceName": "git_ref_t",
          "members": [
            {
              "name": "GIT_REF_INVALID",
              "value": "0"
            },
            {
              "name": "GIT_REF_OID",
              "value": "1",
              "comment": [
                "Invalid reference"
              ]
            },
            {
              "name": "GIT_REF_SYMBOLIC",
              "value": "2",
              "comment": [
                "A reference which points at an object id"
              ]
            },
            {
              "name": "GIT_REF_LISTALL",
              "value": "3",
              "comment": [
                "A reference which points at another reference"
              ]
            }
          ],
          "comment": [
            "Basic type of any Git reference."
          ],
          "location": {
            "file": "types.h",
            "line": 182,
            "column": 9
          },
          "group": "types",
          "returnedBy": [
            "git_reference_type"
          ]
        },
        "git_transfer_progress": {
          "kind": "struct",
          "name": "git_transfer_progress",
          "referenceName": "git_transfer_progress",
          "comment": [
            "This is passed as the first argument to the callback to allow the\n user to see the progress."
          ],
          "members": [
            {
              "name": "total_objects",
              "type": "unsigned int"
            },
            {
              "name": "indexed_objects",
              "type": "unsigned int"
            },
            {
              "name": "received_objects",
              "type": "unsigned int"
            },
            {
              "name": "received_bytes",
              "type": "size_t"
            }
          ],
          "location": {
            "file": "types.h",
            "line": 216,
            "column": 16
          },
          "group": "types",
          "returnedBy": [
            "git_remote_stats"
          ],
          "parameterTo": [
            "git_indexer_stream_add",
            "git_indexer_stream_finalize",
            "git_transfer_progress_callback"
          ]
        },
        "git_transfer_progress_callback": {
          "kind": "callback",
          "name": "git_transfer_progress_callback",
          "type": "int (*)(const git_transfer_progress *, void *)",
          "comment": [
            "Type for progress callbacks during indexing.  Return a value less than zero\n to cancel the transfer."
          ],
          "location": {
            "file": "types.h",
            "line": 230,
            "column": 15
          },
          "params": [
            {
              "name": "stats",
              "direction": "in",
              "comment": "Structure containing information about the state of the transfer",
              "type": "const git_transfer_progress *"
            },
            {
              "name": "payload",
              "direction": "in",
              "comment": "Payload provided by caller",
              "type": "void *"
            }
          ],
          "group": "types",
          "parameterTo": [
            "git_indexer_stream_new",
            "git_odb_write_pack",
            "git_packbuilder_write",
            "git_remote_download"
          ],
          "typedef": true
        }
      },
      "info": {
        "summary": "libgit2 base & compatibility types"
      }
    },
    "version": {
      "apis": {
        "LIBGIT2_VERSION": {
          "kind": "macro",
          "name": "LIBGIT2_VERSION",
          "location": {
            "file": "version.h",
            "line": 10,
            "column": 9
          },
          "value": "\"0.19.0\"",
          "comment": "",
          "group": "version"
        },
        "LIBGIT2_VER_MAJOR": {
          "kind": "macro",
          "name": "LIBGIT2_VER_MAJOR",
          "location": {
            "file": "version.h",
            "line": 11,
            "column": 9
          },
          "value": "0",
          "comment": "",
          "group": "version"
        },
        "LIBGIT2_VER_MINOR": {
          "kind": "macro",
          "name": "LIBGIT2_VER_MINOR",
          "location": {
            "file": "version.h",
            "line": 12,
            "column": 9
          },
          "value": "19",
          "comment": "",
          "group": "version"
        },
        "LIBGIT2_VER_REVISION": {
          "kind": "macro",
          "name": "LIBGIT2_VER_REVISION",
          "location": {
            "file": "version.h",
            "line": 13,
            "column": 9
          },
          "value": "0",
          "comment": "",
          "group": "version"
        }
      },
      "info": {}
    }
  }
}