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
9c5ef8e
..
8c1784d
100644
(file)
--- a/
Documentation/git-ls-files.txt
+++ b/
Documentation/git-ls-files.txt
@@
-1,6
+1,5
@@
git-ls-files(1)
===============
git-ls-files(1)
===============
-v0.1, May 2005
NAME
----
NAME
----
@@
-10,11
+9,11
@@
git-ls-files - Information about files in the cache/working directory
SYNOPSIS
--------
'git-ls-files' [-z] [-t]
SYNOPSIS
--------
'git-ls-files' [-z] [-t]
- (--[cached|deleted|others|ignored|stage|unmerged|killed])\*
- (-[c|d|o|i|s|u|k])\*
+ (--[cached|deleted|others|ignored|stage|unmerged|killed
|modified
])\*
+ (-[c|d|o|i|s|u|k
|m
])\*
[-x <pattern>|--exclude=<pattern>]
[-X <file>|--exclude-from=<file>]
[-x <pattern>|--exclude=<pattern>]
[-X <file>|--exclude-from=<file>]
- [--exclude-per-directory=<file>]
+ [--exclude-per-directory=<file>]
[--] [<file>]\*
DESCRIPTION
-----------
DESCRIPTION
-----------
@@
-33,6
+32,9
@@
OPTIONS
-d|--deleted::
Show deleted files in the output
-d|--deleted::
Show deleted files in the output
+-m|--modified::
+ Show modified files in the output
+
-o|--others::
Show other files in the output
-o|--others::
Show other files in the output
@@
-48,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.
@@
-68,12
+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
- 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
@@
-90,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
----------------
@@
-100,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.
@@
-158,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]
@@
-176,11
+191,12
@@
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
--------
-
link:git-read-tree.html[git-read-tree
]
+
gitlink:git-read-tree[1
]
Author
Author
@@
-193,5
+209,5
@@
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel
GIT
---
GIT
---
-Part of the
link:git.html[git
] suite
+Part of the
gitlink:git[7
] suite