diff options
| -rw-r--r-- | Makefile | 2 | ||||
| -rw-r--r-- | a8eol.1 | 2 | ||||
| -rw-r--r-- | a8utf8.1 | 2 | ||||
| -rw-r--r-- | atr2xfd.1 | 2 | ||||
| -rw-r--r-- | atrsize.1 | 2 | ||||
| -rw-r--r-- | axe.1 | 2 | ||||
| -rw-r--r-- | blob2c.1 | 2 | ||||
| -rw-r--r-- | blob2xex.1 | 2 | ||||
| -rw-r--r-- | cart2xex.1 | 2 | ||||
| -rw-r--r-- | cxrefbas.1 | 4 | ||||
| -rw-r--r-- | cxrefbas.rst | 12 | ||||
| -rw-r--r-- | dasm2atasm.1 | 2 | ||||
| -rw-r--r-- | dumpbas.1 | 26 | ||||
| -rw-r--r-- | dumpbas.rst | 14 | ||||
| -rw-r--r-- | fenders.1 | 2 | ||||
| -rw-r--r-- | genopts.rst | 11 | ||||
| -rw-r--r-- | protbas.1 | 28 | ||||
| -rw-r--r-- | protbas.rst | 14 | ||||
| -rw-r--r-- | renumbas.1 | 66 | ||||
| -rw-r--r-- | renumbas.rst | 47 | ||||
| -rw-r--r-- | rom2cart.1 | 2 | ||||
| -rw-r--r-- | unmac65.1 | 2 | ||||
| -rw-r--r-- | unprotbas.1 | 28 | ||||
| -rw-r--r-- | unprotbas.rst | 14 | ||||
| -rw-r--r-- | vxrefbas.1 | 4 | ||||
| -rw-r--r-- | vxrefbas.rst | 12 | ||||
| -rw-r--r-- | xex1to2.1 | 2 | ||||
| -rw-r--r-- | xexamine.1 | 2 | ||||
| -rw-r--r-- | xexcat.1 | 2 | ||||
| -rw-r--r-- | xexsplit.1 | 2 | ||||
| -rw-r--r-- | xfd2atr.1 | 2 | 
31 files changed, 123 insertions, 193 deletions
| @@ -154,7 +154,7 @@ cart2rom: rom2cart  manpages: $(MANS) $(MAN5S) $(MAN7S) -%.1: %.rst manhdr.rst manftr.rst +%.1: %.rst manhdr.rst manftr.rst genopts.rst  	$(RST2MAN) $< > $@  %.5: %.rst manhdr5.rst manftr.rst @@ -27,7 +27,7 @@ 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 "A8EOL" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "A8EOL" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  a8eol \- convert Atari 8-bit text files to/from UNIX/Windows/Mac  .\" RST source for a8eol(1) man page. Convert with: @@ -27,7 +27,7 @@ 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 "A8UTF8" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "A8UTF8" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  a8utf8 \- Convert Atari 8-bit text to UTF-8 encoded Unicode.  .\" RST source for a8utf8(1) man page. Convert with: @@ -27,7 +27,7 @@ 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 "ATR2XFD" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "ATR2XFD" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  atr2xfd \- Convert an Atari 8-bit ATR disk image to a raw (XFD) image  .\" RST source for atr2xfd(1) man page. Convert with: @@ -27,7 +27,7 @@ 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 "ATRSIZE" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "ATRSIZE" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  atrsize \- Change the size of an Atari 8-bit ATR disk image, or create a blank ATR image  .\" RST source for atrsize(1) man page. Convert with: @@ -27,7 +27,7 @@ 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 "AXE" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "AXE" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  axe \- ATR/XFD Editor  .\" RST source for axe(1) man page. Convert with: @@ -27,7 +27,7 @@ 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 "BLOB2C" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "BLOB2C" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  blob2c \- Create C source and header files from a binary file  .\" RST source for blob2c(1) man page. Convert with: @@ -27,7 +27,7 @@ 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 "BLOB2XEX" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "BLOB2XEX" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  blob2xex \- Create Atari 8-bit executables from arbitrary data  .\" RST source for blob2xex(1) man page. Convert with: @@ -27,7 +27,7 @@ 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 "CART2XEX" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "CART2XEX" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  cart2xex \- Convert an Atari 8-bit ROM cartridge image to a binary load file  .\" RST source for cart2xex(1) man page. Convert with: @@ -27,7 +27,7 @@ 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 "CXREFBAS" 1 "2024-06-17" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "CXREFBAS" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  cxrefbas \- Code cross-reference for tokenized Atari 8-bit BASIC files  .SH SYNOPSIS @@ -69,6 +69,8 @@ warning on standard error, e.g. \fIGOTO A\fP or \fIGOSUB 100*A\fP\&. Even \fIGOT  .sp  Line numbers above 32767, e.g. \fITRAP 40000\fP, are not listed.  .SH OPTIONS +.sp +There are no application\-specific options.  .SS General Options  .INDENT 0.0  .TP diff --git a/cxrefbas.rst b/cxrefbas.rst index 50c4dbc..3966e9c 100644 --- a/cxrefbas.rst +++ b/cxrefbas.rst @@ -51,17 +51,9 @@ Line numbers above 32767, e.g. *TRAP 40000*, are not listed.  OPTIONS  ======= -General Options ---------------- -**--help** -  Print usage message and exit. +There are no application-specific options. -**--version** -  Print version number and exit. - -**-v** -  Verbose operation. When displaying a number in verbose mode, it will -  be prefixed with *$* if it's in hex, or no prefix for decimal. +.. include:: genopts.rst  EXAMPLE  ======= diff --git a/dasm2atasm.1 b/dasm2atasm.1 index 2c7fd04..b8cbdf0 100644 --- a/dasm2atasm.1 +++ b/dasm2atasm.1 @@ -27,7 +27,7 @@ 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 "DASM2ATASM" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "DASM2ATASM" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  dasm2atasm \- Convert 6502 assembly source from dasm syntax to atasm or ca65 syntax.  .\" RST source for dasm2atasm(1) man page. Convert with: @@ -27,7 +27,7 @@ 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 "DUMPBAS" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "DUMPBAS" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  dumpbas \- Formatted hexdump for tokenized Atari 8-bit BASIC files  .SH SYNOPSIS @@ -50,6 +50,18 @@ It\(aqs assumed the user has at least some knowledge of BASIC\(aqs tokenized  SAVE format. The \fBAtari BASIC Sourcebook\fP is a good starting point  for learning the tokenized format.  .SH OPTIONS +.SS Dump Options +.INDENT 0.0 +.TP +.B \fB\-s\fP \fIstart\-lineno\fP +Don\(aqt dump lines before \fBstart\-lineno\fP\&. Default: \fI0\fP\&. +.TP +.B \fB\-e\fP \fIend\-lineno\fP +Don\(aqt dump lines after \fBstart\-lineno\fP\&. Default: \fI32768\fP\&. +.TP +.B \fB\-l\fP \fIlineno\fP +Only dump one line. This is exactly equivalent to "\fB\-s\fP \fIlineno\fP \fB\-e\fP \fIlineno\fP". +.UNINDENT  .SS General Options  .INDENT 0.0  .TP @@ -63,18 +75,6 @@ Print version number and exit.  Verbose operation. When displaying a number in verbose mode, it will  be prefixed with \fI$\fP if it\(aqs in hex, or no prefix for decimal.  .UNINDENT -.SS Dump Options -.INDENT 0.0 -.TP -.B \fB\-s\fP \fIstart\-lineno\fP -Don\(aqt dump lines before \fBstart\-lineno\fP\&. Default: \fI0\fP\&. -.TP -.B \fB\-e\fP \fIend\-lineno\fP -Don\(aqt dump lines after \fBstart\-lineno\fP\&. Default: \fI32768\fP\&. -.TP -.B \fB\-l\fP \fIlineno\fP -Only dump one line. This is exactly equivalent to "\fB\-s\fP \fIlineno\fP \fB\-e\fP \fIlineno\fP". -.UNINDENT  .SH FORMATTING  .sp  Every byte in the file is displayed in hex. However, they are grouped by line diff --git a/dumpbas.rst b/dumpbas.rst index 59cf93b..6dc32b9 100644 --- a/dumpbas.rst +++ b/dumpbas.rst @@ -32,18 +32,6 @@ for learning the tokenized format.  OPTIONS  ======= -General Options ---------------- -**--help** -  Print usage message and exit. - -**--version** -  Print version number and exit. - -**-v** -  Verbose operation. When displaying a number in verbose mode, it will -  be prefixed with *$* if it's in hex, or no prefix for decimal. -  Dump Options  ------------  **-s** *start-lineno* @@ -55,6 +43,8 @@ Dump Options  **-l** *lineno*    Only dump one line. This is exactly equivalent to "**-s** *lineno* **-e** *lineno*". +.. include:: genopts.rst +  FORMATTING  ==========  Every byte in the file is displayed in hex. However, they are grouped by line @@ -27,7 +27,7 @@ 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 "FENDERS" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "FENDERS" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  fenders \- Install Fenders 3-sector loader in boot sectors of an ATR image  .\" RST source for fenders(1) man page. Convert with: diff --git a/genopts.rst b/genopts.rst new file mode 100644 index 0000000..dfc588a --- /dev/null +++ b/genopts.rst @@ -0,0 +1,11 @@ +General Options +--------------- +**--help** +  Print usage message and exit. + +**--version** +  Print version number and exit. + +**-v** +  Verbose operation. When displaying a number in verbose mode, it will +  be prefixed with *$* if it's in hex, or no prefix for decimal. @@ -27,7 +27,7 @@ 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 "PROTBAS" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "PROTBAS" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  protbas \- LIST-protect Atari 8-bit BASIC programs  .SH SYNOPSIS @@ -57,19 +57,6 @@ a bad next\-line pointer. This will fail if there\(aqs already a line  Options may appear in any order. The first non\-option argument is used  for \fBinput\-file\fP; the second is \fBoutput\-file\fP\&. A third non\-option  argument is an error. -.SS General Options -.INDENT 0.0 -.TP -.B \fB\-\-help\fP -Print usage message and exit. -.TP -.B \fB\-\-version\fP -Print version number and exit. -.TP -.B \fB\-v\fP -Verbose operation. When displaying a number in verbose mode, it will -be prefixed with \fI$\fP if it\(aqs in hex, or no prefix for decimal. -.UNINDENT  .SS Protection Options  .INDENT 0.0  .TP @@ -89,6 +76,19 @@ Character to use for variable name protection. \fINN\fP is the  character code in hex, e.g. \fB\-x20\fP to use a space. Default is  \fB9b\fP (the EOL character). \fB\-xr\fP means random codes.  .UNINDENT +.SS General Options +.INDENT 0.0 +.TP +.B \fB\-\-help\fP +Print usage message and exit. +.TP +.B \fB\-\-version\fP +Print version number and exit. +.TP +.B \fB\-v\fP +Verbose operation. When displaying a number in verbose mode, it will +be prefixed with \fI$\fP if it\(aqs in hex, or no prefix for decimal. +.UNINDENT  .SH EXIT STATUS  .INDENT 0.0  .TP diff --git a/protbas.rst b/protbas.rst index 5ceb838..56fb7c1 100644 --- a/protbas.rst +++ b/protbas.rst @@ -41,18 +41,6 @@ Options may appear in any order. The first non-option argument is used  for **input-file**; the second is **output-file**. A third non-option  argument is an error. -General Options ---------------- -**--help** -  Print usage message and exit. - -**--version** -  Print version number and exit. - -**-v** -  Verbose operation. When displaying a number in verbose mode, it will -  be prefixed with *$* if it's in hex, or no prefix for decimal. -  Protection Options  ------------------  **-nc** @@ -71,6 +59,8 @@ Protection Options    character code in hex, e.g. **-x20** to use a space. Default is    **9b** (the EOL character). **-xr** means random codes. +.. include:: genopts.rst +  EXIT STATUS  =========== @@ -27,7 +27,7 @@ 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 "RENUMBAS" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "RENUMBAS" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  renumbas \- Renumber Atari 8-bit BASIC programs  .SH SYNOPSIS @@ -53,11 +53,13 @@ e.g. if line 100 gets changed to 200, any other line that does a GOTO  100 (or GOSUB, RESTORE, TRAP, etc) will be updated with the new line  number.  .sp -Computed line numbers can\(aqt be updated (e.g. GOTO A or GOSUB -1000+A*100). These will draw warnings on stderr, so you can fix them +Computed line numbers can\(aqt be updated (e.g. \fIGOTO A or GOSUB +1000+A*100\fP). These will cause warnings on stderr, so you can fix them  manually.  .sp -Line numbers that don\(aqt exist will not be changed (e.g. TRAP 40000). +Valid line numbers (0 to 32767) that don\(aqt exist will not be changed, +but will cause a warning. Invalid line numbers (e.g. \fITRAP 40000\fP) +will be ignored (no change, no warning).  .sp  Remember that the maximum line number for Atari BASIC is 32767.  Renumbering will fail, if the chosen start and increment values @@ -67,19 +69,6 @@ would result in lines with numbers higher than this.  Options may appear in any order. The first non\-option argument is used  for \fBinput\-file\fP; the second is \fBoutput\-file\fP\&. A third non\-option  argument is an error. -.SS General Options -.INDENT 0.0 -.TP -.B \fB\-\-help\fP -Print usage message and exit. -.TP -.B \fB\-\-version\fP -Print version number and exit. -.TP -.B \fB\-v\fP -Verbose operation. When displaying a number in verbose mode, it will -be prefixed with \fI$\fP if it\(aqs in hex, or no prefix for decimal. -.UNINDENT  .SS Renumber Options  .INDENT 0.0  .TP @@ -93,26 +82,20 @@ Line number increment between successive lines. Default: 10.  Line number in original program where renumbering will start. Lines  numbered lower that this will not be renumbered. Default: 0.  .UNINDENT -.SH LIMITATIONS -.SS Computed line numbers with ON -.sp -If an ON/GOTO or ON/GOSUB uses computed line numbers (and causes a -warning), none of the line numbers after the first computed one will -be updated, even if they are constant. Example: +.SS General Options  .INDENT 0.0 -.INDENT 3.5 -.sp -.nf -.ft C -100 ON X GOTO 10,20*Y,30 -.ft P -.fi -.UNINDENT +.TP +.B \fB\-\-help\fP +Print usage message and exit. +.TP +.B \fB\-\-version\fP +Print version number and exit. +.TP +.B \fB\-v\fP +Verbose operation. When displaying a number in verbose mode, it will +be prefixed with \fI$\fP if it\(aqs in hex, or no prefix for decimal.  .UNINDENT -.sp -The 10 will be changed to whatever line 10 got renumbered to, as expected. The 20 -will \fInot\fP be changed. \fBrenumbas\fP just gives up, after the first computed -line number. +.SH LIMITATIONS  .sp  A pathological case:  .INDENT 0.0 @@ -120,19 +103,18 @@ A pathological case:  .sp  .nf  .ft C -100 ON X GOTO 10+0,20+0 +100 GOTO 200+0  .ft P  .fi  .UNINDENT  .UNINDENT  .sp -The 10+0 and 20+0 are considered computed line numbers, even though -the results of the computation are constant. This is because neither -Atari BASIC nor \fBrenumbas\fP does constant folding. +200+0 is considered a computed line number, even though the results of +the computation are constant. This is because neither Atari BASIC nor +\fBrenumbas\fP does constant folding.  .sp -None of this should be a real\-world problem: computed line numbers in -ON/GOTO or ON/GOSUB are exceedingly rare. The whole \fIpoint\fP of ON is -to avoid computing line numbers. +This shouldn\(aqt be a real\-world problem; did \fIyou\fP ever write code like +that in Atari BASIC?  .SS Warning line numbers  .sp  Any warning that includes a line number (such as "Computed line number") will diff --git a/renumbas.rst b/renumbas.rst index a0b79ba..7d963b1 100644 --- a/renumbas.rst +++ b/renumbas.rst @@ -32,11 +32,13 @@ e.g. if line 100 gets changed to 200, any other line that does a GOTO  100 (or GOSUB, RESTORE, TRAP, etc) will be updated with the new line  number. -Computed line numbers can't be updated (e.g. GOTO A or GOSUB -1000+A*100). These will draw warnings on stderr, so you can fix them +Computed line numbers can't be updated (e.g. *GOTO A or GOSUB +1000+A*100*). These will cause warnings on stderr, so you can fix them  manually. -Line numbers that don't exist will not be changed (e.g. TRAP 40000). +Valid line numbers (0 to 32767) that don't exist will not be changed, +but will cause a warning. Invalid line numbers (e.g. *TRAP 40000*) +will be ignored (no change, no warning).  Remember that the maximum line number for Atari BASIC is 32767.  Renumbering will fail, if the chosen start and increment values @@ -49,18 +51,6 @@ Options may appear in any order. The first non-option argument is used  for **input-file**; the second is **output-file**. A third non-option  argument is an error. -General Options ---------------- -**--help** -  Print usage message and exit. - -**--version** -  Print version number and exit. - -**-v** -  Verbose operation. When displaying a number in verbose mode, it will -  be prefixed with *$* if it's in hex, or no prefix for decimal. -  Renumber Options  ----------------  **-s** *start-lineno* @@ -73,32 +63,21 @@ Renumber Options    Line number in original program where renumbering will start. Lines    numbered lower that this will not be renumbered. Default: 0. +.. include:: genopts.rst +  LIMITATIONS  =========== -Computed line numbers with ON ------------------------------ -If an ON/GOTO or ON/GOSUB uses computed line numbers (and causes a -warning), none of the line numbers after the first computed one will -be updated, even if they are constant. Example:: - -  100 ON X GOTO 10,20*Y,30 - -The 10 will be changed to whatever line 10 got renumbered to, as expected. The 20 -will *not* be changed. **renumbas** just gives up, after the first computed -line number. -  A pathological case:: -  100 ON X GOTO 10+0,20+0 +  100 GOTO 200+0 -The 10+0 and 20+0 are considered computed line numbers, even though -the results of the computation are constant. This is because neither -Atari BASIC nor **renumbas** does constant folding. +200+0 is considered a computed line number, even though the results of +the computation are constant. This is because neither Atari BASIC nor +**renumbas** does constant folding. -None of this should be a real-world problem: computed line numbers in -ON/GOTO or ON/GOSUB are exceedingly rare. The whole *point* of ON is -to avoid computing line numbers. +This shouldn't be a real-world problem; did *you* ever write code like +that in Atari BASIC?  Warning line numbers  -------------------- @@ -27,7 +27,7 @@ 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 "ROM2CART" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "ROM2CART" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  rom2cart \- Convert a raw ROM image to an Atari800 CART image, or vice versa  .\" RST source for rom2cart(1) man page. Convert with: @@ -27,7 +27,7 @@ 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 "UNMAC65" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "UNMAC65" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  unmac65 \- Detokenize Atari 8-bit Mac/65 SAVEd files.  .\" RST source for unmac65(1) man page. Convert with: diff --git a/unprotbas.1 b/unprotbas.1 index 1cbbd98..c12345d 100644 --- a/unprotbas.1 +++ b/unprotbas.1 @@ -27,7 +27,7 @@ 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 "UNPROTBAS" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "UNPROTBAS" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  unprotbas \- Unprotect LIST-protected Atari 8-bit BASIC programs  .SH SYNOPSIS @@ -57,19 +57,6 @@ argument is an error.  Option bundling is not supported, use e.g. \fB\-v \-f\fP, not \fB\-vf\fP\&.  To use filenames beginning with \fI\-\fP, write them as \fI\&./\-file\fP, or they  will be treated as options. -.SS General Options -.INDENT 0.0 -.TP -.B \fB\-\-help\fP -Print usage message and exit. -.TP -.B \fB\-\-version\fP -Print version number and exit. -.TP -.B \fB\-v\fP -Verbose operation. When displaying a number in verbose mode, it will -be prefixed with \fI$\fP if it\(aqs in hex, or no prefix for decimal. -.UNINDENT  .SS Unprotection Options  .INDENT 0.0  .TP @@ -102,6 +89,19 @@ already exists, it will be overwritten.  Read variable names from \fBvarnames.txt\fP, and use them instead of  generating the names. See \fBVARIABLE NAMES\fP, below.  .UNINDENT +.SS General Options +.INDENT 0.0 +.TP +.B \fB\-\-help\fP +Print usage message and exit. +.TP +.B \fB\-\-version\fP +Print version number and exit. +.TP +.B \fB\-v\fP +Verbose operation. When displaying a number in verbose mode, it will +be prefixed with \fI$\fP if it\(aqs in hex, or no prefix for decimal. +.UNINDENT  .SH EXIT STATUS  .INDENT 0.0  .TP diff --git a/unprotbas.rst b/unprotbas.rst index d24b1f3..21bbdb1 100644 --- a/unprotbas.rst +++ b/unprotbas.rst @@ -41,18 +41,6 @@ Option bundling is not supported, use e.g. **-v -f**, not **-vf**.  To use filenames beginning with *-*, write them as *./-file*, or they  will be treated as options. -General Options ---------------- -**--help** -  Print usage message and exit. - -**--version** -  Print version number and exit. - -**-v** -  Verbose operation. When displaying a number in verbose mode, it will -  be prefixed with *$* if it's in hex, or no prefix for decimal. -  Unprotection Options  --------------------  **-f** @@ -84,6 +72,8 @@ Unprotection Options    Read variable names from **varnames.txt**, and use them instead of    generating the names. See **VARIABLE NAMES**, below. +.. include:: genopts.rst +  EXIT STATUS  =========== @@ -27,7 +27,7 @@ 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 "VXREFBAS" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "VXREFBAS" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  vxrefbas \- Variable cross-reference for tokenized Atari 8-bit BASIC files  .SH SYNOPSIS @@ -86,6 +86,8 @@ Variable was set by \fILOCATE\fP on this line.  The last line of output shows the total number of variables and the  number of unreferenced variables.  .SH OPTIONS +.sp +There are no application\-specific options.  .SS General Options  .INDENT 0.0  .TP diff --git a/vxrefbas.rst b/vxrefbas.rst index 5a17cdb..d77e6c5 100644 --- a/vxrefbas.rst +++ b/vxrefbas.rst @@ -68,17 +68,9 @@ number of unreferenced variables.  OPTIONS  ======= -General Options ---------------- -**--help** -  Print usage message and exit. +There are no application-specific options. -**--version** -  Print version number and exit. - -**-v** -  Verbose operation. When displaying a number in verbose mode, it will -  be prefixed with *$* if it's in hex, or no prefix for decimal. +.. include:: genopts.rst  EXIT STATUS  =========== @@ -27,7 +27,7 @@ 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 "XEX1TO2" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "XEX1TO2" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  xex1to2 \- Convert an Atari DOS 1.0 executable to a standard Atari executable  .\" RST source for xex1to2(1) man page. Convert with: @@ -27,7 +27,7 @@ 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 "XEXAMINE" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "XEXAMINE" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  xexamine \- Show information on Atari 8-bit executables (XEX)  .\" RST source for xexamine(1) man page. Convert with: @@ -27,7 +27,7 @@ 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 "XEXCAT" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "XEXCAT" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  xexcat \- Concatenate Atari 8-bit executables (XEX) into a single XEX file.  .\" RST source for xexcat(1) man page. Convert with: @@ -27,7 +27,7 @@ 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 "XEXSPLIT" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "XEXSPLIT" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  xexsplit \- Split a multi-segment Atari 8-bit executable (XEX) into multiple single-segment files.  .\" RST source for xexsplit(1) man page. Convert with: @@ -27,7 +27,7 @@ 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 "XFD2ATR" 1 "2024-06-16" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "XFD2ATR" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"  .SH NAME  xfd2atr \- Convert an Atari 8-bit XFD (raw) disk image to an ATR image.  .\" RST source for xfd2atr(1) man page. Convert with: | 
