+.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
\" 3.0 License.
-.TH "DUS" 1 "July 2009" "Francois Fleuret" "User Commands"
-
.SH "NAME"
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\fR
-display help and exit
+\fB-h\fR, \fB--help\fR
+print the help and exit
.TP
-\fB-d\fR
+\fB-v\fR, \fB--version\fR
+print the version number and exit
+.TP
+\fB-d\fR, \fB--ignore-dots\fR
ignore files and directories whose name starts with a dot
.TP
-\fB-f\fR
+\fB-f\fR, \fB--fancy\fR
display floating point size with K, M and G units
.TP
-\fB-r\fR
+\fB-r\fR, \fB--reverse-order\fR
reverse the sorting order (big to small instead of small to big)
.TP
-\fB-t\fR
+\fB-t\fR, \fB--show-top\fR
show the top of the list instead of the bottom
.TP
-\fB-c \fI<cols>\fR impose the number of columns, -1 means no limit (it
-is by default no limits if the stdout is not a tty and the tty width
-otherwise)
+\fB-c \fI<cols>\fR, \fB--nb-columns \fI<cols>\fR
+force the number of columns, -1 means no limit (it is by default no
+limits if the stdout is not a tty and the tty width otherwise)
+.TP
+\fB-l \fI<lines>\fR, \fB--nb-lines \fI<lines>\fR
+same as \fB-c\fR but for the number of lines
.TP
-\fB-l \fI<lines>\fR same as \fB-c\fR but for the number of lines
+\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. 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"