diff options
Diffstat (limited to 'uxd.1')
| -rw-r--r-- | uxd.1 | 56 |
1 files changed, 54 insertions, 2 deletions
@@ -59,11 +59,17 @@ over the environment. Options can be bundled: \fB\-ubc1234\fP is the same as \fB\-u\fP \fB\-n\fP \fB\-c 1234\fP\&. The one exception is the \fB\-n\fP option, which should appear by itself. +.\" the comments are turned into the --help message by mkusage.pl. +. .INDENT 0.0 .TP .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. +.UNINDENT +.\" bold color output. +. +.INDENT 0.0 .TP .BI \-c \ nnnn Set the colors to use. Must be 2 to 4 digits, from 0 to 7. These are @@ -72,38 +78,70 @@ 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. +.UNINDENT +.\" colors (2 to 4 digits, 0 to 7). +. +.INDENT 0.0 .TP .B \-h\fP,\fB \-\-help Print built\-in usage message and exit. +.UNINDENT +.\" print this help message. +. +.INDENT 0.0 .TP .B \-i After dumping, print information about the input: number of bytes, characters, ASCII (one\-byte) characters, multi\-byte characters, and bad sequences. +.UNINDENT +.\" print number of bytes/chars/ascii/multibyte/bad sequences. +. +.INDENT 0.0 .TP .BI \-l \ length Stop dumping after \fIlength\fP bytes (not characters). If the limit is reached in the middle of a multibyte character, the entire character will be dumped. +.UNINDENT +.\" stop dumping after <length> bytes (not characters). +. +.INDENT 0.0 .TP .B \-m Monochrome mode. Uses underline, bold, reverse video instead of color. Use this if you have trouble distinguishing the colors, or if they look too much like angry fruit salad. Disables prior \fB\-b\fP, \fB\-c\fP options. +.UNINDENT +.\" monochrome mode. +. +.INDENT 0.0 .TP .B \-n Ignore \fBUXD_OPTS\fP environment variable. This option should not be bundled with other options (e.g. use \fB\-n \-u\fP, not \fB\-nu\fP). +.UNINDENT +.\" ignore UXD_OPTS environment variable. +. +.INDENT 0.0 .TP .BI \-o \ offset 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). +.UNINDENT +.\" added to hex offsets (decimal, 0x hex, 0 octal). +. +.INDENT 0.0 .TP .B \-r Highlight multi\-byte sequences in reverse video, in the hex output. Ignored if \fB\-m\fP given. +.UNINDENT +.\" highlight multi-byte chars in reverse video. +. +.INDENT 0.0 .TP .BI \-s \ pos Seek in input before starting to dump. \fIpos\fP is bytes, not @@ -111,18 +149,32 @@ characters. Positive \fIpos\fP means seek from the start of the input. Negative \fIpos\fP only works on files (not standard input); it means seek backward from EOF. Can be given in decimal, hex (with \fI0x\fP prefix), or octal (with \fI0\fP prefix). +.UNINDENT +.\" seek in input before dumping (-pos = seek back from EOF). +. +.INDENT 0.0 .TP .BI \-S \ pos Same as \fB\-s\fP, but file offsets start at 0 rather than the position after seeking. \fB\-S 100\fP is the same as \fB\-s 100 \-o \-100\fP\&. Works with negative \fIpos\fP, too. +.UNINDENT +.\" like -s, but also sets -o so addresses start at 0. +. +.INDENT 0.0 .TP .B \-u Use uppercase hex digits \fIA\-F\fP\&. Default is lowercase. +.UNINDENT +.\" uppercase hex digits. +. +.INDENT 0.0 .TP .B \-v\fP,\fB \-\-version Print version number and exit. .UNINDENT +.\" print version of uxd. +. .SH OUTPUT FORMAT .sp The output is designed to fit in an 80\-column terminal. @@ -231,8 +283,8 @@ The author\(aqs testing is done primarily with \fBurxvt\fP(1). Other terminals aren\(aqt tested as often. Some terminals may need UTF\-8 enabled, if it\(aqs not on by default (e.g. xterm). .sp -Known to work: urxvt, xterm, st, xfce4\-terminal, gnome\-terminal, kitty, the Linux console (but -see \fBFONTS\fP, below). +Known to work: urxvt, xterm, st, xfce4\-terminal, gnome\-terminal, +kitty, konsole, the Linux console (but see \fBFONTS\fP, below). .sp Known \fBnot\fP to work: rxvt (doesn\(aqt support Unicode at all), and its derivatives such as aterm. |