Merge branch 'refs/heads/t/doc-improvements'

[adu.git] / select.ggo

diff --git a/select.ggo b/select.ggo
index c4e1ec0319841322a189e643b04c578c862398c5..d7f8c9388b3ac4d6509cb5e7e0719079b65feba7 100644 (file)
--- a/select.ggo
+++ b/select.ggo
@@ -87,6 +87,20 @@ details="
        output to scripts.
 "
 
+option "trailer" T
+#~~~~~~~~~~~~~~~~~
+"use a customized trailer for listings/summaries"
+string typestr="string"
+optional
+default=""
+details="
+       This option can be used to print any string at the end of
+       the query output.
+
+       In user_list mode the trailer is a format string with the
+       same semantics like the header string.
+"
+
 option "select-mode" m
 #~~~~~~~~~~~~~~~~~~~~~
 "How to print the results of the query"
@@ -120,28 +134,32 @@ string typestr="path"
 optional
 default="-"
 details="
-       If empty, or not given, use stdout. The following conventions
-       cause the output to be written differently:
-
-       An output file name of \"-\" means stdout.
-
-       \"path\" may be prepended by '>' which instructs adu to
-       truncate the output file to length zero.  If \"path\" does
-       not start with '>' and \"path\" already exists, the select
-       query is being aborted. Otherwise, \"path\" is created and
-       output is written to \"path\".
-
-       If the first two characters of \"path\" are '>', the output
-       file (given by removing the leading \">>\" from \"path\")
-       is being opened in append mode. It is no error if the output
-       file does not exist but, as above, the output file name \">>\"
-       is considered invalid.
-
-       If the first character of \"path\" is '|', a pipe is created
-       and the rest of \"path\" is being executed with its standard in
-       redirected to the reading end of the pipe. The output of adu
-       is written to the writing end of the pipe. Again, specifying
-       only \"|\" is considered invalid and causes an error.
+       This option is only useful in interactive mode. If stdin is redirected
+       from a script, and the script contains several queries one can use
+       this option to let each query write its output to a different file.
+
+       If the option is not given, or its argument is either \"-\" or the
+       empty string, stdout is assumed. The following conventions cause the
+       output to be written in a different way:
+
+       \"path\" may be prepended by '>' which instructs adu to truncate
+       the output file to length zero. If \"path\" does not start with
+       '>' and \"path\" already exists, the query is aborted. Otherwise,
+       the file is created and truncated. The output file name \">\" is
+       considered invalid.
+
+       If the first two characters of \"path\" are '>', the output file
+       (given by removing the leading \">>\" from \"path\") is opened in
+       append mode. It is no error if the output file does not exist. However,
+       as above the output file name \">>\" is considered invalid.
+
+       If the first character of \"path\" is '|', a pipe is created and the
+       rest of \"path\" is executed with stdin redirected to the reading
+       end of the pipe while the query output is written to the writing end
+       of the pipe. Again, specifying only \"|\" is considered invalid and
+       causes an error.
+
+       See the manual page for examples.
 "
 
 option "user-summary-sort" -
@@ -191,7 +209,7 @@ details="
        centered alignment respectively. The with specifier is a
        positive integer. Both \"a\" and \"w\" are optional.
 
-       A string directive supported by adu is \"dirname\" which is
+       One string directive supported by adu is \"dirname\" which is
        substituted by the name of the directory. It is available
        if either user_list or global_list mode was selected via
        --select-mode.
@@ -205,12 +223,12 @@ details="
 
                \"%(dirname:c:20)\"
 
-       The other two types of directives, count and size, are used
-       for numbers. The syntax for these is %(name:a:w:u). The \"a\"
-       and the \"w\" specifier have the same meaning as for the string
-       and id directives. The additional \"u\" specifier selects a unit
-       in which the number that corresponds to the directive should
-       be formated. All three specifiers are optional.
+       The count and size directives are used for non-negative
+       numbers. The syntax for these is %(name:a:w:u). The \"a\" and
+       the \"w\" specifiers have the same meaning as for the string
+       and id directives. The additional \"u\" specifier selects a
+       unit in which the number that corresponds to the directive
+       should be formated. All three specifiers are optional.
 
        Possible units are the characters of the set \" bkmgtBKMGT\"
        specifying bytes, kilobytes, megabytes, gigabytes and