aboutsummaryrefslogtreecommitdiff
path: root/uxd.1
diff options
context:
space:
mode:
Diffstat (limited to 'uxd.1')
-rw-r--r--uxd.147
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.