Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 1 | CONFIGURATION FILE |
| 2 | ------------------ |
| 3 | |
| 4 | The git configuration file contains a number of variables that affect |
Junio C Hamano | 8f76dc6 | 2007-01-17 07:24:25 | [diff] [blame] | 5 | the git command's behavior. `.git/config` file for each repository |
| 6 | is used to store the information for that repository, and |
| 7 | `$HOME/.gitconfig` is used to store per user information to give |
Junio C Hamano | 7955690 | 2007-02-24 11:15:54 | [diff] [blame] | 8 | fallback values for `.git/config` file. The file `/etc/gitconfig` |
| 9 | can be used to store system-wide defaults. |
Junio C Hamano | 8f76dc6 | 2007-01-17 07:24:25 | [diff] [blame] | 10 | |
| 11 | They can be used by both the git plumbing |
Junio C Hamano | f1d1480 | 2006-06-08 00:48:17 | [diff] [blame] | 12 | and the porcelains. The variables are divided into sections, where |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 13 | in the fully qualified variable name the variable itself is the last |
| 14 | dot-separated segment and the section name is everything before the last |
| 15 | dot. The variable names are case-insensitive and only alphanumeric |
| 16 | characters are allowed. Some variables may appear multiple times. |
| 17 | |
Junio C Hamano | bee172f | 2007-01-23 08:44:18 | [diff] [blame] | 18 | Syntax |
| 19 | ~~~~~~ |
| 20 | |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 21 | The syntax is fairly flexible and permissive; whitespaces are mostly |
Junio C Hamano | bee172f | 2007-01-23 08:44:18 | [diff] [blame] | 22 | ignored. The '#' and ';' characters begin comments to the end of line, |
| 23 | blank lines are ignored. |
| 24 | |
| 25 | The file consists of sections and variables. A section begins with |
| 26 | the name of the section in square brackets and continues until the next |
| 27 | section begins. Section names are not case sensitive. Only alphanumeric |
| 28 | characters, '`-`' and '`.`' are allowed in section names. Each variable |
| 29 | must belong to some section, which means that there must be section |
| 30 | header before first setting of a variable. |
| 31 | |
| 32 | Sections can be further divided into subsections. To begin a subsection |
| 33 | put its name in double quotes, separated by space from the section name, |
| 34 | in the section header, like in example below: |
| 35 | |
| 36 | -------- |
| 37 | [section "subsection"] |
| 38 | |
| 39 | -------- |
| 40 | |
Junio C Hamano | fa0d4cf | 2007-01-25 02:23:58 | [diff] [blame] | 41 | Subsection names can contain any characters except newline (doublequote |
| 42 | '`"`' and backslash have to be escaped as '`\"`' and '`\\`', |
Junio C Hamano | ee1e428 | 2007-02-04 08:32:04 | [diff] [blame] | 43 | respectively) and are case sensitive. Section header cannot span multiple |
Junio C Hamano | bee172f | 2007-01-23 08:44:18 | [diff] [blame] | 44 | lines. Variables may belong directly to a section or to a given subsection. |
| 45 | You can have `[section]` if you have `[section "subsection"]`, but you |
| 46 | don't need to. |
| 47 | |
| 48 | There is also (case insensitive) alternative `[section.subsection]` syntax. |
| 49 | In this syntax subsection names follow the same restrictions as for section |
| 50 | name. |
| 51 | |
| 52 | All the other lines are recognized as setting variables, in the form |
| 53 | 'name = value'. If there is no equal sign on the line, the entire line |
| 54 | is taken as 'name' and the variable is recognized as boolean "true". |
| 55 | The variable names are case-insensitive and only alphanumeric |
| 56 | characters and '`-`' are allowed. There can be more than one value |
| 57 | for a given variable; we say then that variable is multivalued. |
| 58 | |
| 59 | Leading and trailing whitespace in a variable value is discarded. |
| 60 | Internal whitespace within a variable value is retained verbatim. |
| 61 | |
| 62 | The values following the equals sign in variable assign are all either |
| 63 | a string, an integer, or a boolean. Boolean values may be given as yes/no, |
| 64 | 0/1 or true/false. Case is not significant in boolean values, when |
| 65 | converting value to the canonical form using '--bool' type specifier; |
Junio C Hamano | 7ad22dc | 2007-01-29 02:55:48 | [diff] [blame] | 66 | `git-config` will ensure that the output is "true" or "false". |
Junio C Hamano | bee172f | 2007-01-23 08:44:18 | [diff] [blame] | 67 | |
| 68 | String values may be entirely or partially enclosed in double quotes. |
| 69 | You need to enclose variable value in double quotes if you want to |
| 70 | preserve leading or trailing whitespace, or if variable value contains |
| 71 | beginning of comment characters (if it contains '#' or ';'). |
| 72 | Double quote '`"`' and backslash '`\`' characters in variable value must |
| 73 | be escaped: use '`\"`' for '`"`' and '`\\`' for '`\`'. |
| 74 | |
| 75 | The following escape sequences (beside '`\"`' and '`\\`') are recognized: |
| 76 | '`\n`' for newline character (NL), '`\t`' for horizontal tabulation (HT, TAB) |
| 77 | and '`\b`' for backspace (BS). No other char escape sequence, nor octal |
| 78 | char sequences are valid. |
| 79 | |
| 80 | Variable value ending in a '`\`' is continued on the next line in the |
| 81 | customary UNIX fashion. |
| 82 | |
| 83 | Some variables may require special value format. |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 84 | |
| 85 | Example |
| 86 | ~~~~~~~ |
| 87 | |
| 88 | # Core variables |
| 89 | [core] |
| 90 | ; Don't trust file modes |
| 91 | filemode = false |
| 92 | |
| 93 | # Our diff algorithm |
| 94 | [diff] |
| 95 | external = "/usr/local/bin/gnu-diff -u" |
| 96 | renames = true |
| 97 | |
Junio C Hamano | 52401ef | 2006-12-19 00:54:38 | [diff] [blame] | 98 | [branch "devel"] |
| 99 | remote = origin |
| 100 | merge = refs/heads/devel |
| 101 | |
Junio C Hamano | bee172f | 2007-01-23 08:44:18 | [diff] [blame] | 102 | # Proxy settings |
| 103 | [core] |
Junio C Hamano | c71a873 | 2007-08-04 00:27:26 | [diff] [blame] | 104 | gitProxy="ssh" for "kernel.org" |
Junio C Hamano | bee172f | 2007-01-23 08:44:18 | [diff] [blame] | 105 | gitProxy=default-proxy ; for the rest |
Junio C Hamano | 52401ef | 2006-12-19 00:54:38 | [diff] [blame] | 106 | |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 107 | Variables |
| 108 | ~~~~~~~~~ |
| 109 | |
| 110 | Note that this list is non-comprehensive and not necessarily complete. |
Junio C Hamano | f1d1480 | 2006-06-08 00:48:17 | [diff] [blame] | 111 | For command-specific variables, you will find a more detailed description |
| 112 | in the appropriate manual page. You will find a description of non-core |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 113 | porcelain configuration variables in the respective porcelain documentation. |
| 114 | |
| 115 | core.fileMode:: |
| 116 | If false, the executable bit differences between the index and |
| 117 | the working copy are ignored; useful on broken filesystems like FAT. |
| 118 | See gitlink:git-update-index[1]. True by default. |
| 119 | |
Junio C Hamano | d526ba9 | 2007-07-02 00:17:42 | [diff] [blame] | 120 | core.quotepath:: |
| 121 | The commands that output paths (e.g. `ls-files`, |
| 122 | `diff`), when not given the `-z` option, will quote |
| 123 | "unusual" characters in the pathname by enclosing the |
| 124 | pathname in a double-quote pair and with backslashes the |
| 125 | same way strings in C source code are quoted. If this |
| 126 | variable is set to false, the bytes higher than 0x80 are |
| 127 | not quoted but output as verbatim. Note that double |
| 128 | quote, backslash and control characters are always |
| 129 | quoted without `-z` regardless of the setting of this |
| 130 | variable. |
| 131 | |
Junio C Hamano | d9e0e5d | 2007-04-14 16:22:04 | [diff] [blame] | 132 | core.autocrlf:: |
| 133 | If true, makes git convert `CRLF` at the end of lines in text files to |
| 134 | `LF` when reading from the filesystem, and convert in reverse when |
| 135 | writing to the filesystem. The variable can be set to |
| 136 | 'input', in which case the conversion happens only while |
| 137 | reading from the filesystem but files are written out with |
| 138 | `LF` at the end of lines. Currently, which paths to consider |
| 139 | "text" (i.e. be subjected to the autocrlf mechanism) is |
| 140 | decided purely based on the contents. |
| 141 | |
Junio C Hamano | aa83a7d | 2007-03-05 02:37:29 | [diff] [blame] | 142 | core.symlinks:: |
| 143 | If false, symbolic links are checked out as small plain files that |
| 144 | contain the link text. gitlink:git-update-index[1] and |
| 145 | gitlink:git-add[1] will not change the recorded type to regular |
| 146 | file. Useful on filesystems like FAT that do not support |
| 147 | symbolic links. True by default. |
| 148 | |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 149 | core.gitProxy:: |
| 150 | A "proxy command" to execute (as 'command host port') instead |
| 151 | of establishing direct connection to the remote server when |
| 152 | using the git protocol for fetching. If the variable value is |
| 153 | in the "COMMAND for DOMAIN" format, the command is applied only |
| 154 | on hostnames ending with the specified domain string. This variable |
| 155 | may be set multiple times and is matched in the given order; |
| 156 | the first match wins. |
Junio C Hamano | f1d1480 | 2006-06-08 00:48:17 | [diff] [blame] | 157 | + |
| 158 | Can be overridden by the 'GIT_PROXY_COMMAND' environment variable |
| 159 | (which always applies universally, without the special "for" |
| 160 | handling). |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 161 | |
| 162 | core.ignoreStat:: |
| 163 | The working copy files are assumed to stay unchanged until you |
| 164 | mark them otherwise manually - Git will not detect the file changes |
| 165 | by lstat() calls. This is useful on systems where those are very |
| 166 | slow, such as Microsoft Windows. See gitlink:git-update-index[1]. |
| 167 | False by default. |
| 168 | |
Junio C Hamano | 88a3a07 | 2006-05-04 08:01:43 | [diff] [blame] | 169 | core.preferSymlinkRefs:: |
| 170 | Instead of the default "symref" format for HEAD |
| 171 | and other symbolic reference files, use symbolic links. |
| 172 | This is sometimes needed to work with old scripts that |
| 173 | expect HEAD to be a symbolic link. |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 174 | |
Junio C Hamano | 1025e75 | 2007-02-23 07:21:26 | [diff] [blame] | 175 | core.bare:: |
| 176 | If true this repository is assumed to be 'bare' and has no |
| 177 | working directory associated with it. If this is the case a |
| 178 | number of commands that require a working directory will be |
| 179 | disabled, such as gitlink:git-add[1] or gitlink:git-merge[1]. |
| 180 | + |
| 181 | This setting is automatically guessed by gitlink:git-clone[1] or |
| 182 | gitlink:git-init[1] when the repository was created. By default a |
| 183 | repository that ends in "/.git" is assumed to be not bare (bare = |
| 184 | false), while all other repositories are assumed to be bare (bare |
| 185 | = true). |
| 186 | |
Junio C Hamano | d526ba9 | 2007-07-02 00:17:42 | [diff] [blame] | 187 | core.worktree:: |
| 188 | Set the path to the working tree. The value will not be |
| 189 | used in combination with repositories found automatically in |
| 190 | a .git directory (i.e. $GIT_DIR is not set). |
Junio C Hamano | 764a667 | 2007-10-23 01:23:31 | [diff] [blame] | 191 | This can be overridden by the GIT_WORK_TREE environment |
Junio C Hamano | d526ba9 | 2007-07-02 00:17:42 | [diff] [blame] | 192 | variable and the '--work-tree' command line option. |
| 193 | |
Junio C Hamano | 341071d | 2006-06-04 07:24:48 | [diff] [blame] | 194 | core.logAllRefUpdates:: |
Junio C Hamano | cae8627 | 2007-08-21 02:20:49 | [diff] [blame] | 195 | Enable the reflog. Updates to a ref <ref> is logged to the file |
Junio C Hamano | a2ec14f | 2006-11-02 00:22:48 | [diff] [blame] | 196 | "$GIT_DIR/logs/<ref>", by appending the new and old |
| 197 | SHA1, the date/time and the reason of the update, but |
| 198 | only when the file exists. If this configuration |
| 199 | variable is set to true, missing "$GIT_DIR/logs/<ref>" |
| 200 | file is automatically created for branch heads. |
Junio C Hamano | 1caaf47 | 2006-12-31 08:29:35 | [diff] [blame] | 201 | + |
| 202 | This information can be used to determine what commit |
| 203 | was the tip of a branch "2 days ago". |
| 204 | + |
| 205 | This value is true by default in a repository that has |
| 206 | a working directory associated with it, and false by |
| 207 | default in a bare repository. |
Junio C Hamano | 341071d | 2006-06-04 07:24:48 | [diff] [blame] | 208 | |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 209 | core.repositoryFormatVersion:: |
| 210 | Internal variable identifying the repository format and layout |
| 211 | version. |
| 212 | |
| 213 | core.sharedRepository:: |
Junio C Hamano | 0ab78ae | 2006-08-09 01:00:42 | [diff] [blame] | 214 | When 'group' (or 'true'), the repository is made shareable between |
| 215 | several users in a group (making sure all the files and objects are |
| 216 | group-writable). When 'all' (or 'world' or 'everybody'), the |
| 217 | repository will be readable by all users, additionally to being |
| 218 | group-shareable. When 'umask' (or 'false'), git will use permissions |
Junio C Hamano | 24351a8 | 2007-01-13 08:09:17 | [diff] [blame] | 219 | reported by umask(2). See gitlink:git-init[1]. False by default. |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 220 | |
| 221 | core.warnAmbiguousRefs:: |
| 222 | If true, git will warn you if the ref name you passed it is ambiguous |
| 223 | and might match multiple refs in the .git/refs/ tree. True by default. |
| 224 | |
Junio C Hamano | 7ec1572 | 2006-07-07 02:03:59 | [diff] [blame] | 225 | core.compression:: |
Junio C Hamano | f2ce297 | 2007-05-20 19:12:09 | [diff] [blame] | 226 | An integer -1..9, indicating a default compression level. |
| 227 | -1 is the zlib default. 0 means no compression, |
| 228 | and 1..9 are various speed/size tradeoffs, 9 being slowest. |
Junio C Hamano | a126a3b | 2006-07-04 04:55:26 | [diff] [blame] | 229 | |
Junio C Hamano | f2ce297 | 2007-05-20 19:12:09 | [diff] [blame] | 230 | core.loosecompression:: |
| 231 | An integer -1..9, indicating the compression level for objects that |
| 232 | are not in a pack file. -1 is the zlib default. 0 means no |
| 233 | compression, and 1..9 are various speed/size tradeoffs, 9 being |
| 234 | slowest. If not set, defaults to core.compression. If that is |
| 235 | not set, defaults to 0 (best speed). |
Junio C Hamano | 28d9dfe | 2006-07-25 03:50:49 | [diff] [blame] | 236 | |
Junio C Hamano | fc4d38c | 2007-01-08 06:53:32 | [diff] [blame] | 237 | core.packedGitWindowSize:: |
| 238 | Number of bytes of a pack file to map into memory in a |
| 239 | single mapping operation. Larger window sizes may allow |
| 240 | your system to process a smaller number of large pack files |
| 241 | more quickly. Smaller window sizes will negatively affect |
| 242 | performance due to increased calls to the operating system's |
| 243 | memory manager, but may improve performance when accessing |
| 244 | a large number of large pack files. |
| 245 | + |
| 246 | Default is 1 MiB if NO_MMAP was set at compile time, otherwise 32 |
| 247 | MiB on 32 bit platforms and 1 GiB on 64 bit platforms. This should |
| 248 | be reasonable for all users/operating systems. You probably do |
| 249 | not need to adjust this value. |
| 250 | + |
| 251 | Common unit suffixes of 'k', 'm', or 'g' are supported. |
| 252 | |
| 253 | core.packedGitLimit:: |
| 254 | Maximum number of bytes to map simultaneously into memory |
| 255 | from pack files. If Git needs to access more than this many |
| 256 | bytes at once to complete an operation it will unmap existing |
| 257 | regions to reclaim virtual address space within the process. |
| 258 | + |
| 259 | Default is 256 MiB on 32 bit platforms and 8 GiB on 64 bit platforms. |
| 260 | This should be reasonable for all users/operating systems, except on |
| 261 | the largest projects. You probably do not need to adjust this value. |
| 262 | + |
| 263 | Common unit suffixes of 'k', 'm', or 'g' are supported. |
| 264 | |
Junio C Hamano | b8c5128 | 2007-03-19 10:43:30 | [diff] [blame] | 265 | core.deltaBaseCacheLimit:: |
| 266 | Maximum number of bytes to reserve for caching base objects |
| 267 | that multiple deltafied objects reference. By storing the |
| 268 | entire decompressed base objects in a cache Git is able |
| 269 | to avoid unpacking and decompressing frequently used base |
| 270 | objects multiple times. |
| 271 | + |
| 272 | Default is 16 MiB on all platforms. This should be reasonable |
| 273 | for all users/operating systems, except on the largest projects. |
| 274 | You probably do not need to adjust this value. |
| 275 | + |
| 276 | Common unit suffixes of 'k', 'm', or 'g' are supported. |
| 277 | |
Junio C Hamano | 1d90cb0 | 2007-07-03 07:05:31 | [diff] [blame] | 278 | core.excludesfile:: |
Junio C Hamano | 5e284b4 | 2007-05-22 07:23:37 | [diff] [blame] | 279 | In addition to '.gitignore' (per-directory) and |
| 280 | '.git/info/exclude', git looks into this file for patterns |
Junio C Hamano | 679d22d | 2007-06-02 21:13:44 | [diff] [blame] | 281 | of files which are not meant to be tracked. See |
| 282 | gitlink:gitignore[5]. |
Junio C Hamano | 5e284b4 | 2007-05-22 07:23:37 | [diff] [blame] | 283 | |
Junio C Hamano | f6002a9 | 2007-07-20 10:28:22 | [diff] [blame] | 284 | core.editor:: |
| 285 | Commands such as `commit` and `tag` that lets you edit |
Junio C Hamano | a638742 | 2007-08-25 03:54:27 | [diff] [blame] | 286 | messages by launching an editor uses the value of this |
Junio C Hamano | f6002a9 | 2007-07-20 10:28:22 | [diff] [blame] | 287 | variable when it is set, and the environment variable |
| 288 | `GIT_EDITOR` is not set. The order of preference is |
Junio C Hamano | de9879a | 2007-07-22 09:33:42 | [diff] [blame] | 289 | `GIT_EDITOR` environment, `core.editor`, `VISUAL` and |
| 290 | `EDITOR` environment variables and then finally `vi`. |
Junio C Hamano | f6002a9 | 2007-07-20 10:28:22 | [diff] [blame] | 291 | |
Junio C Hamano | 28d8ede | 2007-07-05 05:51:38 | [diff] [blame] | 292 | core.pager:: |
| 293 | The command that git will use to paginate output. Can be overridden |
| 294 | with the `GIT_PAGER` environment variable. |
| 295 | |
Junio C Hamano | 33db437 | 2006-06-07 19:51:45 | [diff] [blame] | 296 | alias.*:: |
| 297 | Command aliases for the gitlink:git[1] command wrapper - e.g. |
| 298 | after defining "alias.last = cat-file commit HEAD", the invocation |
| 299 | "git last" is equivalent to "git cat-file commit HEAD". To avoid |
Junio C Hamano | f1d1480 | 2006-06-08 00:48:17 | [diff] [blame] | 300 | confusion and troubles with script usage, aliases that |
| 301 | hide existing git commands are ignored. Arguments are split by |
| 302 | spaces, the usual shell quoting and escaping is supported. |
| 303 | quote pair and a backslash can be used to quote them. |
Junio C Hamano | dbb6459 | 2007-09-01 11:17:39 | [diff] [blame] | 304 | + |
| 305 | If the alias expansion is prefixed with an exclamation point, |
| 306 | it will be treated as a shell command. For example, defining |
| 307 | "alias.new = !gitk --all --not ORIG_HEAD", the invocation |
| 308 | "git new" is equivalent to running the shell command |
| 309 | "gitk --all --not ORIG_HEAD". |
Junio C Hamano | 9cb74f2 | 2007-02-12 04:15:05 | [diff] [blame] | 310 | |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 311 | apply.whitespace:: |
| 312 | Tells `git-apply` how to handle whitespaces, in the same way |
| 313 | as the '--whitespace' option. See gitlink:git-apply[1]. |
| 314 | |
Junio C Hamano | 7fd8417 | 2007-05-24 07:00:32 | [diff] [blame] | 315 | branch.autosetupmerge:: |
| 316 | Tells `git-branch` and `git-checkout` to setup new branches |
| 317 | so that gitlink:git-pull[1] will appropriately merge from that |
| 318 | remote branch. Note that even if this option is not set, |
| 319 | this behavior can be chosen per-branch using the `--track` |
Junio C Hamano | 9cb3917 | 2007-07-12 06:45:37 | [diff] [blame] | 320 | and `--no-track` options. This option defaults to false. |
Junio C Hamano | 7fd8417 | 2007-05-24 07:00:32 | [diff] [blame] | 321 | |
Junio C Hamano | 47c1e3c | 2006-09-25 04:45:55 | [diff] [blame] | 322 | branch.<name>.remote:: |
| 323 | When in branch <name>, it tells `git fetch` which remote to fetch. |
Junio C Hamano | 96010b2 | 2006-12-09 21:15:46 | [diff] [blame] | 324 | If this option is not given, `git fetch` defaults to remote "origin". |
Junio C Hamano | 47c1e3c | 2006-09-25 04:45:55 | [diff] [blame] | 325 | |
| 326 | branch.<name>.merge:: |
Junio C Hamano | c2b4709 | 2007-10-25 06:50:31 | [diff] [blame] | 327 | When in branch <name>, it tells `git fetch` the default |
| 328 | refspec to be marked for merging in FETCH_HEAD. The value is |
| 329 | handled like the remote part of a refspec, and must match a |
| 330 | ref which is fetched from the remote given by |
| 331 | "branch.<name>.remote". |
Junio C Hamano | 96010b2 | 2006-12-09 21:15:46 | [diff] [blame] | 332 | The merge information is used by `git pull` (which at first calls |
| 333 | `git fetch`) to lookup the default branch for merging. Without |
| 334 | this option, `git pull` defaults to merge the first refspec fetched. |
| 335 | Specify multiple values to get an octopus merge. |
Junio C Hamano | 6e149c0 | 2007-03-16 10:21:07 | [diff] [blame] | 336 | If you wish to setup `git pull` so that it merges into <name> from |
| 337 | another branch in the local repository, you can point |
| 338 | branch.<name>.merge to the desired branch, and use the special setting |
| 339 | `.` (a period) for branch.<name>.remote. |
Junio C Hamano | 47c1e3c | 2006-09-25 04:45:55 | [diff] [blame] | 340 | |
Junio C Hamano | 1b50ce9 | 2007-10-03 12:05:53 | [diff] [blame] | 341 | branch.<name>.mergeoptions:: |
| 342 | Sets default options for merging into branch <name>. The syntax and |
| 343 | supported options are equal to that of gitlink:git-merge[1], but |
| 344 | option values containing whitespace characters are currently not |
| 345 | supported. |
| 346 | |
Junio C Hamano | 47b9acd | 2007-04-24 07:34:34 | [diff] [blame] | 347 | clean.requireForce:: |
| 348 | A boolean to make git-clean do nothing unless given -f or -n. Defaults |
| 349 | to false. |
| 350 | |
Junio C Hamano | eb69295 | 2007-01-03 22:02:12 | [diff] [blame] | 351 | color.branch:: |
| 352 | A boolean to enable/disable color in the output of |
| 353 | gitlink:git-branch[1]. May be set to `true` (or `always`), |
| 354 | `false` (or `never`) or `auto`, in which case colors are used |
| 355 | only when the output is to a terminal. Defaults to false. |
| 356 | |
| 357 | color.branch.<slot>:: |
| 358 | Use customized color for branch coloration. `<slot>` is one of |
| 359 | `current` (the current branch), `local` (a local branch), |
| 360 | `remote` (a tracking branch in refs/remotes/), `plain` (other |
Junio C Hamano | 5a70233 | 2007-01-28 20:55:22 | [diff] [blame] | 361 | refs). |
| 362 | + |
| 363 | The value for these configuration variables is a list of colors (at most |
| 364 | two) and attributes (at most one), separated by spaces. The colors |
| 365 | accepted are `normal`, `black`, `red`, `green`, `yellow`, `blue`, |
| 366 | `magenta`, `cyan` and `white`; the attributes are `bold`, `dim`, `ul`, |
| 367 | `blink` and `reverse`. The first color given is the foreground; the |
| 368 | second is the background. The position of the attribute, if any, |
| 369 | doesn't matter. |
Junio C Hamano | eb69295 | 2007-01-03 22:02:12 | [diff] [blame] | 370 | |
Junio C Hamano | 3f403b0 | 2006-12-13 10:14:13 | [diff] [blame] | 371 | color.diff:: |
Junio C Hamano | 9ae1a06 | 2006-07-10 08:12:34 | [diff] [blame] | 372 | When true (or `always`), always use colors in patch. |
| 373 | When false (or `never`), never. When set to `auto`, use |
| 374 | colors only when the output is to the terminal. |
| 375 | |
Junio C Hamano | 3f403b0 | 2006-12-13 10:14:13 | [diff] [blame] | 376 | color.diff.<slot>:: |
Junio C Hamano | 5a70233 | 2007-01-28 20:55:22 | [diff] [blame] | 377 | Use customized color for diff colorization. `<slot>` specifies |
| 378 | which part of the patch to use the specified color, and is one |
| 379 | of `plain` (context text), `meta` (metainformation), `frag` |
| 380 | (hunk header), `old` (removed lines), `new` (added lines), |
| 381 | `commit` (commit headers), or `whitespace` (highlighting dubious |
| 382 | whitespace). The values of these variables may be specified as |
| 383 | in color.branch.<slot>. |
Junio C Hamano | 9ae1a06 | 2006-07-10 08:12:34 | [diff] [blame] | 384 | |
Junio C Hamano | e7935c4 | 2006-12-13 21:32:17 | [diff] [blame] | 385 | color.pager:: |
| 386 | A boolean to enable/disable colored output when the pager is in |
| 387 | use (default is true). |
| 388 | |
| 389 | color.status:: |
| 390 | A boolean to enable/disable color in the output of |
| 391 | gitlink:git-status[1]. May be set to `true` (or `always`), |
| 392 | `false` (or `never`) or `auto`, in which case colors are used |
| 393 | only when the output is to a terminal. Defaults to false. |
| 394 | |
| 395 | color.status.<slot>:: |
| 396 | Use customized color for status colorization. `<slot>` is |
| 397 | one of `header` (the header text of the status message), |
Junio C Hamano | 7d23f5e | 2006-12-16 07:44:04 | [diff] [blame] | 398 | `added` or `updated` (files which are added but not committed), |
| 399 | `changed` (files which are changed but not added in the index), |
Junio C Hamano | e7935c4 | 2006-12-13 21:32:17 | [diff] [blame] | 400 | or `untracked` (files which are not tracked by git). The values of |
Junio C Hamano | eb69295 | 2007-01-03 22:02:12 | [diff] [blame] | 401 | these variables may be specified as in color.branch.<slot>. |
Junio C Hamano | e7935c4 | 2006-12-13 21:32:17 | [diff] [blame] | 402 | |
Junio C Hamano | b968dbb | 2007-07-27 07:26:40 | [diff] [blame] | 403 | commit.template:: |
| 404 | Specify a file to use as the template for new commit messages. |
| 405 | |
Junio C Hamano | dbb6459 | 2007-09-01 11:17:39 | [diff] [blame] | 406 | diff.autorefreshindex:: |
| 407 | When using `git diff` to compare with work tree |
| 408 | files, do not consider stat-only change as changed. |
| 409 | Instead, silently run `git update-index --refresh` to |
| 410 | update the cached stat information for paths whose |
| 411 | contents in the work tree match the contents in the |
| 412 | index. This option defaults to true. Note that this |
| 413 | affects only `git diff` Porcelain, and not lower level |
| 414 | `diff` commands, such as `git diff-files`. |
| 415 | |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 416 | diff.renameLimit:: |
| 417 | The number of files to consider when performing the copy/rename |
| 418 | detection; equivalent to the git diff option '-l'. |
| 419 | |
Junio C Hamano | 9ae1a06 | 2006-07-10 08:12:34 | [diff] [blame] | 420 | diff.renames:: |
| 421 | Tells git to detect renames. If set to any boolean value, it |
| 422 | will enable basic rename detection. If set to "copies" or |
| 423 | "copy", it will detect copies, as well. |
| 424 | |
Junio C Hamano | 54ea8d3 | 2007-01-25 07:59:48 | [diff] [blame] | 425 | fetch.unpackLimit:: |
| 426 | If the number of objects fetched over the git native |
| 427 | transfer is below this |
| 428 | limit, then the objects will be unpacked into loose object |
| 429 | files. However if the number of received objects equals or |
| 430 | exceeds this limit then the received pack will be stored as |
| 431 | a pack, after adding any missing delta bases. Storing the |
| 432 | pack from a push can make the push operation complete faster, |
| 433 | especially on slow filesystems. |
| 434 | |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 435 | format.headers:: |
| 436 | Additional email headers to include in a patch to be submitted |
| 437 | by mail. See gitlink:git-format-patch[1]. |
| 438 | |
Junio C Hamano | d4c8e11 | 2007-03-04 10:32:38 | [diff] [blame] | 439 | format.suffix:: |
| 440 | The default for format-patch is to output files with the suffix |
| 441 | `.patch`. Use this variable to change that suffix (make sure to |
| 442 | include the dot if you want it). |
| 443 | |
Junio C Hamano | f2ce297 | 2007-05-20 19:12:09 | [diff] [blame] | 444 | gc.aggressiveWindow:: |
| 445 | The window size parameter used in the delta compression |
| 446 | algorithm used by 'git gc --aggressive'. This defaults |
| 447 | to 10. |
| 448 | |
Junio C Hamano | 1b50ce9 | 2007-10-03 12:05:53 | [diff] [blame] | 449 | gc.auto:: |
| 450 | When there are approximately more than this many loose |
| 451 | objects in the repository, `git gc --auto` will pack them. |
| 452 | Some Porcelain commands use this command to perform a |
| 453 | light-weight garbage collection from time to time. Setting |
| 454 | this to 0 disables it. |
| 455 | |
| 456 | gc.autopacklimit:: |
| 457 | When there are more than this many packs that are not |
| 458 | marked with `*.keep` file in the repository, `git gc |
| 459 | --auto` consolidates them into one larger pack. Setting |
| 460 | this to 0 disables this. |
| 461 | |
Junio C Hamano | 9d52e57 | 2007-02-13 23:48:20 | [diff] [blame] | 462 | gc.packrefs:: |
| 463 | `git gc` does not run `git pack-refs` in a bare repository by |
| 464 | default so that older dumb-transport clients can still fetch |
| 465 | from the repository. Setting this to `true` lets `git |
| 466 | gc` to run `git pack-refs`. Setting this to `false` tells |
| 467 | `git gc` never to run `git pack-refs`. The default setting is |
| 468 | `notbare`. Enable it only when you know you do not have to |
| 469 | support such clients. The default setting will change to `true` |
| 470 | at some stage, and setting this to `false` will continue to |
| 471 | prevent `git pack-refs` from being run from `git gc`. |
| 472 | |
Junio C Hamano | 7464064 | 2006-12-27 10:59:55 | [diff] [blame] | 473 | gc.reflogexpire:: |
| 474 | `git reflog expire` removes reflog entries older than |
| 475 | this time; defaults to 90 days. |
| 476 | |
| 477 | gc.reflogexpireunreachable:: |
| 478 | `git reflog expire` removes reflog entries older than |
| 479 | this time and are not reachable from the current tip; |
| 480 | defaults to 30 days. |
| 481 | |
| 482 | gc.rerereresolved:: |
| 483 | Records of conflicted merge you resolved earlier are |
| 484 | kept for this many days when `git rerere gc` is run. |
| 485 | The default is 60 days. See gitlink:git-rerere[1]. |
| 486 | |
| 487 | gc.rerereunresolved:: |
| 488 | Records of conflicted merge you have not resolved are |
| 489 | kept for this many days when `git rerere gc` is run. |
| 490 | The default is 15 days. See gitlink:git-rerere[1]. |
| 491 | |
Junio C Hamano | 7a4a283 | 2007-07-07 21:53:22 | [diff] [blame] | 492 | rerere.enabled:: |
| 493 | Activate recording of resolved conflicts, so that identical |
| 494 | conflict hunks can be resolved automatically, should they |
| 495 | be encountered again. See gitlink:git-rerere[1]. |
| 496 | |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 497 | gitcvs.enabled:: |
Junio C Hamano | a638742 | 2007-08-25 03:54:27 | [diff] [blame] | 498 | Whether the CVS server interface is enabled for this repository. |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 499 | See gitlink:git-cvsserver[1]. |
| 500 | |
| 501 | gitcvs.logfile:: |
Junio C Hamano | a638742 | 2007-08-25 03:54:27 | [diff] [blame] | 502 | Path to a log file where the CVS server interface well... logs |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 503 | various stuff. See gitlink:git-cvsserver[1]. |
| 504 | |
Junio C Hamano | d9e0e5d | 2007-04-14 16:22:04 | [diff] [blame] | 505 | gitcvs.allbinary:: |
| 506 | If true, all files are sent to the client in mode '-kb'. This |
| 507 | causes the client to treat all files as binary files which suppresses |
| 508 | any newline munging it otherwise might do. A work-around for the |
| 509 | fact that there is no way yet to set single files to mode '-kb'. |
Junio C Hamano | a2ad99e | 2007-04-18 09:57:04 | [diff] [blame] | 510 | |
| 511 | gitcvs.dbname:: |
| 512 | Database used by git-cvsserver to cache revision information |
| 513 | derived from the git repository. The exact meaning depends on the |
| 514 | used database driver, for SQLite (which is the default driver) this |
| 515 | is a filename. Supports variable substitution (see |
| 516 | gitlink:git-cvsserver[1] for details). May not contain semicolons (`;`). |
| 517 | Default: '%Ggitcvs.%m.sqlite' |
| 518 | |
| 519 | gitcvs.dbdriver:: |
| 520 | Used Perl DBI driver. You can specify any available driver |
| 521 | for this here, but it might not work. git-cvsserver is tested |
| 522 | with 'DBD::SQLite', reported to work with 'DBD::Pg', and |
| 523 | reported *not* to work with 'DBD::mysql'. Experimental feature. |
| 524 | May not contain double colons (`:`). Default: 'SQLite'. |
Junio C Hamano | d9e0e5d | 2007-04-14 16:22:04 | [diff] [blame] | 525 | See gitlink:git-cvsserver[1]. |
| 526 | |
Junio C Hamano | a2ad99e | 2007-04-18 09:57:04 | [diff] [blame] | 527 | gitcvs.dbuser, gitcvs.dbpass:: |
| 528 | Database user and password. Only useful if setting 'gitcvs.dbdriver', |
| 529 | since SQLite has no concept of database users and/or passwords. |
| 530 | 'gitcvs.dbuser' supports variable substitution (see |
| 531 | gitlink:git-cvsserver[1] for details). |
| 532 | |
Junio C Hamano | a638742 | 2007-08-25 03:54:27 | [diff] [blame] | 533 | All gitcvs variables except for 'gitcvs.allbinary' can also be |
| 534 | specified as 'gitcvs.<access_method>.<varname>' (where 'access_method' |
| 535 | is one of "ext" and "pserver") to make them apply only for the given |
| 536 | access method. |
Junio C Hamano | a2ad99e | 2007-04-18 09:57:04 | [diff] [blame] | 537 | |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 538 | http.sslVerify:: |
| 539 | Whether to verify the SSL certificate when fetching or pushing |
Junio C Hamano | 33db437 | 2006-06-07 19:51:45 | [diff] [blame] | 540 | over HTTPS. Can be overridden by the 'GIT_SSL_NO_VERIFY' environment |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 541 | variable. |
| 542 | |
| 543 | http.sslCert:: |
| 544 | File containing the SSL certificate when fetching or pushing |
Junio C Hamano | 33db437 | 2006-06-07 19:51:45 | [diff] [blame] | 545 | over HTTPS. Can be overridden by the 'GIT_SSL_CERT' environment |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 546 | variable. |
| 547 | |
| 548 | http.sslKey:: |
| 549 | File containing the SSL private key when fetching or pushing |
Junio C Hamano | 341071d | 2006-06-04 07:24:48 | [diff] [blame] | 550 | over HTTPS. Can be overridden by the 'GIT_SSL_KEY' environment |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 551 | variable. |
| 552 | |
| 553 | http.sslCAInfo:: |
| 554 | File containing the certificates to verify the peer with when |
Junio C Hamano | 341071d | 2006-06-04 07:24:48 | [diff] [blame] | 555 | fetching or pushing over HTTPS. Can be overridden by the |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 556 | 'GIT_SSL_CAINFO' environment variable. |
| 557 | |
| 558 | http.sslCAPath:: |
| 559 | Path containing files with the CA certificates to verify the peer |
Junio C Hamano | 33db437 | 2006-06-07 19:51:45 | [diff] [blame] | 560 | with when fetching or pushing over HTTPS. Can be overridden |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 561 | by the 'GIT_SSL_CAPATH' environment variable. |
| 562 | |
| 563 | http.maxRequests:: |
Junio C Hamano | 341071d | 2006-06-04 07:24:48 | [diff] [blame] | 564 | How many HTTP requests to launch in parallel. Can be overridden |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 565 | by the 'GIT_HTTP_MAX_REQUESTS' environment variable. Default is 5. |
| 566 | |
| 567 | http.lowSpeedLimit, http.lowSpeedTime:: |
| 568 | If the HTTP transfer speed is less than 'http.lowSpeedLimit' |
| 569 | for longer than 'http.lowSpeedTime' seconds, the transfer is aborted. |
Junio C Hamano | 341071d | 2006-06-04 07:24:48 | [diff] [blame] | 570 | Can be overridden by the 'GIT_HTTP_LOW_SPEED_LIMIT' and |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 571 | 'GIT_HTTP_LOW_SPEED_TIME' environment variables. |
| 572 | |
Junio C Hamano | f1dcdfe | 2006-09-29 08:10:51 | [diff] [blame] | 573 | http.noEPSV:: |
| 574 | A boolean which disables using of EPSV ftp command by curl. |
Junio C Hamano | d9e0e5d | 2007-04-14 16:22:04 | [diff] [blame] | 575 | This can helpful with some "poor" ftp servers which don't |
Junio C Hamano | f1dcdfe | 2006-09-29 08:10:51 | [diff] [blame] | 576 | support EPSV mode. Can be overridden by the 'GIT_CURL_FTP_NO_EPSV' |
| 577 | environment variable. Default is false (curl will use EPSV). |
| 578 | |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 579 | i18n.commitEncoding:: |
| 580 | Character encoding the commit messages are stored in; git itself |
| 581 | does not care per se, but this information is necessary e.g. when |
| 582 | importing commits from emails or in the gitk graphical history |
| 583 | browser (and possibly at other places in the future or in other |
| 584 | porcelains). See e.g. gitlink:git-mailinfo[1]. Defaults to 'utf-8'. |
| 585 | |
Junio C Hamano | 51f92e2 | 2006-12-29 05:18:28 | [diff] [blame] | 586 | i18n.logOutputEncoding:: |
| 587 | Character encoding the commit messages are converted to when |
| 588 | running `git-log` and friends. |
| 589 | |
Junio C Hamano | fe9acab | 2006-11-24 12:10:55 | [diff] [blame] | 590 | log.showroot:: |
| 591 | If true, the initial commit will be shown as a big creation event. |
| 592 | This is equivalent to a diff against an empty tree. |
| 593 | Tools like gitlink:git-log[1] or gitlink:git-whatchanged[1], which |
| 594 | normally hide the root commit will now show it. True by default. |
| 595 | |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 596 | merge.summary:: |
| 597 | Whether to include summaries of merged commits in newly created |
| 598 | merge commit messages. False by default. |
| 599 | |
Junio C Hamano | 103ad7f | 2007-03-14 11:19:26 | [diff] [blame] | 600 | merge.tool:: |
| 601 | Controls which merge resolution program is used by |
Junio C Hamano | 1b50ce9 | 2007-10-03 12:05:53 | [diff] [blame] | 602 | gitlink:git-mergetool[1]. Valid values are: "kdiff3", "tkdiff", |
Junio C Hamano | f614c64 | 2007-06-11 01:21:54 | [diff] [blame] | 603 | "meld", "xxdiff", "emerge", "vimdiff", "gvimdiff", and "opendiff". |
Junio C Hamano | 103ad7f | 2007-03-14 11:19:26 | [diff] [blame] | 604 | |
Junio C Hamano | edd2b0a | 2007-01-15 06:12:45 | [diff] [blame] | 605 | merge.verbosity:: |
| 606 | Controls the amount of output shown by the recursive merge |
| 607 | strategy. Level 0 outputs nothing except a final error |
| 608 | message if conflicts were detected. Level 1 outputs only |
| 609 | conflicts, 2 outputs conflicts and file changes. Level 5 and |
| 610 | above outputs debugging information. The default is level 2. |
Junio C Hamano | 764a667 | 2007-10-23 01:23:31 | [diff] [blame] | 611 | Can be overridden by 'GIT_MERGE_VERBOSITY' environment variable. |
Junio C Hamano | edd2b0a | 2007-01-15 06:12:45 | [diff] [blame] | 612 | |
Junio C Hamano | e90436a | 2007-04-22 07:22:13 | [diff] [blame] | 613 | merge.<driver>.name:: |
| 614 | Defines a human readable name for a custom low-level |
| 615 | merge driver. See gitlink:gitattributes[5] for details. |
| 616 | |
| 617 | merge.<driver>.driver:: |
| 618 | Defines the command that implements a custom low-level |
| 619 | merge driver. See gitlink:gitattributes[5] for details. |
| 620 | |
| 621 | merge.<driver>.recursive:: |
| 622 | Names a low-level merge driver to be used when |
| 623 | performing an internal merge between common ancestors. |
| 624 | See gitlink:gitattributes[5] for details. |
| 625 | |
Junio C Hamano | 75cc4c9 | 2006-07-24 08:25:03 | [diff] [blame] | 626 | pack.window:: |
| 627 | The size of the window used by gitlink:git-pack-objects[1] when no |
| 628 | window size is given on the command line. Defaults to 10. |
| 629 | |
Junio C Hamano | 91d44c5 | 2007-05-09 07:16:07 | [diff] [blame] | 630 | pack.depth:: |
| 631 | The maximum delta depth used by gitlink:git-pack-objects[1] when no |
| 632 | maximum depth is given on the command line. Defaults to 50. |
| 633 | |
Junio C Hamano | 235d53f | 2007-07-13 00:25:15 | [diff] [blame] | 634 | pack.windowMemory:: |
| 635 | The window memory size limit used by gitlink:git-pack-objects[1] |
| 636 | when no limit is given on the command line. The value can be |
| 637 | suffixed with "k", "m", or "g". Defaults to 0, meaning no |
| 638 | limit. |
| 639 | |
Junio C Hamano | f2ce297 | 2007-05-20 19:12:09 | [diff] [blame] | 640 | pack.compression:: |
| 641 | An integer -1..9, indicating the compression level for objects |
| 642 | in a pack file. -1 is the zlib default. 0 means no |
| 643 | compression, and 1..9 are various speed/size tradeoffs, 9 being |
| 644 | slowest. If not set, defaults to core.compression. If that is |
| 645 | not set, defaults to -1. |
| 646 | |
Junio C Hamano | 679d22d | 2007-06-02 21:13:44 | [diff] [blame] | 647 | pack.deltaCacheSize:: |
Junio C Hamano | a638742 | 2007-08-25 03:54:27 | [diff] [blame] | 648 | The maximum memory in bytes used for caching deltas in |
Junio C Hamano | 679d22d | 2007-06-02 21:13:44 | [diff] [blame] | 649 | gitlink:git-pack-objects[1]. |
| 650 | A value of 0 means no limit. Defaults to 0. |
| 651 | |
| 652 | pack.deltaCacheLimit:: |
Junio C Hamano | 58155b4 | 2007-09-15 07:46:14 | [diff] [blame] | 653 | The maximum size of a delta, that is cached in |
Junio C Hamano | 679d22d | 2007-06-02 21:13:44 | [diff] [blame] | 654 | gitlink:git-pack-objects[1]. Defaults to 1000. |
| 655 | |
Junio C Hamano | 58155b4 | 2007-09-15 07:46:14 | [diff] [blame] | 656 | pack.threads:: |
| 657 | Specifies the number of threads to spawn when searching for best |
| 658 | delta matches. This requires that gitlink:git-pack-objects[1] |
| 659 | be compiled with pthreads otherwise this option is ignored with a |
| 660 | warning. This is meant to reduce packing time on multiprocessor |
| 661 | machines. The required amount of memory for the delta search window |
| 662 | is however multiplied by the number of threads. |
| 663 | |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 664 | pull.octopus:: |
| 665 | The default merge strategy to use when pulling multiple branches |
| 666 | at once. |
| 667 | |
| 668 | pull.twohead:: |
| 669 | The default merge strategy to use when pulling a single branch. |
| 670 | |
Junio C Hamano | 249572f | 2006-10-24 05:44:08 | [diff] [blame] | 671 | remote.<name>.url:: |
| 672 | The URL of a remote repository. See gitlink:git-fetch[1] or |
| 673 | gitlink:git-push[1]. |
| 674 | |
| 675 | remote.<name>.fetch:: |
| 676 | The default set of "refspec" for gitlink:git-fetch[1]. See |
| 677 | gitlink:git-fetch[1]. |
| 678 | |
| 679 | remote.<name>.push:: |
| 680 | The default set of "refspec" for gitlink:git-push[1]. See |
| 681 | gitlink:git-push[1]. |
| 682 | |
Junio C Hamano | 118d277 | 2007-02-21 20:24:10 | [diff] [blame] | 683 | remote.<name>.skipDefaultUpdate:: |
| 684 | If true, this remote will be skipped by default when updating |
| 685 | using the remote subcommand of gitlink:git-remote[1]. |
| 686 | |
Junio C Hamano | 4ad294b | 2007-01-20 02:22:50 | [diff] [blame] | 687 | remote.<name>.receivepack:: |
Junio C Hamano | 54ea8d3 | 2007-01-25 07:59:48 | [diff] [blame] | 688 | The default program to execute on the remote side when pushing. See |
Junio C Hamano | 4ad294b | 2007-01-20 02:22:50 | [diff] [blame] | 689 | option \--exec of gitlink:git-push[1]. |
| 690 | |
Junio C Hamano | 54ea8d3 | 2007-01-25 07:59:48 | [diff] [blame] | 691 | remote.<name>.uploadpack:: |
| 692 | The default program to execute on the remote side when fetching. See |
| 693 | option \--exec of gitlink:git-fetch-pack[1]. |
| 694 | |
Junio C Hamano | 17dde0e | 2007-02-26 09:50:21 | [diff] [blame] | 695 | remote.<name>.tagopt:: |
| 696 | Setting this value to --no-tags disables automatic tag following when fetching |
| 697 | from remote <name> |
| 698 | |
Junio C Hamano | 118d277 | 2007-02-21 20:24:10 | [diff] [blame] | 699 | remotes.<group>:: |
| 700 | The list of remotes which are fetched by "git remote update |
| 701 | <group>". See gitlink:git-remote[1]. |
| 702 | |
Junio C Hamano | 77b7e90 | 2006-10-23 07:18:50 | [diff] [blame] | 703 | repack.usedeltabaseoffset:: |
| 704 | Allow gitlink:git-repack[1] to create packs that uses |
| 705 | delta-base offset. Defaults to false. |
| 706 | |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 707 | show.difftree:: |
| 708 | The default gitlink:git-diff-tree[1] arguments to be used |
| 709 | for gitlink:git-show[1]. |
| 710 | |
| 711 | showbranch.default:: |
| 712 | The default set of branches for gitlink:git-show-branch[1]. |
| 713 | See gitlink:git-show-branch[1]. |
| 714 | |
Junio C Hamano | 75cc4c9 | 2006-07-24 08:25:03 | [diff] [blame] | 715 | tar.umask:: |
Junio C Hamano | bdebabb | 2007-08-23 00:25:09 | [diff] [blame] | 716 | This variable can be used to restrict the permission bits of |
| 717 | tar archive entries. The default is 0002, which turns off the |
| 718 | world write bit. The special value "user" indicates that the |
| 719 | archiving user's umask will be used instead. See umask(2) and |
| 720 | gitlink:git-archive[1]. |
Junio C Hamano | 75cc4c9 | 2006-07-24 08:25:03 | [diff] [blame] | 721 | |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 722 | user.email:: |
| 723 | Your email address to be recorded in any newly created commits. |
Junio C Hamano | 469d60e | 2007-04-29 18:30:34 | [diff] [blame] | 724 | Can be overridden by the 'GIT_AUTHOR_EMAIL', 'GIT_COMMITTER_EMAIL', and |
| 725 | 'EMAIL' environment variables. See gitlink:git-commit-tree[1]. |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 726 | |
| 727 | user.name:: |
| 728 | Your full name to be recorded in any newly created commits. |
Junio C Hamano | 341071d | 2006-06-04 07:24:48 | [diff] [blame] | 729 | Can be overridden by the 'GIT_AUTHOR_NAME' and 'GIT_COMMITTER_NAME' |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 730 | environment variables. See gitlink:git-commit-tree[1]. |
| 731 | |
Junio C Hamano | a890c4f | 2007-01-28 10:29:21 | [diff] [blame] | 732 | user.signingkey:: |
| 733 | If gitlink:git-tag[1] is not selecting the key you want it to |
| 734 | automatically when creating a signed tag, you can override the |
| 735 | default selection with this variable. This option is passed |
| 736 | unchanged to gpg's --local-user parameter, so you may specify a key |
| 737 | using any method that gpg supports. |
| 738 | |
Junio C Hamano | 07824ce | 2006-04-25 07:36:54 | [diff] [blame] | 739 | whatchanged.difftree:: |
| 740 | The default gitlink:git-diff-tree[1] arguments to be used |
| 741 | for gitlink:git-whatchanged[1]. |
| 742 | |
| 743 | imap:: |
| 744 | The configuration variables in the 'imap' section are described |
| 745 | in gitlink:git-imap-send[1]. |
Junio C Hamano | 459ee22 | 2006-09-21 08:13:28 | [diff] [blame] | 746 | |
Junio C Hamano | 0d3c815 | 2006-11-08 01:33:41 | [diff] [blame] | 747 | receive.unpackLimit:: |
| 748 | If the number of objects received in a push is below this |
| 749 | limit then the objects will be unpacked into loose object |
| 750 | files. However if the number of received objects equals or |
| 751 | exceeds this limit then the received pack will be stored as |
| 752 | a pack, after adding any missing delta bases. Storing the |
| 753 | pack from a push can make the push operation complete faster, |
| 754 | especially on slow filesystems. |
| 755 | |
| 756 | receive.denyNonFastForwards:: |
Junio C Hamano | 459ee22 | 2006-09-21 08:13:28 | [diff] [blame] | 757 | If set to true, git-receive-pack will deny a ref update which is |
| 758 | not a fast forward. Use this to prevent such an update via a push, |
| 759 | even if that push is forced. This configuration variable is |
| 760 | set when initializing a shared repository. |
| 761 | |
Junio C Hamano | 54ea8d3 | 2007-01-25 07:59:48 | [diff] [blame] | 762 | transfer.unpackLimit:: |
| 763 | When `fetch.unpackLimit` or `receive.unpackLimit` are |
| 764 | not set, the value of this variable is used instead. |