6502/cc65
1
0
Fork 0
mirror of https://github.com/cc65/cc65.git synced 2024-12-23 04:30:10 +00:00
Code Issues Projects Releases Wiki Activity

Improved the compiler documentation, a little bit.

Browse Source
This commit is contained in:
Greg King 2015-05-26 11:23:54 -04:00
parent bbb6f89731
commit b49fd26d16
2 changed files with 33 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
doc/cc65.sgml
View File

@ -3,7 +3,7 @@
<article> <article>
<title>cc65 Users Guide <title>cc65 Users Guide
<author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz"> <author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz">
<date>2015-04-21 <date>2015-05-26
<abstract> <abstract>
cc65 is a C compiler for 6502 targets. It supports several 6502 based home cc65 is a C compiler for 6502 targets. It supports several 6502 based home
@ -558,10 +558,10 @@ and the one defined by the ISO standard:
be passed as parameters by value. However, struct assignment *is* be passed as parameters by value. However, struct assignment *is*
possible. possible.
<p> <p>
<item> Most of the C library is available only with the fastcall calling <item> Most of the C library is available with only the fastcall calling
convention (<ref id="extension-fastcall" name="see below">). It means convention (<ref id="extension-fastcall" name="see below">). It means
that you must not mix pointers to those functions with pointers to that you must not mix pointers to those functions with pointers to
user-written, cdecl functions. user-written, cdecl functions (the calling conventions are incompatible).
<p> <p>
<item> The <tt/volatile/ keyword doesn't have an effect. This is not as bad <item> The <tt/volatile/ keyword doesn't have an effect. This is not as bad
as it sounds, since the 6502 has so few registers that it isn't as it sounds, since the 6502 has so few registers that it isn't
@ -611,7 +611,7 @@ This cc65 version has some extensions to the ISO C standard.
<tscreen><verb> <tscreen><verb>
&lt;return type&gt; __fastcall__ &lt;function name&gt; (&lt;parameter list&gt;) &lt;return type&gt; __fastcall__ &lt;function name&gt; (&lt;parameter list&gt;)
</verb></tscreen> </verb></tscreen>
An example would be An example is
<tscreen><verb> <tscreen><verb>
void __fastcall__ f (unsigned char c) void __fastcall__ f (unsigned char c)
</verb></tscreen> </verb></tscreen>
@ -621,7 +621,7 @@ This cc65 version has some extensions to the ISO C standard.
For functions that are <tt/fastcall/, the rightmost parameter is not For functions that are <tt/fastcall/, the rightmost parameter is not
pushed on the stack but left in the primary register when the function pushed on the stack but left in the primary register when the function
is called. That significantly reduces the cost of calling functions. is called. That significantly reduces the cost of calling those functions.
<newline><newline> <newline><newline>
<p> <p>
@ -636,14 +636,14 @@ This cc65 version has some extensions to the ISO C standard.
<tscreen><verb> <tscreen><verb>
&lt;return type&gt; __cdecl__ &lt;function name&gt; (&lt;parameter list&gt;) &lt;return type&gt; __cdecl__ &lt;function name&gt; (&lt;parameter list&gt;)
</verb></tscreen> </verb></tscreen>
An example would be An example is
<tscreen><verb> <tscreen><verb>
int* __cdecl__ f (unsigned char c) int* __cdecl__ f (unsigned char c)
</verb></tscreen> </verb></tscreen>
The first form of the cdecl keyword is in the user namespace; The first form of the cdecl keyword is in the user namespace;
and therefore, can be disabled with the <tt><ref id="option--standard" and therefore, can be disabled with the <tt/<ref id="option--standard"
name="--standard"></tt> command-line option. name="--standard">/ command-line option.
For functions that are <tt/cdecl/, the rightmost parameter is pushed For functions that are <tt/cdecl/, the rightmost parameter is pushed
onto the stack before the function is called. That increases the cost onto the stack before the function is called. That increases the cost

4
doc/customizing.sgml
View File

@ -597,7 +597,7 @@ variable which is stored in the zero page memory space in order to allow
for retrieval of each character in the string via the indirect indexed for retrieval of each character in the string via the indirect indexed
addressing mode. addressing mode.
The assembly language routine is stored in a file named The assembly language routine is stored in a file names
&quot;rs232_tx.s&quot; and is shown below: &quot;rs232_tx.s&quot; and is shown below:
<tscreen><code> <tscreen><code>
@ -681,7 +681,7 @@ all of the behind-the-scene work is transparent to the user.
#define TX_FIFO_FULL (FIFO_STATUS &amp; 0x01) #define TX_FIFO_FULL (FIFO_STATUS &amp; 0x01)
#define RX_FIFO_EMPTY (FIFO_STATUS &amp; 0x02) #define RX_FIFO_EMPTY (FIFO_STATUS &amp; 0x02)
extern void wait (void); extern void wait ();
extern void __fastcall__ rs232_tx (char *str); extern void __fastcall__ rs232_tx (char *str);
int main () { int main () {