From a6262645aecb7c2dce55dc2fc24c5eb1511c4d0e Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Sat, 29 Jun 2024 19:15:50 -0400 Subject: a8xd: added (ATASCII-flavored hex dump). --- a8xd.1 | 182 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 182 insertions(+) create mode 100644 a8xd.1 (limited to 'a8xd.1') diff --git a/a8xd.1 b/a8xd.1 new file mode 100644 index 0000000..0e73cd6 --- /dev/null +++ b/a8xd.1 @@ -0,0 +1,182 @@ +.\" Man page generated from reStructuredText. +. +. +.nr rst2man-indent-level 0 +. +.de1 rstReportMargin +\\$1 \\n[an-margin] +level \\n[rst2man-indent-level] +level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] +- +\\n[rst2man-indent0] +\\n[rst2man-indent1] +\\n[rst2man-indent2] +.. +.de1 INDENT +.\" .rstReportMargin pre: +. RS \\$1 +. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] +. nr rst2man-indent-level +1 +.\" .rstReportMargin post: +.. +.de UNINDENT +. RE +.\" indent \\n[an-margin] +.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] +.nr rst2man-indent-level -1 +.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] +.in \\n[rst2man-indent\\n[rst2man-indent-level]]u +.. +.TH "A8XD" 1 "2024-06-29" "0.2.1" "Urchlay's Atari 8-bit Tools" +.SH NAME +a8xd \- Atari ASCII aware hex dump +.SH SYNOPSIS +.sp +\fIa8xd\fP [\fB\-i\fP] [\fB\-m\fP] [\fB\-v\fP] [\fIinfile\fP] +.SH DESCRIPTION +.sp +\fBa8xd\fP is a hex dump utility, similar to \fBxxd\fP(1), but it +understands and prints ATASCII characters rather than ASCII. +.sp +The ATASCII codes are converted to UTF\-8, in the same way as +\fBa8cat\fP(1). Codes with the high bit set are displayed in inverse +video, using ANSI/VT\-100 escape sequences. +.sp +By default, the output is colorized: +.INDENT 0.0 +.INDENT 3.5 +.INDENT 0.0 +.IP \(bu 2 +Normal characters are green. This includes alphanumerics, spaces, and +punctuation. +.IP \(bu 2 +Codes \fB$00\fP (null, or ATASCII heart) and \fB$9B\fP (EOL) are red. +.IP \(bu 2 +Control characters are yellow. This includes codes \fB$01\fP to \fB$1F\fP, +(control + letters, escape, punctuation, and arrow keys), \fB$60\fP, \fB$7B\fP, \fB$7D\fP +(clear screen), \fB$7E\fP (backspace), and \fB$7F\fP (tab). +.UNINDENT +.UNINDENT +.UNINDENT +.sp +The colors and inverse rendering apply to both the ATASCII and hex bytes. +.sp +Without \fIinfile\fP, or if \fIinfile\fP is \fB\-\fP, \fBa8xd\fP reads from standard input. +.SH OPTIONS +.sp +Options marked with \fB*\fP are not yet implemented. +.INDENT 0.0 +.TP +.B \-i +Print XL/XE International Character Set conversions instead of ATASCII. +.UNINDENT +.INDENT 0.0 +.TP +.B \-l \fIlen\fP +Stop after dumping \fIlen\fP bytes. \fIlen\fP may be given in decimal or hex (with +leading \fI0x\fP or \fI$\fP). +.UNINDENT +.INDENT 0.0 +.TP +.B \-m +Monochrome mode. Disables color, but ATASCII characters with the high bit +set are still displayed in inverse. +.TP +.B \-n +\fB*\fP Narrow dump mode. Displays 8 bytes per line. Maximum line length is +less than 40 columns. Use this if your terminal is less than 75 columns +wide. +.UNINDENT +.INDENT 0.0 +.TP +.B \-o \fIoffset\fP +\fB*\fP Add \fIoffset\fP to displayed file position. \fIoffset\fP can be given in decimal +or hex (with leading \fI0x\fP or \fI$\fP). +.TP +.B \-s \fI[\-]seek\fP +\fB*\fP Start at \fIseek\fP bytes. Without \fI\-\fP, this is an absolute offset. With \fI\-\fP, +it\(aqs relative to the end of the file. The \fI\-\fP option won\(aqt work when +reading from standard input. \fIseek\fP may be given in decimal or hex +(with leading \fI0x\fP or \fI$\fP). +.UNINDENT +.INDENT 0.0 +.TP +.B \-u +\fB*\fP Use uppercase letters; the default is lowercase. +.TP +.B \-v +Verbose. Currently, this option is accepted, but it doesn\(aqt do anything yet. +.UNINDENT +.INDENT 0.0 +.TP +.B \fB\-\-\fP +End of options; the nex argument is the filename. Use this if you\(aqre +trying to work with files whose names begin with \fI\-\fP\&. +.TP +.B \fB\-h\fP, \fB\-\-help\fP +Show built\-in help and exit. +.TP +.B \fB\-\-version\fP +Show version number and exit. +.UNINDENT +.SH NOTES +.sp +\fBa8xd\fP supports a useful subset of \fBxxd\fP(1) options. The main things +missing are: +.INDENT 0.0 +.IP \(bu 2 +\fB\-r\fP (revert). +.IP \(bu 2 +\fB\-include\fP (output as C include) and all options related to it. +.IP \(bu 2 +\fB\-g\fP (grouping; \fBa8xd\fP always uses a group size of 1 byte). +.IP \(bu 2 +\fB\-E\fP (EBCDIC mode). +.IP \(bu 2 +\fB\-p\fP (PostScript/continuous dump). +.IP \(bu 2 +\fB\-cols\fP (\fBa8xd\fP only supports 8 or 16 column dumps). +.IP \(bu 2 +\fB\-b\fP (bits mode). +.UNINDENT +.SH COPYRIGHT +.sp +WTFPL. See \fI\%http://www.wtfpl.net/txt/copying/\fP for details. +.SH AUTHOR +.INDENT 0.0 +.IP B. 3 +Watson <\fI\%urchlay@slackware.uk\fP>; Urchlay on irc.libera.chat \fI##atari\fP\&. +.UNINDENT +.SH SEE ALSO +.sp +\fBa8eol\fP(1), +\fBa8utf8\fP(1), +\fBatr2xfd\fP(1), +\fBatrsize\fP(1), +\fBaxe\fP(1), +\fBblob2c\fP(1), +\fBblob2xex\fP(1), +\fBcart2xex\fP(1), +\fBcxrefbas\fP(1), +\fBdasm2atasm\fP(1), +\fBdumpbas\fP(1), +\fBf2toxex\fP(1), +\fBfenders\fP(1), +\fBlistbas\fP(1), +\fBprotbas\fP(1), +\fBrenumbas\fP(1), +\fBrom2cart\fP(1), +\fBunmac65\fP(1), +\fBunprotbas\fP(1), +\fBvxrefbas\fP(1), +\fBxexamine\fP(1), +\fBxexcat\fP(1), +\fBxexsplit\fP(1), +\fBxfd2atr\fP(1), +\fBxex\fP(5), +\fBatascii\fP(7). +.sp +Any good Atari 8\-bit book: \fIDe Re Atari\fP, \fIThe Atari BASIC Reference +Manual\fP, the \fIOS Users\(aq Guide\fP, \fIMapping the Atari\fP, etc. +.\" Generated by docutils manpage writer. +. -- cgit v1.2.3