aboutsummaryrefslogtreecommitdiff
path: root/cxrefbas.rst
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2024-06-16 17:33:22 -0400
committerB. Watson <urchlay@slackware.uk>2024-06-16 17:33:22 -0400
commite2250e5cb71c9a06bf75d59e9c0369efd65b1206 (patch)
treeae87da4b129ca29c5066e27d375f080d0cac9d72 /cxrefbas.rst
parentdecd8312b033235cb64db2fcd3ffa4829bd21af7 (diff)
downloadbw-atari8-tools-e2250e5cb71c9a06bf75d59e9c0369efd65b1206.tar.gz
cxrefbas: added.
Diffstat (limited to 'cxrefbas.rst')
-rw-r--r--cxrefbas.rst50
1 files changed, 50 insertions, 0 deletions
diff --git a/cxrefbas.rst b/cxrefbas.rst
new file mode 100644
index 0000000..fbfc74a
--- /dev/null
+++ b/cxrefbas.rst
@@ -0,0 +1,50 @@
+========
+cxrefbas
+========
+
+----------------------------------------------------------
+Code cross-reference for tokenized Atari 8-bit BASIC files
+----------------------------------------------------------
+
+.. include:: manhdr.rst
+
+SYNOPSIS
+========
+
+cxrefbas **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*, or *ON/GOSUB*.
+
+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 *!*.
+
+Any command that uses a computed value for a line number will print a
+warning on standard error, e.g. *GOTO A* or *GOSUB 100\*A*. Even *GOTO
+100+0* is a computed value, since BASIC doesn't do constant folding.
+
+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.
+
+EXIT STATUS
+===========
+
+0 for success, 1 for failure.
+
+.. include:: manftr.rst