git-status.html

   1 <!DOCTYPE html>
   2 <html xmlns="http://www.w3.org/1999/xhtml" lang="en">
   3 <head>
   4 <meta charset="UTF-8"/>
   5 <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
   6 <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
   7 <meta name="generator" content="Asciidoctor 2.0.20"/>
   8 <title>git-status(1)</title>
   9 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700"/>
  10 <style>
  11 /*! Asciidoctor default stylesheet | MIT License | https://asciidoctor.org */
  12 /* Uncomment the following line when using as a custom stylesheet */
  13 /* @import "https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700"; */
  14 html{font-family:sans-serif;-webkit-text-size-adjust:100%}
  15 a{background:none}
  16 a:focus{outline:thin dotted}
  17 a:active,a:hover{outline:0}
  18 h1{font-size:2em;margin:.67em 0}
  19 b,strong{font-weight:bold}
  20 abbr{font-size:.9em}
  21 abbr[title]{cursor:help;border-bottom:1px dotted #dddddf;text-decoration:none}
  22 dfn{font-style:italic}
  23 hr{height:0}
  24 mark{background:#ff0;color:#000}
  25 code,kbd,pre,samp{font-family:monospace;font-size:1em}
  26 pre{white-space:pre-wrap}
  27 q{quotes:"\201C" "\201D" "\2018" "\2019"}
  28 small{font-size:80%}
  29 sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}
  30 sup{top:-.5em}
  31 sub{bottom:-.25em}
  32 img{border:0}
  33 svg:not(:root){overflow:hidden}
  34 figure{margin:0}
  35 audio,video{display:inline-block}
  36 audio:not([controls]){display:none;height:0}
  37 fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}
  38 legend{border:0;padding:0}
  39 button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}
  40 button,input{line-height:normal}
  41 button,select{text-transform:none}
  42 button,html input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer}
  43 button[disabled],html input[disabled]{cursor:default}
  44 input[type=checkbox],input[type=radio]{padding:0}
  45 button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}
  46 textarea{overflow:auto;vertical-align:top}
  47 table{border-collapse:collapse;border-spacing:0}
  48 *,::before,::after{box-sizing:border-box}
  49 html,body{font-size:100%}
  50 body{background:#fff;color:rgba(0,0,0,.8);padding:0;margin:0;font-family:"Noto Serif","DejaVu Serif",serif;line-height:1;position:relative;cursor:auto;-moz-tab-size:4;-o-tab-size:4;tab-size:4;word-wrap:anywhere;-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased}
  51 a:hover{cursor:pointer}
  52 img,object,embed{max-width:100%;height:auto}
  53 object,embed{height:100%}
  54 img{-ms-interpolation-mode:bicubic}
  55 .left{float:left!important}
  56 .right{float:right!important}
  57 .text-left{text-align:left!important}
  58 .text-right{text-align:right!important}
  59 .text-center{text-align:center!important}
  60 .text-justify{text-align:justify!important}
  61 .hide{display:none}
  62 img,object,svg{display:inline-block;vertical-align:middle}
  63 textarea{height:auto;min-height:50px}
  64 select{width:100%}
  65 .subheader,.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{line-height:1.45;color:#7a2518;font-weight:400;margin-top:0;margin-bottom:.25em}
  66 div,dl,dt,dd,ul,ol,li,h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6,pre,form,p,blockquote,th,td{margin:0;padding:0}
  67 a{color:#2156a5;text-decoration:underline;line-height:inherit}
  68 a:hover,a:focus{color:#1d4b8f}
  69 a img{border:0}
  70 p{line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}
  71 p aside{font-size:.875em;line-height:1.35;font-style:italic}
  72 h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{font-family:"Open Sans","DejaVu Sans",sans-serif;font-weight:300;font-style:normal;color:#ba3925;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em;line-height:1.0125em}
  73 h1 small,h2 small,h3 small,#toctitle small,.sidebarblock>.content>.title small,h4 small,h5 small,h6 small{font-size:60%;color:#e99b8f;line-height:0}
  74 h1{font-size:2.125em}
  75 h2{font-size:1.6875em}
  76 h3,#toctitle,.sidebarblock>.content>.title{font-size:1.375em}
  77 h4,h5{font-size:1.125em}
  78 h6{font-size:1em}
  79 hr{border:solid #dddddf;border-width:1px 0 0;clear:both;margin:1.25em 0 1.1875em}
  80 em,i{font-style:italic;line-height:inherit}
  81 strong,b{font-weight:bold;line-height:inherit}
  82 small{font-size:60%;line-height:inherit}
  83 code{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;color:rgba(0,0,0,.9)}
  84 ul,ol,dl{line-height:1.6;margin-bottom:1.25em;list-style-position:outside;font-family:inherit}
  85 ul,ol{margin-left:1.5em}
  86 ul li ul,ul li ol{margin-left:1.25em;margin-bottom:0}
  87 ul.circle{list-style-type:circle}
  88 ul.disc{list-style-type:disc}
  89 ul.square{list-style-type:square}
  90 ul.circle ul:not([class]),ul.disc ul:not([class]),ul.square ul:not([class]){list-style:inherit}
  91 ol li ul,ol li ol{margin-left:1.25em;margin-bottom:0}
  92 dl dt{margin-bottom:.3125em;font-weight:bold}
  93 dl dd{margin-bottom:1.25em}
  94 blockquote{margin:0 0 1.25em;padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd}
  95 blockquote,blockquote p{line-height:1.6;color:rgba(0,0,0,.85)}
  96 @media screen and (min-width:768px){h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2}
  97 h1{font-size:2.75em}
  98 h2{font-size:2.3125em}
  99 h3,#toctitle,.sidebarblock>.content>.title{font-size:1.6875em}
 100 h4{font-size:1.4375em}}
 101 table{background:#fff;margin-bottom:1.25em;border:1px solid #dedede;word-wrap:normal}
 102 table thead,table tfoot{background:#f7f8f7}
 103 table thead tr th,table thead tr td,table tfoot tr th,table tfoot tr td{padding:.5em .625em .625em;font-size:inherit;color:rgba(0,0,0,.8);text-align:left}
 104 table tr th,table tr td{padding:.5625em .625em;font-size:inherit;color:rgba(0,0,0,.8)}
 105 table tr.even,table tr.alt{background:#f8f8f7}
 106 table thead tr th,table tfoot tr th,table tbody tr td,table tr td,table tfoot tr td{line-height:1.6}
 107 h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2;word-spacing:-.05em}
 108 h1 strong,h2 strong,h3 strong,#toctitle strong,.sidebarblock>.content>.title strong,h4 strong,h5 strong,h6 strong{font-weight:400}
 109 .center{margin-left:auto;margin-right:auto}
 110 .stretch{width:100%}
 111 .clearfix::before,.clearfix::after,.float-group::before,.float-group::after{content:" ";display:table}
 112 .clearfix::after,.float-group::after{clear:both}
 113 :not(pre).nobreak{word-wrap:normal}
 114 :not(pre).nowrap{white-space:nowrap}
 115 :not(pre).pre-wrap{white-space:pre-wrap}
 116 :not(pre):not([class^=L])>code{font-size:.9375em;font-style:normal!important;letter-spacing:0;padding:.1em .5ex;word-spacing:-.15em;background:#f7f7f8;border-radius:4px;line-height:1.45;text-rendering:optimizeSpeed}
 117 pre{color:rgba(0,0,0,.9);font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;line-height:1.45;text-rendering:optimizeSpeed}
 118 pre code,pre pre{color:inherit;font-size:inherit;line-height:inherit}
 119 pre>code{display:block}
 120 pre.nowrap,pre.nowrap pre{white-space:pre;word-wrap:normal}
 121 em em{font-style:normal}
 122 strong strong{font-weight:400}
 123 .keyseq{color:rgba(51,51,51,.8)}
 124 kbd{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;display:inline-block;color:rgba(0,0,0,.8);font-size:.65em;line-height:1.45;background:#f7f7f7;border:1px solid #ccc;border-radius:3px;box-shadow:0 1px 0 rgba(0,0,0,.2),inset 0 0 0 .1em #fff;margin:0 .15em;padding:.2em .5em;vertical-align:middle;position:relative;top:-.1em;white-space:nowrap}
 125 .keyseq kbd:first-child{margin-left:0}
 126 .keyseq kbd:last-child{margin-right:0}
 127 .menuseq,.menuref{color:#000}
 128 .menuseq b:not(.caret),.menuref{font-weight:inherit}
 129 .menuseq{word-spacing:-.02em}
 130 .menuseq b.caret{font-size:1.25em;line-height:.8}
 131 .menuseq i.caret{font-weight:bold;text-align:center;width:.45em}
 132 b.button::before,b.button::after{position:relative;top:-1px;font-weight:400}
 133 b.button::before{content:"[";padding:0 3px 0 2px}
 134 b.button::after{content:"]";padding:0 2px 0 3px}
 135 p a>code:hover{color:rgba(0,0,0,.9)}
 136 #header,#content,#footnotes,#footer{width:100%;margin:0 auto;max-width:62.5em;*zoom:1;position:relative;padding-left:.9375em;padding-right:.9375em}
 137 #header::before,#header::after,#content::before,#content::after,#footnotes::before,#footnotes::after,#footer::before,#footer::after{content:" ";display:table}
 138 #header::after,#content::after,#footnotes::after,#footer::after{clear:both}
 139 #content{margin-top:1.25em}
 140 #content::before{content:none}
 141 #header>h1:first-child{color:rgba(0,0,0,.85);margin-top:2.25rem;margin-bottom:0}
 142 #header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #dddddf}
 143 #header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #dddddf;padding-bottom:8px}
 144 #header .details{border-bottom:1px solid #dddddf;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:rgba(0,0,0,.6);display:flex;flex-flow:row wrap}
 145 #header .details span:first-child{margin-left:-.125em}
 146 #header .details span.email a{color:rgba(0,0,0,.85)}
 147 #header .details br{display:none}
 148 #header .details br+span::before{content:"\00a0\2013\00a0"}
 149 #header .details br+span.author::before{content:"\00a0\22c5\00a0";color:rgba(0,0,0,.85)}
 150 #header .details br+span#revremark::before{content:"\00a0|\00a0"}
 151 #header #revnumber{text-transform:capitalize}
 152 #header #revnumber::after{content:"\00a0"}
 153 #content>h1:first-child:not([class]){color:rgba(0,0,0,.85);border-bottom:1px solid #dddddf;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem}
 154 #toc{border-bottom:1px solid #e7e7e9;padding-bottom:.5em}
 155 #toc>ul{margin-left:.125em}
 156 #toc ul.sectlevel0>li>a{font-style:italic}
 157 #toc ul.sectlevel0 ul.sectlevel1{margin:.5em 0}
 158 #toc ul{font-family:"Open Sans","DejaVu Sans",sans-serif;list-style-type:none}
 159 #toc li{line-height:1.3334;margin-top:.3334em}
 160 #toc a{text-decoration:none}
 161 #toc a:active{text-decoration:underline}
 162 #toctitle{color:#7a2518;font-size:1.2em}
 163 @media screen and (min-width:768px){#toctitle{font-size:1.375em}
 164 body.toc2{padding-left:15em;padding-right:0}
 165 #toc.toc2{margin-top:0!important;background:#f8f8f7;position:fixed;width:15em;left:0;top:0;border-right:1px solid #e7e7e9;border-top-width:0!important;border-bottom-width:0!important;z-index:1000;padding:1.25em 1em;height:100%;overflow:auto}
 166 #toc.toc2 #toctitle{margin-top:0;margin-bottom:.8rem;font-size:1.2em}
 167 #toc.toc2>ul{font-size:.9em;margin-bottom:0}
 168 #toc.toc2 ul ul{margin-left:0;padding-left:1em}
 169 #toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:0;margin-top:.5em;margin-bottom:.5em}
 170 body.toc2.toc-right{padding-left:0;padding-right:15em}
 171 body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #e7e7e9;left:auto;right:0}}
 172 @media screen and (min-width:1280px){body.toc2{padding-left:20em;padding-right:0}
 173 #toc.toc2{width:20em}
 174 #toc.toc2 #toctitle{font-size:1.375em}
 175 #toc.toc2>ul{font-size:.95em}
 176 #toc.toc2 ul ul{padding-left:1.25em}
 177 body.toc2.toc-right{padding-left:0;padding-right:20em}}
 178 #content #toc{border:1px solid #e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;border-radius:4px}
 179 #content #toc>:first-child{margin-top:0}
 180 #content #toc>:last-child{margin-bottom:0}
 181 #footer{max-width:none;background:rgba(0,0,0,.8);padding:1.25em}
 182 #footer-text{color:hsla(0,0%,100%,.8);line-height:1.44}
 183 #content{margin-bottom:.625em}
 184 .sect1{padding-bottom:.625em}
 185 @media screen and (min-width:768px){#content{margin-bottom:1.25em}
 186 .sect1{padding-bottom:1.25em}}
 187 .sect1:last-child{padding-bottom:0}
 188 .sect1+.sect1{border-top:1px solid #e7e7e9}
 189 #content h1>a.anchor,h2>a.anchor,h3>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none!important;visibility:hidden;text-align:center;font-weight:400}
 190 #content h1>a.anchor::before,h2>a.anchor::before,h3>a.anchor::before,#toctitle>a.anchor::before,.sidebarblock>.content>.title>a.anchor::before,h4>a.anchor::before,h5>a.anchor::before,h6>a.anchor::before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em}
 191 #content h1:hover>a.anchor,#content h1>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,#toctitle:hover>a.anchor,.sidebarblock>.content>.title:hover>a.anchor,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}
 192 #content h1>a.link,h2>a.link,h3>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h4>a.link,h5>a.link,h6>a.link{color:#ba3925;text-decoration:none}
 193 #content h1>a.link:hover,h2>a.link:hover,h3>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#a53221}
 194 details,.audioblock,.imageblock,.literalblock,.listingblock,.stemblock,.videoblock{margin-bottom:1.25em}
 195 details{margin-left:1.25rem}
 196 details>summary{cursor:pointer;display:block;position:relative;line-height:1.6;margin-bottom:.625rem;outline:none;-webkit-tap-highlight-color:transparent}
 197 details>summary::-webkit-details-marker{display:none}
 198 details>summary::before{content:"";border:solid transparent;border-left:solid;border-width:.3em 0 .3em .5em;position:absolute;top:.5em;left:-1.25rem;transform:translateX(15%)}
 199 details[open]>summary::before{border:solid transparent;border-top:solid;border-width:.5em .3em 0;transform:translateY(15%)}
 200 details>summary::after{content:"";width:1.25rem;height:1em;position:absolute;top:.3em;left:-1.25rem}
 201 .admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{text-rendering:optimizeLegibility;text-align:left;font-family:"Noto Serif","DejaVu Serif",serif;font-size:1rem;font-style:italic}
 202 table.tableblock.fit-content>caption.title{white-space:nowrap;width:0}
 203 .paragraph.lead>p,#preamble>.sectionbody>[class=paragraph]:first-of-type p{font-size:1.21875em;line-height:1.6;color:rgba(0,0,0,.85)}
 204 .admonitionblock>table{border-collapse:separate;border:0;background:none;width:100%}
 205 .admonitionblock>table td.icon{text-align:center;width:80px}
 206 .admonitionblock>table td.icon img{max-width:none}
 207 .admonitionblock>table td.icon .title{font-weight:bold;font-family:"Open Sans","DejaVu Sans",sans-serif;text-transform:uppercase}
 208 .admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #dddddf;color:rgba(0,0,0,.6);word-wrap:anywhere}
 209 .admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}
 210 .exampleblock>.content{border:1px solid #e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;border-radius:4px}
 211 .sidebarblock{border:1px solid #dbdbd6;margin-bottom:1.25em;padding:1.25em;background:#f3f3f2;border-radius:4px}
 212 .sidebarblock>.content>.title{color:#7a2518;margin-top:0;text-align:center}
 213 .exampleblock>.content>:first-child,.sidebarblock>.content>:first-child{margin-top:0}
 214 .exampleblock>.content>:last-child,.exampleblock>.content>:last-child>:last-child,.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child{margin-bottom:0}
 215 .literalblock pre,.listingblock>.content>pre{border-radius:4px;overflow-x:auto;padding:1em;font-size:.8125em}
 216 @media screen and (min-width:768px){.literalblock pre,.listingblock>.content>pre{font-size:.90625em}}
 217 @media screen and (min-width:1280px){.literalblock pre,.listingblock>.content>pre{font-size:1em}}
 218 .literalblock pre,.listingblock>.content>pre:not(.highlight),.listingblock>.content>pre[class=highlight],.listingblock>.content>pre[class^="highlight "]{background:#f7f7f8}
 219 .literalblock.output pre{color:#f7f7f8;background:rgba(0,0,0,.9)}
 220 .listingblock>.content{position:relative}
 221 .listingblock code[data-lang]::before{display:none;content:attr(data-lang);position:absolute;font-size:.75em;top:.425rem;right:.5rem;line-height:1;text-transform:uppercase;color:inherit;opacity:.5}
 222 .listingblock:hover code[data-lang]::before{display:block}
 223 .listingblock.terminal pre .command::before{content:attr(data-prompt);padding-right:.5em;color:inherit;opacity:.5}
 224 .listingblock.terminal pre .command:not([data-prompt])::before{content:"$"}
 225 .listingblock pre.highlightjs{padding:0}
 226 .listingblock pre.highlightjs>code{padding:1em;border-radius:4px}
 227 .listingblock pre.prettyprint{border-width:0}
 228 .prettyprint{background:#f7f7f8}
 229 pre.prettyprint .linenums{line-height:1.45;margin-left:2em}
 230 pre.prettyprint li{background:none;list-style-type:inherit;padding-left:0}
 231 pre.prettyprint li code[data-lang]::before{opacity:1}
 232 pre.prettyprint li:not(:first-child) code[data-lang]::before{display:none}
 233 table.linenotable{border-collapse:separate;border:0;margin-bottom:0;background:none}
 234 table.linenotable td[class]{color:inherit;vertical-align:top;padding:0;line-height:inherit;white-space:normal}
 235 table.linenotable td.code{padding-left:.75em}
 236 table.linenotable td.linenos,pre.pygments .linenos{border-right:1px solid;opacity:.35;padding-right:.5em;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}
 237 pre.pygments span.linenos{display:inline-block;margin-right:.75em}
 238 .quoteblock{margin:0 1em 1.25em 1.5em;display:table}
 239 .quoteblock:not(.excerpt)>.title{margin-left:-1.5em;margin-bottom:.75em}
 240 .quoteblock blockquote,.quoteblock p{color:rgba(0,0,0,.85);font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify}
 241 .quoteblock blockquote{margin:0;padding:0;border:0}
 242 .quoteblock blockquote::before{content:"\201c";float:left;font-size:2.75em;font-weight:bold;line-height:.6em;margin-left:-.6em;color:#7a2518;text-shadow:0 1px 2px rgba(0,0,0,.1)}
 243 .quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}
 244 .quoteblock .attribution{margin-top:.75em;margin-right:.5ex;text-align:right}
 245 .verseblock{margin:0 1em 1.25em}
 246 .verseblock pre{font-family:"Open Sans","DejaVu Sans",sans-serif;font-size:1.15rem;color:rgba(0,0,0,.85);font-weight:300;text-rendering:optimizeLegibility}
 247 .verseblock pre strong{font-weight:400}
 248 .verseblock .attribution{margin-top:1.25rem;margin-left:.5ex}
 249 .quoteblock .attribution,.verseblock .attribution{font-size:.9375em;line-height:1.45;font-style:italic}
 250 .quoteblock .attribution br,.verseblock .attribution br{display:none}
 251 .quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.025em;color:rgba(0,0,0,.6)}
 252 .quoteblock.abstract blockquote::before,.quoteblock.excerpt blockquote::before,.quoteblock .quoteblock blockquote::before{display:none}
 253 .quoteblock.abstract blockquote,.quoteblock.abstract p,.quoteblock.excerpt blockquote,.quoteblock.excerpt p,.quoteblock .quoteblock blockquote,.quoteblock .quoteblock p{line-height:1.6;word-spacing:0}
 254 .quoteblock.abstract{margin:0 1em 1.25em;display:block}
 255 .quoteblock.abstract>.title{margin:0 0 .375em;font-size:1.15em;text-align:center}
 256 .quoteblock.excerpt>blockquote,.quoteblock .quoteblock{padding:0 0 .25em 1em;border-left:.25em solid #dddddf}
 257 .quoteblock.excerpt,.quoteblock .quoteblock{margin-left:0}
 258 .quoteblock.excerpt blockquote,.quoteblock.excerpt p,.quoteblock .quoteblock blockquote,.quoteblock .quoteblock p{color:inherit;font-size:1.0625rem}
 259 .quoteblock.excerpt .attribution,.quoteblock .quoteblock .attribution{color:inherit;font-size:.85rem;text-align:left;margin-right:0}
 260 p.tableblock:last-child{margin-bottom:0}
 261 td.tableblock>.content{margin-bottom:1.25em;word-wrap:anywhere}
 262 td.tableblock>.content>:last-child{margin-bottom:-1.25em}
 263 table.tableblock,th.tableblock,td.tableblock{border:0 solid #dedede}
 264 table.grid-all>*>tr>*{border-width:1px}
 265 table.grid-cols>*>tr>*{border-width:0 1px}
 266 table.grid-rows>*>tr>*{border-width:1px 0}
 267 table.frame-all{border-width:1px}
 268 table.frame-ends{border-width:1px 0}
 269 table.frame-sides{border-width:0 1px}
 270 table.frame-none>colgroup+*>:first-child>*,table.frame-sides>colgroup+*>:first-child>*{border-top-width:0}
 271 table.frame-none>:last-child>:last-child>*,table.frame-sides>:last-child>:last-child>*{border-bottom-width:0}
 272 table.frame-none>*>tr>:first-child,table.frame-ends>*>tr>:first-child{border-left-width:0}
 273 table.frame-none>*>tr>:last-child,table.frame-ends>*>tr>:last-child{border-right-width:0}
 274 table.stripes-all>*>tr,table.stripes-odd>*>tr:nth-of-type(odd),table.stripes-even>*>tr:nth-of-type(even),table.stripes-hover>*>tr:hover{background:#f8f8f7}
 275 th.halign-left,td.halign-left{text-align:left}
 276 th.halign-right,td.halign-right{text-align:right}
 277 th.halign-center,td.halign-center{text-align:center}
 278 th.valign-top,td.valign-top{vertical-align:top}
 279 th.valign-bottom,td.valign-bottom{vertical-align:bottom}
 280 th.valign-middle,td.valign-middle{vertical-align:middle}
 281 table thead th,table tfoot th{font-weight:bold}
 282 tbody tr th{background:#f7f8f7}
 283 tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:rgba(0,0,0,.8);font-weight:bold}
 284 p.tableblock>code:only-child{background:none;padding:0}
 285 p.tableblock{font-size:1em}
 286 ol{margin-left:1.75em}
 287 ul li ol{margin-left:1.5em}
 288 dl dd{margin-left:1.125em}
 289 dl dd:last-child,dl dd:last-child>:last-child{margin-bottom:0}
 290 li p,ul dd,ol dd,.olist .olist,.ulist .ulist,.ulist .olist,.olist .ulist{margin-bottom:.625em}
 291 ul.checklist,ul.none,ol.none,ul.no-bullet,ol.no-bullet,ol.unnumbered,ul.unstyled,ol.unstyled{list-style-type:none}
 292 ul.no-bullet,ol.no-bullet,ol.unnumbered{margin-left:.625em}
 293 ul.unstyled,ol.unstyled{margin-left:0}
 294 li>p:empty:only-child::before{content:"";display:inline-block}
 295 ul.checklist>li>p:first-child{margin-left:-1em}
 296 ul.checklist>li>p:first-child>.fa-square-o:first-child,ul.checklist>li>p:first-child>.fa-check-square-o:first-child{width:1.25em;font-size:.8em;position:relative;bottom:.125em}
 297 ul.checklist>li>p:first-child>input[type=checkbox]:first-child{margin-right:.25em}
 298 ul.inline{display:flex;flex-flow:row wrap;list-style:none;margin:0 0 .625em -1.25em}
 299 ul.inline>li{margin-left:1.25em}
 300 .unstyled dl dt{font-weight:400;font-style:normal}
 301 ol.arabic{list-style-type:decimal}
 302 ol.decimal{list-style-type:decimal-leading-zero}
 303 ol.loweralpha{list-style-type:lower-alpha}
 304 ol.upperalpha{list-style-type:upper-alpha}
 305 ol.lowerroman{list-style-type:lower-roman}
 306 ol.upperroman{list-style-type:upper-roman}
 307 ol.lowergreek{list-style-type:lower-greek}
 308 .hdlist>table,.colist>table{border:0;background:none}
 309 .hdlist>table>tbody>tr,.colist>table>tbody>tr{background:none}
 310 td.hdlist1,td.hdlist2{vertical-align:top;padding:0 .625em}
 311 td.hdlist1{font-weight:bold;padding-bottom:1.25em}
 312 td.hdlist2{word-wrap:anywhere}
 313 .literalblock+.colist,.listingblock+.colist{margin-top:-.5em}
 314 .colist td:not([class]):first-child{padding:.4em .75em 0;line-height:1;vertical-align:top}
 315 .colist td:not([class]):first-child img{max-width:none}
 316 .colist td:not([class]):last-child{padding:.25em 0}
 317 .thumb,.th{line-height:0;display:inline-block;border:4px solid #fff;box-shadow:0 0 0 1px #ddd}
 318 .imageblock.left{margin:.25em .625em 1.25em 0}
 319 .imageblock.right{margin:.25em 0 1.25em .625em}
 320 .imageblock>.title{margin-bottom:0}
 321 .imageblock.thumb,.imageblock.th{border-width:6px}
 322 .imageblock.thumb>.title,.imageblock.th>.title{padding:0 .125em}
 323 .image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0}
 324 .image.left{margin-right:.625em}
 325 .image.right{margin-left:.625em}
 326 a.image{text-decoration:none;display:inline-block}
 327 a.image object{pointer-events:none}
 328 sup.footnote,sup.footnoteref{font-size:.875em;position:static;vertical-align:super}
 329 sup.footnote a,sup.footnoteref a{text-decoration:none}
 330 sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}
 331 #footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em}
 332 #footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em;border-width:1px 0 0}
 333 #footnotes .footnote{padding:0 .375em 0 .225em;line-height:1.3334;font-size:.875em;margin-left:1.2em;margin-bottom:.2em}
 334 #footnotes .footnote a:first-of-type{font-weight:bold;text-decoration:none;margin-left:-1.05em}
 335 #footnotes .footnote:last-of-type{margin-bottom:0}
 336 #content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0}
 337 div.unbreakable{page-break-inside:avoid}
 338 .big{font-size:larger}
 339 .small{font-size:smaller}
 340 .underline{text-decoration:underline}
 341 .overline{text-decoration:overline}
 342 .line-through{text-decoration:line-through}
 343 .aqua{color:#00bfbf}
 344 .aqua-background{background:#00fafa}
 345 .black{color:#000}
 346 .black-background{background:#000}
 347 .blue{color:#0000bf}
 348 .blue-background{background:#0000fa}
 349 .fuchsia{color:#bf00bf}
 350 .fuchsia-background{background:#fa00fa}
 351 .gray{color:#606060}
 352 .gray-background{background:#7d7d7d}
 353 .green{color:#006000}
 354 .green-background{background:#007d00}
 355 .lime{color:#00bf00}
 356 .lime-background{background:#00fa00}
 357 .maroon{color:#600000}
 358 .maroon-background{background:#7d0000}
 359 .navy{color:#000060}
 360 .navy-background{background:#00007d}
 361 .olive{color:#606000}
 362 .olive-background{background:#7d7d00}
 363 .purple{color:#600060}
 364 .purple-background{background:#7d007d}
 365 .red{color:#bf0000}
 366 .red-background{background:#fa0000}
 367 .silver{color:#909090}
 368 .silver-background{background:#bcbcbc}
 369 .teal{color:#006060}
 370 .teal-background{background:#007d7d}
 371 .white{color:#bfbfbf}
 372 .white-background{background:#fafafa}
 373 .yellow{color:#bfbf00}
 374 .yellow-background{background:#fafa00}
 375 span.icon>.fa{cursor:default}
 376 a span.icon>.fa{cursor:inherit}
 377 .admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0,0,0,.5);cursor:default}
 378 .admonitionblock td.icon .icon-note::before{content:"\f05a";color:#19407c}
 379 .admonitionblock td.icon .icon-tip::before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155,155,0,.8);color:#111}
 380 .admonitionblock td.icon .icon-warning::before{content:"\f071";color:#bf6900}
 381 .admonitionblock td.icon .icon-caution::before{content:"\f06d";color:#bf3400}
 382 .admonitionblock td.icon .icon-important::before{content:"\f06a";color:#bf0000}
 383 .conum[data-value]{display:inline-block;color:#fff!important;background:rgba(0,0,0,.8);border-radius:50%;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans","DejaVu Sans",sans-serif;font-style:normal;font-weight:bold}
 384 .conum[data-value] *{color:#fff!important}
 385 .conum[data-value]+b{display:none}
 386 .conum[data-value]::after{content:attr(data-value)}
 387 pre .conum[data-value]{position:relative;top:-.125em}
 388 b.conum *{color:inherit!important}
 389 .conum:not([data-value]):empty{display:none}
 390 dt,th.tableblock,td.content,div.footnote{text-rendering:optimizeLegibility}
 391 h1,h2,p,td.content,span.alt,summary{letter-spacing:-.01em}
 392 p strong,td.content strong,div.footnote strong{letter-spacing:-.005em}
 393 p,blockquote,dt,td.content,td.hdlist1,span.alt,summary{font-size:1.0625rem}
 394 p{margin-bottom:1.25rem}
 395 .sidebarblock p,.sidebarblock dt,.sidebarblock td.content,p.tableblock{font-size:1em}
 396 .exampleblock>.content{background:#fffef7;border-color:#e0e0dc;box-shadow:0 1px 4px #e0e0dc}
 397 .print-only{display:none!important}
 398 @page{margin:1.25cm .75cm}
 399 @media print{*{box-shadow:none!important;text-shadow:none!important}
 400 html{font-size:80%}
 401 a{color:inherit!important;text-decoration:underline!important}
 402 a.bare,a[href^="#"],a[href^="mailto:"]{text-decoration:none!important}
 403 a[href^="http:"]:not(.bare)::after,a[href^="https:"]:not(.bare)::after{content:"(" attr(href) ")";display:inline-block;font-size:.875em;padding-left:.25em}
 404 abbr[title]{border-bottom:1px dotted}
 405 abbr[title]::after{content:" (" attr(title) ")"}
 406 pre,blockquote,tr,img,object,svg{page-break-inside:avoid}
 407 thead{display:table-header-group}
 408 svg{max-width:100%}
 409 p,blockquote,dt,td.content{font-size:1em;orphans:3;widows:3}
 410 h2,h3,#toctitle,.sidebarblock>.content>.title{page-break-after:avoid}
 411 #header,#content,#footnotes,#footer{max-width:none}
 412 #toc,.sidebarblock,.exampleblock>.content{background:none!important}
 413 #toc{border-bottom:1px solid #dddddf!important;padding-bottom:0!important}
 414 body.book #header{text-align:center}
 415 body.book #header>h1:first-child{border:0!important;margin:2.5em 0 1em}
 416 body.book #header .details{border:0!important;display:block;padding:0!important}
 417 body.book #header .details span:first-child{margin-left:0!important}
 418 body.book #header .details br{display:block}
 419 body.book #header .details br+span::before{content:none!important}
 420 body.book #toc{border:0!important;text-align:left!important;padding:0!important;margin:0!important}
 421 body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-break-before:always}
 422 .listingblock code[data-lang]::before{display:block}
 423 #footer{padding:0 .9375em}
 424 .hide-on-print{display:none!important}
 425 .print-only{display:block!important}
 426 .hide-for-print{display:none!important}
 427 .show-for-print{display:inherit!important}}
 428 @media amzn-kf8,print{#header>h1:first-child{margin-top:1.25rem}
 429 .sect1{padding:0!important}
 430 .sect1+.sect1{border:0}
 431 #footer{background:none}
 432 #footer-text{color:rgba(0,0,0,.6);font-size:.9em}}
 433 @media amzn-kf8{#header,#content,#footnotes,#footer{padding:0}}
 434 </style>
 435 <style>
 436 pre>code {
 437    display: inline;
 438 }
 439 </style>
 440 </head>
 441 <body class="manpage">
 442 <div id="header">
 443 <h1>git-status(1) Manual Page</h1>
 444 <h2 id="_name">NAME</h2>
 445 <div class="sectionbody">
 446 <p>git-status - Show the working tree status</p>
 447 </div>
 448 </div>
 449 <div id="content">
 450 <div class="sect1">
 451 <h2 id="_synopsis">SYNOPSIS</h2>
 452 <div class="sectionbody">
 453 <div class="verseblock">
 454 <pre class="content"><em>git status</em> [&lt;options&gt;] [--] [&lt;pathspec&gt;&#8230;&#8203;]</pre>
 455 </div>
 456 </div>
 457 </div>
 458 <div class="sect1">
 459 <h2 id="_description">DESCRIPTION</h2>
 460 <div class="sectionbody">
 461 <div class="paragraph">
 462 <p>Displays paths that have differences between the index file and the
 463 current HEAD commit, paths that have differences between the working
 464 tree and the index file, and paths in the working tree that are not
 465 tracked by Git (and are not ignored by <a href="gitignore.html">gitignore(5)</a>). The first
 466 are what you <em>would</em> commit by running <code>git</code> <code>commit</code>; the second and
 467 third are what you <em>could</em> commit by running <em>git add</em> before running
 468 <code>git</code> <code>commit</code>.</p>
 469 </div>
 470 </div>
 471 </div>
 472 <div class="sect1">
 473 <h2 id="_options">OPTIONS</h2>
 474 <div class="sectionbody">
 475 <div class="dlist">
 476 <dl>
 477 <dt class="hdlist1">-s</dt>
 478 <dt class="hdlist1">--short</dt>
 479 <dd>
 480 <p>Give the output in the short-format.</p>
 481 </dd>
 482 <dt class="hdlist1">-b</dt>
 483 <dt class="hdlist1">--branch</dt>
 484 <dd>
 485 <p>Show the branch and tracking info even in short-format.</p>
 486 </dd>
 487 <dt class="hdlist1">--show-stash</dt>
 488 <dd>
 489 <p>Show the number of entries currently stashed away.</p>
 490 </dd>
 491 <dt class="hdlist1">--porcelain[=&lt;version&gt;]</dt>
 492 <dd>
 493 <p>Give the output in an easy-to-parse format for scripts.
 494 This is similar to the short output, but will remain stable
 495 across Git versions and regardless of user configuration. See
 496 below for details.</p>
 497 <div class="paragraph">
 498 <p>The version parameter is used to specify the format version.
 499 This is optional and defaults to the original version <em>v1</em> format.</p>
 500 </div>
 501 </dd>
 502 <dt class="hdlist1">--long</dt>
 503 <dd>
 504 <p>Give the output in the long-format. This is the default.</p>
 505 </dd>
 506 <dt class="hdlist1">-v</dt>
 507 <dt class="hdlist1">--verbose</dt>
 508 <dd>
 509 <p>In addition to the names of files that have been changed, also
 510 show the textual changes that are staged to be committed
 511 (i.e., like the output of <code>git</code> <code>diff</code> <code>--cached</code>). If <code>-v</code> is specified
 512 twice, then also show the changes in the working tree that
 513 have not yet been staged (i.e., like the output of <code>git</code> <code>diff</code>).</p>
 514 </dd>
 515 <dt class="hdlist1">-u[&lt;mode&gt;]</dt>
 516 <dt class="hdlist1">--untracked-files[=&lt;mode&gt;]</dt>
 517 <dd>
 518 <p>Show untracked files.</p>
 519 <div class="openblock">
 520 <div class="content">
 521 <div class="paragraph">
 522 <p>The mode parameter is used to specify the handling of untracked files.
 523 It is optional: it defaults to <em>all</em>, and if specified, it must be
 524 stuck to the option (e.g. <code>-uno</code>, but not <code>-u</code> <code>no</code>).</p>
 525 </div>
 526 <div class="paragraph">
 527 <p>The possible options are:</p>
 528 </div>
 529 <div class="ulist">
 530 <ul>
 531 <li>
 532 <p><em>no</em>     - Show no untracked files.</p>
 533 </li>
 534 <li>
 535 <p><em>normal</em> - Shows untracked files and directories.</p>
 536 </li>
 537 <li>
 538 <p><em>all</em>    - Also shows individual files in untracked directories.</p>
 539 </li>
 540 </ul>
 541 </div>
 542 <div class="paragraph">
 543 <p>When <code>-u</code> option is not used, untracked files and directories are
 544 shown (i.e. the same as specifying <code>normal</code>), to help you avoid
 545 forgetting to add newly created files.  Because it takes extra work
 546 to find untracked files in the filesystem, this mode may take some
 547 time in a large working tree.
 548 Consider enabling untracked cache and split index if supported (see
 549 <code>git</code> <code>update-index</code> <code>--untracked-cache</code> and <code>git</code> <code>update-index</code>
 550 <code>--split-index</code>), Otherwise you can use <code>no</code> to have <code>git</code> <code>status</code>
 551 return more quickly without showing untracked files.
 552 All usual spellings for Boolean value <code>true</code> are taken as <code>normal</code>
 553 and <code>false</code> as <code>no</code>.</p>
 554 </div>
 555 <div class="paragraph">
 556 <p>The default can be changed using the status.showUntrackedFiles
 557 configuration variable documented in <a href="git-config.html">git-config(1)</a>.</p>
 558 </div>
 559 </div>
 560 </div>
 561 </dd>
 562 <dt class="hdlist1">--ignore-submodules[=&lt;when&gt;]</dt>
 563 <dd>
 564 <p>Ignore changes to submodules when looking for changes. &lt;when&gt; can be
 565 either "none", "untracked", "dirty" or "all", which is the default.
 566 Using "none" will consider the submodule modified when it either contains
 567 untracked or modified files or its HEAD differs from the commit recorded
 568 in the superproject and can be used to override any settings of the
 569 <em>ignore</em> option in <a href="git-config.html">git-config(1)</a> or <a href="gitmodules.html">gitmodules(5)</a>. When
 570 "untracked" is used submodules are not considered dirty when they only
 571 contain untracked content (but they are still scanned for modified
 572 content). Using "dirty" ignores all changes to the work tree of submodules,
 573 only changes to the commits stored in the superproject are shown (this was
 574 the behavior before 1.7.0). Using "all" hides all changes to submodules
 575 (and suppresses the output of submodule summaries when the config option
 576 <code>status.submoduleSummary</code> is set).</p>
 577 </dd>
 578 <dt class="hdlist1">--ignored[=&lt;mode&gt;]</dt>
 579 <dd>
 580 <p>Show ignored files as well.</p>
 581 <div class="openblock">
 582 <div class="content">
 583 <div class="paragraph">
 584 <p>The mode parameter is used to specify the handling of ignored files.
 585 It is optional: it defaults to <em>traditional</em>.</p>
 586 </div>
 587 <div class="paragraph">
 588 <p>The possible options are:</p>
 589 </div>
 590 <div class="ulist">
 591 <ul>
 592 <li>
 593 <p><em>traditional</em> - Shows ignored files and directories, unless
 594 --untracked-files=all is specified, in which case
 595 individual files in ignored directories are
 596 displayed.</p>
 597 </li>
 598 <li>
 599 <p><em>no</em>          - Show no ignored files.</p>
 600 </li>
 601 <li>
 602 <p><em>matching</em>    - Shows ignored files and directories matching an
 603 ignore pattern.</p>
 604 </li>
 605 </ul>
 606 </div>
 607 <div class="paragraph">
 608 <p>When <em>matching</em> mode is specified, paths that explicitly match an
 609 ignored pattern are shown. If a directory matches an ignore pattern,
 610 then it is shown, but not paths contained in the ignored directory. If
 611 a directory does not match an ignore pattern, but all contents are
 612 ignored, then the directory is not shown, but all contents are shown.</p>
 613 </div>
 614 </div>
 615 </div>
 616 </dd>
 617 <dt class="hdlist1">-z</dt>
 618 <dd>
 619 <p>Terminate entries with NUL, instead of LF.  This implies
 620 the <code>--porcelain=v1</code> output format if no other format is given.</p>
 621 </dd>
 622 <dt class="hdlist1">--column[=&lt;options&gt;]</dt>
 623 <dt class="hdlist1">--no-column</dt>
 624 <dd>
 625 <p>Display untracked files in columns. See configuration variable
 626 <code>column.status</code> for option syntax. <code>--column</code> and <code>--no-column</code>
 627 without options are equivalent to <em>always</em> and <em>never</em>
 628 respectively.</p>
 629 </dd>
 630 <dt class="hdlist1">--ahead-behind</dt>
 631 <dt class="hdlist1">--no-ahead-behind</dt>
 632 <dd>
 633 <p>Display or do not display detailed ahead/behind counts for the
 634 branch relative to its upstream branch.  Defaults to true.</p>
 635 </dd>
 636 <dt class="hdlist1">--renames</dt>
 637 <dt class="hdlist1">--no-renames</dt>
 638 <dd>
 639 <p>Turn on/off rename detection regardless of user configuration.
 640 See also <a href="git-diff.html">git-diff(1)</a> <code>--no-renames</code>.</p>
 641 </dd>
 642 <dt class="hdlist1">--find-renames[=&lt;n&gt;]</dt>
 643 <dd>
 644 <p>Turn on rename detection, optionally setting the similarity
 645 threshold.
 646 See also <a href="git-diff.html">git-diff(1)</a> <code>--find-renames</code>.</p>
 647 </dd>
 648 <dt class="hdlist1">&lt;pathspec&gt;&#8230;&#8203;</dt>
 649 <dd>
 650 <p>See the <em>pathspec</em> entry in <a href="gitglossary.html">gitglossary(7)</a>.</p>
 651 </dd>
 652 </dl>
 653 </div>
 654 </div>
 655 </div>
 656 <div class="sect1">
 657 <h2 id="_output">OUTPUT</h2>
 658 <div class="sectionbody">
 659 <div class="paragraph">
 660 <p>The output from this command is designed to be used as a commit
 661 template comment.
 662 The default, long format, is designed to be human readable,
 663 verbose and descriptive.  Its contents and format are subject to change
 664 at any time.</p>
 665 </div>
 666 <div class="paragraph">
 667 <p>The paths mentioned in the output, unlike many other Git commands, are
 668 made relative to the current directory if you are working in a
 669 subdirectory (this is on purpose, to help cutting and pasting). See
 670 the status.relativePaths config option below.</p>
 671 </div>
 672 <div class="sect2">
 673 <h3 id="_short_format">Short Format</h3>
 674 <div class="paragraph">
 675 <p>In the short-format, the status of each path is shown as one of these
 676 forms</p>
 677 </div>
 678 <div class="literalblock">
 679 <div class="content">
 680 <pre>XY PATH
 681 XY ORIG_PATH -&gt; PATH</pre>
 682 </div>
 683 </div>
 684 <div class="paragraph">
 685 <p>where <code>ORIG_PATH</code> is where the renamed/copied contents came
 686 from. <code>ORIG_PATH</code> is only shown when the entry is renamed or
 687 copied. The <code>XY</code> is a two-letter status code.</p>
 688 </div>
 689 <div class="paragraph">
 690 <p>The fields (including the <code>-</code>&gt;) are separated from each other by a
 691 single space. If a filename contains whitespace or other nonprintable
 692 characters, that field will be quoted in the manner of a C string
 693 literal: surrounded by ASCII double quote (34) characters, and with
 694 interior special characters backslash-escaped.</p>
 695 </div>
 696 <div class="paragraph">
 697 <p>There are three different types of states that are shown using this format, and
 698 each one uses the <code>XY</code> syntax differently:</p>
 699 </div>
 700 <div class="ulist">
 701 <ul>
 702 <li>
 703 <p>When a merge is occurring and the merge was successful, or outside of a merge
 704 situation, <code>X</code> shows the status of the index and <code>Y</code> shows the status of the
 705 working tree.</p>
 706 </li>
 707 <li>
 708 <p>When a merge conflict has occurred and has not yet been resolved, <code>X</code> and <code>Y</code>
 709 show the state introduced by each head of the merge, relative to the common
 710 ancestor. These paths are said to be <em>unmerged</em>.</p>
 711 </li>
 712 <li>
 713 <p>When a path is untracked, <code>X</code> and <code>Y</code> are always the same, since they are
 714 unknown to the index. ?? is used for untracked paths. Ignored files are
 715 not listed unless <code>--ignored</code> is used; if it is, ignored files are indicated
 716 by !!.</p>
 717 </li>
 718 </ul>
 719 </div>
 720 <div class="paragraph">
 721 <p>Note that the term <em>merge</em> here also includes rebases using the default
 722 <code>--merge</code> strategy, cherry-picks, and anything else using the merge machinery.</p>
 723 </div>
 724 <div class="paragraph">
 725 <p>In the following table, these three classes are shown in separate sections, and
 726 these characters are used for <code>X</code> and <code>Y</code> fields for the first two sections that
 727 show tracked paths:</p>
 728 </div>
 729 <div class="ulist">
 730 <ul>
 731 <li>
 732 <p>' ' = unmodified</p>
 733 </li>
 734 <li>
 735 <p><em>M</em> = modified</p>
 736 </li>
 737 <li>
 738 <p><em>T</em> = file type changed (regular file, symbolic link or submodule)</p>
 739 </li>
 740 <li>
 741 <p><em>A</em> = added</p>
 742 </li>
 743 <li>
 744 <p><em>D</em> = deleted</p>
 745 </li>
 746 <li>
 747 <p><em>R</em> = renamed</p>
 748 </li>
 749 <li>
 750 <p><em>C</em> = copied (if config option status.renames is set to "copies")</p>
 751 </li>
 752 <li>
 753 <p><em>U</em> = updated but unmerged</p>
 754 </li>
 755 </ul>
 756 </div>
 757 <div class="literalblock">
 758 <div class="content">
 759 <pre>X          Y     Meaning
 760 -------------------------------------------------
 761          [AMD]   not updated
 762 M        [ MTD]  updated in index
 763 T        [ MTD]  type changed in index
 764 A        [ MTD]  added to index
 765 D                deleted from index
 766 R        [ MTD]  renamed in index
 767 C        [ MTD]  copied in index
 768 [MTARC]          index and work tree matches
 769 [ MTARC]    M    work tree changed since index
 770 [ MTARC]    T    type changed in work tree since index
 771 [ MTARC]    D    deleted in work tree
 772             R    renamed in work tree
 773             C    copied in work tree
 774 -------------------------------------------------
 775 D           D    unmerged, both deleted
 776 A           U    unmerged, added by us
 777 U           D    unmerged, deleted by them
 778 U           A    unmerged, added by them
 779 D           U    unmerged, deleted by us
 780 A           A    unmerged, both added
 781 U           U    unmerged, both modified
 782 -------------------------------------------------
 783 ?           ?    untracked
 784 !           !    ignored
 785 -------------------------------------------------</pre>
 786 </div>
 787 </div>
 788 <div class="paragraph">
 789 <p>Submodules have more state and instead report</p>
 790 </div>
 791 <div class="ulist">
 792 <ul>
 793 <li>
 794 <p><em>M</em> = the submodule has a different HEAD than recorded in the index</p>
 795 </li>
 796 <li>
 797 <p><em>m</em> = the submodule has modified content</p>
 798 </li>
 799 <li>
 800 <p><em>?</em> = the submodule has untracked files</p>
 801 </li>
 802 </ul>
 803 </div>
 804 <div class="paragraph">
 805 <p>This is since modified content or untracked files in a submodule cannot be added
 806 via <code>git</code> <code>add</code> in the superproject to prepare a commit.</p>
 807 </div>
 808 <div class="paragraph">
 809 <p><em>m</em> and <em>?</em> are applied recursively. For example if a nested submodule
 810 in a submodule contains an untracked file, this is reported as <em>?</em> as well.</p>
 811 </div>
 812 <div class="paragraph">
 813 <p>If -b is used the short-format status is preceded by a line</p>
 814 </div>
 815 <div class="literalblock">
 816 <div class="content">
 817 <pre>## branchname tracking info</pre>
 818 </div>
 819 </div>
 820 </div>
 821 <div class="sect2">
 822 <h3 id="_porcelain_format_version_1">Porcelain Format Version 1</h3>
 823 <div class="paragraph">
 824 <p>Version 1 porcelain format is similar to the short format, but is guaranteed
 825 not to change in a backwards-incompatible way between Git versions or
 826 based on user configuration. This makes it ideal for parsing by scripts.
 827 The description of the short format above also describes the porcelain
 828 format, with a few exceptions:</p>
 829 </div>
 830 <div class="olist arabic">
 831 <ol class="arabic">
 832 <li>
 833 <p>The user&#8217;s color.status configuration is not respected; color will
 834 always be off.</p>
 835 </li>
 836 <li>
 837 <p>The user&#8217;s status.relativePaths configuration is not respected; paths
 838 shown will always be relative to the repository root.</p>
 839 </li>
 840 </ol>
 841 </div>
 842 <div class="paragraph">
 843 <p>There is also an alternate -z format recommended for machine parsing. In
 844 that format, the status field is the same, but some other things
 845 change.  First, the <em>-&gt;</em> is omitted from rename entries and the field
 846 order is reversed (e.g <em>from -&gt; to</em> becomes <em>to from</em>). Second, a NUL
 847 (ASCII 0) follows each filename, replacing space as a field separator
 848 and the terminating newline (but a space still separates the status
 849 field from the first filename).  Third, filenames containing special
 850 characters are not specially formatted; no quoting or
 851 backslash-escaping is performed.</p>
 852 </div>
 853 <div class="paragraph">
 854 <p>Any submodule changes are reported as modified <code>M</code> instead of <code>m</code> or single ?.</p>
 855 </div>
 856 </div>
 857 <div class="sect2">
 858 <h3 id="_porcelain_format_version_2">Porcelain Format Version 2</h3>
 859 <div class="paragraph">
 860 <p>Version 2 format adds more detailed information about the state of
 861 the worktree and changed items.  Version 2 also defines an extensible
 862 set of easy to parse optional headers.</p>
 863 </div>
 864 <div class="paragraph">
 865 <p>Header lines start with "#" and are added in response to specific
 866 command line arguments.  Parsers should ignore headers they
 867 don&#8217;t recognize.</p>
 868 </div>
 869 <div class="sect3">
 870 <h4 id="_branch_headers">Branch Headers</h4>
 871 <div class="paragraph">
 872 <p>If <code>--branch</code> is given, a series of header lines are printed with
 873 information about the current branch.</p>
 874 </div>
 875 <div class="literalblock">
 876 <div class="content">
 877 <pre>Line                                     Notes
 878 ------------------------------------------------------------
 879 # branch.oid &lt;commit&gt; | (initial)        Current commit.
 880 # branch.head &lt;branch&gt; | (detached)      Current branch.
 881 # branch.upstream &lt;upstream-branch&gt;      If upstream is set.
 882 # branch.ab +&lt;ahead&gt; -&lt;behind&gt;           If upstream is set and
 883                                          the commit is present.
 884 ------------------------------------------------------------</pre>
 885 </div>
 886 </div>
 887 </div>
 888 <div class="sect3">
 889 <h4 id="_stash_information">Stash Information</h4>
 890 <div class="paragraph">
 891 <p>If <code>--show-stash</code> is given, one line is printed showing the number of stash
 892 entries if non-zero:</p>
 893 </div>
 894 <div class="literalblock">
 895 <div class="content">
 896 <pre># stash &lt;N&gt;</pre>
 897 </div>
 898 </div>
 899 </div>
 900 <div class="sect3">
 901 <h4 id="_changed_tracked_entries">Changed Tracked Entries</h4>
 902 <div class="paragraph">
 903 <p>Following the headers, a series of lines are printed for tracked
 904 entries.  One of three different line formats may be used to describe
 905 an entry depending on the type of change.  Tracked entries are printed
 906 in an undefined order; parsers should allow for a mixture of the 3
 907 line types in any order.</p>
 908 </div>
 909 <div class="paragraph">
 910 <p>Ordinary changed entries have the following format:</p>
 911 </div>
 912 <div class="literalblock">
 913 <div class="content">
 914 <pre>1 &lt;XY&gt; &lt;sub&gt; &lt;mH&gt; &lt;mI&gt; &lt;mW&gt; &lt;hH&gt; &lt;hI&gt; &lt;path&gt;</pre>
 915 </div>
 916 </div>
 917 <div class="paragraph">
 918 <p>Renamed or copied entries have the following format:</p>
 919 </div>
 920 <div class="literalblock">
 921 <div class="content">
 922 <pre>2 &lt;XY&gt; &lt;sub&gt; &lt;mH&gt; &lt;mI&gt; &lt;mW&gt; &lt;hH&gt; &lt;hI&gt; &lt;X&gt;&lt;score&gt; &lt;path&gt;&lt;sep&gt;&lt;origPath&gt;</pre>
 923 </div>
 924 </div>
 925 <div class="literalblock">
 926 <div class="content">
 927 <pre>Field       Meaning
 928 --------------------------------------------------------
 929 &lt;XY&gt;        A 2 character field containing the staged and
 930             unstaged XY values described in the short format,
 931             with unchanged indicated by a "." rather than
 932             a space.
 933 &lt;sub&gt;       A 4 character field describing the submodule state.
 934             "N..." when the entry is not a submodule.
 935             "S&lt;c&gt;&lt;m&gt;&lt;u&gt;" when the entry is a submodule.
 936             &lt;c&gt; is "C" if the commit changed; otherwise ".".
 937             &lt;m&gt; is "M" if it has tracked changes; otherwise ".".
 938             &lt;u&gt; is "U" if there are untracked changes; otherwise ".".
 939 &lt;mH&gt;        The octal file mode in HEAD.
 940 &lt;mI&gt;        The octal file mode in the index.
 941 &lt;mW&gt;        The octal file mode in the worktree.
 942 &lt;hH&gt;        The object name in HEAD.
 943 &lt;hI&gt;        The object name in the index.
 944 &lt;X&gt;&lt;score&gt;  The rename or copy score (denoting the percentage
 945             of similarity between the source and target of the
 946             move or copy). For example "R100" or "C75".
 947 &lt;path&gt;      The pathname.  In a renamed/copied entry, this
 948             is the target path.
 949 &lt;sep&gt;       When the `-z` option is used, the 2 pathnames are separated
 950             with a NUL (ASCII 0x00) byte; otherwise, a tab (ASCII 0x09)
 951             byte separates them.
 952 &lt;origPath&gt;  The pathname in the commit at HEAD or in the index.
 953             This is only present in a renamed/copied entry, and
 954             tells where the renamed/copied contents came from.
 955 --------------------------------------------------------</pre>
 956 </div>
 957 </div>
 958 <div class="paragraph">
 959 <p>Unmerged entries have the following format; the first character is
 960 a "u" to distinguish from ordinary changed entries.</p>
 961 </div>
 962 <div class="literalblock">
 963 <div class="content">
 964 <pre>u &lt;XY&gt; &lt;sub&gt; &lt;m1&gt; &lt;m2&gt; &lt;m3&gt; &lt;mW&gt; &lt;h1&gt; &lt;h2&gt; &lt;h3&gt; &lt;path&gt;</pre>
 965 </div>
 966 </div>
 967 <div class="literalblock">
 968 <div class="content">
 969 <pre>Field       Meaning
 970 --------------------------------------------------------
 971 &lt;XY&gt;        A 2 character field describing the conflict type
 972             as described in the short format.
 973 &lt;sub&gt;       A 4 character field describing the submodule state
 974             as described above.
 975 &lt;m1&gt;        The octal file mode in stage 1.
 976 &lt;m2&gt;        The octal file mode in stage 2.
 977 &lt;m3&gt;        The octal file mode in stage 3.
 978 &lt;mW&gt;        The octal file mode in the worktree.
 979 &lt;h1&gt;        The object name in stage 1.
 980 &lt;h2&gt;        The object name in stage 2.
 981 &lt;h3&gt;        The object name in stage 3.
 982 &lt;path&gt;      The pathname.
 983 --------------------------------------------------------</pre>
 984 </div>
 985 </div>
 986 </div>
 987 <div class="sect3">
 988 <h4 id="_other_items">Other Items</h4>
 989 <div class="paragraph">
 990 <p>Following the tracked entries (and if requested), a series of
 991 lines will be printed for untracked and then ignored items
 992 found in the worktree.</p>
 993 </div>
 994 <div class="paragraph">
 995 <p>Untracked items have the following format:</p>
 996 </div>
 997 <div class="literalblock">
 998 <div class="content">
 999 <pre>? &lt;path&gt;</pre>
1000 </div>
1001 </div>
1002 <div class="paragraph">
1003 <p>Ignored items have the following format:</p>
1004 </div>
1005 <div class="literalblock">
1006 <div class="content">
1007 <pre>! &lt;path&gt;</pre>
1008 </div>
1009 </div>
1010 </div>
1011 <div class="sect3">
1012 <h4 id="_pathname_format_notes_and_z">Pathname Format Notes and -z</h4>
1013 <div class="paragraph">
1014 <p>When the <code>-z</code> option is given, pathnames are printed as is and
1015 without any quoting and lines are terminated with a NUL (ASCII 0x00)
1016 byte.</p>
1017 </div>
1018 <div class="paragraph">
1019 <p>Without the <code>-z</code> option, pathnames with "unusual" characters are
1020 quoted as explained for the configuration variable <code>core.quotePath</code>
1021 (see <a href="git-config.html">git-config(1)</a>).</p>
1022 </div>
1023 </div>
1024 </div>
1025 </div>
1026 </div>
1027 <div class="sect1">
1028 <h2 id="_configuration">CONFIGURATION</h2>
1029 <div class="sectionbody">
1030 <div class="paragraph">
1031 <p>The command honors <code>color.status</code> (or <code>status.color</code>&#8201;&#8212;&#8201;they
1032 mean the same thing and the latter is kept for backward
1033 compatibility) and <code>color.status.</code><em>&lt;slot&gt;</em> configuration variables
1034 to colorize its output.</p>
1035 </div>
1036 <div class="paragraph">
1037 <p>If the config variable <code>status.relativePaths</code> is set to false, then all
1038 paths shown are relative to the repository root, not to the current
1039 directory.</p>
1040 </div>
1041 <div class="paragraph">
1042 <p>If <code>status.submoduleSummary</code> is set to a non zero number or true (identical
1043 to -1 or an unlimited number), the submodule summary will be enabled for
1044 the long format and a summary of commits for modified submodules will be
1045 shown (see --summary-limit option of <a href="git-submodule.html">git-submodule(1)</a>). Please note
1046 that the summary output from the status command will be suppressed for all
1047 submodules when <code>diff.ignoreSubmodules</code> is set to <em>all</em> or only for those
1048 submodules where <code>submodule.</code><em>&lt;name&gt;</em><code>.ignore=all</code>. To also view the summary for
1049 ignored submodules you can either use the --ignore-submodules=dirty command
1050 line option or the <em>git submodule summary</em> command, which shows a similar
1051 output but does not honor these settings.</p>
1052 </div>
1053 </div>
1054 </div>
1055 <div class="sect1">
1056 <h2 id="_background_refresh">BACKGROUND REFRESH</h2>
1057 <div class="sectionbody">
1058 <div class="paragraph">
1059 <p>By default, <code>git</code> <code>status</code> will automatically refresh the index, updating
1060 the cached stat information from the working tree and writing out the
1061 result. Writing out the updated index is an optimization that isn&#8217;t
1062 strictly necessary (<code>status</code> computes the values for itself, but writing
1063 them out is just to save subsequent programs from repeating our
1064 computation). When <code>status</code> is run in the background, the lock held
1065 during the write may conflict with other simultaneous processes, causing
1066 them to fail. Scripts running <code>status</code> in the background should consider
1067 using <code>git</code> <code>--no-optional-locks</code> <code>status</code> (see <a href="git.html">git(1)</a> for details).</p>
1068 </div>
1069 </div>
1070 </div>
1071 <div class="sect1">
1072 <h2 id="_untracked_files_and_performance">UNTRACKED FILES AND PERFORMANCE</h2>
1073 <div class="sectionbody">
1074 <div class="paragraph">
1075 <p><code>git</code> <code>status</code> can be very slow in large worktrees if/when it
1076 needs to search for untracked files and directories. There are
1077 many configuration options available to speed this up by either
1078 avoiding the work or making use of cached results from previous
1079 Git commands. There is no single optimum set of settings right
1080 for everyone. We&#8217;ll list a summary of the relevant options to help
1081 you, but before going into the list, you may want to run <code>git</code> <code>status</code>
1082 again, because your configuration may already be caching <code>git</code> <code>status</code>
1083 results, so it could be faster on subsequent runs.</p>
1084 </div>
1085 <div class="ulist">
1086 <ul>
1087 <li>
1088 <p>The <code>--untracked-files=no</code> flag or the
1089 <code>status.showUntrackedFiles=no</code> config (see above for both):
1090 indicate that <code>git</code> <code>status</code> should not report untracked
1091 files. This is the fastest option. <code>git</code> <code>status</code> will not list
1092 the untracked files, so you need to be careful to remember if
1093 you create any new files and manually <code>git</code> <code>add</code> them.</p>
1094 </li>
1095 <li>
1096 <p><code>advice.statusUoption=false</code> (see <a href="git-config.html">git-config(1)</a>):
1097 setting this variable to <code>false</code> disables the warning message
1098 given when enumerating untracked files takes more than 2
1099 seconds.  In a large project, it may take longer and the user
1100 may have already accepted the trade off (e.g. using "-uno" may
1101 not be an acceptable option for the user), in which case, there
1102 is no point issuing the warning message, and in such a case,
1103 disabling the warning may be the best.</p>
1104 </li>
1105 <li>
1106 <p><code>core.untrackedCache=true</code> (see <a href="git-update-index.html">git-update-index(1)</a>):
1107 enable the untracked cache feature and only search directories
1108 that have been modified since the previous <code>git</code> <code>status</code> command.
1109 Git remembers the set of untracked files within each directory
1110 and assumes that if a directory has not been modified, then
1111 the set of untracked files within has not changed.  This is much
1112 faster than enumerating the contents of every directory, but still
1113 not without cost, because Git still has to search for the set of
1114 modified directories. The untracked cache is stored in the
1115 .<code>git/index</code> file. The reduced cost of searching for untracked
1116 files is offset slightly by the increased size of the index and
1117 the cost of keeping it up-to-date. That reduced search time is
1118 usually worth the additional size.</p>
1119 </li>
1120 <li>
1121 <p><code>core.untrackedCache=true</code> and <code>core.fsmonitor=true</code> or
1122 <code>core.fsmonitor=</code><em>&lt;hook-command-pathname&gt;</em> (see
1123 <a href="git-update-index.html">git-update-index(1)</a>): enable both the untracked cache
1124 and FSMonitor features and only search directories that have
1125 been modified since the previous <code>git</code> <code>status</code> command.  This
1126 is faster than using just the untracked cache alone because
1127 Git can also avoid searching for modified directories.  Git
1128 only has to enumerate the exact set of directories that have
1129 changed recently. While the FSMonitor feature can be enabled
1130 without the untracked cache, the benefits are greatly reduced
1131 in that case.</p>
1132 </li>
1133 </ul>
1134 </div>
1135 <div class="paragraph">
1136 <p>Note that after you turn on the untracked cache and/or FSMonitor
1137 features it may take a few <code>git</code> <code>status</code> commands for the various
1138 caches to warm up before you see improved command times.  This is
1139 normal.</p>
1140 </div>
1141 </div>
1142 </div>
1143 <div class="sect1">
1144 <h2 id="_see_also">SEE ALSO</h2>
1145 <div class="sectionbody">
1146 <div class="paragraph">
1147 <p><a href="gitignore.html">gitignore(5)</a></p>
1148 </div>
1149 </div>
1150 </div>
1151 <div class="sect1">
1152 <h2 id="_git">GIT</h2>
1153 <div class="sectionbody">
1154 <div class="paragraph">
1155 <p>Part of the <a href="git.html">git(1)</a> suite</p>
1156 </div>
1157 </div>
1158 </div>
1159 </div>
1160 <div id="footer">
1161 <div id="footer-text">
1162 Last updated 2024-03-28 14:36:08 -0700
1163 </div>
1164 </div>
1165 </body>
1166 </html>