doc: format config values with backticks
PATCH 1/1 doc: format config values with backticks
From: mdferdousalam <[email protected]>
Add backtick formatting to bare true/false values in configuration documentation so they render in monospace as config literals, matching the style used throughout most of the existing documentation.
---
doc: format config values with backticks
Add backtick formatting to bare true/false values in configuration documentation so they render in monospace as config literals, matching the style used throughout most of the existing documentation.
Files updated:
* am.adoc, blame.adoc, clean.adoc, commitgraph.adoc
* credential.adoc, fmt-merge-msg.adoc, format.adoc
* grep.adoc, rebase.adoc, rerere.adoc, stash.adoc, status.adoc
This addresses https://github.com/gitgitgadget/git/issues/244
Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-2055%2Fmdferdousalam%2Ffix-config-doc-formatting-v1
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-2055/mdferdousalam/fix-config-doc-formatting-v1
Pull-Request: https://github.com/gitgitgadget/git/pull/2055
Documentation/config/am.adoc | 4 ++-- Documentation/config/blame.adoc | 2 +- Documentation/config/clean.adoc | 2 +- Documentation/config/commitgraph.adoc | 8 ++++---- Documentation/config/credential.adoc | 2 +- Documentation/config/fmt-merge-msg.adoc | 6 +++--- Documentation/config/format.adoc | 22 +++++++++++----------- Documentation/config/grep.adoc | 12 ++++++------ Documentation/config/rebase.adoc | 18 +++++++++--------- Documentation/config/rerere.adoc | 4 ++-- Documentation/config/stash.adoc | 16 ++++++++-------- Documentation/config/status.adoc | 20 ++++++++++---------- 12 files changed, 58 insertions(+), 58 deletions(-)
Documentation/config/am.adoc +2 -2
@@ -1,5 +1,5 @@ am.keepcr:: - If true, git-am will call git-mailsplit for patches in mbox format + If `true`, git-am will call git-mailsplit for patches in mbox format with parameter `--keep-cr`. In this case git-mailsplit will not remove `\r` from lines ending with `\r\n`. Can be overridden by giving `--no-keep-cr` from the command line.
@@ -7,7 +7,7 @@ am.keepcr:: am.threeWay:: By default, `git am` will fail if the patch does not apply cleanly. When - set to true, this setting tells `git am` to fall back on 3-way merge if + set to `true`, this setting tells `git am` to fall back on 3-way merge if the patch records the identity of blobs it is supposed to apply to and we have those blobs available locally (equivalent to giving the `--3way` option from the command line). Defaults to `false`.
Documentation/config/blame.adoc +1 -1
@@ -1,6 +1,6 @@ blame.blankBoundary:: Show blank commit object name for boundary commits in - linkgit:git-blame[1]. This option defaults to false. + linkgit:git-blame[1]. This option defaults to `false`. blame.coloring:: This determines the coloring scheme to be applied to blame
Documentation/config/clean.adoc +1 -1
@@ -1,3 +1,3 @@ clean.requireForce:: A boolean to make git-clean refuse to delete files unless -f - is given. Defaults to true. + is given. Defaults to `true`.
Documentation/config/commitgraph.adoc +4 -4
@@ -9,9 +9,9 @@ commitGraph.maxNewFilters:: commit-graph write` (c.f., linkgit:git-commit-graph[1]). commitGraph.changedPaths:: - If true, then `git commit-graph write` will compute and write + If `true`, then `git commit-graph write` will compute and write changed-path Bloom filters by default, equivalent to passing - `--changed-paths`. If false or unset, changed-paths Bloom filters will + `--changed-paths`. If `false` or unset, changed-paths Bloom filters will be written during `git commit-graph write` only if the filters already exist in the current commit-graph file. This matches the default behavior of `git commit-graph write` without any `--[no-]changed-paths`
@@ -20,8 +20,8 @@ commitGraph.changedPaths:: always takes precedence over this configuration. Defaults to unset. commitGraph.readChangedPaths:: - Deprecated. Equivalent to commitGraph.changedPathsVersion=-1 if true, and - commitGraph.changedPathsVersion=0 if false. (If commitGraph.changedPathVersion + Deprecated. Equivalent to commitGraph.changedPathsVersion=-1 if `true`, and + commitGraph.changedPathsVersion=0 if `false`. (If commitGraph.changedPathVersion is also set, commitGraph.changedPathsVersion takes precedence.) commitGraph.changedPathsVersion::
Documentation/config/credential.adoc +1 -1
@@ -19,7 +19,7 @@ credential.interactive:: credential.useHttpPath:: When acquiring credentials, consider the "path" component of an http - or https URL to be important. Defaults to false. See + or https URL to be important. Defaults to `false`. See linkgit:gitcredentials[7] for more information. credential.sanitizePrompt::
Documentation/config/fmt-merge-msg.adoc +3 -3
@@ -1,13 +1,13 @@ `merge.branchdesc`:: In addition to branch names, populate the log message with the branch description text associated with them. Defaults - to false. + to `false`. `merge.log`:: In addition to branch names, populate the log message with at most the specified number of one-line descriptions from the - actual commits that are being merged. Defaults to false, and - true is a synonym for 20. + actual commits that are being merged. Defaults to `false`, and + `true` is a synonym for 20. `merge.suppressDest`:: By adding a glob that matches the names of integration
Documentation/config/format.adoc +11 -11
@@ -8,23 +8,23 @@ format.attach:: format.from:: Provides the default value for the `--from` option to format-patch. - Accepts a boolean value, or a name and email address. If false, + Accepts a boolean value, or a name and email address. If `false`, format-patch defaults to `--no-from`, using commit authors directly in - the "From:" field of patch mails. If true, format-patch defaults to + the "From:" field of patch mails. If `true`, format-patch defaults to `--from`, using your committer identity in the "From:" field of patch mails and including a "From:" field in the body of the patch mail if different. If set to a non-boolean value, format-patch uses that - value instead of your committer identity. Defaults to false. + value instead of your committer identity. Defaults to `false`. format.forceInBodyFrom:: Provides the default value for the `--[no-]force-in-body-from` - option to format-patch. Defaults to false. + option to format-patch. Defaults to `false`. format.numbered:: A boolean which can enable or disable sequence numbers in patch subjects. It defaults to "auto" which enables it only if there is more than one patch. It can be enabled or disabled for all - messages by setting it to "true" or "false". See --numbered + messages by setting it to `true` or `false`. See --numbered option in linkgit:git-format-patch[1]. format.headers::
@@ -65,7 +65,7 @@ format.suffix:: format.encodeEmailHeaders:: Encode email headers that have non-ASCII characters with "Q-encoding" (described in RFC 2047) for email transmission. - Defaults to true. + Defaults to `true`. format.pretty:: ifndef::with-breaking-changes[]
@@ -85,7 +85,7 @@ format.thread:: where the head is chosen from the cover letter, the `--in-reply-to`, and the first patch mail, in this order. `deep` threading makes every mail a reply to the previous one. - A true boolean value is the same as `shallow`, and a false + A `true` boolean value is the same as `shallow`, and a `false` value disables threading. format.signOff::
@@ -99,7 +99,7 @@ format.coverLetter:: A boolean that controls whether to generate a cover-letter when format-patch is invoked, but in addition can be set to "auto", to generate a cover-letter only when there's more than one patch. - Default is false. + Default is `false`. format.outputDirectory:: Set a custom directory to store the resulting files instead of the
@@ -119,11 +119,11 @@ format.useAutoBase:: format.notes:: Provides the default value for the `--notes` option to format-patch. Accepts a boolean value, or a ref which specifies - where to get notes. If false, format-patch defaults to - `--no-notes`. If true, format-patch defaults to `--notes`. If + where to get notes. If `false`, format-patch defaults to + `--no-notes`. If `true`, format-patch defaults to `--notes`. If set to a non-boolean value, format-patch defaults to `--notes=<ref>`, where `ref` is the non-boolean value. Defaults - to false. + to `false`. + If one wishes to use the ref `refs/notes/true`, please use that literal instead.
Documentation/config/grep.adoc +6 -6
@@ -1,8 +1,8 @@ grep.lineNumber:: - If set to true, enable `-n` option by default. + If set to `true`, enable `-n` option by default. grep.column:: - If set to true, enable the `--column` option by default. + If set to `true`, enable the `--column` option by default. grep.patternType:: Set the default matching behavior. Using a value of 'basic', 'extended',
@@ -12,7 +12,7 @@ grep.patternType:: between 'basic' and 'extended'. grep.extendedRegexp:: - If set to true, enable `--extended-regexp` option by default. This + If set to `true`, enable `--extended-regexp` option by default. This option is ignored when the `grep.patternType` option is set to a value other than 'default'.
@@ -21,8 +21,8 @@ grep.threads:: use as many threads as the number of logical cores available. grep.fullName:: - If set to true, enable `--full-name` option by default. + If set to `true`, enable `--full-name` option by default. grep.fallbackToNoIndex:: - If set to true, fall back to `git grep --no-index` if `git grep` - is executed outside of a git repository. Defaults to false. + If set to `true`, fall back to `git grep --no-index` if `git grep` + is executed outside of a git repository. Defaults to `false`.
Documentation/config/rebase.adoc +9 -9
@@ -9,22 +9,22 @@ rebase.stat:: rebase. False by default. rebase.autoSquash:: - If set to true, enable the `--autosquash` option of + If set to `true`, enable the `--autosquash` option of linkgit:git-rebase[1] by default for interactive mode. This can be overridden with the `--no-autosquash` option. rebase.autoStash:: - When set to true, automatically create a temporary stash entry + When set to `true`, automatically create a temporary stash entry before the operation begins, and apply it after the operation ends. This means that you can run rebase on a dirty worktree. However, use with care: the final stash application after a successful rebase might result in non-trivial conflicts. This option can be overridden by the `--no-autostash` and `--autostash` options of linkgit:git-rebase[1]. - Defaults to false. + Defaults to `false`. rebase.updateRefs:: - If set to true enable `--update-refs` option by default. + If set to `true` enable `--update-refs` option by default. rebase.missingCommitsCheck:: If set to "warn", git rebase -i will print a warning if some
@@ -43,7 +43,7 @@ rebase.instructionFormat:: automatically have the commit hash prepended to the format. rebase.abbreviateCommands:: - If set to true, `git rebase` will use abbreviated command names in the + If set to `true`, `git rebase` will use abbreviated command names in the todo list resulting in something like this: + -------------------------------------------
@@ -60,7 +60,7 @@ instead of: ... ------------------------------------------- + -Defaults to false. +Defaults to `false`. rebase.rescheduleFailedExec:: Automatically reschedule `exec` commands that failed. This only makes
@@ -68,14 +68,14 @@ rebase.rescheduleFailedExec:: This is the same as specifying the `--reschedule-failed-exec` option. rebase.forkPoint:: - If set to false set `--no-fork-point` option by default. + If set to `false` set `--no-fork-point` option by default. rebase.rebaseMerges:: Whether and how to set the `--rebase-merges` option by default. Can be `rebase-cousins`, `no-rebase-cousins`, or a boolean. Setting to - true or to `no-rebase-cousins` is equivalent to + `true` or to `no-rebase-cousins` is equivalent to `--rebase-merges=no-rebase-cousins`, setting to `rebase-cousins` is - equivalent to `--rebase-merges=rebase-cousins`, and setting to false is + equivalent to `--rebase-merges=rebase-cousins`, and setting to `false` is equivalent to `--no-rebase-merges`. Passing `--rebase-merges` on the command line, with or without an argument, overrides any `rebase.rebaseMerges` configuration.
Documentation/config/rerere.adoc +2 -2
@@ -1,7 +1,7 @@ rerere.autoUpdate:: - When set to true, `git-rerere` updates the index with the + When set to `true`, `git-rerere` updates the index with the resulting contents after it cleanly resolves conflicts using - previously recorded resolutions. Defaults to false. + previously recorded resolutions. Defaults to `false`. rerere.enabled:: Activate recording of resolved conflicts, so that identical
Documentation/config/stash.adoc +8 -8
@@ -7,8 +7,8 @@ ifdef::git-stash[] endif::git-stash[] `stash.index`:: - If this is set to true, `git stash apply` and `git stash pop` will - behave as if `--index` was supplied. Defaults to false. + If this is set to `true`, `git stash apply` and `git stash pop` will + behave as if `--index` was supplied. Defaults to `false`. ifndef::git-stash[] See the descriptions in linkgit:git-stash[1]. +
@@ -18,15 +18,15 @@ linkgit:git-pull[1]. endif::git-stash[] `stash.showIncludeUntracked`:: - If this is set to true, the `git stash show` command will show - the untracked files of a stash entry. Defaults to false. {see-show} + If this is set to `true`, the `git stash show` command will show + the untracked files of a stash entry. Defaults to `false`. {see-show} `stash.showPatch`:: - If this is set to true, the `git stash show` command without an - option will show the stash entry in patch form. Defaults to false. + If this is set to `true`, the `git stash show` command without an + option will show the stash entry in patch form. Defaults to `false`. {see-show} `stash.showStat`:: - If this is set to true, the `git stash show` command without an - option will show a diffstat of the stash entry. Defaults to true. + If this is set to `true`, the `git stash show` command without an + option will show a diffstat of the stash entry. Defaults to `true`. {see-show}
Documentation/config/status.adoc +10 -10
@@ -5,24 +5,24 @@ status.relativePaths:: prior to v1.5.4). status.short:: - Set to true to enable --short by default in linkgit:git-status[1]. + Set to `true` to enable --short by default in linkgit:git-status[1]. The option --no-short takes precedence over this variable. status.branch:: - Set to true to enable --branch by default in linkgit:git-status[1]. + Set to `true` to enable --branch by default in linkgit:git-status[1]. The option --no-branch takes precedence over this variable. status.aheadBehind:: - Set to true to enable `--ahead-behind` and false to enable + Set to `true` to enable `--ahead-behind` and `false` to enable `--no-ahead-behind` by default in linkgit:git-status[1] for - non-porcelain status formats. Defaults to true. + non-porcelain status formats. Defaults to `true`. status.displayCommentPrefix:: - If set to true, linkgit:git-status[1] will insert a comment + If set to `true`, linkgit:git-status[1] will insert a comment prefix before each output line (starting with `core.commentChar`, i.e. `#` by default). This was the behavior of linkgit:git-status[1] in Git 1.8.4 and previous. - Defaults to false. + Defaults to `false`. status.renameLimit:: The number of files to consider when performing rename detection
@@ -37,9 +37,9 @@ status.renames:: Defaults to the value of diff.renames. status.showStash:: - If set to true, linkgit:git-status[1] will display the number of + If set to `true`, linkgit:git-status[1] will display the number of entries currently stashed away. - Defaults to false. + Defaults to `false`. status.showUntrackedFiles:: By default, linkgit:git-status[1] and linkgit:git-commit[1] show
@@ -63,8 +63,8 @@ This variable can be overridden with the -u|--untracked-files option of linkgit:git-status[1] and linkgit:git-commit[1]. status.submoduleSummary:: - Defaults to false. - If this is set to a non-zero number or true (identical to -1 or an + Defaults to `false`. + If this is set to a non-zero number or `true` (identical to -1 or an unlimited number), the submodule summary will be enabled and a summary of commits for modified submodules will be shown (see --summary-limit option of linkgit:git-submodule[1]). Please note
base-commit: 7c02d39fc2ed2702223c7674f73150d9a7e61ba4
Signature · 1 line
gitgitgadget
PATCH v2 1/1 doc: format config values with backticks
From: mdferdousalam <[email protected]>
Wrap bare true/false config values in backticks throughout the Documentation/config/*.adoc files, following the convention used by most of the documentation. This ensures consistent formatting of boolean configuration values.
---
doc: format config values with backticks
Add backtick formatting to bare true/false values in configuration documentation so they render in monospace as config literals, matching the style used throughout most of the existing documentation.
Files updated:
* am.adoc, blame.adoc, branch.adoc, clean.adoc, color.adoc
* commitgraph.adoc, core.adoc, credential.adoc, fetch.adoc
* fmt-merge-msg.adoc, format.adoc, gc.adoc, gitcvs.adoc
* grep.adoc, gui.adoc, http.adoc, instaweb.adoc, interactive.adoc
* log.adoc, mailinfo.adoc, maintenance.adoc, merge.adoc
* mergetool.adoc, pack.adoc, pull.adoc, push.adoc, rebase.adoc
* receive.adoc, remote.adoc, repack.adoc, rerere.adoc, revert.adoc
* stash.adoc, status.adoc, submodule.adoc, trace2.adoc
* transfer.adoc, uploadarchive.adoc, worktree.adoc
This addresses https://github.com/gitgitgadget/git/issues/244
Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-2055%2Fmdferdousalam%2Ffix-config-doc-formatting-v2
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-2055/mdferdousalam/fix-config-doc-formatting-v2
Pull-Request: https://github.com/gitgitgadget/git/pull/2055
Range-diff vs v1:
1: 631b9abe41 ! 1: 3a1ca6e5d9 doc: format config values with backticks
@@ Metadata
## Commit message ##
doc: format config values with backticks
- Add backtick formatting to bare true/false values in configuration
- documentation so they render in monospace as config literals, matching
- the style used throughout most of the existing documentation.
+ Wrap bare true/false config values in backticks throughout the
+ Documentation/config/*.adoc files, following the convention used
+ by most of the documentation. This ensures consistent formatting
+ of boolean configuration values.
- Signed-off-by: Md Ferdous Alam <[email protected]>
+ Signed-off-by: Md Ferdous Alam <[email protected]>
## Documentation/config/am.adoc ##
@@
@@ Documentation/config/blame.adoc
blame.coloring::
This determines the coloring scheme to be applied to blame
+@@ Documentation/config/blame.adoc: blame.date::
+
+ blame.showEmail::
+ Show the author email instead of author name in linkgit:git-blame[1].
+- This option defaults to false.
++ This option defaults to false.
+
+ blame.showRoot::
+ Do not treat root commits as boundaries in linkgit:git-blame[1].
+- This option defaults to false.
++ This option defaults to false.
+
+ blame.ignoreRevsFile::
+ Ignore revisions listed in the file, one unabbreviated object name per
+
+ ## Documentation/config/branch.adoc ##
+@@
+ that tracks another branch, this variable tells Git to set
+ up pull to rebase instead of merge (see branch.<name>.rebase).
+ The valid settings are:
+-never;; rebase is never automatically set to true.
+-local;; rebase is set to true for tracked branches of other local branches. +-remote;; rebase is set to true for tracked branches of remote-tracking branches. +-always;; rebase will be set to true for all tracking branches. ++never;; rebase is never automatically set to true.
++local;; rebase is set to true for tracked branches of other local branches. ++remote;; rebase is set to true for tracked branches of remote-tracking branches. ++always;; rebase will be set to true for all tracking branches.
+
+ +
+ See branch.autoSetupMerge for details on how to set up a branch to track another branch. +@@ Documentation/config/branch.adoc: This option defaults to never.
+ supported.
+
+ branch.<name>.rebase::
+- When true, rebase the branch _<name>_ on top of the fetched branch,
++ When true, rebase the branch _<name>_ on top of the fetched branch,
+ instead of merging the default branch from the default remote when
+ git pull is run. See pull.rebase for doing this in a non
+ branch-specific manner.
## Documentation/config/clean.adoc ##
@@
@@ Documentation/config/clean.adoc
- is given. Defaults to true.
+ is given. Defaults to true.
+ ## Documentation/config/color.adoc ##
+@@ Documentation/config/color.adoc: color.interactive.<slot>::
+
+ color.pager::
+ A boolean to specify whether auto color modes should colorize
+- output going to the pager. Defaults to true; set this to false
++ output going to the pager. Defaults to true; set this to false
+ if your pager does not understand ANSI color codes.
+
+ color.push::
+
## Documentation/config/commitgraph.adoc ##
@@ Documentation/config/commitgraph.adoc: commitGraph.maxNewFilters::
commit-graph write` (c.f., linkgit:git-commit-graph[1]).
@@ Documentation/config/commitgraph.adoc: commitGraph.changedPaths::
commitGraph.changedPathsVersion::
+ ## Documentation/config/core.adoc ##
+@@ Documentation/config/core.adoc: Git for Windows or Eclipse).
+ In such a case it may be necessary to set this variable to 'false'.
+ See linkgit:git-update-index[1].
+ +
+-The default is true (when core.filemode is not specified in the config file).
++The default is true (when core.filemode is not specified in the config file).
+
+ core.hideDotFiles::
+- (Windows-only) If true, mark newly-created directories and files whose
++ (Windows-only) If true, mark newly-created directories and files whose
+ name starts with a dot as hidden. If 'dotGitOnly', only the .git/
+ directory is hidden, but no other files starting with a dot. The
+ default mode is 'dotGitOnly'.
+@@ Documentation/config/core.adoc: core.ignoreCase::
+ it is really the same file, and continue to remember it as
+ "Makefile".
+ +
+-The default is false, except linkgit:git-clone[1] or linkgit:git-init[1]
+-will probe and set core.ignoreCase true if appropriate when the repository
++The default is false, except linkgit:git-clone[1] or linkgit:git-init[1]
++will probe and set core.ignoreCase true if appropriate when the repository
+ is created.
+ +
+ Git relies on the proper configuration of this variable for your operating
+@@ Documentation/config/core.adoc: and file system. Modifying this value may result in unexpected behavior. +
+ core.precomposeUnicode::
+ This option is only used by Mac OS implementation of Git.
+- When core.precomposeUnicode=true, Git reverts the unicode decomposition
++ When core.precomposeUnicode=true, Git reverts the unicode decomposition
+ of filenames done by Mac OS. This is useful when sharing a repository
+ between Mac OS and Linux or Windows.
+ (Git for Windows 1.7.10 or higher is needed, or Git under cygwin 1.7).
+- When false, file names are handled fully transparent by Git,
++ When false, file names are handled fully transparent by Git,
+ which is backward compatible with older versions of Git.
+
+ core.protectHFS::
+- If set to true, do not allow checkout of paths that would
++ If set to true, do not allow checkout of paths that would
+ be considered equivalent to .git on an HFS+ filesystem.
+ Defaults to true on Mac OS, and false elsewhere.
+
+ core.protectNTFS::
+- If set to true, do not allow checkout of paths that would
++ If set to true, do not allow checkout of paths that would
+ cause problems with the NTFS filesystem, e.g. conflict with
+ 8.3 "short" names.
+ Defaults to true on Windows, and false elsewhere.
+
+ core.fsmonitor::
+- If set to true, enable the built-in file system monitor
++ If set to true, enable the built-in file system monitor
+ daemon for this working directory (linkgit:git-fsmonitor{litdd}daemon[1]).
+ +
+ Like hook-based file system monitors, the built-in file system monitor
+@@ Documentation/config/core.adoc: something that can be used to determine what files have changed
+ without race conditions.
+
+ core.trustctime::
+- If false, the ctime differences between the index and the
++ If false, the ctime differences between the index and the
+ working tree are ignored; useful when the inode change time
+ is regularly modified by something outside Git (file system
+ crawlers and some backup systems).
+- See linkgit:git-update-index[1]. True by default.
++ See linkgit:git-update-index[1]. True by default.
+
+ core.splitIndex::
+- If true, the split-index feature of the index will be used.
+- See linkgit:git-update-index[1]. False by default.
++ If true, the split-index feature of the index will be used.
++ See linkgit:git-update-index[1]. False by default.
+
+ core.untrackedCache::
+ Determines what to do about the untracked cache feature of the
+@@ Documentation/config/core.adoc: core.quotePath::
+ backslashes in the same way C escapes control characters (e.g.
+ \t for TAB, \n for LF, \\ for backslash) or bytes with
+ values larger than 0x80 (e.g. octal \302\265 for "micro" in
+- UTF-8). If this variable is set to false, bytes higher than
++ UTF-8). If this variable is set to false, bytes higher than
+ 0x80 are not considered "unusual" any more. Double-quotes,
+ backslash and control characters are always escaped regardless
+ of the setting of this variable. A simple space character is
+ not considered "unusual". Many commands can output pathnames
+ completely verbatim using the -z option. The default value
+- is true.
++ is true.
+
+ core.eol::
+ Sets the line ending type to use in the working directory for
+@@ Documentation/config/core.adoc: core.eol::
+ is set to true or input.
+
+ core.safecrlf::
+- If true, makes Git check if converting CRLF is reversible when
++ If true, makes Git check if converting CRLF is reversible when
+ end-of-line conversion is active. Git will verify if a command
+ modifies a file in the work tree either directly or indirectly.
+ For example, committing a file followed by checking out the
+@@ Documentation/config/core.adoc: mechanism.
+ core.autocrlf::
+ Setting this variable to "true" is the same as setting
+ the text attribute to "auto" on all files and core.eol to "crlf".
+- Set to true if you want to have CRLF line endings in your
++ Set to true if you want to have CRLF line endings in your
+ working directory and the repository has LF line endings.
+ This variable can be set to 'input',
+ in which case no output conversion is performed.
+@@ Documentation/config/core.adoc: core.checkRoundtripEncoding::
+ The default value is SHIFT-JIS.
+
+ core.symlinks::
+- If false, symbolic links are checked out as small plain files that
++ If false, symbolic links are checked out as small plain files that
+ contain the link text. linkgit:git-update-index[1] and
+ linkgit:git-add[1] will not change the recorded type to regular
+ file. Useful on filesystems like FAT that do not support
+ symbolic links.
+ +
+-The default is true, except linkgit:git-clone[1] or linkgit:git-init[1]
+-will probe and set core.symlinks false if appropriate when the repository
++The default is true, except linkgit:git-clone[1] or linkgit:git-init[1]
++will probe and set core.symlinks false if appropriate when the repository
+ is created.
+
+ core.gitProxy::
+@@ Documentation/config/core.adoc: core.sshCommand::
+ when the environment variable is set.
+
+ core.ignoreStat::
+- If true, Git will avoid using lstat() calls to detect if files have
++ If true, Git will avoid using lstat() calls to detect if files have
+ changed by setting the "assume-unchanged" bit for those tracked files
+ which it has updated identically in both the index and working tree.
+ +
+@@ Documentation/config/core.adoc: Git will not normally detect changes to those files.
+ This is useful on systems where lstat() calls are very slow, such as
+ CIFS/Microsoft Windows.
+ +
+-False by default.
++False by default.
+
+ core.preferSymlinkRefs::
+ Instead of the default "symref" format for HEAD
+@@ Documentation/config/core.adoc: core.alternateRefsPrefixes::
+ core.alternateRefsPrefixes has no effect.
+
+ core.bare::
+- If true this repository is assumed to be 'bare' and has no
++ If true this repository is assumed to be 'bare' and has no
+ working directory associated with it. If this is the case a
+ number of commands that require a working directory will be
+ disabled, such as linkgit:git-add[1] or linkgit:git-merge[1].
+@@ Documentation/config/core.adoc: core.bare::
+ This setting is automatically guessed by linkgit:git-clone[1] or
+ linkgit:git-init[1] when the repository was created. By default a
+ repository that ends in "/.git" is assumed to be not bare (bare =
+-false), while all other repositories are assumed to be bare (bare
+-= true).
++false), while all other repositories are assumed to be bare (bare
++= true).
+
+ core.worktree::
+ Set the path to the root of the working tree.
+@@ Documentation/config/core.adoc: read-only snapshot of the same index to a location different from the
+ repository's usual working tree).
+
+ core.lockfilePid::
+- If true, Git will create a PID file alongside lock files. When a
++ If true, Git will create a PID file alongside lock files. When a
+ lock acquisition fails and a PID file exists, Git can provide
+ additional diagnostic information about the process holding the
+ lock, including whether it is still running. Defaults to false.
+@@ Documentation/config/core.adoc: core.logAllRefUpdates::
+ This information can be used to determine what commit
+ was the tip of a branch "2 days ago".
+ +
+-This value is true by default in a repository that has
+-a working directory associated with it, and false by
++This value is true by default in a repository that has
++a working directory associated with it, and false by
+ default in a bare repository.
+
+ core.repositoryFormatVersion::
+@@ Documentation/config/core.adoc: core.sharedRepository::
+ the repo read/write-able for the owner and group, but inaccessible to
+ others (equivalent to 'group' unless umask is e.g. '0022'). '0640' is a
+ repository that is group-readable but not group-writable.
+- See linkgit:git-init[1]. False by default.
++ See linkgit:git-init[1]. False by default.
+
+ core.warnAmbiguousRefs::
+- If true, Git will warn you if the ref name you passed it is ambiguous
+- and might match multiple refs in the repository. True by default.
++ If true, Git will warn you if the ref name you passed it is ambiguous
++ and might match multiple refs in the repository. True by default.
+
+ core.compression::
+ An integer -1..9, indicating a default compression level.
+@@ Documentation/config/core.adoc: core.fsyncObjectFiles::
+ This setting is deprecated. Use core.fsync instead.
+ +
+ This setting affects data added to the Git repository in loose-object
+-form. When set to true, Git will issue an fsync or similar system call
++form. When set to true, Git will issue an fsync or similar system call
+ to flush caches so that loose-objects remain consistent in the face
+ of a unclean system shutdown.
+
+@@ Documentation/config/core.adoc: This can speed up operations like 'git diff' and 'git status' especially
+ on filesystems like NFS that have weak caching semantics and thus
+ relatively high IO latencies. When enabled, Git will do the
+ index comparison to the filesystem data in parallel, allowing
+-overlapping IO's. Defaults to true.
++overlapping IO's. Defaults to true.
+
+ core.unsetenvvars::
+ Windows-only: comma-separated list of environment variables'
+@@ Documentation/config/core.adoc: This setting defaults to "refs/notes/commits", and it can be overridden by
+ the GIT_NOTES_REF environment variable. See linkgit:git-notes[1].
+
+ core.commitGraph::
+- If true, then git will read the commit-graph file (if it exists)
+- to parse the graph structure of commits. Defaults to true. See
++ If true, then git will read the commit-graph file (if it exists)
++ to parse the graph structure of commits. Defaults to true. See
+ linkgit:git-commit-graph[1] for more information.
+
+ core.useReplaceRefs::
+@@ Documentation/config/core.adoc: core.useReplaceRefs::
+ core.multiPackIndex::
+ Use the multi-pack-index file to track multiple packfiles using a
+ single index. See linkgit:git-multi-pack-index[1] for more
+- information. Defaults to true.
++ information. Defaults to true.
+
+ core.sparseCheckout::
+ Enable "sparse checkout" feature. See linkgit:git-sparse-checkout[1]
+
## Documentation/config/credential.adoc ##
@@ Documentation/config/credential.adoc: credential.interactive::
@@ Documentation/config/credential.adoc: credential.interactive::
credential.sanitizePrompt::
+ ## Documentation/config/fetch.adoc ##
+@@
+ in git pull) will recursively fetch into populated submodules.
+ This option can be set either to a boolean value or to on-demand.
+ Setting it to a boolean changes the behavior of fetch and pull to
+- recurse unconditionally into submodules when set to true or to not
+- recurse at all when set to false. When set to on-demand, fetch and
++ recurse unconditionally into submodules when set to true or to not
++ recurse at all when set to false. When set to on-demand, fetch and
+ pull will only recurse into a populated submodule when its
+ superproject retrieves a commit that updates the submodule's
+ reference.
+ Defaults to on-demand, or to the value of submodule.recurse if set.
+
+ fetch.fsckObjects::
+- If it is set to true, git-fetch-pack will check all fetched
++ If it is set to true, git-fetch-pack will check all fetched
+ objects. See transfer.fsckObjects for what's
+ checked. Defaults to false. If not set, the value of
+ transfer.fsckObjects is used instead.
+@@
+ transfer.unpackLimit is used instead.
+
+ fetch.prune::
+- If true, fetch will automatically behave as if the --prune
++ If true, fetch will automatically behave as if the --prune
+ option was given on the command line. See also remote.<name>.prune
+ and the PRUNING section of linkgit:git-fetch[1].
+
+ fetch.pruneTags::
+- If true, fetch will automatically behave as if the
++ If true, fetch will automatically behave as if the
+ refs/tags/*:refs/tags/* refspec was provided when pruning,
+ if not set already. This allows for setting both this option
+ and fetch.prune to maintain a 1=1 mapping to upstream
+@@
+ section of linkgit:git-fetch[1].
+
+ fetch.all::
+- If true, fetch will attempt to update all available remotes.
++ If true, fetch will attempt to update all available remotes.
+ This behavior can be overridden by passing --no-all or by
+ explicitly specifying one or more remote(s) to fetch from.
+ Defaults to false.
+@@ Documentation/config/fetch.adoc: For submodules, this setting can be overridden using the submodule.fetchJobs
+ config setting.
+
+ fetch.writeCommitGraph::
+- Set to true to write a commit-graph after every git fetch command
++ Set to true to write a commit-graph after every git fetch command
+ that downloads a pack-file from a remote. Using the --split option,
+ most executions will create a very small commit-graph file on top of
+ the existing commit-graph file(s). Occasionally, these files will
+
## Documentation/config/fmt-merge-msg.adoc ##
@@
merge.branchdesc::
@@ Documentation/config/format.adoc: format.useAutoBase::
If one wishes to use the ref refs/notes/true, please use that literal
instead.
+ ## Documentation/config/gc.adoc ##
+@@ Documentation/config/gc.adoc: use, it'll affect how the auto pack limit works.
+
+ gc.autoDetach::
+ Make git gc --auto return immediately and run in the background
+- if the system supports it. Default is true. This config variable acts
++ if the system supports it. Default is true. This config variable acts
+ as a fallback in case maintenance.autoDetach is not set.
+
+ gc.bigPackThreshold::
+@@ Documentation/config/gc.adoc: will also be excluded (this is the equivalent of running git gc with
+ --keep-largest-pack).
+
+ gc.writeCommitGraph::
+- If true, then gc will rewrite the commit-graph file when
++ If true, then gc will rewrite the commit-graph file when
+ linkgit:git-gc[1] is run. When using git gc --auto
+ the commit-graph will be updated if housekeeping is
+- required. Default is true. See linkgit:git-commit-graph[1]
++ required. Default is true. See linkgit:git-commit-graph[1]
+ for details.
+
+ gc.logExpiry::
+
+ ## Documentation/config/gitcvs.adoc ##
+@@ Documentation/config/gitcvs.adoc: gitcvs.logFile::
+ various stuff. See linkgit:git-cvsserver[1].
+
+ gitcvs.usecrlfattr::
+- If true, the server will look up the end-of-line conversion
++ If true, the server will look up the end-of-line conversion
+ attributes for files to determine the -k modes to use. If
+ the attributes force Git to treat a file as text,
+ the -k mode will be left blank so CVS clients will
+@@ Documentation/config/gitcvs.adoc: gitcvs.usecrlfattr::
+
+ gitcvs.allBinary::
+ This is used if gitcvs.usecrlfattr does not resolve
+- the correct '-kb' mode to use. If true, all
++ the correct '-kb' mode to use. If true, all
+ unresolved files are sent to the client in
+ mode '-kb'. This causes the client to treat them
+ as binary files, which suppresses any newline munging it
+
## Documentation/config/grep.adoc ##
@@
grep.lineNumber::
@@ Documentation/config/grep.adoc: grep.threads::
+ If set to true, fall back to git grep --no-index if git grep
+ is executed outside of a git repository. Defaults to false.
+ ## Documentation/config/gui.adoc ##
+@@ Documentation/config/gui.adoc: gui.spellingDictionary::
+ off.
+
+ gui.fastCopyBlame::
+- If true, 'git gui blame' uses -C instead of -C -C for original
++ If true, 'git gui blame' uses -C instead of -C -C for original
+ location detection. It makes blame significantly faster on huge
+ repositories at the expense of less thorough copy detection.
+
+
+ ## Documentation/config/http.adoc ##
+@@ Documentation/config/http.adoc: http.emptyAuth::
+ http.proactiveAuth::
+ Attempt authentication without first making an unauthenticated attempt and
+ receiving a 401 response. This can be used to ensure that all requests are
+- authenticated. If http.emptyAuth is set to true, this value has no effect.
++ authenticated. If http.emptyAuth is set to true, this value has no effect.
+ +
+ If the credential helper used specifies an authentication scheme (i.e., via the
+ authtype field), that value will be used; if a username and password is
+@@ Documentation/config/http.adoc: empty string.
+
+ http.sslVerify::
+ Whether to verify the SSL certificate when fetching or pushing
+- over HTTPS. Defaults to true. Can be overridden by the
++ over HTTPS. Defaults to true. Can be overridden by the
+ GIT_SSL_NO_VERIFY environment variable.
+
+ http.sslCert::
+@@ Documentation/config/http.adoc: http.sslTry::
+ when connecting via regular FTP protocol. This might be needed
+ if the FTP server requires it for security reasons or you wish
+ to connect securely whenever remote FTP server supports it.
+- Default is false since it might trigger certificate verification
++ Default is false since it might trigger certificate verification
+ errors on misconfigured servers.
+
+ http.maxRequests::
+@@ Documentation/config/http.adoc: http.noEPSV::
+ A boolean which disables using of EPSV ftp command by curl.
+ This can be helpful with some "poor" ftp servers which don't
+ support EPSV mode. Can be overridden by the GIT_CURL_FTP_NO_EPSV
+- environment variable. Default is false (curl will use EPSV).
++ environment variable. Default is false (curl will use EPSV).
+
+ http.userAgent::
+ The HTTP USER_AGENT string presented to an HTTP server. The default
+
+ ## Documentation/config/instaweb.adoc ##
+@@ Documentation/config/instaweb.adoc: instaweb.httpd::
+ repository. See linkgit:git-instaweb[1].
+
+ instaweb.local::
+- If true the web server started by linkgit:git-instaweb[1] will
++ If true the web server started by linkgit:git-instaweb[1] will
+ be bound to the local IP (127.0.0.1).
+
+ instaweb.modulePath::
+
+ ## Documentation/config/interactive.adoc ##
+@@
+ interactive.singleKey::
+- When set to true, allow the user to provide one-letter input
++ When set to true, allow the user to provide one-letter input
+ with a single key (i.e., without hitting the Enter key) in
+ interactive commands. This is currently used by the --patch
+ mode of linkgit:git-add[1], linkgit:git-checkout[1],
+
+ ## Documentation/config/log.adoc ##
+@@ Documentation/config/log.adoc: This is the same as the --decorate option of the git log.
+ history lines in git log --graph.
+
+ log.showRoot::
+- If true, the initial commit will be shown as a big creation event.
++ If true, the initial commit will be shown as a big creation event.
+ This is equivalent to a diff against an empty tree.
+ Tools like linkgit:git-log[1] or linkgit:git-whatchanged[1], which
+ normally hide the root commit will now show it. True by default.
+
+ log.showSignature::
+- If true, makes linkgit:git-log[1], linkgit:git-show[1], and
++ If true, makes linkgit:git-log[1], linkgit:git-show[1], and
+ linkgit:git-whatchanged[1] assume --show-signature.
+
+ log.mailmap::
+- If true, makes linkgit:git-log[1], linkgit:git-show[1], and
++ If true, makes linkgit:git-log[1], linkgit:git-show[1], and
+ linkgit:git-whatchanged[1] assume --use-mailmap, otherwise
+ assume --no-use-mailmap. True by default.
+
+ ## Documentation/config/mailinfo.adoc ##
+@@
+ mailinfo.scissors::
+- If true, makes linkgit:git-mailinfo[1] (and therefore
++ If true, makes linkgit:git-mailinfo[1] (and therefore
+ linkgit:git-am[1]) act by default as if the --scissors option
+ was provided on the command-line. When active, this feature
+ removes everything from the message body before a scissors
+
+ ## Documentation/config/maintenance.adoc ##
+@@
+ maintenance.auto::
+ This boolean config option controls whether some commands run
+ git maintenance run --auto after doing their normal work. Defaults
+- to true.
++ to true.
+
+ maintenance.autoDetach::
+ Many Git commands trigger automatic maintenance after they have
+@@ Documentation/config/maintenance.adoc: maintenance.autoDetach::
+ continue to run in the background.
+ +
+ If unset, the value of gc.autoDetach is used as a fallback. Defaults
+-to true if both are unset, meaning that the maintenance process will
++to true if both are unset, meaning that the maintenance process will
+ detach.
+
+ maintenance.strategy::
+@@ Documentation/config/maintenance.adoc: maintenance.<task>.enabled::
+ with name <task> is run when no --task option is specified to
+ git maintenance run. These config values are ignored if a
+ --task option exists. By default, only maintenance.gc.enabled
+- is true.
++ is true.
+
+ maintenance.<task>.schedule::
+ This config option controls whether or not the given <task> runs
+
+ ## Documentation/config/merge.adoc ##
+@@
+ branches at the remote named by branch.<current-branch>.remote
+ are consulted, and then they are mapped via remote.<remote>.fetch
+ to their corresponding remote-tracking branches, and the tips of
+- these tracking branches are merged. Defaults to true.
++ these tracking branches are merged. Defaults to true.
+
+ merge.ff::
+ By default, Git does not create an extra merge commit when merging
+@@
+ command line).
+
+ merge.verifySignatures::
+- If true, this is equivalent to the --verify-signatures command
++ If true, this is equivalent to the --verify-signatures command
+ line option. See linkgit:git-merge[1] for details.
+
+ include::fmt-merge-msg.adoc[]
+
+ ## Documentation/config/mergetool.adoc ##
+@@
+ mergetool.<tool>.trustExitCode::
+ For a custom merge command, specify whether the exit code of
+ the merge command can be used to determine whether the merge was
+- successful. If this is not set to true then the merge target file
++ successful. If this is not set to true then the merge target file
+ timestamp is checked, and the merge is assumed to have been successful
+ if the file has been updated; otherwise, the user is prompted to
+ indicate the success of the merge.
+
+ ## Documentation/config/pack.adoc ##
+@@ Documentation/config/pack.adoc: all existing objects. You can force recompression by passing the -F option
+ to linkgit:git-repack[1].
+
+ pack.allowPackReuse::
+- When true or "single", and when reachability bitmaps are
++ When true or "single", and when reachability bitmaps are
+ enabled, pack-objects will try to send parts of the bitmapped
+ packfile verbatim. When "multi", and when a multi-pack
+ reachability bitmap is available, pack-objects will try to send
+@@ Documentation/config/pack.adoc: pack.allowPackReuse::
+ If only a single pack bitmap is available, and pack.allowPackReuse
+ is set to "multi", reuse parts of just the bitmapped packfile. This
+ can reduce memory and CPU usage to serve fetches, but might result in
+-sending a slightly larger pack. Defaults to true.
++sending a slightly larger pack. Defaults to true.
+
+ pack.island::
+ An extended regular expression configuring a set of delta
+@@ Documentation/config/pack.adoc: The minimum size allowed is limited to 1 MiB. The default is unlimited.
+ Common unit suffixes of 'k', 'm', or 'g' are supported.
+
+ pack.useBitmaps::
+- When true, git will use pack bitmaps (if available) when packing
++ When true, git will use pack bitmaps (if available) when packing
+ to stdout (e.g., during the server side of a fetch). Defaults to
+- true. You should not generally need to turn this off unless
++ true. You should not generally need to turn this off unless
+ you are debugging pack bitmaps.
+
+ pack.useBitmapBoundaryTraversal::
+- When true, Git will use an experimental algorithm for computing
++ When true, Git will use an experimental algorithm for computing
+ reachability queries with bitmaps. Instead of building up
+ complete bitmaps for all of the negated tips and then OR-ing
+ them together, consider negated tips with existing bitmaps as
+@@ Documentation/config/pack.adoc: particularly when there is poor bitmap coverage of the negated side of
+ the query.
+
+ pack.useSparse::
+- When true, git will default to using the '--sparse' option in
++ When true, git will default to using the '--sparse' option in
+ 'git pack-objects' when the '--revs' option is present. This
+ algorithm only walks trees that appear in paths that introduce new
+ objects. This can have significant performance benefits when
+@@ Documentation/config/pack.adoc: pack.writeBitmaps (deprecated)::
+ This is a deprecated synonym for repack.writeBitmaps.
+
+ pack.writeBitmapHashCache::
+- When true, git will include a "hash cache" section in the bitmap
++ When true, git will include a "hash cache" section in the bitmap
+ index (if one is written). This cache can be used to feed git's
+ delta heuristics, potentially leading to better deltas between
+ bitmapped and non-bitmapped objects (e.g., when serving a fetch
+ between an older, bitmapped pack and objects that have been
+ pushed since the last gc). The downside is that it consumes 4
+- bytes per object of disk space. Defaults to true.
++ bytes per object of disk space. Defaults to true.
+ +
+ When writing a multi-pack reachability bitmap, no new namehashes are
+ computed; instead, any namehashes stored in an existing bitmap are
+ permuted into their appropriate location when writing a new bitmap.
+
+ pack.writeBitmapLookupTable::
+- When true, Git will include a "lookup table" section in the
++ When true, Git will include a "lookup table" section in the
+ bitmap index (if one is written). This table is used to defer
+ loading individual bitmaps as late as possible. This can be
+ beneficial in repositories that have relatively large bitmap
+- indexes. Defaults to false.
++ indexes. Defaults to false.
+
+ pack.readReverseIndex::
+- When true, git will read any .rev file(s) that may be available
+- (see: linkgit:gitformat-pack[5]). When false, the reverse index
++ When true, git will read any .rev file(s) that may be available
++ (see: linkgit:gitformat-pack[5]). When false, the reverse index
+ will be generated from scratch and stored in memory. Defaults to
+- true.
++ true.
+
+ pack.writeReverseIndex::
+- When true, git will write a corresponding .rev file (see:
++ When true, git will write a corresponding .rev file (see:
+ linkgit:gitformat-pack[5])
+ for each new packfile that it writes in all places except for
+ linkgit:git-fast-import[1] and in the bulk checkin mechanism.
+- Defaults to true.
++ Defaults to true.
+
+ ## Documentation/config/pull.adoc ##
+@@ Documentation/config/pull.adoc: pull.ff::
+ command line). This setting overrides merge.ff when pulling.
+
+ pull.rebase::
+- When true, rebase branches on top of the fetched branch, instead
++ When true, rebase branches on top of the fetched branch, instead
+ of merging the default branch from the default remote when "git
+ pull" is run. See "branch.<name>.rebase" for setting this on a
+ per-branch basis.
+@@ Documentation/config/pull.adoc: pull.octopus::
+ at once.
+
+ pull.autoStash::
+- When set to true, automatically create a temporary stash entry
++ When set to true, automatically create a temporary stash entry
+ to record the local changes before the operation begins, and
+ restore them after the operation completes. When your "git
+ pull" rebases (instead of merges), this may be convenient, since
+
+ ## Documentation/config/push.adoc ##
+@@ Documentation/config/push.adoc: new default).
+ --
+
+ push.followTags::
+- If set to true, enable --follow-tags option by default. You
++ If set to true, enable --follow-tags option by default. You
+ may override this configuration at time of push by specifying
+ --no-follow-tags.
+
+
## Documentation/config/rebase.adoc ##
@@ Documentation/config/rebase.adoc: rebase.stat::
rebase. False by default.
@@ Documentation/config/rebase.adoc: rebase.rescheduleFailedExec::
command line, with or without an argument, overrides any
rebase.rebaseMerges configuration.
+ ## Documentation/config/receive.adoc ##
+@@
+ receive.advertiseAtomic::
+ By default, git-receive-pack will advertise the atomic push
+ capability to its clients. If you don't want to advertise this
+- capability, set this variable to false.
++ capability, set this variable to false.
+
+ receive.advertisePushOptions::
+- When set to true, git-receive-pack will advertise the push options
++ When set to true, git-receive-pack will advertise the push options
+ capability to its clients. False by default.
+
+ receive.autogc::
+ By default, git-receive-pack will run "git maintenance run --auto" after
+ receiving data from git-push and updating refs. You can stop
+- it by setting this variable to false.
++ it by setting this variable to false.
+
+ receive.certNonceSeed::
+ By setting this variable to a string, git receive-pack
+@@ Documentation/config/receive.adoc: receive.certNonceSlop::
+ can check GIT_PUSH_CERT_NONCE_STATUS is OK.
+
+ receive.fsckObjects::
+- If it is set to true, git-receive-pack will check all received
++ If it is set to true, git-receive-pack will check all received
+ objects. See transfer.fsckObjects for what's checked.
+- Defaults to false. If not set, the value of
++ Defaults to false. If not set, the value of
+ transfer.fsckObjects is used instead.
+
+ receive.fsck.<msg-id>::
+@@ Documentation/config/receive.adoc: receive.maxInputSize::
+ is unlimited.
+
+ receive.denyDeletes::
+- If set to true, git-receive-pack will deny a ref update that deletes
++ If set to true, git-receive-pack will deny a ref update that deletes
+ the ref. Use this to prevent such a ref deletion via a push.
+
+ receive.denyDeleteCurrent::
+- If set to true, git-receive-pack will deny a ref update that
++ If set to true, git-receive-pack will deny a ref update that
+ deletes the currently checked out branch of a non-bare repository.
+
+ receive.denyCurrentBranch::
+- If set to true or "refuse", git-receive-pack will deny a ref update
++ If set to true or "refuse", git-receive-pack will deny a ref update
+ to the currently checked out branch of a non-bare repository.
+ Such a push is potentially dangerous because it brings the HEAD
+ out of sync with the index and working tree. If set to "warn",
+ print a warning of such a push to stderr, but allow the push to
+- proceed. If set to false or "ignore", allow such pushes with no
++ proceed. If set to false or "ignore", allow such pushes with no
+ message. Defaults to "refuse".
+ +
+ Another option is "updateInstead" which will update the working
+@@ Documentation/config/receive.adoc: the index have any difference from the HEAD, but the push-to-checkout
+ hook can be used to customize this. See linkgit:githooks[5].
+
+ receive.denyNonFastForwards::
+- If set to true, git-receive-pack will deny a ref update which is
++ If set to true, git-receive-pack will deny a ref update which is
+ not a fast-forward. Use this to prevent such an update via a push,
+ even if that push is forced. This configuration variable is
+ set when initializing a shared repository.
+@@ Documentation/config/receive.adoc: E.g.:
+ git config --system --add receive.procReceiveRefs !:refs/heads
+
+ receive.updateServerInfo::
+- If set to true, git-receive-pack will run git-update-server-info
++ If set to true, git-receive-pack will run git-update-server-info
+ after receiving data from git-push and updating refs.
+
+ receive.shallowUpdate::
+- If set to true, .git/shallow can be updated when new refs
++ If set to true, .git/shallow can be updated when new refs
+ require new shallow roots. Otherwise those refs are rejected.
+
+ ## Documentation/config/remote.adoc ##
+@@ Documentation/config/remote.adoc: remote.<name>.push::
+ linkgit:git-push[1].
+
+ remote.<name>.mirror::
+- If true, pushing to this remote will automatically behave
++ If true, pushing to this remote will automatically behave
+ as if the --mirror option was given on the command line.
+
+ remote.<name>.skipDefaultUpdate::
+@@ Documentation/config/remote.adoc: remote.<name>.skipDefaultUpdate::
+ values, the value of the last occurrence will be used).
+
+ remote.<name>.skipFetchAll::
+- If true, this remote will be skipped when updating
++ If true, this remote will be skipped when updating
+ using linkgit:git-fetch[1], the update subcommand of
+ linkgit:git-remote[1], and ignored by the prefetch task
+ of git maintenance.
+@@ Documentation/config/remote.adoc: remote.<name>.vcs::
+ the remote with the git-remote-<vcs> helper.
+
+ remote.<name>.prune::
+- When set to true, fetching from this remote by default will also
++ When set to true, fetching from this remote by default will also
+ remove any remote-tracking references that no longer exist on the
+ remote (as if the --prune option was given on the command line).
+ Overrides fetch.prune settings, if any.
+
+ remote.<name>.pruneTags::
+- When set to true, fetching from this remote by default will also
++ When set to true, fetching from this remote by default will also
+ remove any local tags that no longer exist on the remote if pruning
+ is activated in general via remote.<name>.prune, fetch.prune or
+ --prune. Overrides fetch.pruneTags settings, if any.
+@@ Documentation/config/remote.adoc: See also remote.<name>.prune and the PRUNING section of
+ linkgit:git-fetch[1].
+
+ remote.<name>.promisor::
+- When set to true, this remote will be used to fetch promisor
++ When set to true, this remote will be used to fetch promisor
+ objects.
+
+ remote.<name>.partialclonefilter::
+
+ ## Documentation/config/repack.adoc ##
+@@ Documentation/config/repack.adoc: repack.useDeltaBaseOffset::
+ native protocol are unaffected by this option.
+
+ repack.packKeptObjects::
+- If set to true, makes git repack act as if
++ If set to true, makes git repack act as if
+ --pack-kept-objects was passed. See linkgit:git-repack[1] for
+ details. Defaults to false normally, but true if a bitmap
+ index is being written (either via --write-bitmap-index or
+ repack.writeBitmaps).
+
+ repack.useDeltaIslands::
+- If set to true, makes git repack act as if --delta-islands
++ If set to true, makes git repack act as if --delta-islands
+ was passed. Defaults to false.
+
+ repack.writeBitmaps::
+- When true, git will write a bitmap index when packing all
++ When true, git will write a bitmap index when packing all
+ objects to disk (e.g., when git repack -a is run). This
+ index can speed up the "counting objects" phase of subsequent
+ packs created for clones and fetches, at the cost of some disk
+ space and extra time spent on the initial repack. This has
+ no effect if multiple packfiles are created.
+- Defaults to true on bare repos, false otherwise.
++ Defaults to true on bare repos, false otherwise.
+
+ repack.updateServerInfo::
+- If set to false, linkgit:git-repack[1] will not run
+- linkgit:git-update-server-info[1]. Defaults to true. Can be overridden
+- when true by the -n option of linkgit:git-repack[1].
++ If set to false, linkgit:git-repack[1] will not run
++ linkgit:git-update-server-info[1]. Defaults to true. Can be overridden
++ when true by the -n option of linkgit:git-repack[1].
+
+ repack.cruftWindow::
+ repack.cruftWindowMemory::
+@@ Documentation/config/repack.adoc: repack.cruftThreads::
+ variables for defaults and meaning.
+
+ repack.midxMustContainCruft::
+- When set to true, linkgit:git-repack[1] will unconditionally include
++ When set to true, linkgit:git-repack[1] will unconditionally include
+ cruft pack(s), if any, in the multi-pack index when invoked with
+- --write-midx. When false, cruft packs are only included in the MIDX
++ --write-midx. When false, cruft packs are only included in the MIDX
+ when necessary (e.g., because they might be required to form a
+- reachability closure with MIDX bitmaps). Defaults to true.
++ reachability closure with MIDX bitmaps). Defaults to true.
+
## Documentation/config/rerere.adoc ##
@@
rerere.autoUpdate::
@@ Documentation/config/rerere.adoc
rerere.enabled::
Activate recording of resolved conflicts, so that identical
+ ## Documentation/config/revert.adoc ##
+@@
+ revert.reference::
+- Setting this variable to true makes git revert behave
++ Setting this variable to true makes git revert behave
+ as if the --reference option is given.
+
## Documentation/config/stash.adoc ##
@@ Documentation/config/stash.adoc: ifdef::git-stash[]
endif::git-stash[]
@@ Documentation/config/status.adoc: This variable can be overridden with the -u|--
unlimited number), the submodule summary will be enabled and a
summary of commits for modified submodules will be shown (see
--summary-limit option of linkgit:git-submodule[1]). Please note
+
+ ## Documentation/config/submodule.adoc ##
+@@ Documentation/config/submodule.adoc: submodule.active::
+
+ submodule.recurse::
+ A boolean indicating if commands should enable the --recurse-submodules
+- option by default. Defaults to false.
++ option by default. Defaults to false.
+ +
+-When set to true, it can be deactivated via the
++When set to true, it can be deactivated via the
+ --no-recurse-submodules option. Note that some Git commands
+ lacking this option may call some of the above commands affected by
+ submodule.recurse; for instance git remote update will call
+@@ Documentation/config/submodule.adoc: submodule.propagateBranches::
+ Enabling this will allow certain commands to accept
+ --recurse-submodules and certain commands that already accept
+ --recurse-submodules will now consider branches.
+- Defaults to false.
++ Defaults to false.
+
+ submodule.fetchJobs::
+ Specifies how many submodules are fetched/cloned at the same time.
+
+ ## Documentation/config/trace2.adoc ##
+@@ Documentation/config/trace2.adoc: trace2.eventTarget::
+ include::../trace2-target-values.adoc[]
+
+ trace2.normalBrief::
+- Boolean. When true time, filename, and line fields are
++ Boolean. When true time, filename, and line fields are
+ omitted from normal output. May be overridden by the
+- GIT_TRACE2_BRIEF environment variable. Defaults to false.
++ GIT_TRACE2_BRIEF environment variable. Defaults to false.
+
+ trace2.perfBrief::
+- Boolean. When true time, filename, and line fields are
++ Boolean. When true time, filename, and line fields are
+ omitted from PERF output. May be overridden by the
+- GIT_TRACE2_PERF_BRIEF environment variable. Defaults to false.
++ GIT_TRACE2_PERF_BRIEF environment variable. Defaults to false.
+
+ trace2.eventBrief::
+- Boolean. When true time, filename, and line fields are
++ Boolean. When true time, filename, and line fields are
+ omitted from event output. May be overridden by the
+- GIT_TRACE2_EVENT_BRIEF environment variable. Defaults to false.
++ GIT_TRACE2_EVENT_BRIEF environment variable. Defaults to false.
+
+ trace2.eventNesting::
+ Integer. Specifies desired depth of nested regions in the
+@@ Documentation/config/trace2.adoc: trace2.envVars::
+ default.
+
+ trace2.destinationDebug::
+- Boolean. When true Git will print error messages when a
++ Boolean. When true Git will print error messages when a
+ trace target destination cannot be opened for writing.
+ By default, these errors are suppressed and tracing is
+ silently disabled. May be overridden by the
+
+ ## Documentation/config/transfer.adoc ##
+@@ Documentation/config/transfer.adoc: data in git's configuration files. If you do want to use this, set
+ transfer.fsckObjects::
+ When fetch.fsckObjects or receive.fsckObjects are
+ not set, the value of this variable is used instead.
+- Defaults to false.
++ Defaults to false.
+ +
+ When set, the fetch or receive will abort in the case of a malformed
+ object or a link to a nonexistent object. In addition, various other
+@@ Documentation/config/transfer.adoc: transfer.unpackLimit::
+ The default value is 100.
+
+ transfer.advertiseSID::
+- Boolean. When true, client and server processes will advertise their
+- unique session IDs to their remote counterpart. Defaults to false.
++ Boolean. When true, client and server processes will advertise their
++ unique session IDs to their remote counterpart. Defaults to false.
+
+ transfer.bundleURI::
+ When true, local git clone commands will request bundle
+@@ Documentation/config/transfer.adoc: transfer.bundleURI::
+
+ transfer.advertiseObjectInfo::
+ When true, the object-info capability is advertised by
+- servers. Defaults to false.
++ servers. Defaults to false.
+
+ ## Documentation/config/uploadarchive.adoc ##
+@@
+ uploadarchive.allowUnreachable::
+- If true, allow clients to use git archive --remote to request
++ If true, allow clients to use git archive --remote to request
+ any tree, whether reachable from the ref tips or not. See the
+ discussion in the "SECURITY" section of
+ linkgit:git-upload-archive[1] for more details. Defaults to
+
+ ## Documentation/config/worktree.adoc ##
+@@
+ If no branch is specified and neither -b nor -B nor
+ --detach is used, then git worktree add defaults to
+ creating a new branch from HEAD. If worktree.guessRemote is
+- set to true, worktree add tries to find a remote-tracking
++ set to true, worktree add tries to find a remote-tracking
+ branch whose name uniquely matches the new branch name. If
+ such a branch exists, it is checked out and set as "upstream"
+ for the new branch. If no such match can be found, it falls
Documentation/config/am.adoc | 4 +- Documentation/config/blame.adoc | 6 +-- Documentation/config/branch.adoc | 10 ++-- Documentation/config/clean.adoc | 2 +- Documentation/config/color.adoc | 2 +- Documentation/config/commitgraph.adoc | 8 +-- Documentation/config/core.adoc | 72 ++++++++++++------------- Documentation/config/credential.adoc | 2 +- Documentation/config/fetch.adoc | 14 ++--- Documentation/config/fmt-merge-msg.adoc | 6 +-- Documentation/config/format.adoc | 22 ++++---- Documentation/config/gc.adoc | 6 +-- Documentation/config/gitcvs.adoc | 4 +- Documentation/config/grep.adoc | 12 ++--- Documentation/config/gui.adoc | 2 +- Documentation/config/http.adoc | 8 +-- Documentation/config/instaweb.adoc | 2 +- Documentation/config/interactive.adoc | 2 +- Documentation/config/log.adoc | 6 +-- Documentation/config/mailinfo.adoc | 2 +- Documentation/config/maintenance.adoc | 6 +-- Documentation/config/merge.adoc | 4 +- Documentation/config/mergetool.adoc | 2 +- Documentation/config/pack.adoc | 30 +++++------ Documentation/config/pull.adoc | 4 +- Documentation/config/push.adoc | 2 +- Documentation/config/rebase.adoc | 18 +++---- Documentation/config/receive.adoc | 24 ++++----- Documentation/config/remote.adoc | 10 ++-- Documentation/config/repack.adoc | 20 +++---- Documentation/config/rerere.adoc | 4 +- Documentation/config/revert.adoc | 2 +- Documentation/config/stash.adoc | 16 +++--- Documentation/config/status.adoc | 20 +++---- Documentation/config/submodule.adoc | 6 +-- Documentation/config/trace2.adoc | 14 ++--- Documentation/config/transfer.adoc | 8 +-- Documentation/config/uploadarchive.adoc | 2 +- Documentation/config/worktree.adoc | 2 +- 39 files changed, 193 insertions(+), 193 deletions(-)
Documentation/config/am.adoc +2 -2
@@ -1,5 +1,5 @@ am.keepcr:: - If true, git-am will call git-mailsplit for patches in mbox format + If `true`, git-am will call git-mailsplit for patches in mbox format with parameter `--keep-cr`. In this case git-mailsplit will not remove `\r` from lines ending with `\r\n`. Can be overridden by giving `--no-keep-cr` from the command line.
@@ -7,7 +7,7 @@ am.keepcr:: am.threeWay:: By default, `git am` will fail if the patch does not apply cleanly. When - set to true, this setting tells `git am` to fall back on 3-way merge if + set to `true`, this setting tells `git am` to fall back on 3-way merge if the patch records the identity of blobs it is supposed to apply to and we have those blobs available locally (equivalent to giving the `--3way` option from the command line). Defaults to `false`.
Documentation/config/blame.adoc +3 -3
@@ -1,6 +1,6 @@ blame.blankBoundary:: Show blank commit object name for boundary commits in - linkgit:git-blame[1]. This option defaults to false. + linkgit:git-blame[1]. This option defaults to `false`. blame.coloring:: This determines the coloring scheme to be applied to blame
@@ -14,11 +14,11 @@ blame.date:: blame.showEmail:: Show the author email instead of author name in linkgit:git-blame[1]. - This option defaults to false. + This option defaults to `false`. blame.showRoot:: Do not treat root commits as boundaries in linkgit:git-blame[1]. - This option defaults to false. + This option defaults to `false`. blame.ignoreRevsFile:: Ignore revisions listed in the file, one unabbreviated object name per
Documentation/config/branch.adoc +5 -5
@@ -20,10 +20,10 @@ that tracks another branch, this variable tells Git to set up pull to rebase instead of merge (see `branch.<name>.rebase`). The valid settings are: -`never`;; rebase is never automatically set to true. -`local`;; rebase is set to true for tracked branches of other local branches. -`remote`;; rebase is set to true for tracked branches of remote-tracking branches. -`always`;; rebase will be set to true for all tracking branches. +`never`;; rebase is never automatically set to `true`. +`local`;; rebase is set to `true` for tracked branches of other local branches. +`remote`;; rebase is set to `true` for tracked branches of remote-tracking branches. +`always`;; rebase will be set to `true` for all tracking branches. + See `branch.autoSetupMerge` for details on how to set up a branch to track another branch.
@@ -81,7 +81,7 @@ This option defaults to `never`. supported. `branch.<name>.rebase`:: - When true, rebase the branch _<name>_ on top of the fetched branch, + When `true`, rebase the branch _<name>_ on top of the fetched branch, instead of merging the default branch from the default remote when `git pull` is run. See `pull.rebase` for doing this in a non branch-specific manner.
Documentation/config/clean.adoc +1 -1
@@ -1,3 +1,3 @@ clean.requireForce:: A boolean to make git-clean refuse to delete files unless -f - is given. Defaults to true. + is given. Defaults to `true`.
Documentation/config/color.adoc +1 -1
@@ -132,7 +132,7 @@ color.interactive.<slot>:: color.pager:: A boolean to specify whether `auto` color modes should colorize - output going to the pager. Defaults to true; set this to false + output going to the pager. Defaults to `true`; set this to `false` if your pager does not understand ANSI color codes. color.push::
Documentation/config/commitgraph.adoc +4 -4
@@ -9,9 +9,9 @@ commitGraph.maxNewFilters:: commit-graph write` (c.f., linkgit:git-commit-graph[1]). commitGraph.changedPaths:: - If true, then `git commit-graph write` will compute and write + If `true`, then `git commit-graph write` will compute and write changed-path Bloom filters by default, equivalent to passing - `--changed-paths`. If false or unset, changed-paths Bloom filters will + `--changed-paths`. If `false` or unset, changed-paths Bloom filters will be written during `git commit-graph write` only if the filters already exist in the current commit-graph file. This matches the default behavior of `git commit-graph write` without any `--[no-]changed-paths`
@@ -20,8 +20,8 @@ commitGraph.changedPaths:: always takes precedence over this configuration. Defaults to unset. commitGraph.readChangedPaths:: - Deprecated. Equivalent to commitGraph.changedPathsVersion=-1 if true, and - commitGraph.changedPathsVersion=0 if false. (If commitGraph.changedPathVersion + Deprecated. Equivalent to commitGraph.changedPathsVersion=-1 if `true`, and + commitGraph.changedPathsVersion=0 if `false`. (If commitGraph.changedPathVersion is also set, commitGraph.changedPathsVersion takes precedence.) commitGraph.changedPathsVersion::
Documentation/config/core.adoc +36 -36
220 lines not on this page · raw message
Documentation/config/credential.adoc +1 -1
@@ -19,7 +19,7 @@ credential.interactive:: credential.useHttpPath:: When acquiring credentials, consider the "path" component of an http - or https URL to be important. Defaults to false. See + or https URL to be important. Defaults to `false`. See linkgit:gitcredentials[7] for more information. credential.sanitizePrompt::
Documentation/config/fetch.adoc +7 -7
@@ -3,15 +3,15 @@ in `git pull`) will recursively fetch into populated submodules. This option can be set either to a boolean value or to `on-demand`. Setting it to a boolean changes the behavior of fetch and pull to - recurse unconditionally into submodules when set to true or to not - recurse at all when set to false. When set to `on-demand`, fetch and + recurse unconditionally into submodules when set to `true` or to not + recurse at all when set to `false`. When set to `on-demand`, fetch and pull will only recurse into a populated submodule when its superproject retrieves a commit that updates the submodule's reference. Defaults to `on-demand`, or to the value of `submodule.recurse` if set. `fetch.fsckObjects`:: - If it is set to true, git-fetch-pack will check all fetched + If it is set to `true`, git-fetch-pack will check all fetched objects. See `transfer.fsckObjects` for what's checked. Defaults to `false`. If not set, the value of `transfer.fsckObjects` is used instead.
@@ -38,12 +38,12 @@ `transfer.unpackLimit` is used instead. `fetch.prune`:: - If true, fetch will automatically behave as if the `--prune` + If `true`, fetch will automatically behave as if the `--prune` option was given on the command line. See also `remote.<name>.prune` and the PRUNING section of linkgit:git-fetch[1]. `fetch.pruneTags`:: - If true, fetch will automatically behave as if the + If `true`, fetch will automatically behave as if the `refs/tags/*:refs/tags/*` refspec was provided when pruning, if not set already. This allows for setting both this option and `fetch.prune` to maintain a 1=1 mapping to upstream
@@ -51,7 +51,7 @@ section of linkgit:git-fetch[1]. `fetch.all`:: - If true, fetch will attempt to update all available remotes. + If `true`, fetch will attempt to update all available remotes. This behavior can be overridden by passing `--no-all` or by explicitly specifying one or more remote(s) to fetch from. Defaults to `false`.
@@ -95,7 +95,7 @@ For submodules, this setting can be overridden using the `submodule.fetchJobs` config setting. `fetch.writeCommitGraph`:: - Set to true to write a commit-graph after every `git fetch` command + Set to `true` to write a commit-graph after every `git fetch` command that downloads a pack-file from a remote. Using the `--split` option, most executions will create a very small commit-graph file on top of the existing commit-graph file(s). Occasionally, these files will
Documentation/config/fmt-merge-msg.adoc +3 -3
@@ -1,13 +1,13 @@ `merge.branchdesc`:: In addition to branch names, populate the log message with the branch description text associated with them. Defaults - to false. + to `false`. `merge.log`:: In addition to branch names, populate the log message with at most the specified number of one-line descriptions from the - actual commits that are being merged. Defaults to false, and - true is a synonym for 20. + actual commits that are being merged. Defaults to `false`, and + `true` is a synonym for 20. `merge.suppressDest`:: By adding a glob that matches the names of integration
Documentation/config/format.adoc +11 -11
@@ -8,23 +8,23 @@ format.attach:: format.from:: Provides the default value for the `--from` option to format-patch. - Accepts a boolean value, or a name and email address. If false, + Accepts a boolean value, or a name and email address. If `false`, format-patch defaults to `--no-from`, using commit authors directly in - the "From:" field of patch mails. If true, format-patch defaults to + the "From:" field of patch mails. If `true`, format-patch defaults to `--from`, using your committer identity in the "From:" field of patch mails and including a "From:" field in the body of the patch mail if different. If set to a non-boolean value, format-patch uses that - value instead of your committer identity. Defaults to false. + value instead of your committer identity. Defaults to `false`. format.forceInBodyFrom:: Provides the default value for the `--[no-]force-in-body-from` - option to format-patch. Defaults to false. + option to format-patch. Defaults to `false`. format.numbered:: A boolean which can enable or disable sequence numbers in patch subjects. It defaults to "auto" which enables it only if there is more than one patch. It can be enabled or disabled for all - messages by setting it to "true" or "false". See --numbered + messages by setting it to `true` or `false`. See --numbered option in linkgit:git-format-patch[1]. format.headers::
@@ -65,7 +65,7 @@ format.suffix:: format.encodeEmailHeaders:: Encode email headers that have non-ASCII characters with "Q-encoding" (described in RFC 2047) for email transmission. - Defaults to true. + Defaults to `true`. format.pretty:: ifndef::with-breaking-changes[]
@@ -85,7 +85,7 @@ format.thread:: where the head is chosen from the cover letter, the `--in-reply-to`, and the first patch mail, in this order. `deep` threading makes every mail a reply to the previous one. - A true boolean value is the same as `shallow`, and a false + A `true` boolean value is the same as `shallow`, and a `false` value disables threading. format.signOff::
@@ -99,7 +99,7 @@ format.coverLetter:: A boolean that controls whether to generate a cover-letter when format-patch is invoked, but in addition can be set to "auto", to generate a cover-letter only when there's more than one patch. - Default is false. + Default is `false`. format.outputDirectory:: Set a custom directory to store the resulting files instead of the
@@ -119,11 +119,11 @@ format.useAutoBase:: format.notes:: Provides the default value for the `--notes` option to format-patch. Accepts a boolean value, or a ref which specifies - where to get notes. If false, format-patch defaults to - `--no-notes`. If true, format-patch defaults to `--notes`. If + where to get notes. If `false`, format-patch defaults to + `--no-notes`. If `true`, format-patch defaults to `--notes`. If set to a non-boolean value, format-patch defaults to `--notes=<ref>`, where `ref` is the non-boolean value. Defaults - to false. + to `false`. + If one wishes to use the ref `refs/notes/true`, please use that literal instead.
Documentation/config/gc.adoc +3 -3
@@ -40,7 +40,7 @@ use, it'll affect how the auto pack limit works. gc.autoDetach:: Make `git gc --auto` return immediately and run in the background - if the system supports it. Default is true. This config variable acts + if the system supports it. Default is `true`. This config variable acts as a fallback in case `maintenance.autoDetach` is not set. gc.bigPackThreshold::
@@ -61,10 +61,10 @@ will also be excluded (this is the equivalent of running `git gc` with `--keep-largest-pack`). gc.writeCommitGraph:: - If true, then gc will rewrite the commit-graph file when + If `true`, then gc will rewrite the commit-graph file when linkgit:git-gc[1] is run. When using `git gc --auto` the commit-graph will be updated if housekeeping is - required. Default is true. See linkgit:git-commit-graph[1] + required. Default is `true`. See linkgit:git-commit-graph[1] for details. gc.logExpiry::
Documentation/config/gitcvs.adoc +2 -2
@@ -11,7 +11,7 @@ gitcvs.logFile:: various stuff. See linkgit:git-cvsserver[1]. gitcvs.usecrlfattr:: - If true, the server will look up the end-of-line conversion + If `true`, the server will look up the end-of-line conversion attributes for files to determine the `-k` modes to use. If the attributes force Git to treat a file as text, the `-k` mode will be left blank so CVS clients will
@@ -23,7 +23,7 @@ gitcvs.usecrlfattr:: gitcvs.allBinary:: This is used if `gitcvs.usecrlfattr` does not resolve - the correct '-kb' mode to use. If true, all + the correct '-kb' mode to use. If `true`, all unresolved files are sent to the client in mode '-kb'. This causes the client to treat them as binary files, which suppresses any newline munging it
Documentation/config/grep.adoc +6 -6
@@ -1,8 +1,8 @@ grep.lineNumber:: - If set to true, enable `-n` option by default. + If set to `true`, enable `-n` option by default. grep.column:: - If set to true, enable the `--column` option by default. + If set to `true`, enable the `--column` option by default. grep.patternType:: Set the default matching behavior. Using a value of 'basic', 'extended',
@@ -12,7 +12,7 @@ grep.patternType:: between 'basic' and 'extended'. grep.extendedRegexp:: - If set to true, enable `--extended-regexp` option by default. This + If set to `true`, enable `--extended-regexp` option by default. This option is ignored when the `grep.patternType` option is set to a value other than 'default'.
@@ -21,8 +21,8 @@ grep.threads:: use as many threads as the number of logical cores available. grep.fullName:: - If set to true, enable `--full-name` option by default. + If set to `true`, enable `--full-name` option by default. grep.fallbackToNoIndex:: - If set to true, fall back to `git grep --no-index` if `git grep` - is executed outside of a git repository. Defaults to false. + If set to `true`, fall back to `git grep --no-index` if `git grep` + is executed outside of a git repository. Defaults to `false`.
Documentation/config/gui.adoc +1 -1
@@ -41,7 +41,7 @@ gui.spellingDictionary:: off. gui.fastCopyBlame:: - If true, 'git gui blame' uses `-C` instead of `-C -C` for original + If `true`, 'git gui blame' uses `-C` instead of `-C -C` for original location detection. It makes blame significantly faster on huge repositories at the expense of less thorough copy detection.
Documentation/config/http.adoc +4 -4
@@ -64,7 +64,7 @@ http.emptyAuth:: http.proactiveAuth:: Attempt authentication without first making an unauthenticated attempt and receiving a 401 response. This can be used to ensure that all requests are - authenticated. If `http.emptyAuth` is set to true, this value has no effect. + authenticated. If `http.emptyAuth` is set to `true`, this value has no effect. + If the credential helper used specifies an authentication scheme (i.e., via the `authtype` field), that value will be used; if a username and password is
@@ -182,7 +182,7 @@ empty string. http.sslVerify:: Whether to verify the SSL certificate when fetching or pushing - over HTTPS. Defaults to true. Can be overridden by the + over HTTPS. Defaults to `true`. Can be overridden by the `GIT_SSL_NO_VERIFY` environment variable. http.sslCert::
@@ -260,7 +260,7 @@ http.sslTry:: when connecting via regular FTP protocol. This might be needed if the FTP server requires it for security reasons or you wish to connect securely whenever remote FTP server supports it. - Default is false since it might trigger certificate verification + Default is `false` since it might trigger certificate verification errors on misconfigured servers. http.maxRequests::
@@ -319,7 +319,7 @@ http.noEPSV:: A boolean which disables using of EPSV ftp command by curl. This can be helpful with some "poor" ftp servers which don't support EPSV mode. Can be overridden by the `GIT_CURL_FTP_NO_EPSV` - environment variable. Default is false (curl will use EPSV). + environment variable. Default is `false` (curl will use EPSV). http.userAgent:: The HTTP USER_AGENT string presented to an HTTP server. The default
Documentation/config/instaweb.adoc +1 -1
@@ -7,7 +7,7 @@ instaweb.httpd:: repository. See linkgit:git-instaweb[1]. instaweb.local:: - If true the web server started by linkgit:git-instaweb[1] will + If `true` the web server started by linkgit:git-instaweb[1] will be bound to the local IP (127.0.0.1). instaweb.modulePath::
Documentation/config/interactive.adoc +1 -1
@@ -1,5 +1,5 @@ interactive.singleKey:: - When set to true, allow the user to provide one-letter input + When set to `true`, allow the user to provide one-letter input with a single key (i.e., without hitting the Enter key) in interactive commands. This is currently used by the `--patch` mode of linkgit:git-add[1], linkgit:git-checkout[1],
Documentation/config/log.adoc +3 -3
@@ -61,16 +61,16 @@ This is the same as the `--decorate` option of the `git log`. history lines in `git log --graph`. `log.showRoot`:: - If true, the initial commit will be shown as a big creation event. + If `true`, the initial commit will be shown as a big creation event. This is equivalent to a diff against an empty tree. Tools like linkgit:git-log[1] or linkgit:git-whatchanged[1], which normally hide the root commit will now show it. True by default. `log.showSignature`:: - If true, makes linkgit:git-log[1], linkgit:git-show[1], and + If `true`, makes linkgit:git-log[1], linkgit:git-show[1], and linkgit:git-whatchanged[1] assume `--show-signature`. `log.mailmap`:: - If true, makes linkgit:git-log[1], linkgit:git-show[1], and + If `true`, makes linkgit:git-log[1], linkgit:git-show[1], and linkgit:git-whatchanged[1] assume `--use-mailmap`, otherwise assume `--no-use-mailmap`. True by default.
Documentation/config/mailinfo.adoc +1 -1
@@ -1,5 +1,5 @@ mailinfo.scissors:: - If true, makes linkgit:git-mailinfo[1] (and therefore + If `true`, makes linkgit:git-mailinfo[1] (and therefore linkgit:git-am[1]) act by default as if the --scissors option was provided on the command-line. When active, this feature removes everything from the message body before a scissors
Documentation/config/maintenance.adoc +3 -3
@@ -1,7 +1,7 @@ maintenance.auto:: This boolean config option controls whether some commands run `git maintenance run --auto` after doing their normal work. Defaults - to true. + to `true`. maintenance.autoDetach:: Many Git commands trigger automatic maintenance after they have
@@ -11,7 +11,7 @@ maintenance.autoDetach:: continue to run in the background. + If unset, the value of `gc.autoDetach` is used as a fallback. Defaults -to true if both are unset, meaning that the maintenance process will +to `true` if both are unset, meaning that the maintenance process will detach. maintenance.strategy::
@@ -52,7 +52,7 @@ maintenance.<task>.enabled:: with name `<task>` is run when no `--task` option is specified to `git maintenance run`. These config values are ignored if a `--task` option exists. By default, only `maintenance.gc.enabled` - is true. + is `true`. maintenance.<task>.schedule:: This config option controls whether or not the given `<task>` runs
Documentation/config/merge.adoc +2 -2
@@ -21,7 +21,7 @@ branches at the remote named by `branch.<current-branch>.remote` are consulted, and then they are mapped via `remote.<remote>.fetch` to their corresponding remote-tracking branches, and the tips of - these tracking branches are merged. Defaults to true. + these tracking branches are merged. Defaults to `true`. `merge.ff`:: By default, Git does not create an extra merge commit when merging
@@ -34,7 +34,7 @@ command line). `merge.verifySignatures`:: - If true, this is equivalent to the `--verify-signatures` command + If `true`, this is equivalent to the `--verify-signatures` command line option. See linkgit:git-merge[1] for details. include::fmt-merge-msg.adoc[]
Documentation/config/mergetool.adoc +1 -1
@@ -21,7 +21,7 @@ `mergetool.<tool>.trustExitCode`:: For a custom merge command, specify whether the exit code of the merge command can be used to determine whether the merge was - successful. If this is not set to true then the merge target file + successful. If this is not set to `true` then the merge target file timestamp is checked, and the merge is assumed to have been successful if the file has been updated; otherwise, the user is prompted to indicate the success of the merge.
Documentation/config/pack.adoc +15 -15
@@ -28,7 +28,7 @@ all existing objects. You can force recompression by passing the -F option to linkgit:git-repack[1]. pack.allowPackReuse:: - When true or "single", and when reachability bitmaps are + When `true` or "single", and when reachability bitmaps are enabled, pack-objects will try to send parts of the bitmapped packfile verbatim. When "multi", and when a multi-pack reachability bitmap is available, pack-objects will try to send
@@ -37,7 +37,7 @@ pack.allowPackReuse:: If only a single pack bitmap is available, and `pack.allowPackReuse` is set to "multi", reuse parts of just the bitmapped packfile. This can reduce memory and CPU usage to serve fetches, but might result in -sending a slightly larger pack. Defaults to true. +sending a slightly larger pack. Defaults to `true`. pack.island:: An extended regular expression configuring a set of delta
@@ -123,13 +123,13 @@ The minimum size allowed is limited to 1 MiB. The default is unlimited. Common unit suffixes of 'k', 'm', or 'g' are supported. pack.useBitmaps:: - When true, git will use pack bitmaps (if available) when packing + When `true`, git will use pack bitmaps (if available) when packing to stdout (e.g., during the server side of a fetch). Defaults to - true. You should not generally need to turn this off unless + `true`. You should not generally need to turn this off unless you are debugging pack bitmaps. pack.useBitmapBoundaryTraversal:: - When true, Git will use an experimental algorithm for computing + When `true`, Git will use an experimental algorithm for computing reachability queries with bitmaps. Instead of building up complete bitmaps for all of the negated tips and then OR-ing them together, consider negated tips with existing bitmaps as
@@ -146,7 +146,7 @@ particularly when there is poor bitmap coverage of the negated side of the query. pack.useSparse:: - When true, git will default to using the '--sparse' option in + When `true`, git will default to using the '--sparse' option in 'git pack-objects' when the '--revs' option is present. This algorithm only walks trees that appear in paths that introduce new objects. This can have significant performance benefits when
@@ -178,34 +178,34 @@ pack.writeBitmaps (deprecated):: This is a deprecated synonym for `repack.writeBitmaps`. pack.writeBitmapHashCache:: - When true, git will include a "hash cache" section in the bitmap + When `true`, git will include a "hash cache" section in the bitmap index (if one is written). This cache can be used to feed git's delta heuristics, potentially leading to better deltas between bitmapped and non-bitmapped objects (e.g., when serving a fetch between an older, bitmapped pack and objects that have been pushed since the last gc). The downside is that it consumes 4 - bytes per object of disk space. Defaults to true. + bytes per object of disk space. Defaults to `true`. + When writing a multi-pack reachability bitmap, no new namehashes are computed; instead, any namehashes stored in an existing bitmap are permuted into their appropriate location when writing a new bitmap. pack.writeBitmapLookupTable:: - When true, Git will include a "lookup table" section in the + When `true`, Git will include a "lookup table" section in the bitmap index (if one is written). This table is used to defer loading individual bitmaps as late as possible. This can be beneficial in repositories that have relatively large bitmap - indexes. Defaults to false. + indexes. Defaults to `false`. pack.readReverseIndex:: - When true, git will read any .rev file(s) that may be available - (see: linkgit:gitformat-pack[5]). When false, the reverse index + When `true`, git will read any .rev file(s) that may be available + (see: linkgit:gitformat-pack[5]). When `false`, the reverse index will be generated from scratch and stored in memory. Defaults to - true. + `true`. pack.writeReverseIndex:: - When true, git will write a corresponding .rev file (see: + When `true`, git will write a corresponding .rev file (see: linkgit:gitformat-pack[5]) for each new packfile that it writes in all places except for linkgit:git-fast-import[1] and in the bulk checkin mechanism. - Defaults to true. + Defaults to `true`.
Documentation/config/pull.adoc +2 -2
@@ -9,7 +9,7 @@ pull.ff:: command line). This setting overrides `merge.ff` when pulling. pull.rebase:: - When true, rebase branches on top of the fetched branch, instead + When `true`, rebase branches on top of the fetched branch, instead of merging the default branch from the default remote when "git pull" is run. See "branch.<name>.rebase" for setting this on a per-branch basis.
@@ -30,7 +30,7 @@ pull.octopus:: at once. pull.autoStash:: - When set to true, automatically create a temporary stash entry + When set to `true`, automatically create a temporary stash entry to record the local changes before the operation begins, and restore them after the operation completes. When your "git pull" rebases (instead of merges), this may be convenient, since
Documentation/config/push.adoc +1 -1
@@ -72,7 +72,7 @@ new default). -- `push.followTags`:: - If set to true, enable `--follow-tags` option by default. You + If set to `true`, enable `--follow-tags` option by default. You may override this configuration at time of push by specifying `--no-follow-tags`.
Documentation/config/rebase.adoc +9 -9
@@ -9,22 +9,22 @@ rebase.stat:: rebase. False by default. rebase.autoSquash:: - If set to true, enable the `--autosquash` option of + If set to `true`, enable the `--autosquash` option of linkgit:git-rebase[1] by default for interactive mode. This can be overridden with the `--no-autosquash` option. rebase.autoStash:: - When set to true, automatically create a temporary stash entry + When set to `true`, automatically create a temporary stash entry before the operation begins, and apply it after the operation ends. This means that you can run rebase on a dirty worktree. However, use with care: the final stash application after a successful rebase might result in non-trivial conflicts. This option can be overridden by the `--no-autostash` and `--autostash` options of linkgit:git-rebase[1]. - Defaults to false. + Defaults to `false`. rebase.updateRefs:: - If set to true enable `--update-refs` option by default. + If set to `true` enable `--update-refs` option by default. rebase.missingCommitsCheck:: If set to "warn", git rebase -i will print a warning if some
@@ -43,7 +43,7 @@ rebase.instructionFormat:: automatically have the commit hash prepended to the format. rebase.abbreviateCommands:: - If set to true, `git rebase` will use abbreviated command names in the + If set to `true`, `git rebase` will use abbreviated command names in the todo list resulting in something like this: + -------------------------------------------
@@ -60,7 +60,7 @@ instead of: ... ------------------------------------------- + -Defaults to false. +Defaults to `false`. rebase.rescheduleFailedExec:: Automatically reschedule `exec` commands that failed. This only makes
@@ -68,14 +68,14 @@ rebase.rescheduleFailedExec:: This is the same as specifying the `--reschedule-failed-exec` option. rebase.forkPoint:: - If set to false set `--no-fork-point` option by default. + If set to `false` set `--no-fork-point` option by default. rebase.rebaseMerges:: Whether and how to set the `--rebase-merges` option by default. Can be `rebase-cousins`, `no-rebase-cousins`, or a boolean. Setting to - true or to `no-rebase-cousins` is equivalent to + `true` or to `no-rebase-cousins` is equivalent to `--rebase-merges=no-rebase-cousins`, setting to `rebase-cousins` is - equivalent to `--rebase-merges=rebase-cousins`, and setting to false is + equivalent to `--rebase-merges=rebase-cousins`, and setting to `false` is equivalent to `--no-rebase-merges`. Passing `--rebase-merges` on the command line, with or without an argument, overrides any `rebase.rebaseMerges` configuration.
Documentation/config/receive.adoc +12 -12
@@ -1,16 +1,16 @@ receive.advertiseAtomic:: By default, git-receive-pack will advertise the atomic push capability to its clients. If you don't want to advertise this - capability, set this variable to false. + capability, set this variable to `false`. receive.advertisePushOptions:: - When set to true, git-receive-pack will advertise the push options + When set to `true`, git-receive-pack will advertise the push options capability to its clients. False by default. receive.autogc:: By default, git-receive-pack will run "git maintenance run --auto" after receiving data from git-push and updating refs. You can stop - it by setting this variable to false. + it by setting this variable to `false`. receive.certNonceSeed:: By setting this variable to a string, `git receive-pack`
@@ -32,9 +32,9 @@ receive.certNonceSlop:: can check `GIT_PUSH_CERT_NONCE_STATUS` is `OK`. receive.fsckObjects:: - If it is set to true, git-receive-pack will check all received + If it is set to `true`, git-receive-pack will check all received objects. See `transfer.fsckObjects` for what's checked. - Defaults to false. If not set, the value of + Defaults to `false`. If not set, the value of `transfer.fsckObjects` is used instead. receive.fsck.<msg-id>::
@@ -75,20 +75,20 @@ receive.maxInputSize:: is unlimited. receive.denyDeletes:: - If set to true, git-receive-pack will deny a ref update that deletes + If set to `true`, git-receive-pack will deny a ref update that deletes the ref. Use this to prevent such a ref deletion via a push. receive.denyDeleteCurrent:: - If set to true, git-receive-pack will deny a ref update that + If set to `true`, git-receive-pack will deny a ref update that deletes the currently checked out branch of a non-bare repository. receive.denyCurrentBranch:: - If set to true or "refuse", git-receive-pack will deny a ref update + If set to `true` or "refuse", git-receive-pack will deny a ref update to the currently checked out branch of a non-bare repository. Such a push is potentially dangerous because it brings the HEAD out of sync with the index and working tree. If set to "warn", print a warning of such a push to stderr, but allow the push to - proceed. If set to false or "ignore", allow such pushes with no + proceed. If set to `false` or "ignore", allow such pushes with no message. Defaults to "refuse". + Another option is "updateInstead" which will update the working
@@ -103,7 +103,7 @@ the index have any difference from the HEAD, but the `push-to-checkout` hook can be used to customize this. See linkgit:githooks[5]. receive.denyNonFastForwards:: - If set to true, git-receive-pack will deny a ref update which is + If set to `true`, git-receive-pack will deny a ref update which is not a fast-forward. Use this to prevent such an update via a push, even if that push is forced. This configuration variable is set when initializing a shared repository.
@@ -137,9 +137,9 @@ E.g.: git config --system --add receive.procReceiveRefs !:refs/heads receive.updateServerInfo:: - If set to true, git-receive-pack will run git-update-server-info + If set to `true`, git-receive-pack will run git-update-server-info after receiving data from git-push and updating refs. receive.shallowUpdate:: - If set to true, .git/shallow can be updated when new refs + If set to `true`, .git/shallow can be updated when new refs require new shallow roots. Otherwise those refs are rejected.
Documentation/config/remote.adoc +5 -5
@@ -38,7 +38,7 @@ remote.<name>.push:: linkgit:git-push[1]. remote.<name>.mirror:: - If true, pushing to this remote will automatically behave + If `true`, pushing to this remote will automatically behave as if the `--mirror` option was given on the command line. remote.<name>.skipDefaultUpdate::
@@ -47,7 +47,7 @@ remote.<name>.skipDefaultUpdate:: values, the value of the last occurrence will be used). remote.<name>.skipFetchAll:: - If true, this remote will be skipped when updating + If `true`, this remote will be skipped when updating using linkgit:git-fetch[1], the `update` subcommand of linkgit:git-remote[1], and ignored by the prefetch task of `git maintenance`.
@@ -73,13 +73,13 @@ remote.<name>.vcs:: the remote with the git-remote-<vcs> helper. remote.<name>.prune:: - When set to true, fetching from this remote by default will also + When set to `true`, fetching from this remote by default will also remove any remote-tracking references that no longer exist on the remote (as if the `--prune` option was given on the command line). Overrides `fetch.prune` settings, if any. remote.<name>.pruneTags:: - When set to true, fetching from this remote by default will also + When set to `true`, fetching from this remote by default will also remove any local tags that no longer exist on the remote if pruning is activated in general via `remote.<name>.prune`, `fetch.prune` or `--prune`. Overrides `fetch.pruneTags` settings, if any.
@@ -88,7 +88,7 @@ See also `remote.<name>.prune` and the PRUNING section of linkgit:git-fetch[1]. remote.<name>.promisor:: - When set to true, this remote will be used to fetch promisor + When set to `true`, this remote will be used to fetch promisor objects. remote.<name>.partialclonefilter::
Documentation/config/repack.adoc +10 -10
@@ -7,29 +7,29 @@ repack.useDeltaBaseOffset:: native protocol are unaffected by this option. repack.packKeptObjects:: - If set to true, makes `git repack` act as if + If set to `true`, makes `git repack` act as if `--pack-kept-objects` was passed. See linkgit:git-repack[1] for details. Defaults to `false` normally, but `true` if a bitmap index is being written (either via `--write-bitmap-index` or `repack.writeBitmaps`). repack.useDeltaIslands:: - If set to true, makes `git repack` act as if `--delta-islands` + If set to `true`, makes `git repack` act as if `--delta-islands` was passed. Defaults to `false`. repack.writeBitmaps:: - When true, git will write a bitmap index when packing all + When `true`, git will write a bitmap index when packing all objects to disk (e.g., when `git repack -a` is run). This index can speed up the "counting objects" phase of subsequent packs created for clones and fetches, at the cost of some disk space and extra time spent on the initial repack. This has no effect if multiple packfiles are created. - Defaults to true on bare repos, false otherwise. + Defaults to `true` on bare repos, `false` otherwise. repack.updateServerInfo:: - If set to false, linkgit:git-repack[1] will not run - linkgit:git-update-server-info[1]. Defaults to true. Can be overridden - when true by the `-n` option of linkgit:git-repack[1]. + If set to `false`, linkgit:git-repack[1] will not run + linkgit:git-update-server-info[1]. Defaults to `true`. Can be overridden + when `true` by the `-n` option of linkgit:git-repack[1]. repack.cruftWindow:: repack.cruftWindowMemory::
@@ -41,8 +41,8 @@ repack.cruftThreads:: variables for defaults and meaning. repack.midxMustContainCruft:: - When set to true, linkgit:git-repack[1] will unconditionally include + When set to `true`, linkgit:git-repack[1] will unconditionally include cruft pack(s), if any, in the multi-pack index when invoked with - `--write-midx`. When false, cruft packs are only included in the MIDX + `--write-midx`. When `false`, cruft packs are only included in the MIDX when necessary (e.g., because they might be required to form a - reachability closure with MIDX bitmaps). Defaults to true. + reachability closure with MIDX bitmaps). Defaults to `true`.
Documentation/config/rerere.adoc +2 -2
@@ -1,7 +1,7 @@ rerere.autoUpdate:: - When set to true, `git-rerere` updates the index with the + When set to `true`, `git-rerere` updates the index with the resulting contents after it cleanly resolves conflicts using - previously recorded resolutions. Defaults to false. + previously recorded resolutions. Defaults to `false`. rerere.enabled:: Activate recording of resolved conflicts, so that identical
Documentation/config/revert.adoc +1 -1
@@ -1,3 +1,3 @@ revert.reference:: - Setting this variable to true makes `git revert` behave + Setting this variable to `true` makes `git revert` behave as if the `--reference` option is given.
Documentation/config/stash.adoc +8 -8
@@ -7,8 +7,8 @@ ifdef::git-stash[] endif::git-stash[] `stash.index`:: - If this is set to true, `git stash apply` and `git stash pop` will - behave as if `--index` was supplied. Defaults to false. + If this is set to `true`, `git stash apply` and `git stash pop` will + behave as if `--index` was supplied. Defaults to `false`. ifndef::git-stash[] See the descriptions in linkgit:git-stash[1]. +
@@ -18,15 +18,15 @@ linkgit:git-pull[1]. endif::git-stash[] `stash.showIncludeUntracked`:: - If this is set to true, the `git stash show` command will show - the untracked files of a stash entry. Defaults to false. {see-show} + If this is set to `true`, the `git stash show` command will show + the untracked files of a stash entry. Defaults to `false`. {see-show} `stash.showPatch`:: - If this is set to true, the `git stash show` command without an - option will show the stash entry in patch form. Defaults to false. + If this is set to `true`, the `git stash show` command without an + option will show the stash entry in patch form. Defaults to `false`. {see-show} `stash.showStat`:: - If this is set to true, the `git stash show` command without an - option will show a diffstat of the stash entry. Defaults to true. + If this is set to `true`, the `git stash show` command without an + option will show a diffstat of the stash entry. Defaults to `true`. {see-show}
Documentation/config/status.adoc +10 -10
@@ -5,24 +5,24 @@ status.relativePaths:: prior to v1.5.4). status.short:: - Set to true to enable --short by default in linkgit:git-status[1]. + Set to `true` to enable --short by default in linkgit:git-status[1]. The option --no-short takes precedence over this variable. status.branch:: - Set to true to enable --branch by default in linkgit:git-status[1]. + Set to `true` to enable --branch by default in linkgit:git-status[1]. The option --no-branch takes precedence over this variable. status.aheadBehind:: - Set to true to enable `--ahead-behind` and false to enable + Set to `true` to enable `--ahead-behind` and `false` to enable `--no-ahead-behind` by default in linkgit:git-status[1] for - non-porcelain status formats. Defaults to true. + non-porcelain status formats. Defaults to `true`. status.displayCommentPrefix:: - If set to true, linkgit:git-status[1] will insert a comment + If set to `true`, linkgit:git-status[1] will insert a comment prefix before each output line (starting with `core.commentChar`, i.e. `#` by default). This was the behavior of linkgit:git-status[1] in Git 1.8.4 and previous. - Defaults to false. + Defaults to `false`. status.renameLimit:: The number of files to consider when performing rename detection
@@ -37,9 +37,9 @@ status.renames:: Defaults to the value of diff.renames. status.showStash:: - If set to true, linkgit:git-status[1] will display the number of + If set to `true`, linkgit:git-status[1] will display the number of entries currently stashed away. - Defaults to false. + Defaults to `false`. status.showUntrackedFiles:: By default, linkgit:git-status[1] and linkgit:git-commit[1] show
@@ -63,8 +63,8 @@ This variable can be overridden with the -u|--untracked-files option of linkgit:git-status[1] and linkgit:git-commit[1]. status.submoduleSummary:: - Defaults to false. - If this is set to a non-zero number or true (identical to -1 or an + Defaults to `false`. + If this is set to a non-zero number or `true` (identical to -1 or an unlimited number), the submodule summary will be enabled and a summary of commits for modified submodules will be shown (see --summary-limit option of linkgit:git-submodule[1]). Please note
Documentation/config/submodule.adoc +3 -3
@@ -66,9 +66,9 @@ submodule.active:: submodule.recurse:: A boolean indicating if commands should enable the `--recurse-submodules` - option by default. Defaults to false. + option by default. Defaults to `false`. + -When set to true, it can be deactivated via the +When set to `true`, it can be deactivated via the `--no-recurse-submodules` option. Note that some Git commands lacking this option may call some of the above commands affected by `submodule.recurse`; for instance `git remote update` will call
@@ -92,7 +92,7 @@ submodule.propagateBranches:: Enabling this will allow certain commands to accept `--recurse-submodules` and certain commands that already accept `--recurse-submodules` will now consider branches. - Defaults to false. + Defaults to `false`. submodule.fetchJobs:: Specifies how many submodules are fetched/cloned at the same time.
Documentation/config/trace2.adoc +7 -7
@@ -20,19 +20,19 @@ trace2.eventTarget:: include::../trace2-target-values.adoc[] trace2.normalBrief:: - Boolean. When true `time`, `filename`, and `line` fields are + Boolean. When `true` `time`, `filename`, and `line` fields are omitted from normal output. May be overridden by the - `GIT_TRACE2_BRIEF` environment variable. Defaults to false. + `GIT_TRACE2_BRIEF` environment variable. Defaults to `false`. trace2.perfBrief:: - Boolean. When true `time`, `filename`, and `line` fields are + Boolean. When `true` `time`, `filename`, and `line` fields are omitted from PERF output. May be overridden by the - `GIT_TRACE2_PERF_BRIEF` environment variable. Defaults to false. + `GIT_TRACE2_PERF_BRIEF` environment variable. Defaults to `false`. trace2.eventBrief:: - Boolean. When true `time`, `filename`, and `line` fields are + Boolean. When `true` `time`, `filename`, and `line` fields are omitted from event output. May be overridden by the - `GIT_TRACE2_EVENT_BRIEF` environment variable. Defaults to false. + `GIT_TRACE2_EVENT_BRIEF` environment variable. Defaults to `false`. trace2.eventNesting:: Integer. Specifies desired depth of nested regions in the
@@ -58,7 +58,7 @@ trace2.envVars:: default. trace2.destinationDebug:: - Boolean. When true Git will print error messages when a + Boolean. When `true` Git will print error messages when a trace target destination cannot be opened for writing. By default, these errors are suppressed and tracing is silently disabled. May be overridden by the
Documentation/config/transfer.adoc +4 -4
@@ -39,7 +39,7 @@ data in git's configuration files. If you do want to use this, set transfer.fsckObjects:: When `fetch.fsckObjects` or `receive.fsckObjects` are not set, the value of this variable is used instead. - Defaults to false. + Defaults to `false`. + When set, the fetch or receive will abort in the case of a malformed object or a link to a nonexistent object. In addition, various other
@@ -113,8 +113,8 @@ transfer.unpackLimit:: The default value is 100. transfer.advertiseSID:: - Boolean. When true, client and server processes will advertise their - unique session IDs to their remote counterpart. Defaults to false. + Boolean. When `true`, client and server processes will advertise their + unique session IDs to their remote counterpart. Defaults to `false`. transfer.bundleURI:: When `true`, local `git clone` commands will request bundle
@@ -124,4 +124,4 @@ transfer.bundleURI:: transfer.advertiseObjectInfo:: When `true`, the `object-info` capability is advertised by - servers. Defaults to false. + servers. Defaults to `false`.
Documentation/config/uploadarchive.adoc +1 -1
@@ -1,5 +1,5 @@ uploadarchive.allowUnreachable:: - If true, allow clients to use `git archive --remote` to request + If `true`, allow clients to use `git archive --remote` to request any tree, whether reachable from the ref tips or not. See the discussion in the "SECURITY" section of linkgit:git-upload-archive[1] for more details. Defaults to
Documentation/config/worktree.adoc +1 -1
@@ -2,7 +2,7 @@ If no branch is specified and neither `-b` nor `-B` nor `--detach` is used, then `git worktree add` defaults to creating a new branch from HEAD. If `worktree.guessRemote` is - set to true, `worktree add` tries to find a remote-tracking + set to `true`, `worktree add` tries to find a remote-tracking branch whose name uniquely matches the new branch name. If such a branch exists, it is checked out and set as "upstream" for the new branch. If no such match can be found, it falls
base-commit: 7c02d39fc2ed2702223c7674f73150d9a7e61ba4
Signature · 1 line
gitgitgadget