CINXE.COM
Git - git-status Documentation
<!DOCTYPE html> <html lang="fr"> <head> <script type="text/javascript"> const currentTheme = localStorage.getItem("theme") if (currentTheme) { const prefersDarkScheme = window.matchMedia("(prefers-color-scheme: dark)").matches if ((prefersDarkScheme && currentTheme === "light") || (!prefersDarkScheme && currentTheme === "dark")) { document.documentElement.dataset.theme = currentTheme } } </script> <meta charset='utf-8'> <meta content='IE=edge,chrome=1' http-equiv='X-UA-Compatible'> <meta name="viewport" content="width=device-width, initial-scale=1"> <title>Git - git-status Documentation</title> <link href="/favicon.ico" rel='shortcut icon' type='image/x-icon'> <link rel="stylesheet" href="/application.min.css"> </head> <body id="documentation"> <div class="inner"> <header> <a id="logo" href="/"><img src="/images/logo@2x.png" width="110" height="46" alt="Git" class="no-filter" /></a> <span id="tagline"></span> <script type="text/javascript"> const taglines = [ "fast-version-control", "everything-is-local", "distributed-even-if-your-workflow-isnt", "local-branching-on-the-cheap", "distributed-is-the-new-centralized" ]; var tagline = taglines[Math.floor(Math.random() * taglines.length)]; document.getElementById('tagline').innerHTML = '--' + tagline; </script> <div id="search-container"> <form id="search" action="/search/results"> <input id="search-text" name="search" placeholder="Type / to search entire site…" autocomplete="off" type="text" /> </form> <div id="search-results"></div> </div> <img src="/images/dark-mode.svg" id="dark-mode-button" /> </header> </div> <div class="inner"> <div id="content-wrapper"> <div tabindex="1" class="sidebar-btn"></div> <aside class="sidebar" id="sidebar"> <nav> <ul> <li> <a href="/about">About</a> <ul> </ul> </li> <li> <a href="/doc" class="active">Documentation</a> <ul class="expanded"> <li> <a href="/docs" class="active">Reference</a> </li> <li> <a href="/book">Book</a> </li> <li> <a href="/videos">Videos</a> </li> <li> <a href="/doc/ext">External Links</a> </li> </ul> </li> <li> <a href="/downloads">Downloads</a> <ul > <li> <a href="/downloads/guis">GUI Clients</a> </li> <li> <a href="/downloads/logos">Logos</a> </li> </ul> </li> <li> <a href="/community">Community</a> </li> </ul> </nav> </aside> <div id="content"> <div id='reference-version'> <a class="dropdown-trigger" id="reference-languages-trigger" data-panel-id="l10n-versions-dropdown" href="#"> Français ▾</a> <div class='dropdown-panel right' id='l10n-versions-dropdown'> <header>Localized versions of <strong>git-status</strong> manual</header> <ol class='reference-previous-versions'> <li> <a href="/docs/git-status"><span class="version">English</span> </a> </li> <li> <a href="/docs/git-status/fr"><span class="version">Français</span> </a> </li> <li> <a href="/docs/git-status/pt_BR"><span class="version">Português (Brasil)</span> </a> </li> <li> <a href="/docs/git-status/zh_HANS-CN"><span class="version">简体中文</span> </a> </li> </ol> <footer> Want to read in your language or fix typos?<br/> <a href="https://github.com/jnavila/git-manpages-l10n">You can help translate this page</a>. </footer> </div> <a class="dropdown-trigger" id="reference-topics-trigger" data-panel-id="topics-dropdown" href="#">Topics ▾</a> <div class='dropdown-panel right' id='topics-dropdown'> <div class='three-column'> <div class='column-left'> <h3 class='setup'>Setup and Config</h3> <ul class='unstyled'> <li> <a href="/docs/git/fr"> git </a> </li> <li> <a href="/docs/git-config/fr"> config </a> </li> <li> <a href="/docs/git-help/fr"> help </a> </li> <li> <a href="/docs/git-bugreport/fr"> bugreport </a> </li> <li> <a href="/doc/credential-helpers"> Credential helpers </a> </li> </ul> <h3 class='projects'>Getting and Creating Projects</h3> <ul class='unstyled'> <li> <a href="/docs/git-init/fr"> init </a> </li> <li> <a href="/docs/git-clone/fr"> clone </a> </li> </ul> <h3 class='snapshotting'>Basic Snapshotting</h3> <ul class='unstyled'> <li> <a href="/docs/git-add/fr"> add </a> </li> <li> <a href="/docs/git-status/fr"> status </a> </li> <li> <a href="/docs/git-diff/fr"> diff </a> </li> <li> <a href="/docs/git-commit/fr"> commit </a> </li> <li> <a href="/docs/git-notes/fr"> notes </a> </li> <li> <a href="/docs/git-restore/fr"> restore </a> </li> <li> <a href="/docs/git-reset/fr"> reset </a> </li> <li> <a href="/docs/git-rm/fr"> rm </a> </li> <li> <a href="/docs/git-mv/fr"> mv </a> </li> </ul> <h3 class='branching'>Branching and Merging</h3> <ul class='unstyled'> <li> <a href="/docs/git-branch/fr"> branch </a> </li> <li> <a href="/docs/git-checkout/fr"> checkout </a> </li> <li> <a href="/docs/git-switch/fr"> switch </a> </li> <li> <a href="/docs/git-merge/fr"> merge </a> </li> <li> <a href="/docs/git-mergetool/fr"> mergetool </a> </li> <li> <a href="/docs/git-log/fr"> log </a> </li> <li> <a href="/docs/git-stash/fr"> stash </a> </li> <li> <a href="/docs/git-tag/fr"> tag </a> </li> <li> <a href="/docs/git-worktree/fr"> worktree </a> </li> </ul> <h3 class='sharing'>Sharing and Updating Projects</h3> <ul class='unstyled'> <li> <a href="/docs/git-fetch/fr"> fetch </a> </li> <li> <a href="/docs/git-pull/fr"> pull </a> </li> <li> <a href="/docs/git-push/fr"> push </a> </li> <li> <a href="/docs/git-remote/fr"> remote </a> </li> <li> <a href="/docs/git-submodule/fr"> submodule </a> </li> </ul> </div> <div class='column-middle'> <h3 class='inspection'>Inspection and Comparison</h3> <ul class='unstyled'> <li> <a href="/docs/git-show/fr"> show </a> </li> <li> <a href="/docs/git-log/fr"> log </a> </li> <li> <a href="/docs/git-diff/fr"> diff </a> </li> <li> <a href="/docs/git-difftool/fr"> difftool </a> </li> <li> <a href="/docs/git-range-diff/fr"> range-diff </a> </li> <li> <a href="/docs/git-shortlog/fr"> shortlog </a> </li> <li> <a href="/docs/git-describe/fr"> describe </a> </li> </ul> <h3 class='patching'>Patching</h3> <ul class='unstyled'> <li> <a href="/docs/git-apply/fr"> apply </a> </li> <li> <a href="/docs/git-cherry-pick/fr"> cherry-pick </a> </li> <li> <a href="/docs/git-diff/fr"> diff </a> </li> <li> <a href="/docs/git-rebase/fr"> rebase </a> </li> <li> <a href="/docs/git-revert/fr"> revert </a> </li> </ul> <h3 class='debugging'>Debugging</h3> <ul class='unstyled'> <li> <a href="/docs/git-bisect/fr"> bisect </a> </li> <li> <a href="/docs/git-blame/fr"> blame </a> </li> <li> <a href="/docs/git-grep/fr"> grep </a> </li> </ul> <h3 class='email'>Email</h3> <ul class='unstyled'> <li> <a href="/docs/git-am/fr"> am </a> </li> <li> <a href="/docs/git-apply/fr"> apply </a> </li> <li> <a href="/docs/git-format-patch/fr"> format-patch </a> </li> <li> <a href="/docs/git-send-email"> send-email </a> </li> <li> <a href="/docs/git-request-pull/fr"> request-pull </a> </li> </ul> <h3 class='external'>External Systems</h3> <ul class='unstyled'> <li> <a href="/docs/git-svn"> svn </a> </li> <li> <a href="/docs/git-fast-import/fr"> fast-import </a> </li> </ul> <h3 class='server-admin'>Server Admin</h3> <ul class='unstyled'> <li> <a href="/docs/git-daemon/fr"> daemon </a> </li> <li> <a href="/docs/git-update-server-info"> update-server-info </a> </li> </ul> </div> <div class='column-right'> <h3 class='guides'>Guides</h3> <ul class='unstyled'> <li> <a href="/docs/gitattributes"> gitattributes </a> </li> <li> <a href="/docs/gitcli"> Command-line interface conventions </a> </li> <li> <a href="/docs/giteveryday"> Everyday Git </a> </li> <li> <a href="/docs/gitfaq"> Frequently Asked Questions (FAQ) </a> </li> <li> <a href="/docs/gitglossary/fr"> Glossary </a> </li> <li> <a href="/docs/githooks"> Hooks </a> </li> <li> <a href="/docs/gitignore/fr"> gitignore </a> </li> <li> <a href="/docs/gitmodules"> gitmodules </a> </li> <li> <a href="/docs/gitrevisions"> Revisions </a> </li> <li> <a href="/docs/gitsubmodules"> Submodules </a> </li> <li> <a href="/docs/gittutorial"> Tutorial </a> </li> <li> <a href="/docs/gitworkflows"> Workflows </a> </li> <li> <a href="/docs/git#_guides"> All guides... </a> </li> </ul> <h3 class='admin'>Administration</h3> <ul class='unstyled'> <li> <a href="/docs/git-clean/fr"> clean </a> </li> <li> <a href="/docs/git-gc/fr"> gc </a> </li> <li> <a href="/docs/git-fsck/fr"> fsck </a> </li> <li> <a href="/docs/git-reflog/fr"> reflog </a> </li> <li> <a href="/docs/git-filter-branch"> filter-branch </a> </li> <li> <a href="/docs/git-instaweb/fr"> instaweb </a> </li> <li> <a href="/docs/git-archive/fr"> archive </a> </li> <li> <a href="/docs/git-bundle/fr"> bundle </a> </li> </ul> <h3 class='plumbing'>Plumbing Commands</h3> <ul class='unstyled'> <li> <a href="/docs/git-cat-file/fr"> cat-file </a> </li> <li> <a href="/docs/git-check-ignore/fr"> check-ignore </a> </li> <li> <a href="/docs/git-checkout-index/fr"> checkout-index </a> </li> <li> <a href="/docs/git-commit-tree/fr"> commit-tree </a> </li> <li> <a href="/docs/git-count-objects/fr"> count-objects </a> </li> <li> <a href="/docs/git-diff-index"> diff-index </a> </li> <li> <a href="/docs/git-for-each-ref"> for-each-ref </a> </li> <li> <a href="/docs/git-hash-object"> hash-object </a> </li> <li> <a href="/docs/git-ls-files"> ls-files </a> </li> <li> <a href="/docs/git-ls-tree"> ls-tree </a> </li> <li> <a href="/docs/git-merge-base"> merge-base </a> </li> <li> <a href="/docs/git-read-tree"> read-tree </a> </li> <li> <a href="/docs/git-rev-list/fr"> rev-list </a> </li> <li> <a href="/docs/git-rev-parse"> rev-parse </a> </li> <li> <a href="/docs/git-show-ref"> show-ref </a> </li> <li> <a href="/docs/git-symbolic-ref"> symbolic-ref </a> </li> <li> <a href="/docs/git-update-index"> update-index </a> </li> <li> <a href="/docs/git-update-ref"> update-ref </a> </li> <li> <a href="/docs/git-verify-pack"> verify-pack </a> </li> <li> <a href="/docs/git-write-tree"> write-tree </a> </li> </ul> </div> </div> </div> <a class="dropdown-trigger" id="reference-versions-trigger" data-panel-id="previous-versions-dropdown" href="#"> Latest version ▾ </a> <span class="light d-flex">git-status last updated in 2.45.0</span> <div class='dropdown-panel left' id='previous-versions-dropdown'> <header>Changes in the <strong>git-status</strong> manual</header> <ol class='reference-previous-versions'> <li class="no-change"><span>2.45.1 → 2.49.0 no changes</span></li> <li> <a href="/docs/git-status/2.45.0"><span class="version">2.45.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2024-04-29</em> </a> </li> <li class="no-change"><span>2.44.1 → 2.44.3 no changes</span></li> <li> <a href="/docs/git-status/2.44.0"><span class="version">2.44.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2024-02-23</em> </a> </li> <li class="no-change"><span>2.43.1 → 2.43.6 no changes</span></li> <li> <a href="/docs/git-status/2.43.0"><span class="version">2.43.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2023-11-20</em> </a> </li> <li class="no-change"><span>2.40.1 → 2.42.4 no changes</span></li> <li> <a href="/docs/git-status/2.40.0"><span class="version">2.40.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2023-03-12</em> </a> </li> <li class="no-change"><span>2.39.1 → 2.39.5 no changes</span></li> <li> <a href="/docs/git-status/2.39.0"><span class="version">2.39.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2022-12-12</em> </a> </li> <li class="no-change"><span>2.35.1 → 2.38.5 no changes</span></li> <li> <a href="/docs/git-status/2.35.0"><span class="version">2.35.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2022-01-24</em> </a> </li> <li class="no-change"><span>2.34.1 → 2.34.8 no changes</span></li> <li> <a href="/docs/git-status/2.34.0"><span class="version">2.34.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2021-11-15</em> </a> </li> <li class="no-change"><span>2.31.1 → 2.33.8 no changes</span></li> <li> <a href="/docs/git-status/2.31.0"><span class="version">2.31.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2021-03-15</em> </a> </li> <li class="no-change"><span>2.30.2 → 2.30.9 no changes</span></li> <li> <a href="/docs/git-status/2.30.1"><span class="version">2.30.1</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2021-02-08</em> </a> </li> <li class="no-change"><span>2.24.1 → 2.30.0 no changes</span></li> <li> <a href="/docs/git-status/2.24.0"><span class="version">2.24.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2019-11-04</em> </a> </li> <li class="no-change"><span>2.22.1 → 2.23.4 no changes</span></li> <li> <a href="/docs/git-status/2.22.0"><span class="version">2.22.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2019-06-07</em> </a> </li> <li class="no-change"><span>2.21.1 → 2.21.4 no changes</span></li> <li> <a href="/docs/git-status/2.21.0"><span class="version">2.21.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2019-02-24</em> </a> </li> <li class="no-change"><span>2.19.1 → 2.20.5 no changes</span></li> <li> <a href="/docs/git-status/2.19.0"><span class="version">2.19.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2018-09-10</em> </a> </li> <li class="no-change"><span>2.18.1 → 2.18.5 no changes</span></li> <li> <a href="/docs/git-status/2.18.0"><span class="version">2.18.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2018-06-21</em> </a> </li> <li class="no-change"><span>2.17.1 → 2.17.6 no changes</span></li> <li> <a href="/docs/git-status/2.17.0"><span class="version">2.17.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2018-04-02</em> </a> </li> <li> <a href="/docs/git-status/2.16.6"><span class="version">2.16.6</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2019-12-06</em> </a> </li> <li class="no-change"><span>2.15.4 no changes</span></li> <li> <a href="/docs/git-status/2.14.6"><span class="version">2.14.6</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2019-12-06</em> </a> </li> <li> <a href="/docs/git-status/2.13.7"><span class="version">2.13.7</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2018-05-22</em> </a> </li> <li class="no-change"><span>2.12.5 no changes</span></li> <li> <a href="/docs/git-status/2.11.4"><span class="version">2.11.4</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2017-09-22</em> </a> </li> <li class="no-change"><span>2.7.6 → 2.10.5 no changes</span></li> <li> <a href="/docs/git-status/2.6.7"><span class="version">2.6.7</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2017-05-05</em> </a> </li> <li> <a href="/docs/git-status/2.5.6"><span class="version">2.5.6</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2017-05-05</em> </a> </li> <li> <a href="/docs/git-status/2.4.12"><span class="version">2.4.12</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2017-05-05</em> </a> </li> <li class="no-change"><span>2.3.10 no changes</span></li> <li> <a href="/docs/git-status/2.2.3"><span class="version">2.2.3</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2015-09-04</em> </a> </li> <li class="no-change"><span>2.1.4 no changes</span></li> <li> <a href="/docs/git-status/2.0.5"><span class="version">2.0.5</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2014-12-17</em> </a> </li> <li> </li> </ol> <footer> <p>Check your version of git by running</p> <code class="command">git --version</code> </footer> </div> </div> <div id="main" data-pagefind-filter="category:reference" data-pagefind-meta="category:Reference" data-pagefind-weight="0.05" data-pagefind-body> <div class="sect1"> <h2 id="_nom"><a class="anchor" href="#_nom"></a>NOM</h2> <div class="sectionbody"> <div class="paragraph"> <p>git-status - Montrer le statut de l’arbre de travail</p> </div> </div> </div> <div class="sect1"> <h2 id="_synopsis"><a class="anchor" href="#_synopsis"></a>SYNOPSIS</h2> <div class="sectionbody"> <div class="verseblock"> <pre class="content"><em>git status</em> [<options>] [--] [<spéc-de-chemin>…​]</pre> </div> </div> </div> <div class="sect1"> <h2 id="_description"><a class="anchor" href="#_description"></a>DESCRIPTION</h2> <div class="sectionbody"> <div class="paragraph"> <p>Montre les chemins qui ont des différences entre le fichier d’index et le commit HEAD actuel, les chemins qui ont des différences entre l’arbre de travail et de fichier d’index, et les chemins dans l’arbre de travail qui ne sont pas suivis par Git (et qui ne sont pas ignorés par <a href='/docs/gitignore/fr'>gitignore[5]</a>). Les premiers sont ce que vous <em>valideriez</em> en lançant <code>git commit</code> ; les seconds et les troisièmes sont ce que vous <em>pourriez</em> valider en lançant <code>git add</code> avant de lancer <code>git commit</code>.</p> </div> </div> </div> <div class="sect1"> <h2 id="_options"><a class="anchor" href="#_options"></a>OPTIONS</h2> <div class="sectionbody"> <div class="dlist"> <dl> <dt class="hdlist1" id="git-status--s"> <a class="anchor" href="#git-status--s"></a>-s </dt> <dt class="hdlist1" id="git-status---short"> <a class="anchor" href="#git-status---short"></a>--short </dt> <dd> <p>Afficher la sortie en format court.</p> </dd> <dt class="hdlist1" id="git-status--b"> <a class="anchor" href="#git-status--b"></a>-b </dt> <dt class="hdlist1" id="git-status---branch"> <a class="anchor" href="#git-status---branch"></a>--branch </dt> <dd> <p>Montrer la branche et l’information de suivi, y compris en format court.</p> </dd> <dt class="hdlist1" id="git-status---show-stash"> <a class="anchor" href="#git-status---show-stash"></a>--show-stash </dt> <dd> <p>Montrer le nombre d’entrées actuellement remisées.</p> </dd> <dt class="hdlist1" id="git-status---porcelainltversiongt"> <a class="anchor" href="#git-status---porcelainltversiongt"></a>--porcelain[=<version>] </dt> <dd> <p>Donner la sortie dans un format facile à analyser par script. Ceci est similaire à la sortie courte, mais restera stable à travers les versions de Git et sans tenir compte de la configuration utilisateur. Voir ci-dessous pour de plus amples détails.</p> <div class="paragraph"> <p>Le paramètre de version est utilisé pour spécifier la version de format. Ceci est optionnel et utilise par défaut le format <em>v1</em> de la version d’origine.</p> </div> </dd> <dt class="hdlist1" id="git-status---long"> <a class="anchor" href="#git-status---long"></a>--long </dt> <dd> <p>Afficher la sortie en format long. Option par défaut.</p> </dd> <dt class="hdlist1" id="git-status--v"> <a class="anchor" href="#git-status--v"></a>-v </dt> <dt class="hdlist1" id="git-status---verbose"> <a class="anchor" href="#git-status---verbose"></a>--verbose </dt> <dd> <p>En plus des noms de fichiers qui ont été changés, montrer aussi les changements textuels qui sont indexés pour validation (c.-à-d., comme la sortie de <code>git diff --cached</code>). Si <code>-v</code> est spécifié deux fois, alors montrer également les modifications dans l’arbre de travail qui n’ont pas encore été indexées (c.-à-d., comme la sortie de <code>git diff</code>).</p> </dd> <dt class="hdlist1" id="git-status--ultmodegt"> <a class="anchor" href="#git-status--ultmodegt"></a>-u[<mode>] </dt> <dt class="hdlist1" id="git-status---untracked-filesltmodegt"> <a class="anchor" href="#git-status---untracked-filesltmodegt"></a>--untracked-files[=<mode>] </dt> <dd> <p>Montrer les fichiers non-suivis.</p> <div class="openblock"> <div class="content"> <div class="paragraph"> <p>Le paramètre mode est utilisé pour spécifier le traitement des fichiers non-suivis. C’est optionnel : il vaut par défaut <em>all</em>, et si spécifié, il doit être collé à l’option (par exemple, <code>-uno</code>, mais pas <code>-u no</code>).</p> </div> <div class="paragraph"> <p>Les options possibles sont :</p> </div> <div class="ulist"> <ul> <li> <p><em>no</em> - Ne montrer aucun fichier non-suivi.</p> </li> <li> <p><em>normal</em> - Montrer les fichiers non-suivis et les dossiers.</p> </li> <li> <p><em>all</em> - Montrer aussi les fichiers dans les dossiers dont le contenu n’est pas suivi.</p> </li> </ul> </div> <div class="paragraph"> <p>Quand l’option <code>-u</code> n’est pas utilisée, les fichiers non-suivis et les dossiers sont montrés (c.-à-d. comme en spécifiant <code>normal</code>), pour vous aider à éviter d’oublier d’ajouter des fichiers nouvellement créés. Étant donné que la recherche de fichiers non-suivis dans le système de fichiers nécessite un travail supplémentaire, ce mode peut prendre un certain temps dans un grand arbre de travail. Pensez à activer le cache non suivi et l’index fractionné, le cas échéant (voyez <code>git update-index --untracked-cache</code> et <code>git update-index --split-index</code>), sinon vous pouvez utiliser <code>no</code> pour que <code>git status</code> revienne plus rapidement sans afficher les fichiers non-suivis. Toutes les orthographes habituelles pour la valeur booléenne <code>true</code> sont prises comme <code>normal</code> et <code>false</code> comme <code>no</code>.</p> </div> <div class="paragraph"> <p>La valeur par défaut est contenue dans la variable de configuration status.showUntrackedFiles documentée dans <a href='/docs/git-config/fr'>git-config[1]</a>.</p> </div> </div> </div> </dd> <dt class="hdlist1" id="git-status---ignore-submodulesltquandgt"> <a class="anchor" href="#git-status---ignore-submodulesltquandgt"></a>--ignore-submodules[=<quand>] </dt> <dd> <p>Ignorer les modifications apportées aux sous-modules lors de la recherche de modifications. <quand> peut être "none", "untracked", "dirty" ou "all", qui est la valeur par défaut. Utiliser "none" considérera le sous-module comme modifié lorsqu’il contient des fichiers non suivis ou modifiés ou que sa HEAD diffère de la validation enregistrée dans le super-projet et peut être utilisé pour remplacer les paramètres de l’option <em>ignore</em> dans <a href='/docs/git-config/fr'>git-config[1]</a> ou <a href='/docs/gitmodules/fr'>gitmodules[5]</a>. Lorsque "untracked" est utilisé, les sous-modules ne sont pas considérés comme sales lorsqu’ils contiennent uniquement du contenu non suivi (mais ils sont toujours analysés pour rechercher le contenu modifié). L’utilisation de "dirty" ignore toutes les modifications apportées à l’arborescence de travail des sous-modules ; seules les modifications des validations stockées dans le super-projet sont affichées (il s’agissait du comportement avant la version 1.7.0). L’utilisation de "all" masque toutes les modifications apportées aux sous-modules (et supprime la sortie des résumés de sous-modules lorsque l’option de configuration <code>status.submoduleSummary</code> est définie).</p> </dd> <dt class="hdlist1" id="git-status---ignoredltmodegt"> <a class="anchor" href="#git-status---ignoredltmodegt"></a>--ignored[=<mode>] </dt> <dd> <p>Montrer aussi les fichiers ignorés.</p> <div class="openblock"> <div class="content"> <div class="paragraph"> <p>Le paramètre mode est utilisé pour spécifier le traitement des fichiers ignorés. Il est optionnel est vaut par défaut <em>traditional</em>.</p> </div> <div class="paragraph"> <p>Les options possibles sont :</p> </div> <div class="ulist"> <ul> <li> <p><em>traditional</em> - Montrer les fichiers non-suivis et les dossiers dont le contenu n’est pas suivi, à moins que --untracked-files=all soit spécifié, auquel cas les fichiers individuels dans les dossiers ignorés sont affichés.</p> </li> <li> <p><em>no</em> - Ne montrer aucun fichier ignoré.</p> </li> <li> <p><em>matching</em> - Montre les fichiers et les dossiers ignorés correspondants à un motif à ignorer.</p> </li> </ul> </div> <div class="paragraph"> <p>Quand le mode <em>matching</em> est spécifié, les chemins qui correspondent explicitement à un motif à ignorer sont affichés. Si un dossier correspond à un motif à ignorer, alors il est affiché, mais pas les chemins contenus dans celui-ci. Si un dossier ne correspond pas à un motif à ignorer, mais que tout son contenu est ignoré, alors le dossier n’est pas affiché, mais tout son contenu est affiché.</p> </div> </div> </div> </dd> <dt class="hdlist1" id="git-status--z"> <a class="anchor" href="#git-status--z"></a>-z </dt> <dd> <p>Terminer les entrées avec NUL au lieu de LF. Cela implique le format de sortie <code>--porcelain=v1</code> si aucun autre format n’est fourni.</p> </dd> <dt class="hdlist1" id="git-status---columnltoptionsgt"> <a class="anchor" href="#git-status---columnltoptionsgt"></a>--column[=<options>] </dt> <dt class="hdlist1" id="git-status---no-column"> <a class="anchor" href="#git-status---no-column"></a>--no-column </dt> <dd> <p>Afficher les fichiers non suivis en colonnes. Voir la variable de configuration <code>column.status</code> pour la syntaxe de l’option. <code>--column</code> et <code>--no-column</code> sans options sont équivalents à <em>always</em> et <em>never</em> respectivement.</p> </dd> <dt class="hdlist1" id="git-status---ahead-behind"> <a class="anchor" href="#git-status---ahead-behind"></a>--ahead-behind </dt> <dt class="hdlist1" id="git-status---no-ahead-behind"> <a class="anchor" href="#git-status---no-ahead-behind"></a>--no-ahead-behind </dt> <dd> <p>Afficher ou ne pas afficher les comptes détaillés devant/derrière pour la branche par rapport à sa branche amont. La valeur par défaut est true.</p> </dd> <dt class="hdlist1" id="git-status---renames"> <a class="anchor" href="#git-status---renames"></a>--renames </dt> <dt class="hdlist1" id="git-status---no-renames"> <a class="anchor" href="#git-status---no-renames"></a>--no-renames </dt> <dd> <p>Activer ou désactiver la détection de renommage sans tenir compte de la configuration utilisateur. Voir aussi <a href='/docs/git-diff/fr'>git-diff[1]</a> <code>--no-renames</code>.</p> </dd> <dt class="hdlist1" id="git-status---find-renamesltngt"> <a class="anchor" href="#git-status---find-renamesltngt"></a>--find-renames[=<n>] </dt> <dd> <p>Activer la détection de renommage, en définissant de manière optionnelle le seuil de similarité. Voir aussi <a href='/docs/git-diff/fr'>git-diff[1]</a> <code>--find-renames</code>.</p> </dd> <dt class="hdlist1" id="git-status-ltspcificateurdechemingt82308203"> <a class="anchor" href="#git-status-ltspcificateurdechemingt82308203"></a><spécificateur de chemin>…​ </dt> <dd> <p>Voir l’entrée <em>spécificateur de chemin</em> dans <a href='/docs/gitglossary/fr'>gitglossary[7]</a>.</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_sortie"><a class="anchor" href="#_sortie"></a>SORTIE</h2> <div class="sectionbody"> <div class="paragraph"> <p>La sortie de cette commande est conçue pour être utilisée comme modèle de message de validation. La valeur par défaut, format long, est conçue pour être lisible par un humain, commentée et descriptive. Son contenu et son format sont susceptibles de changer à tout moment.</p> </div> <div class="paragraph"> <p>Contrairement au comportement de beaucoup d’autres commandes Git qui référencent la racine de l’arbre de travail, les chemins mentionnés dans la sortie sont relatifs au répertoire courant (ceci est à dessein, pour aider le couper-coller). Voir l’option de configuration status.relativePaths ci-dessous.</p> </div> <div class="sect2"> <h3 id="_format_court"><a class="anchor" href="#_format_court"></a>Format court</h3> <div class="paragraph"> <p>Dans le format court, le statut de chaque chemin est affiché selon une de ces formes</p> </div> <div class="literalblock"> <div class="content"> <pre>XY CHEMIN XY CHEMIN_ORIGINE -> CHEMIN</pre> </div> </div> <div class="paragraph"> <p>où <code>CHEMIN_ORIGINE</code> est l’origine du contenu renommé/copié. <code>CHEMIN_ORIGINE</code> n’est montré que lorsque l’entrée est renommée ou copiée. Le <code>XY</code> est un code de statut à deux lettres.</p> </div> <div class="paragraph"> <p>Les champs (incluant le <code>-></code>) sont séparés les uns des autres par un seul espace. Si un nom de fichier contient des espaces ou d’autres caractères non imprimables, ce champ sera cité à la manière d’un littéral de chaîne C : entouré par des caractères de guillemets ASCII (34), et avec les caractères spéciaux à l’intérieur échappés par la barre oblique inversée.</p> </div> <div class="paragraph"> <p>Il existe trois types d’états différents qui sont présentés selon ce format, et chacun utilise la syntaxe <code>XY</code> de manière différente :</p> </div> <div class="ulist"> <ul> <li> <p>Lorsqu’une fusion est en cours et que la fusion a été réussie, ou en dehors d’une fusion <code>X</code> indique l’état de l’index et <code>Y</code> indique l’état de l’abre de travail.</p> </li> <li> <p>Lorsqu’un conflit de fusion s’est produit et n’a pas encore été résolu, <code>X</code> et <code>Y</code> montrent l’état introduit par chaque tête de la fusion, par rapport à l’ancêtre commun. Ces chemins sont dits <em>non fusionnés</em>.</p> </li> <li> <p>Lorsqu’un chemin n’est pas tracé, <code>X</code> et <code>Y</code> sont toujours les mêmes, puisqu’ils sont inconnus de l’index. <code>??</code> est utilisé pour les chemins non suivis. Les fichiers ignorés ne sont pas listés sauf si <code>--ignored</code> est utilisé ; si c’est le cas, les fichiers ignorés sont indiqués par <code>!!</code>.</p> </li> </ul> </div> <div class="paragraph"> <p>Notez que le terme <em>merge</em> ici inclut également les rebasages utilisant la stratégie de <code>--merge</code> par défaut, les picorages, et tout ce qui utilise la machinerie de fusion.</p> </div> <div class="paragraph"> <p>Dans le tableau suivant, ces trois classes sont présentées dans des sections séparées, et ces caractères sont utilisés pour les champs <code>X</code> et <code>Y</code> des deux premières sections qui montrent les chemins suivis :</p> </div> <div class="ulist"> <ul> <li> <p>' ' = non modifié</p> </li> <li> <p><em>M</em> = modifié</p> </li> <li> <p><em>T</em> = changement de type de fichier (fichier ordinaire, lien symbolique ou sous-module)</p> </li> <li> <p><em>A</em> = ajouté</p> </li> <li> <p><em>D</em> = supprimé (<em>Deleted</em>)</p> </li> <li> <p><em>R</em> = renommé</p> </li> <li> <p><em>C</em> = copié (si l’option de configuration status.renames est définie comme "copies")</p> </li> <li> <p><em>U</em> = mis à jour (<em>Updated</em>) mais non fusionné</p> </li> </ul> </div> <div class="literalblock"> <div class="content"> <pre>X Y Signification --------------------------------------------------------- [AMD] non mis à jour M [ MTD] mis à jour dans l'index T [ MTD] changement de type dans l'index A [ MTD] ajouté à l'index D supprimé de l'index R [ MTD] renommé dans l'index C [ MTD] copié dans l'index [MTARC] l'index et l'arbre de travail correspondent [ MTARC] M arbre de travail modifié depuis l'index [ MTARC] T type modifié dans l'arbre de travail depuis l'index [ MTARC] D supprimé dans l'arbre de travail R renommé dans l'arbre de travail C copié dans l'arbre de travail --------------------------------------------------------- D D non fusionné, les deux l'ont supprimé A U non fusionné, ajouté par nous U D non fusionné, supprimé par eux U A non fusionné, ajouté par eux D U non fusionné, supprimé par nous A A non fusionné, les deux l'ont ajouté U U non fusionné, les deux l'ont modifié --------------------------------------------------------- ? ? non suivi ! ! ignoré ---------------------------------------------------------</pre> </div> </div> <div class="paragraph"> <p>Les sous-modules ont plus d’état et plutôt indiquent</p> </div> <div class="ulist"> <ul> <li> <p><em>M</em> = le sous-module a une HEAD différente que celle enregistrée dans l’index</p> </li> <li> <p><em>m</em> = le sous-module a du contenu modifié</p> </li> <li> <p><em>?</em> = le sous-module a des fichiers non suivis</p> </li> </ul> </div> <div class="paragraph"> <p>Ceci s’explique du fait que le contenu modifié ou les fichiers non suivis dans un sous-module ne peuvent pas être ajoutés via <code>git add</code> dans le superprojet pour préparer un commit.</p> </div> <div class="paragraph"> <p><em>m</em> et <em>?</em> sont appliqués récursivement. Par exemple, si un sous-module niché dans un sous-module contient un fichier non suivi, ceci sera aussi indiqué par <em>?</em>.</p> </div> <div class="paragraph"> <p>Si -b est utilisé, le statut en format court est précédé par une ligne</p> </div> <div class="literalblock"> <div class="content"> <pre>## information de suivi de branche</pre> </div> </div> </div> <div class="sect2"> <h3 id="_format_de_porcelaine_version_1"><a class="anchor" href="#_format_de_porcelaine_version_1"></a>Format de porcelaine version 1</h3> <div class="paragraph"> <p>Le format de porcelaine de la version 1 est similaire au format court, mais le maintien de compatibilité est garanti au fil des versions et indépendamment de la configuration utilisateur. Cela le rend idéal pour l’analyse par script. La description du format court ci-dessus décrit également le format porcelaine, avec quelques exceptions :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>La configuration color.status de l’utilisateur n’est pas respectée ; la couleur sera toujours éteinte.</p> </li> <li> <p>La configuration status.relativePaths de l’utilisateur n’est pas respectée ; les chemins affichés seront toujours relatifs à la racine du dépôt.</p> </li> </ol> </div> <div class="paragraph"> <p>Il y a aussi un format alternatif -z recommandé pour l’analyse par la machine. Dans ce format, le champ de statut est le même, mais d’autres choses changent. Premièrement, le <em>-></em> est omis pour les entrées renommées et l’ordre des champs est inversé (par exemple, <em>de -> à</em> devient <em>à de</em>). Deuxièmement, un NUL (ASCII 0) suit chaque nom de fichier, remplaçant l’espace comme séparateur de champ et la nouvelle ligne de fin (mais un espace sépare toujours le champ de statut du premier nom de fichier). Troisièmement, les noms de fichier contenant des caractères spéciaux ne sont pas spécialement formatés ; aucune mise entre guillemets ni échappement par barre oblique inversée n’est effectué.</p> </div> <div class="paragraph"> <p>N’importe quelle modification dans un sous-module est indiquée comme modifiée par <code>M</code> au lieu de <code>m</code> ou un <code>?</code> seul.</p> </div> </div> <div class="sect2"> <h3 id="_format_de_porcelaine_version_2"><a class="anchor" href="#_format_de_porcelaine_version_2"></a>Format de porcelaine version 2</h3> <div class="paragraph"> <p>Le format version 2 ajoute des informations détaillées sur l’état de l’arbre de travail et les éléments modifiés. La version 2 définit également un ensemble extensible d’en-têtes optionnels faciles à analyser.</p> </div> <div class="paragraph"> <p>Les lignes d’en-tête commencent par "#" et sont ajoutées en réponse à des arguments spécifiques en ligne de commande. Les analyseurs syntaxiques doivent ignorer les en-têtes qu’ils ne reconnaissent pas.</p> </div> <div class="sect3"> <h4 id="_en_têtes_de_branche"><a class="anchor" href="#_en_têtes_de_branche"></a>En-têtes de branche</h4> <div class="paragraph"> <p>Si <code>--branch</code> est fourni, une série de lignes d’en-tête est affichée avec des informations sur la branche actuelle.</p> </div> <div class="literalblock"> <div class="content"> <pre>Ligne Notes ------------------------------------------------------------ # branch.oid <commit> | (initial) Commit courant. # branch.head <branche> | (detached) Branche courante. # branch.upstream <branche-amont> Si l'amont est défini. # branch.ab +<devant> -<derrière> Si l'amont est défini et le commit est présent. ------------------------------------------------------------</pre> </div> </div> </div> <div class="sect3"> <h4 id="_information_de_remisage"><a class="anchor" href="#_information_de_remisage"></a>Information de Remisage</h4> <div class="paragraph"> <p>Si <code>--show-stash</code> est donné, une ligne est affichée montrant le nombre d’entrées de remisage s’il est différent de zéro :</p> </div> <div class="literalblock"> <div class="content"> <pre># remisage <N></pre> </div> </div> </div> <div class="sect3"> <h4 id="_entrées_suivies_modifiées"><a class="anchor" href="#_entrées_suivies_modifiées"></a>Entrées suivies modifiées</h4> <div class="paragraph"> <p>Après les en-têtes, une série de lignes est affichée pour les entrées suivies. Un des trois différents formats de ligne peut être utilisé pour décrire une entrée en fonction du type de changement. Les entrées suivies sont affichées dans un ordre indéfini ; les analyseurs syntaxiques doivent autoriser un mélange des 3 types de lignes dans n’importe quel ordre.</p> </div> <div class="paragraph"> <p>Les entrées modifiées normales ont le format suivant :</p> </div> <div class="literalblock"> <div class="content"> <pre>1 <XY> <sous> <mH> <mI> <mW> <hH> <hI> <chemin></pre> </div> </div> <div class="paragraph"> <p>Les entrées renommées ou copiées ont le format suivant :</p> </div> <div class="literalblock"> <div class="content"> <pre>2 <XY> <sous> <mH> <mI> <mW> <hH> <hI> <X><score> <chemin><sep><cheminOrig></pre> </div> </div> <div class="literalblock"> <div class="content"> <pre>Champ Signification -------------------------------------------------------- <XY> Un champ à 2 caractères contenant les valeurs XY indexées et non indexées décrites dans le format court, avec non-modifié indiqué par un "." plutôt qu'un espace. <sous> Un champ à 4 caractères décrivant l'état du sous-module. "N..." quand l'entrée n'est pas un sous-module. "S<c><m><u>" quand l'entrée est un sous-module. <c> vaut "C" si le commit a changé ; autrement ".". <m> vaut "M" s'il a des modifications suivies ; autrement ".". <u> vaut "U" s'il y a des modifications non-suivies ; autrement ".". <mH> Le mode octal du fichier dans HEAD. <mI> Le mode octal du fichier dans l'index. <mW> Le mode octal du fichier dans l'arbre de travail. <hH> Le nom de l'objet dans HEAD. <hI> Le nom de l'objet dans l'index. <X><score> Le score de renommage ou de copie (indiquant le pourcentage de similarité entre la source et la cible du déplacement ou de la copie). Par exemple, "R100" ou "C75". <chemin> Le nom du chemin. Dans une entrée renommée/copiée, c'est le chemin cible. <sep> Quand l'option `-z` est utilisée, les 2 noms de chemin sont séparés par un octet NUL (ASCII 0x00) ; autrement, un octet tabulation (ASCII 0x09) les sépare. <cheminOrig> Le nom du chemin dans le commit de HEAD ou dans l'index. C'est présent que dans une entrée renommée/copiée, et indique d'où le contenu renommé/copié vient. --------------------------------------------------------</pre> </div> </div> <div class="paragraph"> <p>Les entrées non fusionnées ont le format suivant ; le premier caractère est un "u" pour les différencier des entrées ordinaires modifiées.</p> </div> <div class="literalblock"> <div class="content"> <pre>u <XY> <sous> <m1> <m2> <m3> <mW> <h1> <h2> <h3> <chemin></pre> </div> </div> <div class="literalblock"> <div class="content"> <pre>Champ Signification -------------------------------------------------------- <XY> Un champ à 2 caractères décrivant le type de conflit comme décrit dans le format court. <sous> Un champ à 4 caractères décrivant l'état du sous-module comme décrit ci-dessus. <m1> Le mode octal du fichier dans l'étape 1. <m2> Le mode octal du fichier dans l'étape 2. <m3> Le mode octal du fichier dans l'étape 3. <mW> Le mode octal du fichier dans l'arbre de travail. <h1> Le nom de l'objet dans l'étape 1. <h2> Le nom de l'objet dans l'étape 2. <h3> Le nom de l'objet dans l'étape 3. <chemin> Le nom du chemin. --------------------------------------------------------</pre> </div> </div> </div> <div class="sect3"> <h4 id="_autres_éléments"><a class="anchor" href="#_autres_éléments"></a>Autres éléments</h4> <div class="paragraph"> <p>Après les entrées suivies (et si demandé), une série de lignes sera affichée pour les éléments non suivis, puis ignorés, trouvés dans l’arbre de travail.</p> </div> <div class="paragraph"> <p>Les entrées non-suivies ont le format suivant :</p> </div> <div class="literalblock"> <div class="content"> <pre>? <chemin></pre> </div> </div> <div class="paragraph"> <p>Les entrées ignorées ont le format suivant :</p> </div> <div class="literalblock"> <div class="content"> <pre>! <chemin></pre> </div> </div> </div> <div class="sect3"> <h4 id="_notes_de_format_du_nom_de_chemin_et_z"><a class="anchor" href="#_notes_de_format_du_nom_de_chemin_et_z"></a>Notes de format du nom de chemin et -z</h4> <div class="paragraph"> <p>Quand l’option <code>-z</code> est fournie, les noms de chemin sont affichés tels quels et sans guillemets et les lignes sont terminées par un octet NUL (ASCII 0x00).</p> </div> <div class="paragraph"> <p>Sans l’option <code>-z</code>, les noms de chemin avec des caractères « inhabituels » sont cités comme expliqué pour la variable de configuration <code>core.quotePath</code> (voir <a href='/docs/git-config/fr'>git-config[1]</a>).</p> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_configuration"><a class="anchor" href="#_configuration"></a>CONFIGURATION</h2> <div class="sectionbody"> <div class="paragraph"> <p>La commande honore les variables de configuration <code>color.status</code> (ou <code>status.color</code> — elles signifient la même chose et la dernière est conservée pour la compatibilité ascendante) et <code>color.status.<slot></code> pour colorer sa sortie.</p> </div> <div class="paragraph"> <p>Si la variable de configuration <code>status.relativePaths</code> est définie à <em>false</em>, alors tous les chemins affichés sont relatifs à la racine du dépôt, et non pas au répertoire courant.</p> </div> <div class="paragraph"> <p>Si <code>status.submoduleSummary</code> est défini sur un nombre non nul ou vrai (identique à -1 ou à un nombre illimité), le résumé du sous-module sera activé pour le format long et un résumé des validations pour les sous-modules modifiés sera affiché (voir l’option --summary-limit de <a href='/docs/git-submodule/fr'>git-submodule[1]</a>). Veuillez noter que la sortie récapitulative de la commande status sera supprimée pour tous les sous-modules lorsque <code>diff.ignoreSubmodules</code> est réglé sur <em>all</em> ou uniquement pour les sous-modules où <code>submodule.<Name>.ignore = all</code>. Pour afficher également le résumé des sous-modules ignorés, vous pouvez utiliser l’option de ligne de commande --ignore-submodules=dirty ou la commande <em>git submodule summary</em>, qui affiche une sortie similaire mais ne respecte pas ces paramètres.</p> </div> </div> </div> <div class="sect1"> <h2 id="_rafraîchissement_en_tâche_de_fond"><a class="anchor" href="#_rafraîchissement_en_tâche_de_fond"></a>RAFRAÎCHISSEMENT EN TÂCHE DE FOND</h2> <div class="sectionbody"> <div class="paragraph"> <p>Par défaut, <code>git status</code> actualisera automatiquement l’index, mettant à jour les informations statistiques mises en cache à partir de l’arbre de travail et écrivant le résultat. Écrire l’index mis à jour est une optimisation qui n’est pas strictement nécessaire (<code>status</code> calcule les valeurs pour lui-même, mais les écrire ne sert qu’à épargner les programmes suivants de répéter nos calculs). Lorsque <code>status</code> est exécuté en arrière-plan, le verrou maintenu pendant l’écriture peut entrer en conflit avec d’autres processus simultanés, entraînant leur échec. Les scripts exécutant <code>status</code> en arrière-plan doivent envisager d’utiliser <code>git --no-optional-locks status</code> (voir <a href='/docs/git/fr'>git[1]</a> pour plus de détails).</p> </div> </div> </div> <div class="sect1"> <h2 id="_fichiers_non_suivis_et_performances"><a class="anchor" href="#_fichiers_non_suivis_et_performances"></a>FICHIERS NON SUIVIS ET PERFORMANCES</h2> <div class="sectionbody"> <div class="paragraph"> <p><code>git status</code> peut être très lent dans les grands arbres-de-travail si/quand il doit rechercher des fichiers et des répertoires non suivis. Il y a beaucoup d’options de configuration disponibles pour accélérer cela, soit en évitant le travail, soit en utilisant les résultats en cache des commandes Git précédentes. Il n’y a pas un seul ensemble optimal de paramètres qui convienne à tout le monde. Nous allons lister un résumé des options pertinentes pour vous aider, mais avant de les lister, vous devriez lancer <code>git status</code> à nouveau, parce que votre configuration peut déjà avoir mis en cache les résultats de <code>git status</code>, et donc être plus rapide lors des exécutions suivantes.</p> </div> <div class="ulist"> <ul> <li> <p>Le drapeau <code>--untracked-files=no</code> ou la <code>status.showUntrackedFiles=no</code>(voir ci-dessus pour les deux) : indique que <code>git status</code> ne doit pas signaler les fichiers non suivis. C’est l’option la plus rapide. <code>git status</code> ne listera pas les fichiers non suivis, vous devez donc faire attention à vous souvenir si vous créez de nouveaux fichiers et à les <code>git add</code> manuellement.</p> </li> <li> <p><code>advice.statusUoption=false</code> (voir <a href='/docs/git-config/fr'>git-config[1]</a>) : mettre cette variable à <code>false</code> désactive le message d’avertissement donné lorsque l’énumération des fichiers non suivis prend plus de 2 secondes. Dans un grand projet, cela peut prendre plus de temps et l’utilisateur peut avoir déjà accepté le compromis (par exemple, l’utilisation de "-uno" peut ne pas être une option acceptable pour l’utilisateur), auquel cas, il n’y a pas de raison d’émettre un message d’avertissement, et désactiver l’avertissement peut être la meilleure solution.</p> </li> <li> <p><code>core.untrackedCache=true</code> (voir <a href='/docs/git-update-index/fr'>git-update-index[1]</a>) : activer la fonctionnalité de cache non suivi et ne rechercher que les répertoires qui ont été modifiés depuis la précédente commande <code>git status</code>. Git se souvient de l’ensemble des fichiers non suivis dans chaque répertoire et suppose que si un répertoire n’a pas été modifié, alors l’ensemble des fichiers non suivis n’a pas changé. C’est beaucoup plus rapide que d’énumérer le contenu de chaque répertoire, mais ce n’est pas sans coût, car Git doit toujours rechercher l’ensemble des répertoires modifiés. Le cache non suivi est stocké dans le fichier <code>.git/index</code>. Le coût réduit de la recherche des fichiers non suivis est légèrement compensé par l’augmentation de la taille de l’index et le coût de sa mise à jour. Cette réduction du temps de recherche l’emporte généralement sur la taille supplémentaire.</p> </li> <li> <p><code>core.untrackedCache=true</code> et <code>core.fsmonitor=true</code> ou <code>core.fsmonitor=<chemin-de-commande-crochet></code> (voir <a href='/docs/git-update-index/fr'>git-update-index[1]</a>) : active à la fois les fonctionnalités de cache de non suivi et de FSMonitor et ne recherche que les répertoires qui ont été modifiés depuis la précédente commande <code>git status</code>. Ceci est plus rapide que d’utiliser uniquement le cache de non suivi car Git peut également éviter de rechercher les répertoires modifiés. Git doit seulement énumérer l’ensemble exact des répertoires qui ont été modifiés récemment. Bien que la fonctionnalité FSMonitor puisse être activée sans le cache de non suivi, les avantages sont considérablement réduits dans ce cas.</p> </li> </ul> </div> <div class="paragraph"> <p>Notez qu’après avoir activé les fonctionnalités cache de non suivi et/ou FSMonitor, quelques commandes <code>git status</code> peuvent être nécessaires pour que les différents caches se remplissent avant que vous ne constatiez une amélioration des temps de commande. Ceci est normal.</p> </div> </div> </div> <div class="sect1"> <h2 id="_voir_aussi"><a class="anchor" href="#_voir_aussi"></a>VOIR AUSSI</h2> <div class="sectionbody"> <div class="paragraph"> <p><a href='/docs/gitignore/fr'>gitignore[5]</a></p> </div> </div> </div> <div class="sect1"> <h2 id="_git"><a class="anchor" href="#_git"></a>GIT</h2> <div class="sectionbody"> <div class="paragraph"> <p>Fait partie de la suite <a href='/docs/git/fr'>git[1]</a></p> </div> </div> </div> <div class="sect1"> <h2 id="_traduction"><a class="anchor" href="#_traduction"></a>TRADUCTION</h2> <div class="sectionbody"> <div class="paragraph"> <p>Cette page de manuel a été traduite par Jean-Noël Avila <jn.avila AT free DOT fr> et les membres du projet git-manpages-l10n. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le site <a href="https://github.com/jnavila/git-manpages-l10n" class="bare">https://github.com/jnavila/git-manpages-l10n</a> .</p> </div> </div> </div> </div> </div> </div> <footer> <div class="site-source"> <a href="/site">About this site</a><br> Patches, suggestions, and comments are welcome. </div> <div class="sfc-member"> Git is a member of <a href="/sfc">Software Freedom Conservancy</a> </div> </footer> <a href="#top" class="no-js scrollToTop" id="scrollToTop" data-label="Scroll to top"> <img src="/images/icons/chevron-up@2x.png" width="20" height="20" alt="scroll-to-top"/> </a> <script src="/js/jquery-1.7.1.min.js"></script> <script src="/js/jquery-ui-1.8.18.custom.min.js"></script> <script src="/js/jquery.defaultvalue.js"></script> <script src="/js/session.min.js"></script> <script src="/js/modernizr.js"></script> <script src="/js/modernize.js"></script> <script src="/js/application.min.js"></script> </div> </body> </html>