Initial commit.
[dus.git] / dus.1
1 \" This man page was written by Francois Fleuret <francois@fleuret.org>
2 \" and is distributed under a Creative Commons Attribution-Share Alike
3 \" 3.0 License.
4
5 .TH "DUS" 1 "July 2009" "Francois Fleuret" "User Commands"
6
7 .SH "NAME"
8
9 dus \- A simple command line utility for dynamic pattern selection
10
11 .SH "SYNOPSIS"
12
13 \fBdus\fP [OPTION]... [FILE]...
14
15 .SH "DESCRIPTION"
16
17 \fBdus\fP is a command line utility to sort files and directories
18 according to their size. It computes the said size by summing
19 recursively exact file sizes through directories.
20
21 .SH "OPTIONS"
22 .TP
23 \fB-h\fR
24 display help and exit
25 .TP
26 \fB-d\fR
27 ignore files and directories whose name starts with a dot
28 .TP
29 \fB-f\fR
30 display floating point size with K, M and G units
31 .TP
32 \fB-r\fR
33 reverse the sorting order (big to small instead of small to big)
34 .TP
35 \fB-t\fR
36 show the top of the list instead of the bottom
37 .TP
38 \fB-c \fI<cols>\fR impose the number of columns, -1 means no limit (it
39 is by default no limits if the stdout is not a tty and the tty width
40 otherwise)
41 .TP
42 \fB-l \fI<lines>\fR same as \fB-c\fR but for the number of lines
43
44 .SH "BUGS"
45
46 None known, probably many though.
47
48 .SH "AUTHOR"
49
50 Written by Francois Fleuret <francois@fleuret.org> and distributed
51 under the terms of the GNU General Public License version 3 as
52 published by the Free Software Foundation. This is free software: you
53 are free to change and redistribute it. There is NO WARRANTY, to the
54 extent permitted by law.