git.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
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).