]>
Commit | Line | Data |
---|---|---|
215a7ad1 JH |
1 | git-status(1) |
2 | ============= | |
3f971fc4 JH |
3 | |
4 | NAME | |
5 | ---- | |
c3f0baac | 6 | git-status - Show the working tree status |
3f971fc4 JH |
7 | |
8 | ||
9 | SYNOPSIS | |
10 | -------- | |
fb6ff943 | 11 | 'git-status' <options>... |
3f971fc4 JH |
12 | |
13 | DESCRIPTION | |
14 | ----------- | |
2099bca9 JK |
15 | Displays paths that have differences between the index file and the |
16 | current HEAD commit, paths that have differences between the working | |
17 | tree and the index file, and paths in the working tree that are not | |
5162e697 | 18 | tracked by git (and are not ignored by linkgit:gitignore[5]). The first |
2099bca9 JK |
19 | are what you _would_ commit by running `git commit`; the second and |
20 | third are what you _could_ commit by running `git add` before running | |
21 | `git commit`. | |
3f971fc4 | 22 | |
fb6ff943 JH |
23 | The command takes the same set of options as `git-commit`; it |
24 | shows what would be committed if the same options are given to | |
25 | `git-commit`. | |
26 | ||
2099bca9 JK |
27 | If there is no path that is different between the index file and |
28 | the current HEAD commit (i.e., there is nothing to commit by running | |
29 | `git-commit`), the command exits with non-zero status. | |
30 | ||
3f971fc4 JH |
31 | |
32 | OUTPUT | |
33 | ------ | |
34 | The output from this command is designed to be used as a commit | |
2099bca9 | 35 | template comment, and all the output lines are prefixed with '#'. |
3f971fc4 | 36 | |
c7860507 | 37 | The paths mentioned in the output, unlike many other git commands, are |
2099bca9 | 38 | made relative to the current directory if you are working in a |
46f721c8 JK |
39 | subdirectory (this is on purpose, to help cutting and pasting). See |
40 | the status.relativePaths config option below. | |
c7860507 | 41 | |
3f971fc4 | 42 | |
31fcd63c JH |
43 | CONFIGURATION |
44 | ------------- | |
45 | ||
46 | The command honors `color.status` (or `status.color` -- they | |
47 | mean the same thing and the latter is kept for backward | |
48 | compatibility) and `color.status.<slot>` configuration variables | |
49 | to colorize its output. | |
50 | ||
46f721c8 JK |
51 | If the config variable `status.relativePaths` is set to false, then all |
52 | paths shown are relative to the repository root, not to the current | |
53 | directory. | |
54 | ||
ac8d5afc PY |
55 | If `status.submodulesummary` is set to a non zero number or true (identical |
56 | to -1 or an unlimited number), the submodule summary will be enabled and a | |
57 | summary of commits for modified submodules will be shown (see --summary-limit | |
58 | option of linkgit:git-submodule[1]). | |
59 | ||
56ae8df5 | 60 | SEE ALSO |
cedb8d5d | 61 | -------- |
5162e697 | 62 | linkgit:gitignore[5] |
31fcd63c | 63 | |
3f971fc4 JH |
64 | Author |
65 | ------ | |
66 | Written by Linus Torvalds <torvalds@osdl.org> and | |
67 | Junio C Hamano <junkio@cox.net>. | |
68 | ||
69 | Documentation | |
70 | -------------- | |
71 | Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>. | |
72 | ||
73 | GIT | |
74 | --- | |
5162e697 | 75 | Part of the linkgit:git[7] suite |