X-Git-Url: http://git.tuebingen.mpg.de/?a=blobdiff_plain;f=README;h=5c2b23c8f1798196aa9e6c3ff8dcb006caa4857a;hb=599cc210028d11e60bee2bad0721a6b20f3a26d6;hp=7e19d779fb0b576b989291b7422fdf24028d2f3d;hpb=3bb9b0ca535be1eb28b64972bdf0e205e6afc93e;p=adu.git

diff --git a/README b/README
index 7e19d77..5c2b23c 100644
--- a/README
+++ b/README
@@ -1,10 +1,31 @@
 adu creates a database containing disk usage statistics of a given
-directory. It allows to query that database to quickly retrieve usage
-patterns of subdirectories containing files owned by a given user.
+directory. This database can be queried to quickly retrieve, for
+example, the number and the size of all files in a subdirectory owned
+by a given user.
 
 Four different output modes are available: global list, global summary,
-user list, user summary. The format of the output may be customized
+user list and user summary. The format of the output may be customized
 via format strings.
 
 There's an interactive mode which allows to quickly launch many queries
 on the same database using different modes and different output files.
+
+By default, adu uses the user-summary output format which looks like
+this:
+
+	User summary
+	root                0   605    12K  267m
+	mysql             103     8   144    81m
+	postgres          113    19   506    31m
+	man                 6    37    87     2m
+	syslog            101     1    54     1m
+	...
+
+The user-list mode prints the largest directories of one or more users:
+
+	uid 0 (root):
+	  55m    8  /var/cache/apt/apt-file/
+	  43m   35  /var/lib/apt/lists/
+	  27m    6K /var/lib/dpkg/info/
+	  25m    4  /var/cache/apt/
+	  20m  118  /var/lib/gconf/defaults/