X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-status.txt;h=84f60f3407499c40a8e0caadf9d40ed5e9b8386b;hb=40bad52d7d559177e373127f50c7bb3a19d56d85;hp=b0cb6bc8b74158f3c9012b6f2d0f10f8f9e5bae9;hpb=9f6f4e0bc2700a631c5fee3fb6b7c98d20b04589;p=git.git diff --git a/Documentation/git-status.txt b/Documentation/git-status.txt index b0cb6bc8b..84f60f340 100644 --- a/Documentation/git-status.txt +++ b/Documentation/git-status.txt @@ -8,41 +8,36 @@ git-status - Show the working tree status SYNOPSIS -------- -'git-status' ... +'git status' ... DESCRIPTION ----------- -Examines paths in the working tree that has changes unrecorded -to the index file, and changes between the index file and the -current HEAD commit. The former paths are what you _could_ -commit by running 'git add' before running 'git -commit', and the latter paths are what you _would_ commit by -running 'git commit'. - -If there is no path that is different between the index file and -the current HEAD commit, the command exits with non-zero -status. - -The command takes the same set of options as `git-commit`; it +Displays paths that have differences between the index file and the +current HEAD commit, paths that have differences between the working +tree and the index file, and paths in the working tree that are not +tracked by git (and are not ignored by linkgit:gitignore[5]). The first +are what you _would_ commit by running `git commit`; the second and +third are what you _could_ commit by running 'git-add' before running +`git commit`. + +The command takes the same set of options as 'git-commit'; it shows what would be committed if the same options are given to -`git-commit`. +'git-commit'. -If any paths have been touched in the working tree (that is, -their modification times have changed) but their contents and -permissions are identical to those in the index file, the command -updates the index file. Running `git-status` can thus speed up -subsequent operations such as `git-diff` if the working tree -contains many paths that have been touched but not modified. +If there is no path that is different between the index file and +the current HEAD commit (i.e., there is nothing to commit by running +`git commit`), the command exits with non-zero status. OUTPUT ------ The output from this command is designed to be used as a commit -template comments, and all the output lines are prefixed with '#'. +template comment, and all the output lines are prefixed with '#'. The paths mentioned in the output, unlike many other git commands, are -made relative to the current directory, if you are working in a -subdirectory (this is on purpose, to help cutting and pasting). +made relative to the current directory if you are working in a +subdirectory (this is on purpose, to help cutting and pasting). See +the status.relativePaths config option below. CONFIGURATION @@ -53,14 +48,23 @@ mean the same thing and the latter is kept for backward compatibility) and `color.status.` configuration variables to colorize its output. -See Also +If the config variable `status.relativePaths` is set to false, then all +paths shown are relative to the repository root, not to the current +directory. + +If `status.submodulesummary` 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]). + +SEE ALSO -------- -gitlink:gitignore[5] +linkgit:gitignore[5] Author ------ Written by Linus Torvalds and -Junio C Hamano . +Junio C Hamano . Documentation -------------- @@ -68,4 +72,4 @@ Documentation by David Greaves, Junio C Hamano and the git-list