projects
/
git.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
GIT 0.99.9c
[git.git]
/
Documentation
/
git-ls-files.txt
diff --git
a/Documentation/git-ls-files.txt
b/Documentation/git-ls-files.txt
index
591f4ed
..
8c1784d
100644
(file)
--- a/
Documentation/git-ls-files.txt
+++ b/
Documentation/git-ls-files.txt
@@
-13,7
+13,7
@@
SYNOPSIS
(-[c|d|o|i|s|u|k|m])\*
[-x <pattern>|--exclude=<pattern>]
[-X <file>|--exclude-from=<file>]
(-[c|d|o|i|s|u|k|m])\*
[-x <pattern>|--exclude=<pattern>]
[-X <file>|--exclude-from=<file>]
- [--exclude-per-directory=<file>]
+ [--exclude-per-directory=<file>]
[--] [<file>]\*
DESCRIPTION
-----------
DESCRIPTION
-----------
@@
-50,11
+50,11
@@
OPTIONS
-k|--killed::
Show files on the filesystem that need to be removed due
-k|--killed::
Show files on the filesystem that need to be removed due
- to file/directory conflicts for checkout-
cache
to
+ to file/directory conflicts for checkout-
index
to
succeed.
-z::
succeed.
-z::
- \0 line termination on output
+ \0 line termination on output
.
-x|--exclude=<pattern>::
Skips files matching pattern.
-x|--exclude=<pattern>::
Skips files matching pattern.
@@
-70,13
+70,20
@@
OPTIONS
-t::
Identify the file status with the following tags (followed by
a space) at the start of each line:
-t::
Identify the file status with the following tags (followed by
a space) at the start of each line:
- H
cached
- M
unmerged
- R
removed/deleted
- C
modifed/changed
- K
to be killed
+ H
::
cached
+ M
::
unmerged
+ R
::
removed/deleted
+ C
::
modifed/changed
+ K
::
to be killed
? other
? other
+--::
+ Do not interpret any more arguments as options.
+
+<file>::
+ Files to show. If no files are given all files which match the other
+ specified criteria are shown.
+
Output
------
show files just outputs the filename unless '--stage' is specified in
Output
------
show files just outputs the filename unless '--stage' is specified in
@@
-93,6
+100,10
@@
the dircache records up to three such pairs; one from tree O in stage
the user (or the porcelain) to see what should eventually be recorded at the
path. (see git-read-tree for more information on state)
the user (or the porcelain) to see what should eventually be recorded at the
path. (see git-read-tree for more information on state)
+When `-z` option is not used, TAB, LF, and backslash characters
+in pathnames are represented as `\t`, `\n`, and `\\`,
+respectively.
+
Exclude Patterns
----------------
Exclude Patterns
----------------
@@
-103,13
+114,13
@@
flags --others or --ignored are specified.
These exclude patterns come from these places:
These exclude patterns come from these places:
-
(1)
command line flag --exclude=<pattern> specifies a single
+
1.
command line flag --exclude=<pattern> specifies a single
pattern.
pattern.
-
(2)
command line flag --exclude-from=<file> specifies a list of
+
2.
command line flag --exclude-from=<file> specifies a list of
patterns stored in a file.
patterns stored in a file.
-
(3)
command line flag --exclude-per-directory=<name> specifies
+
3.
command line flag --exclude-per-directory=<name> specifies
a name of the file in each directory 'git-ls-files'
examines, and if exists, its contents are used as an
additional list of patterns.
a name of the file in each directory 'git-ls-files'
examines, and if exists, its contents are used as an
additional list of patterns.
@@
-161,12
+172,13
@@
An exclude pattern is of the following format:
- otherwise, it is a shell glob pattern, suitable for
consumption by fnmatch(3) with FNM_PATHNAME flag. I.e. a
slash in the pattern must match a slash in the pathname.
- otherwise, it is a shell glob pattern, suitable for
consumption by fnmatch(3) with FNM_PATHNAME flag. I.e. a
slash in the pattern must match a slash in the pathname.
- "Documentation/*.html" matches "Documentation/git.html" but
+ "Documentation/
\
*.html" matches "Documentation/git.html" but
not "ppc/ppc.html". As a natural exception, "/*.c" matches
"cat-file.c" but not "mozilla-sha1/sha1.c".
An example:
not "ppc/ppc.html". As a natural exception, "/*.c" matches
"cat-file.c" but not "mozilla-sha1/sha1.c".
An example:
+--------------------------------------------------------------
$ cat .git/ignore
# ignore objects and archives, anywhere in the tree.
*.[oa]
$ cat .git/ignore
# ignore objects and archives, anywhere in the tree.
*.[oa]
@@
-179,6
+191,7
@@
An example:
--exclude='Documentation/*.[0-9]' \
--exclude-from=.git/ignore \
--exclude-per-directory=.gitignore
--exclude='Documentation/*.[0-9]' \
--exclude-from=.git/ignore \
--exclude-per-directory=.gitignore
+--------------------------------------------------------------
See Also
See Also