VXREFBAS(1)

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

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.

  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.

COPYRIGHT

WTFPL. See http://www.wtfpl.net/txt/copying/ for details.

AUTHOR

B.  Watson <urchlay@slackware.uk>; Urchlay on irc.libera.chat ##atari.

SEE ALSO

a8cat(1), a8eol(1), a8xd(1), atr2xfd(1), atrsize(1), axe(1), bas2aplus(1), blob2c(1), blob2xex(1), cart2xex(1), cxrefbas(1), dasm2atasm(1), diffbas(1), dumpbas(1), f2toxex(1), fenders(1), listbas(1), listamsb(1), protbas(1), renumbas(1), rom2cart(1), unmac65(1), unprotbas(1), vxrefbas(1), whichbas(1), xex1to2(1), xexamine(1), xexcat(1), xexsplit(1), xfd2atr(1), xex(5), atascii(7), fauxtari(7).

Any good Atari 8-bit book: De Re Atari, The Atari BASIC Reference Manual, the OS Users' Guide, Mapping the Atari, etc.