| blob | 9ce68e5e274d74ee4194328534fe3ec37ccac854 |
4 <head>
9 /* Debug borders */
11 /*
12 border: 1px solid red;
13 */
14 }
16 body {
18 }
20 a {
23 }
26 }
28 em {
31 }
33 strong {
36 }
38 tt {
40 }
48 }
52 }
53 h2 {
55 }
56 h3 {
58 }
59 h3 + * {
61 }
66 }
68 hr {
70 }
72 p {
75 }
79 }
81 pre {
84 }
86 span#author {
91 }
92 span#email {
93 }
96 }
98 div#footer {
104 }
105 div#footer-text {
108 }
109 div#footer-badges {
112 }
114 div#preamble {
117 }
123 }
127 }
131 }
133 /* Block element titles. */
141 }
144 }
148 }
151 }
154 }
160 }
166 }
171 }
175 }
180 }
183 }
187 }
188 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
191 }
200 }
204 }
209 }
215 dl {
218 }
219 dt {
224 }
227 }
231 }
234 }
237 }
240 }
243 }
246 }
253 }
257 }
258 thead {
261 }
262 tfoot {
264 }
267 }
270 }
271 /* Because the table frame attribute is overriden by CSS in most browsers. */
274 }
278 }
282 }
288 }
291 }
294 }
300 }
303 }
307 }
311 }
315 }
317 div#toctitle {
324 }
329 }
333 }
337 }
341 }
342 /* Overrides for manpage documents */
343 h1 {
348 }
349 h2 {
351 }
354 }
358 }
360 /* Workarounds for IE6's broken and incomplete CSS2. */
366 }
373 }
379 }
384 }
388 }
392 }
397 }
399 /* IE6 sets dynamically generated links as visited. */
401 </style>
402 </head>
403 <body>
405 <h1>
406 git-status(1) Manual Page
407 </h1>
410 <p>git-status -
411 Show the working tree status
412 </p>
413 </div>
414 </div>
417 <div class="paragraph"><p><em>git status</em> [<options>…] [--] [<pathspec>…]</p></div>
418 </div>
422 current HEAD commit, paths that have differences between the working
423 tree and the index file, and paths in the working tree that are not
428 </div>
433 -s
434 </dt>
436 --short
437 </dt>
438 <dd>
439 <p>
440 Give the output in the short-format.
441 </p>
442 </dd>
444 -b
445 </dt>
447 --branch
448 </dt>
449 <dd>
450 <p>
451 Show the branch and tracking info even in short-format.
452 </p>
453 </dd>
455 --porcelain
456 </dt>
457 <dd>
458 <p>
459 Give the output in a stable, easy-to-parse format for scripts.
460 Currently this is identical to --short output, but is guaranteed
461 not to change in the future, making it safe for scripts.
462 </p>
463 </dd>
466 </dt>
469 </dt>
470 <dd>
471 <p>
472 Show untracked files.
473 </p>
474 <div class="paragraph"><p>The mode parameter is optional (defaults to <em>all</em>), and is used to
475 specify the handling of untracked files; when -u is not used, the
479 <li>
480 <p>
482 </p>
483 </li>
484 <li>
485 <p>
487 </p>
488 </li>
489 <li>
490 <p>
492 </p>
495 </li>
496 </ul></div>
497 </dd>
500 </dt>
501 <dd>
502 <p>
505 Using "none" will consider the submodule modified when it either contains
506 untracked or modified files or its HEAD differs from the commit recorded
507 in the superproject and can be used to override any settings of the
508 <em>ignore</em> option in <a href="git-config.html">git-config(1)</a> or <a href="gitmodules.html">gitmodules(5)</a>. When
509 "untracked" is used submodules are not considered dirty when they only
510 contain untracked content (but they are still scanned for modified
511 content). Using "dirty" ignores all changes to the work tree of submodules,
512 only changes to the commits stored in the superproject are shown (this was
514 (and suppresses the output of submodule summaries when the config option
516 </p>
517 </dd>
519 -z
520 </dt>
521 <dd>
522 <p>
523 Terminate entries with NUL, instead of LF. This implies
525 </p>
526 </dd>
527 </dl></div>
528 </div>
533 The default, long format, is designed to be human readable,
534 verbose and descriptive. They are subject to change in any time.</p></div>
535 <div class="paragraph"><p>The paths mentioned in the output, unlike many other git commands, are
536 made relative to the current directory if you are working in a
537 subdirectory (this is on purpose, to help cutting and pasting). See
538 the status.relativePaths config option below.</p></div>
543 </div></div>
544 <div class="paragraph"><p>where <tt>PATH1</tt> is the path in the <tt>HEAD</tt>, and ` → PATH2` part is
547 status code.</p></div>
548 <div class="paragraph"><p>The fields (including the <tt>→</tt>) are separated from each other by a
549 single space. If a filename contains whitespace or other nonprintable
550 characters, that field will be quoted in the manner of a C string
551 literal: surrounded by ASCII double quote (34) characters, and with
552 interior special characters backslash-escaped.</p></div>
553 <div class="paragraph"><p>For paths with merge conflicts, <tt>X</tt> and <em>Y</em> show the modification
554 states of each side of the merge. For paths that do not have merge
557 codes can be interpreted as follows:</p></div>
559 <li>
560 <p>
561 ' ' = unmodified
562 </p>
563 </li>
564 <li>
565 <p>
567 </p>
568 </li>
569 <li>
570 <p>
572 </p>
573 </li>
574 <li>
575 <p>
577 </p>
578 </li>
579 <li>
580 <p>
582 </p>
583 </li>
584 <li>
585 <p>
587 </p>
588 </li>
589 <li>
590 <p>
592 </p>
593 </li>
594 </ul></div>
598 <pre><tt>X Y Meaning
599 -------------------------------------------------
600 [MD] not updated
601 M [ MD] updated in index
602 A [ MD] added to index
603 D [ M] deleted from index
604 R [ MD] renamed in index
605 C [ MD] copied in index
606 [MARC] index and work tree matches
607 [ MARC] M work tree changed since index
608 [ MARC] D deleted in work tree
609 -------------------------------------------------
610 D D unmerged, both deleted
611 A U unmerged, added by us
612 U D unmerged, deleted by them
613 U A unmerged, added by them
614 D U unmerged, deleted by us
615 A A unmerged, both added
616 U U unmerged, both modified
617 -------------------------------------------------
618 ? ? untracked
619 -------------------------------------------------</tt></pre>
620 </div></div>
624 that format, the status field is the same, but some other things
627 (ASCII 0) follows each filename, replacing space as a field separator
628 and the terminating newline (but a space still separates the status
629 field from the first filename). Third, filenames containing special
630 characters are not specially formatted; no quoting or
631 backslash-escaping is performed. Fourth, there is no branch line.</p></div>
632 </div>
635 <div class="paragraph"><p>The command honors <tt>color.status</tt> (or <tt>status.color</tt> — they
636 mean the same thing and the latter is kept for backward
638 to colorize its output.</p></div>
639 <div class="paragraph"><p>If the config variable <tt>status.relativePaths</tt> is set to false, then all
640 paths shown are relative to the repository root, not to the current
641 directory.</p></div>
642 <div class="paragraph"><p>If <tt>status.submodulesummary</tt> is set to a non zero number or true (identical
643 to -1 or an unlimited number), the submodule summary will be enabled for
644 the long format and a summary of commits for modified submodules will be
645 shown (see --summary-limit option of <a href="git-submodule.html">git-submodule(1)</a>).</p></div>
646 </div>
650 </div>
654 </div>
658 </div>
659 </div>
660 </body>
661 </html>