aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2024-06-17 18:40:35 -0400
committerB. Watson <urchlay@slackware.uk>2024-06-17 18:40:35 -0400
commit7e359d5a95b28e59d2a3e97bef12f028d2ab0ad0 (patch)
treef964f19db67c16232aa6f9d40a5c9984bb4d1311
parent2025724a923b73a1cce27524aea5ed4ac22ffd21 (diff)
downloadbw-atari8-tools-7e359d5a95b28e59d2a3e97bef12f028d2ab0ad0.tar.gz
cxrefbas: update doc.
-rw-r--r--cxrefbas.126
-rw-r--r--cxrefbas.rst24
2 files changed, 44 insertions, 6 deletions
diff --git a/cxrefbas.1 b/cxrefbas.1
index 99870a2..15dd6c1 100644
--- a/cxrefbas.1
+++ b/cxrefbas.1
@@ -32,13 +32,33 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
cxrefbas \- Code cross-reference for tokenized Atari 8-bit BASIC files
.SH SYNOPSIS
.sp
-cxrefbas \fBinput\-file\fP
+cxrefbas [\fB\-v\fP] \fBinput\-file\fP
.SH DESCRIPTION
.sp
\fBcxrefbas\fP reads an Atari 8\-bit BASIC tokenized program. For each
line number in the program, it prints a list of lines that reference
-it, via \fIGOTO\fP, \fIGOSUB\fP, \fIRESTORE\fP, \fITRAP\fP, \fION/GOTO\fP, \fION/GOTO\fP,
-or \fION/GOSUB\fP\&.
+it. Each reference is followed by a letter that indicates the type
+of reference:
+.INDENT 0.0
+.TP
+.B \fBG\fP
+\fIGOTO\fP (without \fION\fP) or \fIGO TO\fP\&.
+.TP
+.B \fBS\fP
+\fIGOSUB\fP (without \fION\fP).
+.TP
+.B \fBI\fP
+\fIIF\fP with line number only, e.g. \fIIF X THEN 1000\fP\&.
+.TP
+.B \fBO\fP
+\fION/GOTO\fP or \fION/GOSUB\fP\&.
+.TP
+.B \fBR\fP
+\fIRESTORE\fP\&.
+.TP
+.B \fBT\fP
+\fITRAP\fP\&.
+.UNINDENT
.sp
If a line doesn\(aqt exist, but is referenced (e.g. \fIGOTO 100\fP, but there
is no line 100), it\(aqs printed in the table, prefixed with \fI!\fP\&.
diff --git a/cxrefbas.rst b/cxrefbas.rst
index 2bba3f7..62346cd 100644
--- a/cxrefbas.rst
+++ b/cxrefbas.rst
@@ -11,15 +11,33 @@ Code cross-reference for tokenized Atari 8-bit BASIC files
SYNOPSIS
========
-cxrefbas **input-file**
+cxrefbas [**-v**] **input-file**
DESCRIPTION
===========
**cxrefbas** reads an Atari 8-bit BASIC tokenized program. For each
line number in the program, it prints a list of lines that reference
-it, via *GOTO*, *GOSUB*, *RESTORE*, *TRAP*, *ON/GOTO*, *ON/GOTO*,
-or *ON/GOSUB*.
+it. Each reference is followed by a letter that indicates the type
+of reference:
+
+**G**
+ *GOTO* (without *ON*) or *GO TO*.
+
+**S**
+ *GOSUB* (without *ON*).
+
+**I**
+ *IF* with line number only, e.g. *IF X THEN 1000*.
+
+**O**
+ *ON/GOTO* or *ON/GOSUB*.
+
+**R**
+ *RESTORE*.
+
+**T**
+ *TRAP*.
If a line doesn't exist, but is referenced (e.g. *GOTO 100*, but there
is no line 100), it's printed in the table, prefixed with *!*.