document all options (including unimplemented ones).

1 files changed, 39 insertions, 8 deletions

diff --git a/uxd.1 b/uxd.1
index 69a41cb..bf7dafa 100644
--- a/uxd.1
+++ b/uxd.1
@@ -51,10 +51,28 @@ terminal. It\(aqs assumed that the terminal supports ANSI\-style color and
 UTF\-8. See \fBTERMINAL SUPPORT\fP below. If you want to pipe the output
 to a pager, try \fBless \-R\fP\&.
 .SH OPTIONS
+.sp
+These options can be used on the command line, and/or in the
+\fBUXD_OPTS\fP environment variable. The command line takes precedence
+over the environment.
 .INDENT 0.0
 .TP
-.B  \-r
-Highlight multi\-byte sequences in reverse video, in the hex output.
+.B  \-b
+Bold output. This may be more or less readable, depending on your
+terminal and its color settings. Ignored if \fB\-m\fP given.
+NOT IMPLEMENTED YET.
+.TP
+.BI \-c \ nnnn
+Set the colors to use. Must be 2 to 4 digits, from 0 to 7. These are
+standard ANSI colors. The first 2 are the alternating colors for
+normal characters, the 3rd digit (optional) is the color for non\-printable
+and space characters, and the 4th (optional) is for invalid UTF\-8
+sequences. Default: \fB2351\fP\&. This option also disables a prior \fB\-m\fP
+option.
+NOT IMPLEMENTED YET.
+.TP
+.B  \-h\fP,\fB  \-\-help
+Print built\-in usage message and exit.
 .TP
 .B  \-m
 Monochrome mode. Uses underline, bold, reverse video instead of color.
@@ -67,6 +85,10 @@ Add this amount to the hex offsets (left column). May be negative,
 if you can think of a reason to want it to be. Can be given in
 decimal, hex (with \fI0x\fP prefix), or octal (with \fI0\fP prefix).
 .TP
+.B  \-r
+Highlight multi\-byte sequences in reverse video, in the hex
+output. Ignored if \fB\-m\fP given.
+.TP
 .BI \-s \ position
 Seek in input before starting to dump. Positive \fIposition\fP means
 seek from the start of the input. Negative \fIposition\fP only works
@@ -76,9 +98,6 @@ NOT IMPLEMENTED YET.
 .B  \-u
 Use uppercase hex digits A\-F. Default is lowercase.
 .TP
-.B  \-h\fP,\fB  \-\-help
-Print built\-in usage message and exit.
-.TP
 .B  \-v\fP,\fB  \-\-version
 Print version number and exit.
 .UNINDENT
@@ -218,10 +237,22 @@ specifically a problem with \fBuxd\fP\&.
 \fBuxd\fP doesn\(aqt read any files other than the input file, and doesn\(aqt write to
 any files other than standard output. There\(aqs no config file.
 .SH ENVIRONMENT
+.INDENT 0.0
+.TP
+.B \fBUXD_OPTS\fP
+If this is set, its value is treated as a set of options, which
+get applied before any command\-line options.
+NOT IMPLEMENTED YET.
+.TP
+.B \fBNO_COLOR\fP
+If this is set (to any value), \fBuxd\fP runs in monochrome mode, just
+as though the \fB\-m\fP option were given. This variable is also
+respected by \fBxxd\fP\&.
+NOT IMPLEMENTED YET.
+.UNINDENT
 .sp
-\fBuxd\fP doesn\(aqt read anything from the environment. It\(aqs \fInot\fP necessary to
-have a UTF\-8 locale set in e.g. \fBLANG\fP or \fBLC_ALL\fP\&. Also, the \fBTERM\fP
-variable is not used.
+It\(aqs \fInot\fP necessary to have a UTF\-8 locale set in e.g. \fBLANG\fP or
+\fBLC_ALL\fP\&. Also, the \fBTERM\fP variable is not used.
 .SH EXIT STATUS
 .sp
 Zero for success, non\-zero for failure.