aboutsummaryrefslogtreecommitdiff
path: root/cxrefbas.rst
blob: 2bba3f7eb1df30ec53f234b5828ffaeea5948557 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
========
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*, *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.

Line numbers above 32767, e.g. *TRAP 40000*, are not listed.

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