1git-ls-files(1) 2=============== 3v0.1, May 2005 4 5NAME 6---- 7git-ls-files - Information about files in the cache/working directory 8 9 10SYNOPSIS 11-------- 12'git-ls-files' [-z] [-t] 13 (--[cached|deleted|others|ignored|stage|unmerged])\* 14 (-[c|d|o|i|s|u])\* 15 [-x <pattern>|--exclude=<pattern>] 16 [-X <file>|--exclude-from=<file>] 17 18DESCRIPTION 19----------- 20This merges the file listing in the directory cache index with the 21actual working directory list, and shows different combinations of the 22two. 23 24One or more of the options below may be used to determine the files 25shown: 26 27OPTIONS 28------- 29-c|--cached:: 30 Show cached files in the output (default) 31 32-d|--deleted:: 33 Show deleted files in the output 34 35-o|--others:: 36 Show other files in the output 37 38-i|--ignored:: 39 Show ignored files in the output 40 Note the this also reverses any exclude list present. 41 42-s|--stage:: 43 Show stage files in the output 44 45-u|--unmerged:: 46 Show unmerged files in the output (forces --stage) 47 48-z:: 49 \0 line termination on output 50 51-x|--exclude=<pattern>:: 52 Skips files matching pattern. 53 Note that pattern is a shell wildcard pattern. 54 55-X|--exclude-from=<file>:: 56 exclude patterns are read from <file>; 1 per line. 57 Allows the use of the famous dontdiff file as follows to find 58 out about uncommitted files just as dontdiff is used with 59 the diff command: 60 git-ls-files --others --exclude-from=dontdiff 61 62-t:: 63 Identify the file status with the following tags (followed by 64 a space) at the start of each line: 65 H cached 66 M unmerged 67 R removed/deleted 68 ? other 69 70Output 71------ 72show files just outputs the filename unless '--stage' is specified in 73which case it outputs: 74 75 [<tag> ]<mode> <object> <stage> <file> 76 77"git-ls-files --unmerged" and "git-ls-files --stage" can be used to examine 78detailed information on unmerged paths. 79 80For an unmerged path, instead of recording a single mode/SHA1 pair, 81the dircache records up to three such pairs; one from tree O in stage 821, A in stage 2, and B in stage 3. This information can be used by 83the user (or Cogito) to see what should eventually be recorded at the 84path. (see read-cache for more information on state) 85 86See Also 87-------- 88link:read-cache.html[read-cache] 89 90 91Author 92------ 93Written by Linus Torvalds <torvalds@osdl.org> 94 95Documentation 96-------------- 97Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>. 98 99GIT 100--- 101Part of the link:git.html[git] suite 102