aboutsummaryrefslogtreecommitdiff
path: root/vxrefbas.rst
blob: d77e6c541f1f2d212050ef760892e7b7af7365f3 (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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
========
vxrefbas
========

--------------------------------------------------------------
Variable cross-reference for tokenized Atari 8-bit BASIC files
--------------------------------------------------------------

.. include:: manhdr.rst

SYNOPSIS
========

vxrefbas **input-file**

DESCRIPTION
===========

**vxrefbas** reads an Atari 8-bit BASIC tokenized program and prints a
list of variables (names and token numbers), each with a list of line
numbers where the variable is referenced.

String variable names end with *$*. Arrays end with *(*. Numeric
(scalar) variable names don't have a special character.

After the list of lines, the reference count is shown in parentheses.
Multiple references on the same line of code are not counted
separately, so this is a count of *lines* that reference the variable.
Variables that aren't used by the program are listed as *(no
references)*.

Each line number may be followed by an *=* and one or more markers,
which show the type of variable access.

**A**
  Variable is assigned on this line, with *LET* or "implied LET" (e.g.
  *A=1*).

**F**
  Variable is used as the control variable of a *FOR* loop on this line.

**N**
  Variable is used in a *NEXT* on this line.

**D**
  The variable is dimensioned (*DIM* command) on this line. Only applies to
  string and array variables.

**I**
  Variable was *INPUT* on this line.

**R**
  Variable was *READ* on this line.

**G**
  Variable was read with *GET* on this line.

**O**
  Variable was set by *NOTE* on this line. Sorry, this can't be *N*, it's
  already used for *NEXT*.

**L**
  Variable was set by *LOCATE* on this line.

The last line of output shows the total number of variables and the
number of unreferenced variables.

OPTIONS
=======

There are no application-specific options.

.. include:: genopts.rst

EXIT STATUS
===========

0 for success, 1 for failure.

.. include:: manftr.rst