diff options
Diffstat (limited to 'jindroush/man')
| -rw-r--r-- | jindroush/man/chkbas.1 | 24 | ||||
| -rw-r--r-- | jindroush/man/chkbas.rst | 14 |
2 files changed, 27 insertions, 11 deletions
diff --git a/jindroush/man/chkbas.1 b/jindroush/man/chkbas.1 index 1069d6c..f2664f3 100644 --- a/jindroush/man/chkbas.1 +++ b/jindroush/man/chkbas.1 @@ -27,14 +27,12 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "CHKBAS" 1 "2024-05-16" "1.10" "Jindroush's Atari 8-bit tools" +.TH "CHKBAS" 1 "2024-07-10" "1.10" "Jindroush's Atari 8-bit tools" .SH NAME chkbas \- check and detokenize Atari BASIC SAVEd files .SH SYNOPSIS .sp chkbas [\fB\-atari\fP] [\fB\-short\fP] [\fB\-verbose\fP] [\fB\-noinverse\fP] [\fB\-tbs\fP | \fB\-bxl\fP | \fB\-bxe\fP] \fBbasic\-file\fP [\fBoutput\-file\fP] -.sp -listbas [\fB\-atari\fP] [\fB\-verbose\fP] [\fB\-noinverse\fP] [\fB\-tbs\fP | \fB\-bxl\fP | \fB\-bxe\fP] \fBbasic\-file\fP [\fBoutput\-file\fP] .SH DESCRIPTION .sp \fBchkbas\fP detokenizes Atari 8\-bit BASIC SAVEd files. It lists the BASIC @@ -47,7 +45,21 @@ standard output. If \fBbasic\-file\fP is anything other than standard Atari BASIC, the BASIC dialect must be specified (see \fBOPTIONS\fP, below). .sp -\fBlistbas\fP is simply an alias for \fBchkbas \-short\fP\&. +It\(aqs highly recommended to avoid running \fBchkbas\fP without +redirecting or piping its output: If the program contains ATASCII +graphics or inverse characters, they will be printed as\-is to the +terminal, which can confuse the terminal. For simply reading the code, +pipe to \fBa8cat\fP(1), thus: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +$ chkbas \-atari PROGRAM.BAS | a8cat +.ft P +.fi +.UNINDENT +.UNINDENT .sp Sample run, with no options: .INDENT 0.0 @@ -69,7 +81,7 @@ Input file: HELLO.BAS Constants & pointers: Start of Name Table (VNT) : 000E End of Name Table (VNTE) : 0011 -Lenght of Name Table (VNTL) : 0004 +Length of Name Table (VNTL) : 0004 Start of Variable Table (VVT) : 0012 End of Variable Table (VVTE) : 0021 Length of Variable Table (VVTL) : 0010 @@ -125,7 +137,7 @@ EOL characters (\fB$9B\fP). .B \fB\-short\fP Output only the program listing, with lines terminated by the system default newline character(s), e.g. \fBn\fP on UNIX\-like OSes, -\fBrn\fP on MS\-DOS or Windows. This is the default for \fBlistbas\fP\&. +\fBrn\fP on MS\-DOS or Windows. .TP .B \fB\-verbose\fP Program listing will be interspersed with per\-line and per\-statement diff --git a/jindroush/man/chkbas.rst b/jindroush/man/chkbas.rst index 2f9e6b7..b6c678f 100644 --- a/jindroush/man/chkbas.rst +++ b/jindroush/man/chkbas.rst @@ -15,8 +15,6 @@ SYNOPSIS chkbas [**-atari**] [**-short**] [**-verbose**] [**-noinverse**] [**-tbs** | **-bxl** | **-bxe**] **basic-file** [**output-file**] -listbas [**-atari**] [**-verbose**] [**-noinverse**] [**-tbs** | **-bxl** | **-bxe**] **basic-file** [**output-file**] - DESCRIPTION =========== @@ -30,7 +28,13 @@ standard output. If **basic-file** is anything other than standard Atari BASIC, the BASIC dialect must be specified (see **OPTIONS**, below). -**listbas** is simply an alias for **chkbas -short**. +It's highly recommended to avoid running **chkbas** without +redirecting or piping its output: If the program contains ATASCII +graphics or inverse characters, they will be printed as-is to the +terminal, which can confuse the terminal. For simply reading the code, +pipe to **a8cat**\(1), thus:: + + $ chkbas -atari PROGRAM.BAS | a8cat Sample run, with no options:: @@ -48,7 +52,7 @@ Sample run, with no options:: Constants & pointers: Start of Name Table (VNT) : 000E End of Name Table (VNTE) : 0011 - Lenght of Name Table (VNTL) : 0004 + Length of Name Table (VNTL) : 0004 Start of Variable Table (VVT) : 0012 End of Variable Table (VVTE) : 0021 Length of Variable Table (VVTL) : 0010 @@ -103,7 +107,7 @@ Output Options **-short** Output only the program listing, with lines terminated by the system default newline character(s), e.g. **\n** on UNIX-like OSes, - **\r\n** on MS-DOS or Windows. This is the default for **listbas**. + **\r\n** on MS-DOS or Windows. **-verbose** Program listing will be interspersed with per-line and per-statement |