Minor documentation improvments.
authorAndre Noll <maan@systemlinux.org>
Sat, 1 Nov 2008 21:07:23 +0000 (22:07 +0100)
committerAndre Noll <maan@systemlinux.org>
Sat, 1 Nov 2008 21:07:23 +0000 (22:07 +0100)
adu.ggo

diff --git a/adu.ggo b/adu.ggo
index 11a5d00..4c9b4fe 100644 (file)
--- a/adu.ggo
+++ b/adu.ggo
@@ -69,9 +69,9 @@ section "Modes"
 defgroup "mode"
 #==============
 groupdesc="
-       adu may be started in one of two possible modes, each of which
-       corresponds to a different command line option. Exactly one
-       of these options must be given.
+       adu may be started in one of three possible modes, each of
+       which corresponds to a different command line option. Exactly
+       one of these options must be given.
 
 "
 required
@@ -92,7 +92,9 @@ groupoption "interactive" I
 "activate interactive mode"
 group="mode"
 details="
-       In this mode, adu reads commands from stdin.
+       In this mode, adu reads commands from stdin.  This makes it
+       possible to run different select queries without opening the
+       underlying osl database for each query (which is expensive).
 "
 
 groupoption "select" S
@@ -100,8 +102,9 @@ groupoption "select" S
 "query a database previously created with --create"
 group="mode"
 details="
-       This option prints statistics about matching subdirectories to
-       stdout. The output depends on the other options, see below.
+       This option prints statistics about matching subdirectories
+       to stdout. The output can be customized by specifying select
+       options, see below.
 "
 
 ##############################
@@ -146,6 +149,10 @@ details="
        users. Decreasing the value causes adu to use slightly less memory.
 "
 
+##############################
+section "Options for --select"
+##############################
+
 option "select-options" s
 #~~~~~~~~~~~~~~~~~~~~~~~~~
 "Options for select mode"
@@ -153,5 +160,9 @@ string typestr="<options>"
 optional
 dependon="select"
 details="
-       Try --select-options \"-h\"
+       This option takes a string whose content is another set of
+       options as described below.  Select options may be specified
+       either directly in select mode, in which case you have to quote
+       them to prevent them from being interpreted as adu options,
+       or via the \"set\" command in interactive mode.
 "