![[tokkee]](http://tokkee.org/images/avatar.png){kind=avatar}
index 2ec0c0d270edde03adff3f56531e4cee5fe05a57..f43af417404d4f0f658933d57742d23c847f1619 100644 (file)
SYNOPSIS
--------
[verse]
SYNOPSIS
--------
[verse]
-'git-ls-files' [-z] [-t] [-v]
+'git ls-files' [-z] [-t] [-v]
(--[cached|deleted|others|ignored|stage|unmerged|killed|modified])\*
(-[c|d|o|i|s|u|k|m])\*
[-x <pattern>|--exclude=<pattern>]
(--[cached|deleted|others|ignored|stage|unmerged|killed|modified])\*
(-[c|d|o|i|s|u|k|m])\*
[-x <pattern>|--exclude=<pattern>]
OPTIONS
-------
OPTIONS
-------
--c|--cached::
+-c::
+--cached::
Show cached files in the output (default)
Show cached files in the output (default)
--d|--deleted::
+-d::
+--deleted::
Show deleted files in the output
Show deleted files in the output
--m|--modified::
+-m::
+--modified::
Show modified files in the output
Show modified files in the output
--o|--others::
+-o::
+--others::
Show other files in the output
Show other files in the output
--i|--ignored::
+-i::
+--ignored::
Show ignored files in the output.
Note that this also reverses any exclude list present.
Show ignored files in the output.
Note that this also reverses any exclude list present.
--s|--stage::
+-s::
+--stage::
Show stage files in the output
--directory::
Show stage files in the output
--directory::
--no-empty-directory::
Do not list empty directories. Has no effect without --directory.
--no-empty-directory::
Do not list empty directories. Has no effect without --directory.
--u|--unmerged::
+-u::
+--unmerged::
Show unmerged files in the output (forces --stage)
Show unmerged files in the output (forces --stage)
--k|--killed::
+-k::
+--killed::
Show files on the filesystem that need to be removed due
to file/directory conflicts for checkout-index to
succeed.
Show files on the filesystem that need to be removed due
to file/directory conflicts for checkout-index to
succeed.
-z::
\0 line termination on output.
-z::
\0 line termination on output.
--x|--exclude=<pattern>::
+-x <pattern>::
+--exclude=<pattern>::
Skips files matching pattern.
Note that pattern is a shell wildcard pattern.
Skips files matching pattern.
Note that pattern is a shell wildcard pattern.
--X|--exclude-from=<file>::
+-X <file>::
+--exclude-from=<file>::
exclude patterns are read from <file>; 1 per line.
--exclude-per-directory=<file>::
exclude patterns are read from <file>; 1 per line.
--exclude-per-directory=<file>::
-v::
Similar to `-t`, but use lowercase letters for files
-v::
Similar to `-t`, but use lowercase letters for files
- that are marked as 'always matching index'.
+ that are marked as 'assume unchanged' (see
+ linkgit:git-update-index[1]).
--full-name::
When run from a subdirectory, the command usually
--full-name::
When run from a subdirectory, the command usually
[<tag> ]<mode> <object> <stage> <file>
[<tag> ]<mode> <object> <stage> <file>
-"git-ls-files --unmerged" and "git-ls-files --stage" can be used to examine
+'git-ls-files --unmerged' and 'git-ls-files --stage' can be used to examine
detailed information on unmerged paths.
For an unmerged path, instead of recording a single mode/SHA1 pair,
the index records up to three such pairs; one from tree O in stage
1, A in stage 2, and B in stage 3. This information can be used by
the user (or the porcelain) to see what should eventually be recorded at the
detailed information on unmerged paths.
For an unmerged path, instead of recording a single mode/SHA1 pair,
the index records up to three such pairs; one from tree O in stage
1, A in stage 2, and B in stage 3. This information can be used by
the user (or the porcelain) to see what should eventually be recorded at the
-path. (see git-read-tree for more information on state)
+path. (see linkgit:git-read-tree[1] for more information on state)
When `-z` option is not used, TAB, LF, and backslash characters
in pathnames are represented as `\t`, `\n`, and `\\`,
When `-z` option is not used, TAB, LF, and backslash characters
in pathnames are represented as `\t`, `\n`, and `\\`,
'git-ls-files' can use a list of "exclude patterns" when
traversing the directory tree and finding files to show when the
'git-ls-files' can use a list of "exclude patterns" when
traversing the directory tree and finding files to show when the
-flags --others or --ignored are specified. gitlink:gitignore[5]
+flags --others or --ignored are specified. linkgit:gitignore[5]
specifies the format of exclude patterns.
These exclude patterns come from these places, in order:
specifies the format of exclude patterns.
These exclude patterns come from these places, in order:
by --exclude-per-directory is relative to the directory that the
pattern file appears in.
by --exclude-per-directory is relative to the directory that the
pattern file appears in.
-See Also
+SEE ALSO
--------
--------
-gitlink:git-read-tree[1], gitlink:gitignore[5]
+linkgit:git-read-tree[1], linkgit:gitignore[5]
Author
Author
GIT
---
GIT
---
-Part of the gitlink:git[7] suite
+Part of the linkgit:git[1] suite