ATARI HOME
Introduction
Definitions
Disk Contents
Starting SOURCGEN
Symbol-Table & Editor
Generating Source Code
- from an SMB file
- for the ATARI OS
Creating SMB files
The Function Keys
The Functions A - U
A. ADDR/symb search
B. BYTE-change
C. CODE-search
D. DELETE symbols
E. EDIT
F. FILE
G. GO
H. HEAD
I. INDEX
J. JUNK?
K. KEY (0..9)
L. LIST symbols
M. MINIMUM-label
N. NEW
O. OBTAIN symbols
P. PREPARE labels
Q. QUIT (1)
R. RE-ADDRESS
S. SAVE symbols
T. TRACE
U. UTILITY (V. 3.2)
The Fram-disk
Output Menu
Error Messages
Reference card
New in V.3.2

P. PREPARE labels

<ADR1> [<ADR2>]

After the execution of this function, addresses in the listing will be substituted where appropriate with labels.

SOURCGEN writes each of these addresses in one of three internal tables called the J, T and
H tables. JSR and JMP addresses are stored in the J table; branch addresses in the H table. All
other addresses will be noted in the T-table.

When you start the listing, you will see that a J or T lable is composed of the letter J or T followed
by the address to which the lable refers. (eg. J4E00,TA8F3). The H-labels, on the other hand are
simply numbered. (eg. H1,H2,H3).

In working with SOURCGEN, you will soon see that the distinction between the various kinds of labels increases clarity. The J and H lables will almost always be found in sections of normal code, whereas T-labels will often refer to tables and text.

When SOURCGEN needs a lable, it will search through the tables in the following order: S, J, T, H. ('S' stands for symbol table). Thus it is possible for a command such as 'BNE J8A08' to appear in your listing, whereas a command such as 'JMP H60' is not possible.

<ADR1> <ADR2> <NUM>

If you enter a value for <NUM> then the H-lables will be numbered beginning with this value.
If for instance <NUM> is given then value B2 then the first label will be HB2, the second label HB3 etc.

<ADR1> [<ADR2>] [<NUM>]/+

The J, T, and H tables will not be cleared before new lables are added.