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

changed "inline assembler statement" to "inline assembler expression" as suggested in #2191

Browse Source
This commit is contained in:
mrdudz 2023-10-14 16:21:08 +02:00
parent e138403727
commit bb92144717
1 changed files with 9 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
doc/cc65.sgml
View File

@ -837,7 +837,7 @@ This cc65 version has some extensions to the ISO C standard.
<itemize> <itemize>
<item> The compiler allows to insert assembler statements into the output <item> The compiler allows to insert assembler expressions into the output
file. The syntax is file. The syntax is
<tscreen><verb> <tscreen><verb>
@ -851,7 +851,7 @@ This cc65 version has some extensions to the ISO C standard.
The first form is in the user namespace; and, is disabled if the <tt/-A/ The first form is in the user namespace; and, is disabled if the <tt/-A/
switch is given. switch is given.
There is a whole section covering inline assembler statements, There is a whole section covering inline assembler expressions,
<ref id="inline-asm" name="see there">. <ref id="inline-asm" name="see there">.
<p> <p>
@ -1714,7 +1714,7 @@ bloated code and a slowdown.
<sect>Inline assembler<label id="inline-asm"><p> <sect>Inline assembler<label id="inline-asm"><p>
The compiler allows to insert assembler statements into the output file. The The compiler allows to insert assembler expressions into the output file. The
syntax is syntax is
<tscreen><verb> <tscreen><verb>
@ -1729,7 +1729,7 @@ or
The first form is in the user namespace; and, is disabled by <tt><ref The first form is in the user namespace; and, is disabled by <tt><ref
id="option--standard" name="--standard"></tt> if the argument is not <tt/cc65/. id="option--standard" name="--standard"></tt> if the argument is not <tt/cc65/.
The <tt/asm/ statement can be used only inside a function. Please note that The <tt/asm/ expression can be used only inside a function. Please note that
the result of an inline assembler expression is always of type <tt/void/. the result of an inline assembler expression is always of type <tt/void/.
The contents of the string literal are preparsed by the compiler; and, inserted The contents of the string literal are preparsed by the compiler; and, inserted
@ -1741,15 +1741,15 @@ even if the ca65 assembler (which is used to translate the generated assembler
code) would accept them. The built-in inline assembler is not a replacement for code) would accept them. The built-in inline assembler is not a replacement for
the full-blown macro assembler which comes with the compiler. the full-blown macro assembler which comes with the compiler.
Note: Inline assembler statements are subject to all optimizations done by the Note: Inline assembler expressions are subject to all optimizations done by the
compiler. There currently is no way to protect an inline assembler statement compiler. There currently is no way to protect an inline assembler expression
-- alone -- from being moved or removed completely by the optimizer. If in -- alone -- from being moved or removed completely by the optimizer. If in
doubt, check the generated assembler output; or, disable optimizations (for doubt, check the generated assembler output; or, disable optimizations (for
that function). that function).
As a shortcut, you can put the <tt/volatile/ qualifier in your <tt/asm/ As a shortcut, you can put the <tt/volatile/ qualifier in your <tt/asm/
statements. It will disable optimization for the functions in which those expressions. It will disable optimization for the functions in which those
<tt/asm volatile/ statements sit. The effect is the same as though you put <tt/asm volatile/ expressions sit. The effect is the same as though you put
<tt/#pragma optimize(push, off)/ above those functions, and <tt/#pragma <tt/#pragma optimize(push, off)/ above those functions, and <tt/#pragma
optimize(pop)/ below those functions. optimize(pop)/ below those functions.
@ -1844,7 +1844,7 @@ Arrays also can be accessed:
<p> <p>
Note: Do not embed the assembler labels that are used as names of global Note: Do not embed the assembler labels that are used as names of global
variables or functions into your <tt/asm/ statements. Code such as this: variables or functions into your <tt/asm/ expressions. Code such as this:
<tscreen><verb> <tscreen><verb>
int foo; int foo;