coreutils: Update to coreutils 8.22

[linuxjm/coreutils.git] / original / man1 / ls.1

diff --git a/original/man1/ls.1 b/original/man1/ls.1
index b6d2029..9a77485 100644 (file)
--- a/original/man1/ls.1
+++ b/original/man1/ls.1
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
-.TH LS "1" "May 2014" "GNU coreutils 8.21" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.43.3.
+.TH LS "1" "May 2014" "GNU coreutils 8.22" "User Commands"
 .SH NAME
 ls \- list directory contents
 .SH SYNOPSIS
@@ -26,29 +26,28 @@ with \fB\-l\fR, print the author of each file
 print C\-style escapes for nongraphic characters
 .TP
 \fB\-\-block\-size\fR=\fISIZE\fR
-scale sizes by SIZE before printing them.  E.g.,
+scale sizes by SIZE before printing them; e.g.,
 \&'\-\-block\-size=M' prints sizes in units of
-1,048,576 bytes.  See SIZE format below.
+1,048,576 bytes; see SIZE format below
 .TP
 \fB\-B\fR, \fB\-\-ignore\-backups\fR
 do not list implied entries ending with ~
 .TP
 \fB\-c\fR
 with \fB\-lt\fR: sort by, and show, ctime (time of last
-modification of file status information)
-with \fB\-l\fR: show ctime and sort by name
+modification of file status information);
+with \fB\-l\fR: show ctime and sort by name;
 otherwise: sort by ctime, newest first
 .TP
 \fB\-C\fR
 list entries by columns
 .TP
 \fB\-\-color\fR[=\fIWHEN\fR]
-colorize the output.  WHEN defaults to 'always'
-or can be 'never' or 'auto'.  More info below
+colorize the output; WHEN can be 'never', 'auto',
+or 'always' (the default); more info below
 .TP
 \fB\-d\fR, \fB\-\-directory\fR
-list directory entries instead of contents,
-and do not dereference symbolic links
+list directories themselves, not their contents
 .TP
 \fB\-D\fR, \fB\-\-dired\fR
 generate output designed for Emacs' dired mode
@@ -73,9 +72,9 @@ like \fB\-l\fR \fB\-\-time\-style\fR=\fIfull\-iso\fR
 like \fB\-l\fR, but do not list owner
 .TP
 \fB\-\-group\-directories\-first\fR
-group directories before files.
+group directories before files;
 .IP
-augment with a \fB\-\-sort\fR option, but any
+can be augmented with a \fB\-\-sort\fR option, but any
 use of \fB\-\-sort\fR=\fInone\fR (\fB\-U\fR) disables grouping
 .TP
 \fB\-G\fR, \fB\-\-no\-group\fR
@@ -93,6 +92,7 @@ follow symbolic links listed on the command line
 .TP
 \fB\-\-dereference\-command\-line\-symlink\-to\-dir\fR
 follow each command line symbolic link
+.IP
 that points to a directory
 .TP
 \fB\-\-hide\fR=\fIPATTERN\fR
@@ -111,7 +111,7 @@ print the index number of each file
 do not list implied entries matching shell PATTERN
 .TP
 \fB\-k\fR, \fB\-\-kibibytes\fR
-use 1024\-byte blocks
+default to 1024\-byte blocks for disk usage
 .TP
 \fB\-l\fR
 use a long listing format
@@ -138,10 +138,10 @@ like \fB\-l\fR, but do not list group information
 append / indicator to directories
 .TP
 \fB\-q\fR, \fB\-\-hide\-control\-chars\fR
-print ? instead of non graphic characters
+print ? instead of nongraphic characters
 .TP
 \fB\-\-show\-control\-chars\fR
-show non graphic characters as\-is (default
+show nongraphic characters as\-is (the default,
 unless program is 'ls' and output is a terminal)
 .TP
 \fB\-Q\fR, \fB\-\-quote\-name\fR
@@ -164,21 +164,21 @@ print the allocated size of each file, in blocks
 sort by file size
 .TP
 \fB\-\-sort\fR=\fIWORD\fR
-sort by WORD instead of name: none \fB\-U\fR,
-extension \fB\-X\fR, size \fB\-S\fR, time \fB\-t\fR, version \fB\-v\fR
+sort by WORD instead of name: none (\fB\-U\fR), size (\fB\-S\fR),
+time (\fB\-t\fR), version (\fB\-v\fR), extension (\fB\-X\fR)
 .TP
 \fB\-\-time\fR=\fIWORD\fR
-with \fB\-l\fR, show time as WORD instead of modification
-time: atime \fB\-u\fR, access \fB\-u\fR, use \fB\-u\fR, ctime \fB\-c\fR,
-or status \fB\-c\fR; use specified time as sort key
-if \fB\-\-sort\fR=\fItime\fR
+with \fB\-l\fR, show time as WORD instead of default
+modification time: atime or access or use (\fB\-u\fR)
+ctime or status (\fB\-c\fR); also use specified time
+as sort key if \fB\-\-sort\fR=\fItime\fR
 .TP
 \fB\-\-time\-style\fR=\fISTYLE\fR
 with \fB\-l\fR, show times using style STYLE:
-full\-iso, long\-iso, iso, locale, +FORMAT.
-FORMAT is interpreted like 'date'; if FORMAT is
-FORMAT1<newline>FORMAT2, FORMAT1 applies to
-non\-recent files and FORMAT2 to recent files;
+full\-iso, long\-iso, iso, locale, or +FORMAT;
+FORMAT is interpreted like in 'date'; if FORMAT
+is FORMAT1<newline>FORMAT2, then FORMAT1 applies
+to non\-recent files and FORMAT2 to recent files;
 if STYLE is prefixed with 'posix\-', STYLE
 takes effect only outside the POSIX locale
 .TP
@@ -189,8 +189,8 @@ sort by modification time, newest first
 assume tab stops at each COLS instead of 8
 .TP
 \fB\-u\fR
-with \fB\-lt\fR: sort by, and show, access time
-with \fB\-l\fR: show access time and sort by name
+with \fB\-lt\fR: sort by, and show, access time;
+with \fB\-l\fR: show access time and sort by name;
 otherwise: sort by access time
 .TP
 \fB\-U\fR
@@ -237,16 +237,11 @@ if minor problems (e.g., cannot access subdirectory),
 .TP
 2
 if serious trouble (e.g., cannot access command\-line argument).
+.PP
+GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
+Report ls translation bugs to <http://translationproject.org/team/>
 .SH AUTHOR
 Written by Richard M. Stallman and David MacKenzie.
-.SH "REPORTING BUGS"
-Report ls bugs to bug\-coreutils@gnu.org
-.br
-GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
-.br
-General help using GNU software: <http://www.gnu.org/gethelp/>
-.br
-Report ls translation bugs to <http://translationproject.org/team/>
 .SH COPYRIGHT
 Copyright \(co 2013 Free Software Foundation, Inc.
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.