X-Git-Url: https://www.fleuret.org/cgi-bin/gitweb/gitweb.cgi?a=blobdiff_plain;f=dus.1;h=394f722d6fb3c24f241db1d0459a28f80a7a44fd;hb=3095e1570e1f1d4edf264b07480c256a2691b43c;hp=01cee50e7900c38455eb7deb898d512d508883b7;hpb=8f34c2a3b6f0f23f9125f75d35955df3b01d8140;p=dus.git

diff --git a/dus.1 b/dus.1
index 01cee50..394f722 100644
--- a/dus.1
+++ b/dus.1
@@ -1,4 +1,4 @@
-.TH "DUS" 1 "Mar 2010" "Francois Fleuret" "User Commands"
+.TH "DUS" "1.1" "Mar 2010" "Francois Fleuret" "User Commands"
 
 \" This man page was written by Francois Fleuret <francois@fleuret.org>
 \" and is distributed under a Creative Commons Attribution-Share Alike
@@ -14,25 +14,28 @@ dus \- A simple command line utility for size-sorting files
 
 .SH "DESCRIPTION"
 
-\fBdus\fP is a command line utility to sort files and directories
-according to their size. It computes the said size by summing
-recursively exact file sizes through directories.
+\fBdus\fP lists files and directories according to their size. It
+computes the said sizes by summing recursively exact file sizes
+through directories. If a directory has its name appended with '/', it
+is not listed, but the elements it contains are. If no files or
+directories are provided as arguments, the current directory is used
+as default.
 
 .SH "OPTIONS"
 .TP
-\fB-h, --help\fR
+\fB-h\fR, \fB--help\fR
 display help and exit
 .TP
-\fB-d, --ignore-dots\fR
+\fB-d\fR, \fB--ignore-dots\fR
 ignore files and directories whose name starts with a dot
 .TP
-\fB-f, --fancy\fR
+\fB-f\fR, \fB--fancy\fR
 display floating point size with K, M and G units
 .TP
-\fB-r, --reverse-order\fR
+\fB-r\fR, \fB--reverse-order\fR
 reverse the sorting order (big to small instead of small to big)
 .TP
-\fB-t, --show-top\fR
+\fB-t\fR, \fB--show-top\fR
 show the top of the list instead of the bottom
 .TP
 \fB-c \fI<cols>\fR, \fB--nb-columns \fI<cols>\fR
@@ -44,7 +47,16 @@ same as \fB-c\fR but for the number of lines
 .TP
 \fB-m \fI<size min>\fR, \fB--min-size \fI<size min>\fR
 restrict the printing of files and directories to these of size bigger
-than a lower bound
+than a lower bound. The size can be specified using the G, M, K, and B
+units
+
+.SH "EXAMPLE"
+
+.B dus -m 1M -rt ~/private/
+
+.fi
+List the largest files and directories present in ~/private/, of sizes
+greater than 1024kb, sorted in decreasing order.
 
 .SH "BUGS"