doc/source/en/TortoiseGit/git_doc/git-status.html.xml

   1 <?xml version="1.0" encoding="UTF-8"?>\r
   2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">\r
   3 \r
   4 <article lang="en" id="git-status(1)">\r
   5 <articleinfo>\r
   6     <title>git-status(1)</title>\r
   7         <indexterm>\r
   8                 <primary>git-status(1)</primary>\r
   9         </indexterm>\r
  10 </articleinfo>\r
  11 <simplesect id="_name">\r
  12 <title>NAME</title>\r
  13 <simpara>git-status - Show the working tree status</simpara>\r
  14 </simplesect>\r
  15 <simplesect id="_synopsis">\r
  16 <title>SYNOPSIS</title>\r
  17 <simpara><emphasis>git status</emphasis> &lt;options&gt;&#8230;</simpara>\r
  18 </simplesect>\r
  19 <simplesect id="_description">\r
  20 <title>DESCRIPTION</title>\r
  21 <simpara>Displays paths that have differences between the index file and the\r
  22 current HEAD commit, paths that have differences between the working\r
  23 tree and the index file, and paths in the working tree that are not\r
  24 tracked by git (and are not ignored by <xref linkend="gitignore(5)"/>). The first\r
  25 are what you <emphasis>would</emphasis> commit by running <literal>git commit</literal>; the second and\r
  26 third are what you <emphasis>could</emphasis> commit by running <emphasis>git-add</emphasis> before running\r
  27 <literal>git commit</literal>.</simpara>\r
  28 <simpara>The command takes the same set of options as <emphasis>git-commit</emphasis>; it\r
  29 shows what would be committed if the same options are given to\r
  30 <emphasis>git-commit</emphasis>.</simpara>\r
  31 <simpara>If there is no path that is different between the index file and\r
  32 the current HEAD commit (i.e., there is nothing to commit by running\r
  33 <literal>git commit</literal>), the command exits with non-zero status.</simpara>\r
  34 </simplesect>\r
  35 <simplesect id="_output">\r
  36 <title>OUTPUT</title>\r
  37 <simpara>The output from this command is designed to be used as a commit\r
  38 template comment, and all the output lines are prefixed with <emphasis>#</emphasis>.</simpara>\r
  39 <simpara>The paths mentioned in the output, unlike many other git commands, are\r
  40 made relative to the current directory if you are working in a\r
  41 subdirectory (this is on purpose, to help cutting and pasting). See\r
  42 the status.relativePaths config option below.</simpara>\r
  43 </simplesect>\r
  44 <simplesect id="_configuration">\r
  45 <title>CONFIGURATION</title>\r
  46 <simpara>The command honors <literal>color.status</literal> (or <literal>status.color</literal>&#8201;&#8212;&#8201;they\r
  47 mean the same thing and the latter is kept for backward\r
  48 compatibility) and <literal>color.status.&lt;slot&gt;</literal> configuration variables\r
  49 to colorize its output.</simpara>\r
  50 <simpara>If the config variable <literal>status.relativePaths</literal> is set to false, then all\r
  51 paths shown are relative to the repository root, not to the current\r
  52 directory.</simpara>\r
  53 <simpara>If <literal>status.submodulesummary</literal> is set to a non zero number or true (identical\r
  54 to -1 or an unlimited number), the submodule summary will be enabled and a\r
  55 summary of commits for modified submodules will be shown (see --summary-limit\r
  56 option of <xref linkend="git-submodule(1)"/>).</simpara>\r
  57 </simplesect>\r
  58 <simplesect id="_see_also">\r
  59 <title>SEE ALSO</title>\r
  60 <simpara><xref linkend="gitignore(5)"/></simpara>\r
  61 </simplesect>\r
  62 <simplesect id="_author">\r
  63 <title>Author</title>\r
  64 <simpara>Written by Linus Torvalds &lt;<ulink url="mailto:torvalds@osdl.org">torvalds@osdl.org</ulink>&gt; and\r
  65 Junio C Hamano &lt;<ulink url="mailto:gitster@pobox.com">gitster@pobox.com</ulink>&gt;.</simpara>\r
  66 </simplesect>\r
  67 <simplesect id="_documentation">\r
  68 <title>Documentation</title>\r
  69 <simpara>Documentation by David Greaves, Junio C Hamano and the git-list &lt;<ulink url="mailto:git@vger.kernel.org">git@vger.kernel.org</ulink>&gt;.</simpara>\r
  70 </simplesect>\r
  71 <simplesect id="_git">\r
  72 <title>GIT</title>\r
  73 <simpara>Part of the <xref linkend="git(1)"/> suite</simpara>\r
  74 </simplesect>\r
  75 </article>\r