From 7e359d5a95b28e59d2a3e97bef12f028d2ab0ad0 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Mon, 17 Jun 2024 18:40:35 -0400 Subject: cxrefbas: update doc. --- cxrefbas.1 | 26 +++++++++++++++++++++++--- cxrefbas.rst | 24 +++++++++++++++++++++--- 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 *!*. -- cgit v1.2.3