git-ls-files.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-ls-files(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-ls-files(1) Manual Page</h1>
 444 <h2 id="_name">NAME</h2>
 445 <div class="sectionbody">
 446 <p>git-ls-files - Show information about files in the index and the working tree</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 ls-files</em> [-z] [-t] [-v] [-f]
 455                 [-c|--cached] [-d|--deleted] [-o|--others] [-i|--ignored]
 456                 [-s|--stage] [-u|--unmerged] [-k|--killed] [-m|--modified]
 457                 [--resolve-undo]
 458                 [--directory [--no-empty-directory]] [--eol]
 459                 [--deduplicate]
 460                 [-x &lt;pattern&gt;|--exclude=&lt;pattern&gt;]
 461                 [-X &lt;file&gt;|--exclude-from=&lt;file&gt;]
 462                 [--exclude-per-directory=&lt;file&gt;]
 463                 [--exclude-standard]
 464                 [--error-unmatch] [--with-tree=&lt;tree-ish&gt;]
 465                 [--full-name] [--recurse-submodules]
 466                 [--abbrev[=&lt;n&gt;]] [--format=&lt;format&gt;] [--] [&lt;file&gt;&#8230;&#8203;]</pre>
 467 </div>
 468 </div>
 469 </div>
 470 <div class="sect1">
 471 <h2 id="_description">DESCRIPTION</h2>
 472 <div class="sectionbody">
 473 <div class="paragraph">
 474 <p>This command merges the file listing in the index with the actual working
 475 directory list, and shows different combinations of the two.</p>
 476 </div>
 477 <div class="paragraph">
 478 <p>Several flags can be used to determine which files are
 479 shown, and each file may be printed multiple times if there are
 480 multiple entries in the index or if multiple statuses are applicable for
 481 the relevant file selection options.</p>
 482 </div>
 483 </div>
 484 </div>
 485 <div class="sect1">
 486 <h2 id="_options">OPTIONS</h2>
 487 <div class="sectionbody">
 488 <div class="dlist">
 489 <dl>
 490 <dt class="hdlist1">-c</dt>
 491 <dt class="hdlist1">--cached</dt>
 492 <dd>
 493 <p>Show all files cached in Git&#8217;s index, i.e. all tracked files.
 494 (This is the default if no -c/-s/-d/-o/-u/-k/-m/--resolve-undo
 495 options are specified.)</p>
 496 </dd>
 497 <dt class="hdlist1">-d</dt>
 498 <dt class="hdlist1">--deleted</dt>
 499 <dd>
 500 <p>Show files with an unstaged deletion</p>
 501 </dd>
 502 <dt class="hdlist1">-m</dt>
 503 <dt class="hdlist1">--modified</dt>
 504 <dd>
 505 <p>Show files with an unstaged modification (note that an unstaged
 506 deletion also counts as an unstaged modification)</p>
 507 </dd>
 508 <dt class="hdlist1">-o</dt>
 509 <dt class="hdlist1">--others</dt>
 510 <dd>
 511 <p>Show other (i.e. untracked) files in the output</p>
 512 </dd>
 513 <dt class="hdlist1">-i</dt>
 514 <dt class="hdlist1">--ignored</dt>
 515 <dd>
 516 <p>Show only ignored files in the output.  Must be used with
 517 either an explicit <em>-c</em> or <em>-o</em>.  When showing files in the
 518 index (i.e. when used with <em>-c</em>), print only those files
 519 matching an exclude pattern.  When showing "other" files
 520 (i.e. when used with <em>-o</em>), show only those matched by an
 521 exclude pattern.  Standard ignore rules are not automatically
 522 activated; therefore, at least one of the <code>--exclude</code>* options
 523 is required.</p>
 524 </dd>
 525 <dt class="hdlist1">-s</dt>
 526 <dt class="hdlist1">--stage</dt>
 527 <dd>
 528 <p>Show staged contents' mode bits, object name and stage number in the output.</p>
 529 </dd>
 530 <dt class="hdlist1">--directory</dt>
 531 <dd>
 532 <p>If a whole directory is classified as "other", show just its
 533 name (with a trailing slash) and not its whole contents.
 534 Has no effect without -o/--others.</p>
 535 </dd>
 536 <dt class="hdlist1">--no-empty-directory</dt>
 537 <dd>
 538 <p>Do not list empty directories. Has no effect without --directory.</p>
 539 </dd>
 540 <dt class="hdlist1">-u</dt>
 541 <dt class="hdlist1">--unmerged</dt>
 542 <dd>
 543 <p>Show information about unmerged files in the output, but do
 544 not show any other tracked files (forces --stage, overrides
 545 --cached).</p>
 546 </dd>
 547 <dt class="hdlist1">-k</dt>
 548 <dt class="hdlist1">--killed</dt>
 549 <dd>
 550 <p>Show untracked files on the filesystem that need to be removed
 551 due to file/directory conflicts for tracked files to be able to
 552 be written to the filesystem.</p>
 553 </dd>
 554 <dt class="hdlist1">--resolve-undo</dt>
 555 <dd>
 556 <p>Show files having resolve-undo information in the index
 557 together with their resolve-undo information.  (resolve-undo
 558 information is what is used to implement "git checkout -m
 559 $PATH", i.e. to recreate merge conflicts that were
 560 accidentally resolved)</p>
 561 </dd>
 562 <dt class="hdlist1">-z</dt>
 563 <dd>
 564 <p>\0 line termination on output and do not quote filenames.
 565 See OUTPUT below for more information.</p>
 566 </dd>
 567 <dt class="hdlist1">--deduplicate</dt>
 568 <dd>
 569 <p>When only filenames are shown, suppress duplicates that may
 570 come from having multiple stages during a merge, or giving
 571 <code>--deleted</code> and <code>--modified</code> option at the same time.
 572 When any of the <code>-t</code>, <code>--unmerged</code>, or <code>--stage</code> option is
 573 in use, this option has no effect.</p>
 574 </dd>
 575 <dt class="hdlist1">-x &lt;pattern&gt;</dt>
 576 <dt class="hdlist1">--exclude=&lt;pattern&gt;</dt>
 577 <dd>
 578 <p>Skip untracked files matching pattern.
 579 Note that pattern is a shell wildcard pattern. See EXCLUDE PATTERNS
 580 below for more information.</p>
 581 </dd>
 582 <dt class="hdlist1">-X &lt;file&gt;</dt>
 583 <dt class="hdlist1">--exclude-from=&lt;file&gt;</dt>
 584 <dd>
 585 <p>Read exclude patterns from &lt;file&gt;; 1 per line.</p>
 586 </dd>
 587 <dt class="hdlist1">--exclude-per-directory=&lt;file&gt;</dt>
 588 <dd>
 589 <p>Read additional exclude patterns that apply only to the
 590 directory and its subdirectories in &lt;file&gt;.  If you are
 591 trying to emulate the way Porcelain commands work, using
 592 the <code>--exclude-standard</code> option instead is easier and more
 593 thorough.</p>
 594 </dd>
 595 <dt class="hdlist1">--exclude-standard</dt>
 596 <dd>
 597 <p>Add the standard Git exclusions: .git/info/exclude, .gitignore
 598 in each directory, and the user&#8217;s global exclusion file.</p>
 599 </dd>
 600 <dt class="hdlist1">--error-unmatch</dt>
 601 <dd>
 602 <p>If any &lt;file&gt; does not appear in the index, treat this as an
 603 error (return 1).</p>
 604 </dd>
 605 <dt class="hdlist1">--with-tree=&lt;tree-ish&gt;</dt>
 606 <dd>
 607 <p>When using --error-unmatch to expand the user supplied
 608 &lt;file&gt; (i.e. path pattern) arguments to paths, pretend
 609 that paths which were removed in the index since the
 610 named &lt;tree-ish&gt; are still present.  Using this option
 611 with <code>-s</code> or <code>-u</code> options does not make any sense.</p>
 612 </dd>
 613 <dt class="hdlist1">-t</dt>
 614 <dd>
 615 <p>Show status tags together with filenames.  Note that for
 616 scripting purposes, <a href="git-status.html">git-status(1)</a> <code>--porcelain</code> and
 617 <a href="git-diff-files.html">git-diff-files(1)</a> <code>--name-status</code> are almost always
 618 superior alternatives; users should look at
 619 <a href="git-status.html">git-status(1)</a> <code>--short</code> or <a href="git-diff.html">git-diff(1)</a>
 620 <code>--name-status</code> for more user-friendly alternatives.</p>
 621 <div class="openblock">
 622 <div class="content">
 623 <div class="paragraph">
 624 <p>This option provides a reason for showing each filename, in the form
 625 of a status tag (which is followed by a space and then the filename).
 626 The status tags are all single characters from the following list:</p>
 627 </div>
 628 <div class="dlist">
 629 <dl>
 630 <dt class="hdlist1">H</dt>
 631 <dd>
 632 <p>tracked file that is not either unmerged or skip-worktree</p>
 633 </dd>
 634 <dt class="hdlist1">S</dt>
 635 <dd>
 636 <p>tracked file that is skip-worktree</p>
 637 </dd>
 638 <dt class="hdlist1">M</dt>
 639 <dd>
 640 <p>tracked file that is unmerged</p>
 641 </dd>
 642 <dt class="hdlist1">R</dt>
 643 <dd>
 644 <p>tracked file with unstaged removal/deletion</p>
 645 </dd>
 646 <dt class="hdlist1">C</dt>
 647 <dd>
 648 <p>tracked file with unstaged modification/change</p>
 649 </dd>
 650 <dt class="hdlist1">K</dt>
 651 <dd>
 652 <p>untracked paths which are part of file/directory conflicts
 653 which prevent checking out tracked files</p>
 654 </dd>
 655 <dt class="hdlist1">?</dt>
 656 <dd>
 657 <p>untracked file</p>
 658 </dd>
 659 <dt class="hdlist1">U</dt>
 660 <dd>
 661 <p>file with resolve-undo information</p>
 662 </dd>
 663 </dl>
 664 </div>
 665 </div>
 666 </div>
 667 </dd>
 668 <dt class="hdlist1">-v</dt>
 669 <dd>
 670 <p>Similar to <code>-t</code>, but use lowercase letters for files
 671 that are marked as <em>assume unchanged</em> (see
 672 <a href="git-update-index.html">git-update-index(1)</a>).</p>
 673 </dd>
 674 <dt class="hdlist1">-f</dt>
 675 <dd>
 676 <p>Similar to <code>-t</code>, but use lowercase letters for files
 677 that are marked as <em>fsmonitor valid</em> (see
 678 <a href="git-update-index.html">git-update-index(1)</a>).</p>
 679 </dd>
 680 <dt class="hdlist1">--full-name</dt>
 681 <dd>
 682 <p>When run from a subdirectory, the command usually
 683 outputs paths relative to the current directory.  This
 684 option forces paths to be output relative to the project
 685 top directory.</p>
 686 </dd>
 687 <dt class="hdlist1">--recurse-submodules</dt>
 688 <dd>
 689 <p>Recursively calls ls-files on each active submodule in the repository.
 690 Currently there is only support for the --cached and --stage modes.</p>
 691 </dd>
 692 <dt class="hdlist1">--abbrev[=&lt;n&gt;]</dt>
 693 <dd>
 694 <p>Instead of showing the full 40-byte hexadecimal object
 695 lines, show the shortest prefix that is at least <em>&lt;n&gt;</em>
 696 hexdigits long that uniquely refers the object.
 697 Non default number of digits can be specified with --abbrev=&lt;n&gt;.</p>
 698 </dd>
 699 <dt class="hdlist1">--debug</dt>
 700 <dd>
 701 <p>After each line that describes a file, add more data about its
 702 cache entry.  This is intended to show as much information as
 703 possible for manual inspection; the exact format may change at
 704 any time.</p>
 705 </dd>
 706 <dt class="hdlist1">--eol</dt>
 707 <dd>
 708 <p>Show &lt;eolinfo&gt; and &lt;eolattr&gt; of files.
 709 &lt;eolinfo&gt; is the file content identification used by Git when
 710 the "text" attribute is "auto" (or not set and core.autocrlf is not false).
 711 &lt;eolinfo&gt; is either "-text", "none", "lf", "crlf", "mixed" or "".</p>
 712 <div class="paragraph">
 713 <p>"" means the file is not a regular file, it is not in the index or
 714 not accessible in the working tree.</p>
 715 </div>
 716 <div class="paragraph">
 717 <p>&lt;eolattr&gt; is the attribute that is used when checking out or committing,
 718 it is either "", "-text", "text", "text=auto", "text eol=lf", "text eol=crlf".
 719 Since Git 2.10 "text=auto eol=lf" and "text=auto eol=crlf" are supported.</p>
 720 </div>
 721 <div class="paragraph">
 722 <p>Both the &lt;eolinfo&gt; in the index ("i/&lt;eolinfo&gt;")
 723 and in the working tree ("w/&lt;eolinfo&gt;") are shown for regular files,
 724 followed by the  ("attr/&lt;eolattr&gt;").</p>
 725 </div>
 726 </dd>
 727 <dt class="hdlist1">--sparse</dt>
 728 <dd>
 729 <p>If the index is sparse, show the sparse directories without expanding
 730 to the contained files. Sparse directories will be shown with a
 731 trailing slash, such as "x/" for a sparse directory "x".</p>
 732 </dd>
 733 <dt class="hdlist1">--format=&lt;format&gt;</dt>
 734 <dd>
 735 <p>A string that interpolates %(<code>fieldname</code>) from the result being shown.
 736 It also interpolates %% to %, and %xXX where <code>XX</code> are hex digits
 737 interpolates to character with hex code <code>XX</code>; for example %x00
 738 interpolates to \0 (NUL), %x09 to \t (TAB) and %x0a to \n (LF).
 739 --format cannot be combined with <code>-s</code>, <code>-o</code>, <code>-k</code>, <code>-t</code>, <code>--resolve-undo</code>
 740 and <code>--eol</code>.</p>
 741 </dd>
 742 <dt class="hdlist1">--</dt>
 743 <dd>
 744 <p>Do not interpret any more arguments as options.</p>
 745 </dd>
 746 <dt class="hdlist1">&lt;file&gt;</dt>
 747 <dd>
 748 <p>Files to show. If no files are given all files which match the other
 749 specified criteria are shown.</p>
 750 </dd>
 751 </dl>
 752 </div>
 753 </div>
 754 </div>
 755 <div class="sect1">
 756 <h2 id="_output">OUTPUT</h2>
 757 <div class="sectionbody">
 758 <div class="paragraph">
 759 <p><em>git ls-files</em> just outputs the filenames unless <code>--stage</code> is specified in
 760 which case it outputs:</p>
 761 </div>
 762 <div class="literalblock">
 763 <div class="content">
 764 <pre>[&lt;tag&gt; ]&lt;mode&gt; &lt;object&gt; &lt;stage&gt; &lt;file&gt;</pre>
 765 </div>
 766 </div>
 767 <div class="paragraph">
 768 <p><em>git ls-files --eol</em> will show
 769         i/&lt;eolinfo&gt;&lt;SPACES&gt;w/&lt;eolinfo&gt;&lt;SPACES&gt;attr/&lt;eolattr&gt;&lt;SPACE*&gt;&lt;TAB&gt;&lt;file&gt;</p>
 770 </div>
 771 <div class="paragraph">
 772 <p><em>git ls-files --unmerged</em> and <em>git ls-files --stage</em> can be used to examine
 773 detailed information on unmerged paths.</p>
 774 </div>
 775 <div class="paragraph">
 776 <p>For an unmerged path, instead of recording a single mode/SHA-1 pair,
 777 the index records up to three such pairs; one from tree O in stage
 778 1, A in stage 2, and B in stage 3.  This information can be used by
 779 the user (or the porcelain) to see what should eventually be recorded at the
 780 path. (see <a href="git-read-tree.html">git-read-tree(1)</a> for more information on state)</p>
 781 </div>
 782 <div class="paragraph">
 783 <p>Without the <code>-z</code> option, pathnames with "unusual" characters are
 784 quoted as explained for the configuration variable <code>core.quotePath</code>
 785 (see <a href="git-config.html">git-config(1)</a>).  Using <code>-z</code> the filename is output
 786 verbatim and the line is terminated by a NUL byte.</p>
 787 </div>
 788 <div class="paragraph">
 789 <p>It is possible to print in a custom format by using the <code>--format</code>
 790 option, which is able to interpolate different fields using
 791 a %(<code>fieldname</code>) notation. For example, if you only care about the
 792 "objectname" and "path" fields, you can execute with a specific
 793 "--format" like</p>
 794 </div>
 795 <div class="literalblock">
 796 <div class="content">
 797 <pre>git ls-files --format='%(objectname) %(path)'</pre>
 798 </div>
 799 </div>
 800 </div>
 801 </div>
 802 <div class="sect1">
 803 <h2 id="_field_names">FIELD NAMES</h2>
 804 <div class="sectionbody">
 805 <div class="paragraph">
 806 <p>The way each path is shown can be customized by using the
 807 <code>--format=</code><em>&lt;format&gt;</em> option, where the %(fieldname) in the
 808 &lt;format&gt; string for various aspects of the index entry are
 809 interpolated.  The following "fieldname" are understood:</p>
 810 </div>
 811 <div class="dlist">
 812 <dl>
 813 <dt class="hdlist1">objectmode</dt>
 814 <dd>
 815 <p>The mode of the file which is recorded in the index.</p>
 816 </dd>
 817 <dt class="hdlist1">objecttype</dt>
 818 <dd>
 819 <p>The object type of the file which is recorded in the index.</p>
 820 </dd>
 821 <dt class="hdlist1">objectname</dt>
 822 <dd>
 823 <p>The name of the file which is recorded in the index.</p>
 824 </dd>
 825 <dt class="hdlist1">objectsize[:padded]</dt>
 826 <dd>
 827 <p>The object size of the file which is recorded in the index
 828 ("-" if the object is a <code>commit</code> or <code>tree</code>).
 829 It also supports a padded format of size with "%(objectsize:padded)".</p>
 830 </dd>
 831 <dt class="hdlist1">stage</dt>
 832 <dd>
 833 <p>The stage of the file which is recorded in the index.</p>
 834 </dd>
 835 <dt class="hdlist1">eolinfo:index</dt>
 836 <dt class="hdlist1">eolinfo:worktree</dt>
 837 <dd>
 838 <p>The &lt;eolinfo&gt; (see the description of the <code>--eol</code> option) of
 839 the contents in the index or in the worktree for the path.</p>
 840 </dd>
 841 <dt class="hdlist1">eolattr</dt>
 842 <dd>
 843 <p>The &lt;eolattr&gt; (see the description of the <code>--eol</code> option)
 844 that applies to the path.</p>
 845 </dd>
 846 <dt class="hdlist1">path</dt>
 847 <dd>
 848 <p>The pathname of the file which is recorded in the index.</p>
 849 </dd>
 850 </dl>
 851 </div>
 852 </div>
 853 </div>
 854 <div class="sect1">
 855 <h2 id="_exclude_patterns">EXCLUDE PATTERNS</h2>
 856 <div class="sectionbody">
 857 <div class="paragraph">
 858 <p><em>git ls-files</em> can use a list of "exclude patterns" when
 859 traversing the directory tree and finding files to show when the
 860 flags --others or --ignored are specified.  <a href="gitignore.html">gitignore(5)</a>
 861 specifies the format of exclude patterns.</p>
 862 </div>
 863 <div class="paragraph">
 864 <p>These exclude patterns can be specified from the following places,
 865 in order:</p>
 866 </div>
 867 <div class="olist arabic">
 868 <ol class="arabic">
 869 <li>
 870 <p>The command-line flag --exclude=&lt;pattern&gt; specifies a
 871 single pattern.  Patterns are ordered in the same order
 872 they appear in the command line.</p>
 873 </li>
 874 <li>
 875 <p>The command-line flag --exclude-from=&lt;file&gt; specifies a
 876 file containing a list of patterns.  Patterns are ordered
 877 in the same order they appear in the file.</p>
 878 </li>
 879 <li>
 880 <p>The command-line flag --exclude-per-directory=&lt;name&gt; specifies
 881 a name of the file in each directory <em>git ls-files</em>
 882 examines, normally .<code>gitignore</code>.  Files in deeper
 883 directories take precedence.  Patterns are ordered in the
 884 same order they appear in the files.</p>
 885 </li>
 886 </ol>
 887 </div>
 888 <div class="paragraph">
 889 <p>A pattern specified on the command line with --exclude or read
 890 from the file specified with --exclude-from is relative to the
 891 top of the directory tree.  A pattern read from a file specified
 892 by --exclude-per-directory is relative to the directory that the
 893 pattern file appears in.</p>
 894 </div>
 895 <div class="paragraph">
 896 <p>Generally, you should be able to use <code>--exclude-standard</code> when you
 897 want the exclude rules applied the same way as what Porcelain
 898 commands do.  To emulate what <code>--exclude-standard</code> specifies, you
 899 can give <code>--exclude-per-directory=.gitignore</code>, and then specify:</p>
 900 </div>
 901 <div class="olist arabic">
 902 <ol class="arabic">
 903 <li>
 904 <p>The file specified by the <code>core.excludesfile</code> configuration
 905 variable, if exists, or the <code>$XDG_CONFIG_HOME/git/ignore</code> file.</p>
 906 </li>
 907 <li>
 908 <p>The <code>$GIT_DIR/info/exclude</code> file.</p>
 909 </li>
 910 </ol>
 911 </div>
 912 <div class="paragraph">
 913 <p>via the <code>--exclude-from=</code> option.</p>
 914 </div>
 915 </div>
 916 </div>
 917 <div class="sect1">
 918 <h2 id="_see_also">SEE ALSO</h2>
 919 <div class="sectionbody">
 920 <div class="paragraph">
 921 <p><a href="git-read-tree.html">git-read-tree(1)</a>, <a href="gitignore.html">gitignore(5)</a></p>
 922 </div>
 923 </div>
 924 </div>
 925 <div class="sect1">
 926 <h2 id="_git">GIT</h2>
 927 <div class="sectionbody">
 928 <div class="paragraph">
 929 <p>Part of the <a href="git.html">git(1)</a> suite</p>
 930 </div>
 931 </div>
 932 </div>
 933 </div>
 934 <div id="footer">
 935 <div id="footer-text">
 936 Last updated 2024-08-14 15:45:55 -0700
 937 </div>
 938 </div>
 939 </body>
 940 </html>