the10thwiz/cc65
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add info about cheap local names in macro local symbols.

Browse Source
This commit is contained in:
Kugel Fuhr
2025-07-07 12:05:46 +02:00
parent 29f7ab3809
commit b64c811a3f
1 changed files with 12 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
doc/ca65.sgml
View File

@@ -918,6 +918,7 @@ See the description of the <tt><ref id=".PROC" name=".PROC"></tt>
directive for more information. directive for more information.
<label id=cheap-locals>
<sect1>Cheap local labels<p> <sect1>Cheap local labels<p>
Cheap local labels are defined like standard labels, but the name of the Cheap local labels are defined like standard labels, but the name of the
@@ -3751,20 +3752,23 @@ See: <tt><ref id=".ASCIIZ" name=".ASCIIZ"></tt>,<tt><ref id=".BYTE" name=".BYTE"
<sect1><tt>.LOCAL</tt><label id=".LOCAL"><p> <sect1><tt>.LOCAL</tt><label id=".LOCAL"><p>
This command may only be used inside a macro definition. It declares a This command may only be used inside a macro definition. It declares a list
list of identifiers as local to the macro expansion. of identifiers as local to the macro expansion. The identifers may be
standard identifiers or cheap local identifiers depending on the planed use.
A problem when using macros are labels: Since they don't change their name, A problem when using macros are labels: Since they don't change their name,
you get a "duplicate symbol" error if the macro is expanded the second time. you get a "duplicate symbol" error if the macro is expanded the second time.
Labels declared with <tt><ref id=".LOCAL" name=".LOCAL"></tt> have their Labels declared with <tt><ref id=".LOCAL" name=".LOCAL"></tt> have their
name mapped to an internal unique name (<tt/___ABCD__/) with each macro name replaced by an internally generated unique name for each macro
invocation. invocation.
Some other assemblers start a new lexical block inside a macro expansion. Please note that while the generated names are unique and guaranteed to not
This has some drawbacks however, since that will not allow <em/any/ symbol clash with any user generated names, they are still regular symbols and
to be visible outside a macro, a feature that is sometimes useful. The added to the current scope. This means that a local macro label will start a
<tt><ref id=".LOCAL" name=".LOCAL"></tt> command is in my eyes a better way new scope for cheap locals whenever the macro is expanded. To avoid that,
to address the problem. you may also use a <ref id="cheap-locals" name="cheap local symbol"> for the
name. In this case the assembler will generate unique cheap local
identifiers instead of standard ones.
You get an error when using <tt><ref id=".LOCAL" name=".LOCAL"></tt> outside You get an error when using <tt><ref id=".LOCAL" name=".LOCAL"></tt> outside
a macro. a macro.