6502/cc65
1
0
Fork 0
mirror of https://github.com/cc65/cc65.git synced 2025-01-10 19:29:45 +00:00
Code Issues Projects Releases Wiki Activity

doc/ld65.sgml: document the INIT segment

Browse Source 
- re-arrange the segments in the "Special segments" section alphabetically
- some small changes in section 5.8 (FILE) regarding Atari XEX format
This commit is contained in:
Christian Groessler 2021-02-11 19:20:11 +01:00 committed by Oliver Schmidt
parent ab8bb26868
commit 9cd1ffa6a6
1 changed files with 15 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
doc/ld65.sgml
View File

@ -921,9 +921,8 @@ name="6502 binary relocation format specification">). It is defined like this:
} }
</verb></tscreen> </verb></tscreen>
The other format available is the Atari (xex) segmented file format, this is The other format available is the Atari segmented file format (xex), this is
the standard format used by Atari DOS 2.0 and upward file managers in the Atari the standard format used by Atari DOS 2.0 and upwards, and it is defined like this:
8-bit computers, and it is defined like this:
<tscreen><verb> <tscreen><verb>
FILES { FILES {
@ -1140,6 +1139,19 @@ The builtin config files do contain segments that have a special meaning for
the compiler and the libraries that come with it. If you replace the builtin the compiler and the libraries that come with it. If you replace the builtin
config files, you will need the following information. config files, you will need the following information.
<sect1>INIT<p>
The INIT segment is some kind of 'bss' segment since it contains
uninitialized data. Unlike <tt>.bss</tt> itself, its contents aren't
initialized to zero at program startup . It's mostly used by
constructors in the startup code. An example for the use of the INIT
segment is saving/restoring the zero page area used by cc65.
<sect1>LOWCODE<p>
For the LOWCODE segment, it is guaranteed that it won't be banked out, so it
is reachable at any time by interrupt handlers or similar.
<sect1>ONCE<p> <sect1>ONCE<p>
The ONCE segment is used for initialization code run only once before The ONCE segment is used for initialization code run only once before
@ -1147,11 +1159,6 @@ execution reaches main() - provided that the program runs in RAM. You
may for example add the ONCE segment to the heap in really memory may for example add the ONCE segment to the heap in really memory
constrained systems. constrained systems.
<sect1>LOWCODE<p>
For the LOWCODE segment, it is guaranteed that it won't be banked out, so it
is reachable at any time by interrupt handlers or similar.
<sect1>STARTUP<p> <sect1>STARTUP<p>
This segment contains the startup code which initializes the C software stack This segment contains the startup code which initializes the C software stack