6502/cc65
1
0
Fork 0
mirror of https://github.com/cc65/cc65.git synced 2024-06-07 07:29:33 +00:00
Code Issues Projects Releases Wiki Activity

Correction in documentation regarding __A__ pseudo variable

Browse Source
This commit is contained in:
Piotr Kaczorowski 2021-01-06 16:02:25 +01:00 committed by Oliver Schmidt
parent e3fa247012
commit 0884278ae3
1 changed files with 1 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
doc/cc65.sgml
View File

@ -709,7 +709,7 @@ This cc65 version has some extensions to the ISO C standard.
places.
<p>
<item> There are two pseudo variables named <tt/__AX__/ and <tt/__EAX__/.
<item> There are two pseudo variables named <tt/__A__, __AX__/ and <tt/__EAX__/.
Both refer to the primary register that is used by the compiler to
evaluate expressions or return function results. <tt/__AX__/ is of
type <tt/unsigned int/ and <tt/__EAX__/ of type <tt/long unsigned int/
@ -728,26 +728,6 @@ This cc65 version has some extensions to the ISO C standard.
will give the high byte of any unsigned value.
<p>
<item> There is pseudo variable named <tt/__A__/ that indicates accumulator register.
It can be used to highlight the returned variable in non-void
function where result is hidden in the <tt/asm/ section.
For example, in the function below
<tscreen><verb>
BYTE get_key_via_atarixl_romcall_device_k(void) \
asm("LDA $E425"); \
asm("PHA"); \
asm("LDA $E424"); \
asm("PHA"); \
asm("RTS"); \
return __A__;
</verb></tscreen>
<tt/return __A__;/ will indicate that result is stored in the accumulator
and suppress warning that function has no return statement. Instead, you can
also use <tt/#pragma warn (return-type, off) ... pragma warn (return-type, on)/
<p>
<item> Inside a function, the identifier <tt/__func__/ gives the name of the
current function as a string. Outside of functions, <tt/__func__/ is
undefined.