summaryrefslogtreecommitdiff
path: root/doc/coreutils.texi
diff options
context:
space:
mode:
authorBernhard Voelker <mail@bernhard-voelker.de>2013-01-23 01:26:40 +0100
committerBernhard Voelker <mail@bernhard-voelker.de>2013-01-23 06:42:51 +0100
commitec68354dc6e2ac22eb314d262984e40894022121 (patch)
tree9e464acc97d944164fb66ae5e9fab6e1dee53871 /doc/coreutils.texi
parent4eaadb47430f21aee83eb920378be01945845a9a (diff)
downloadcoreutils-ec68354dc6e2ac22eb314d262984e40894022121.tar.xz
doc: fix order of du options in usage and texinfo manual
* src/du.c (usage): Bring options into alphabetical order. * doc/coreutils.texi (du invocation): Likewise. Furthermore, use the @itemx macro for the long options --max-depth and --threshold instead of @item.
Diffstat (limited to 'doc/coreutils.texi')
-rw-r--r--doc/coreutils.texi102
1 files changed, 51 insertions, 51 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 8d7eff764..1d508c996 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -10887,6 +10887,8 @@ The program accepts the following options. Also see @ref{Common options}.
@table @samp
+@optNull{du}
+
@item -a
@itemx --all
@opindex -a
@@ -10912,12 +10914,6 @@ dd bs=1 seek=2GiB if=/dev/null of=big
has an apparent size of 2 GiB, yet on most modern
systems, it actually uses almost no disk space.
-@item -b
-@itemx --bytes
-@opindex -b
-@opindex --bytes
-Equivalent to @code{--apparent-size --block-size=1}.
-
@item -B @var{size}
@itemx --block-size=@var{size}
@opindex -B
@@ -10926,6 +10922,12 @@ Equivalent to @code{--apparent-size --block-size=1}.
Scale sizes by @var{size} before printing them (@pxref{Block size}).
For example, @option{-BG} prints sizes in units of 1,073,741,824 bytes.
+@item -b
+@itemx --bytes
+@opindex -b
+@opindex --bytes
+Equivalent to @code{--apparent-size --block-size=1}.
+
@item -c
@itemx --total
@opindex -c
@@ -10944,15 +10946,24 @@ Does not affect other symbolic links. This is helpful for finding
out the disk usage of directories, such as @file{/usr/tmp}, which
are often symbolic links.
+@item -d @var{depth}
+@itemx --max-depth=@var{depth}
+@opindex -d @var{depth}
+@opindex --max-depth=@var{depth}
+@cindex limiting output of @command{du}
+Show the total for each directory (and file if --all) that is at
+most MAX_DEPTH levels down from the root of the hierarchy. The root
+is at level 0, so @code{du --max-depth=0} is equivalent to @code{du -s}.
+
@c --files0-from=FILE
@filesZeroFromOption{du,, with the @option{--total} (@option{-c}) option}
-@optHumanReadable
-
@item -H
@opindex -H
Equivalent to @option{--dereference-args} (@option{-D}).
+@optHumanReadable
+
@item -k
@opindex -k
@cindex kibibytes for file sizes
@@ -10960,14 +10971,6 @@ Print sizes in 1024-byte blocks, overriding the default block size
(@pxref{Block size}).
This option is equivalent to @option{--block-size=1K}.
-@item -l
-@itemx --count-links
-@opindex -l
-@opindex --count-links
-@cindex hard links, counting in @command{du}
-Count the size of all files, even if they have appeared already (as a
-hard link).
-
@item -L
@itemx --dereference
@opindex -L
@@ -10977,6 +10980,14 @@ Dereference symbolic links (show the disk space used by the file
or directory that the link points to instead of the space used by
the link).
+@item -l
+@itemx --count-links
+@opindex -l
+@opindex --count-links
+@cindex hard links, counting in @command{du}
+Count the size of all files, even if they have appeared already (as a
+hard link).
+
@item -m
@opindex -m
@cindex mebibytes for file sizes
@@ -10992,25 +11003,6 @@ This option is equivalent to @option{--block-size=1M}.
For each symbolic links encountered by @command{du},
consider the disk space used by the symbolic link.
-@item -d @var{depth}
-@item --max-depth=@var{depth}
-@opindex -d @var{depth}
-@opindex --max-depth=@var{depth}
-@cindex limiting output of @command{du}
-Show the total for each directory (and file if --all) that is at
-most MAX_DEPTH levels down from the root of the hierarchy. The root
-is at level 0, so @code{du --max-depth=0} is equivalent to @code{du -s}.
-
-@optNull{du}
-
-@optSi
-
-@item -s
-@itemx --summarize
-@opindex -s
-@opindex --summarize
-Display only a total for each argument.
-
@item -S
@itemx --separate-dirs
@opindex -S
@@ -11022,8 +11014,16 @@ With @option{--separate-dirs}, the size reported for a directory name,
@var{d}, is merely the @code{stat.st_size}-derived size of the directory
entry, @var{d}.
+@optSi
+
+@item -s
+@itemx --summarize
+@opindex -s
+@opindex --summarize
+Display only a total for each argument.
+
@item -t @var{size}
-@item --threshold=@var{size}
+@itemx --threshold=@var{size}
@opindex -t
@opindex --threshold
Exclude entries based on a given @var{size} (@pxref{Block size}).
@@ -11124,21 +11124,6 @@ the newline and any later characters are ignored; if @env{TIME_STYLE}
begins with @samp{posix-} the @samp{posix-} is ignored; and if
@env{TIME_STYLE} is @samp{locale} it is ignored.
-@item -x
-@itemx --one-file-system
-@opindex -x
-@opindex --one-file-system
-@cindex one file system, restricting @command{du} to
-Skip directories that are on different file systems from the one that
-the argument being processed is on.
-
-@item --exclude=@var{pattern}
-@opindex --exclude=@var{pattern}
-@cindex excluding files from @command{du}
-When recursing, skip subdirectories or files matching @var{pattern}.
-For example, @code{du --exclude='*.o'} excludes files whose names
-end in @samp{.o}.
-
@item -X @var{file}
@itemx --exclude-from=@var{file}
@opindex -X @var{file}
@@ -11148,6 +11133,21 @@ Like @option{--exclude}, except take the patterns to exclude from @var{file},
one per line. If @var{file} is @samp{-}, take the patterns from standard
input.
+@item --exclude=@var{pattern}
+@opindex --exclude=@var{pattern}
+@cindex excluding files from @command{du}
+When recursing, skip subdirectories or files matching @var{pattern}.
+For example, @code{du --exclude='*.o'} excludes files whose names
+end in @samp{.o}.
+
+@item -x
+@itemx --one-file-system
+@opindex -x
+@opindex --one-file-system
+@cindex one file system, restricting @command{du} to
+Skip directories that are on different file systems from the one that
+the argument being processed is on.
+
@end table
@cindex NFS mounts from BSD to HP-UX