X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~mdw/git/misc/blobdiff_plain/de41f398e807540bf9eaee6dd4ca21f19c2af388..22fb157c9459f0d07eb46d09370c27d3e57a437c:/gorp.1

diff --git a/gorp.1 b/gorp.1
index f00ce13..6f9000d 100644
--- a/gorp.1
+++ b/gorp.1
@@ -4,12 +4,58 @@
 gorp \- write a short random string
 .SH SYNOPSIS
 .B gorp
+.RB [ \-y ]
+.RB [ \-l
+.IR length ]
+.RB [ \-f
+.IR format ]
 .RI [ bits ]
 .SH DESCRIPTION
 Generates
 .I bits
 random bits (must be a multiple of 8, default is 128) and writes the
-resulting string to standard output in base64 format.
+resulting string to standard output.
+.PP
+The following options are recognized.
+.TP
+.B "\-h, \-\-help"
+Prints a help message to standard output and exits successfully.
+.TP
+.B "\-v, \-\-version"
+Prints the program's version number to standard output and exits
+successfully.
+.TP
+.B "\-u, \-\-usage"
+Prints a really short usage summary to standard output and exits
+successfully.
+.TP
+.BI "\-f, \-\-format=" format
+Prints the random string using the chosen output
+.IR format ,
+which may be
+.B base64
+(standard Base64 encoding, as described in RFC2045; this is the default), 
+.B file64
+(Base64 encoding, with
+.RB ` % '
+instead of
+.RB ` / ',
+so the output is suitable for use as a filename),
+.B hex
+(plain hexadecimal encoding), or
+.B raw
+(raw binary output, not printable).
+.TP
+.B "\-l, \-\-line=" length
+Breaks textual output into lines of at most
+.I length
+characters, and does all encoding in a strictly conforming way.  By
+default, the textual output is not line-broken, and strange terminator
+characters are not printed.
+.TP
+.B "\-y, \-\-bytes"
+The output length is bits, not bytes.  This doesn't affect the default
+value of 128.
 .SH BUGS
 None known.
 .SH AUTHOR