diff --git a/SourceGen/RuntimeData/Help/advanced.html b/SourceGen/RuntimeData/Help/advanced.html index 987fc13..5ae1c7e 100644 --- a/SourceGen/RuntimeData/Help/advanced.html +++ b/SourceGen/RuntimeData/Help/advanced.html @@ -30,21 +30,21 @@ Blank lines, and lines that begin with a semicolon (';'), are ignored. Lines that begin with an asterisk ('*') are commands. Two are currently defined:

Tags can be used by extension scripts to identify a subset of symbols. The symbols are still part of the global set; the tag just provides a way to extract a subset. Tags should be comprised of non-whitespace ASCII -characters. Tags are global, so use a long, descriptive string. If *TAG -is not followed by a string, the symbols that follow are treated as -untagged.

+characters. Tags are global, so use a long, descriptive string. If +*TAG is not followed by a string, the symbols that follow +are treated as untagged.

All other lines are symbols, which have the form:

-  label {=|@} value [;comment]
+  label {=|@} value [width] [;comment]
 

Labels must be at least two characters long, begin with a letter or @@ -61,6 +61,10 @@ binary (with a leading '%'). The numeric base will be recorded and used when formatting the symbol in generated output, so use whichever form is most appropriate. Values are unsigned 24-bit numbers.

+

The width is optional, and ignored for constants. It must be a +decimal or hexadecimal value between 1 and 65536, inclusive. If omitted, +the default width is 1.

+

The comment is optional. If present, it will be saved and used as the end-of-line comment on the .EQ directive if the symbol is used.

@@ -70,20 +74,20 @@ end-of-line comment on the .EQ directive if the symbol is used.

text file, named with a ".sym65" extension. (If your text editor of choice doesn't like that, you can put a ".txt" on the end while you're editing.) Make sure you create it in the same directory where your project file -(the file that ends with ".dis65") lives. Add a *SYNOPSIS, then add -the desired symbols.

+(the file that ends with ".dis65") lives. Add a *SYNOPSIS, +then add the desired symbols.

Finally, add it to your project. Select Edit > Project Properties, switch to the Symbol Files tab, click Add Symbol Files, and select your symbol file. It should appear in the list with a "PROJ:" prefix.

If an example helps, the A2-Amper-fdraw project in the Examples directory has a project-local symbol file, called "fdraw-exports". -(Amper-fdraw provides an Applesoft BASIC interface to a machine-language -library.)

+(Amper-fdraw provides an Applesoft BASIC interface to the machine-language +fdraw library.)

NOTE: in the current version of SourceGen, changes to .sym65 files are not detected automatically. Closing and re-opening the project -(File > Close, then click on the first recent-file link) will reload +(File > Recent Projects, then select the first entry) will reload them.