manual: Add two more examples.

[adu.git] / adu.1.inc

diff --git a/adu.1.inc b/adu.1.inc
index 9faf62d1d3426f5b45e2823287a08f5ea6e67c40..1bf06c214873ba132cc5a01d4aba046aeb399c16 100644 (file)
--- a/adu.1.inc
+++ b/adu.1.inc
@@ -1,4 +1,39 @@
 [NAME]
 adu \- advanced disk usage
+[EXAMPLES]
+
+.PP
+The following example creates a database containing the disk usage
+patterns of the /var directory:
+.IP
+       $ adu --create --database-dir /root/adu-var --base-dir /var
+
+.PP
+Here's a simple query that uses the newly created database to print
+the user-summary:
+.IP
+       $ adu --select --database-dir /root/adu-var
+.PP
+To print the one-line global summary instead, use
+.IP
+       $ adu --select --database-dir /root/adu-var --select-options '--select-mode global_summary'
+.PP
+To sort the user summary by file count rather than by file size, run
+.IP
+       $ adu --select --database-dir /root/adu-var --select-options '--list-sort=file_count'
+.PP
+The command below prints the five largest directories of the users root and
+mysql:
+.IP
+       $ adu --select --database-dir /root/adu-var --select-options '--select-mode user_list --user root --user mysql --limit 5'
+.PP
+The same, using short options:
+.IP
+       $ adu -Sd /root/adu-var -s '-m user_list -u root -u mysql -l 5'
+.PP
+Again the same, but omitting /var/cache:
+.IP
+       $ adu -Sd /root/adu-var -s '-m user_list -u root -u mysql -l 5 -p !^cache/'
+
 [SEE ALSO]
 .BR du (1)