From: jari.aalto@cante.net
To: git@vger.kernel.org
Cc: Jari Aalto <jari.aalto@cante.net>
Subject: [PATCH] git-ls-files.txt: order options alphabetically
Date: Wed, 1 Dec 2010 22:31:29 +0200 [thread overview]
Message-ID: <1291235489-21802-1-git-send-email-jari.aalto@cante.net> (raw)
From: Jari Aalto <jari.aalto@cante.net>
Signed-off-by: Jari Aalto <jari.aalto@cante.net>
---
Documentation/git-ls-files.txt | 123 ++++++++++++++++++++--------------------
1 files changed, 62 insertions(+), 61 deletions(-)
diff --git a/Documentation/git-ls-files.txt b/Documentation/git-ls-files.txt
index 86abd13..4b88940 100644
--- a/Documentation/git-ls-files.txt
+++ b/Documentation/git-ls-files.txt
@@ -30,6 +30,15 @@ shown:
OPTIONS
-------
+
+\--::
+ Do not interpret any more arguments as options.
+
+--abbrev[=<n>]::
+ Instead of showing the full 40-byte hexadecimal object
+ lines, show only a partial prefix.
+ Non default number of digits can be specified with --abbrev=<n>.
+
-c::
--cached::
Show cached files in the output (default)
@@ -38,53 +47,32 @@ OPTIONS
--deleted::
Show deleted files in the output
--m::
---modified::
- Show modified files in the output
-
--o::
---others::
- Show other (i.e. untracked) files in the output
-
--i::
---ignored::
- Show only ignored files in the output. When showing files in the
- index, print only those matched by an exclude pattern. When
- showing "other" files, show only those matched by an exclude
- pattern.
-
--s::
---stage::
- Show staged contents' object name, mode bits and stage number in the output.
+--debug::
+ After each line that describes a file, add more data about its
+ cache entry. This is intended to show as much information as
+ possible for manual inspection; the exact format may change at
+ any time.
--directory::
+--no-empty-directory::
If a whole directory is classified as "other", show just its
name (with a trailing slash) and not its whole contents.
---no-empty-directory::
- Do not list empty directories. Has no effect without --directory.
-
--u::
---unmerged::
- Show unmerged files in the output (forces --stage)
+ Alternatively do not list empty directories. Has no effect
+ without `--directory'.
--k::
---killed::
- 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.
+--error-unmatch::
+ If any <file> does not appear in the index, treat this as an
+ error (return 1).
--x <pattern>::
--exclude=<pattern>::
+-x <pattern>::
Skip untracked files matching pattern.
Note that pattern is a shell wildcard pattern. See EXCLUDE PATTERNS
below for more information.
--X <file>::
--exclude-from=<file>::
+-X <file>::
Read exclude patterns from <file>; 1 per line.
--exclude-per-directory=<file>::
@@ -95,16 +83,36 @@ OPTIONS
Add the standard git exclusions: .git/info/exclude, .gitignore
in each directory, and the user's global exclusion file.
---error-unmatch::
- If any <file> does not appear in the index, treat this as an
- error (return 1).
+--full-name::
+ When run from a subdirectory, the command usually
+ outputs paths relative to the current directory. This
+ option forces paths to be output relative to the project
+ top directory.
---with-tree=<tree-ish>::
- When using --error-unmatch to expand the user supplied
- <file> (i.e. path pattern) arguments to paths, pretend
- that paths which were removed in the index since the
- named <tree-ish> are still present. Using this option
- with `-s` or `-u` options does not make any sense.
+-i::
+--ignored::
+ Show only ignored files in the output. When showing files in the
+ index, print only those matched by an exclude pattern. When
+ showing "other" files, show only those matched by an exclude
+ pattern.
+
+-k::
+--killed::
+ Show files on the filesystem that need to be removed due
+ to file/directory conflicts for checkout-index to
+ succeed.
+
+-m::
+--modified::
+ Show modified files in the output
+
+-o::
+--others::
+ Show other (i.e. untracked) files in the output
+
+-s::
+--stage::
+ Show staged contents' object name, mode bits and stage number in the output.
-t::
This feature is semi-deprecated. For scripting purpose,
@@ -124,31 +132,24 @@ a space) at the start of each line:
C:: modified/changed
K:: to be killed
?:: other
+-u::
+--unmerged::
+ Show unmerged files in the output (forces --stage)
-v::
Similar to `-t`, but use lowercase letters for files
that are marked as 'assume unchanged' (see
linkgit:git-update-index[1]).
---full-name::
- When run from a subdirectory, the command usually
- outputs paths relative to the current directory. This
- option forces paths to be output relative to the project
- top directory.
-
---abbrev[=<n>]::
- Instead of showing the full 40-byte hexadecimal object
- lines, show only a partial prefix.
- Non default number of digits can be specified with --abbrev=<n>.
-
---debug::
- After each line that describes a file, add more data about its
- cache entry. This is intended to show as much information as
- possible for manual inspection; the exact format may change at
- any time.
+--with-tree=<tree-ish>::
+ When using --error-unmatch to expand the user supplied
+ <file> (i.e. path pattern) arguments to paths, pretend
+ that paths which were removed in the index since the
+ named <tree-ish> are still present. Using this option
+ with `-s` or `-u` options does not make any sense.
-\--::
- Do not interpret any more arguments as options.
+-z::
+ \0 line termination on output.
<file>::
Files to show. If no files are given all files which match the other
--
1.7.2.3
reply other threads:[~2010-12-01 20:31 UTC|newest]
Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1291235489-21802-1-git-send-email-jari.aalto@cante.net \
--to=jari.aalto@cante.net \
--cc=git@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).