Documentation/git-status.txt

   1 git-status(1)
   2 =============
   3
   4 NAME
   5 ----
   6 git-status - Show the working tree status
   7
   8
   9 SYNOPSIS
  10 --------
  11 'git-status' <options>...
  12
  13 DESCRIPTION
  14 -----------
  15 Examines paths in the working tree that has changes unrecorded
  16 to the index file, and changes between the index file and the
  17 current HEAD commit.  The former paths are what you _could_
  18 commit by running 'git add' before running 'git
  19 commit', and the latter paths are what you _would_ commit by
  20 running 'git commit'.
  21
  22 If there is no path that is different between the index file and
  23 the current HEAD commit, the command exits with non-zero
  24 status.
  25
  26 The command takes the same set of options as `git-commit`; it
  27 shows what would be committed if the same options are given to
  28 `git-commit`.
  29
  30
  31 OUTPUT
  32 ------
  33 The output from this command is designed to be used as a commit
  34 template comments, and all the output lines are prefixed with '#'.
  35
  36
  37 CONFIGURATION
  38 -------------
  39
  40 The command honors `color.status` (or `status.color` -- they
  41 mean the same thing and the latter is kept for backward
  42 compatibility) and `color.status.<slot>` configuration variables
  43 to colorize its output.
  44
  45 As for gitlink:git-add[1], the configuration variable
  46 'core.excludesfile' can indicate a path to a file containing patterns
  47 of file names to exclude, in addition to patterns given in
  48 'info/exclude' and '.gitignore'.
  49
  50
  51 Author
  52 ------
  53 Written by Linus Torvalds <torvalds@osdl.org> and
  54 Junio C Hamano <junkio@cox.net>.
  55
  56 Documentation
  57 --------------
  58 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
  59
  60 GIT
  61 ---
  62 Part of the gitlink:git[7] suite
  63