]> git.ipfire.org Git - thirdparty/git.git/blob - Documentation/config/status.txt
Git 2.20.3
[thirdparty/git.git] / Documentation / config / status.txt
1 status.relativePaths::
2 By default, linkgit:git-status[1] shows paths relative to the
3 current directory. Setting this variable to `false` shows paths
4 relative to the repository root (this was the default for Git
5 prior to v1.5.4).
6
7 status.short::
8 Set to true to enable --short by default in linkgit:git-status[1].
9 The option --no-short takes precedence over this variable.
10
11 status.branch::
12 Set to true to enable --branch by default in linkgit:git-status[1].
13 The option --no-branch takes precedence over this variable.
14
15 status.displayCommentPrefix::
16 If set to true, linkgit:git-status[1] will insert a comment
17 prefix before each output line (starting with
18 `core.commentChar`, i.e. `#` by default). This was the
19 behavior of linkgit:git-status[1] in Git 1.8.4 and previous.
20 Defaults to false.
21
22 status.renameLimit::
23 The number of files to consider when performing rename detection
24 in linkgit:git-status[1] and linkgit:git-commit[1]. Defaults to
25 the value of diff.renameLimit.
26
27 status.renames::
28 Whether and how Git detects renames in linkgit:git-status[1] and
29 linkgit:git-commit[1] . If set to "false", rename detection is
30 disabled. If set to "true", basic rename detection is enabled.
31 If set to "copies" or "copy", Git will detect copies, as well.
32 Defaults to the value of diff.renames.
33
34 status.showStash::
35 If set to true, linkgit:git-status[1] will display the number of
36 entries currently stashed away.
37 Defaults to false.
38
39 status.showUntrackedFiles::
40 By default, linkgit:git-status[1] and linkgit:git-commit[1] show
41 files which are not currently tracked by Git. Directories which
42 contain only untracked files, are shown with the directory name
43 only. Showing untracked files means that Git needs to lstat() all
44 the files in the whole repository, which might be slow on some
45 systems. So, this variable controls how the commands displays
46 the untracked files. Possible values are:
47 +
48 --
49 * `no` - Show no untracked files.
50 * `normal` - Show untracked files and directories.
51 * `all` - Show also individual files in untracked directories.
52 --
53 +
54 If this variable is not specified, it defaults to 'normal'.
55 This variable can be overridden with the -u|--untracked-files option
56 of linkgit:git-status[1] and linkgit:git-commit[1].
57
58 status.submoduleSummary::
59 Defaults to false.
60 If this is set to a non zero number or true (identical to -1 or an
61 unlimited number), the submodule summary will be enabled and a
62 summary of commits for modified submodules will be shown (see
63 --summary-limit option of linkgit:git-submodule[1]). Please note
64 that the summary output command will be suppressed for all
65 submodules when `diff.ignoreSubmodules` is set to 'all' or only
66 for those submodules where `submodule.<name>.ignore=all`. The only
67 exception to that rule is that status and commit will show staged
68 submodule changes. To
69 also view the summary for ignored submodules you can either use
70 the --ignore-submodules=dirty command-line option or the 'git
71 submodule summary' command, which shows a similar output but does
72 not honor these settings.