X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=doc%2Fld65.sgml;h=d37beced749309c3cc5a50e03fe4cea46e77651d;hb=a7f392a96fefd667bbcabfc816bbb6b3e3de70ac;hp=32eaaf86f450f2a0f1bef0683d8c8fc32573d1e4;hpb=293bb8818838816cc0023a6cef49046d0b94b08b;p=cc65
diff --git a/doc/ld65.sgml b/doc/ld65.sgml
index 32eaaf86f..d37beced7 100644
--- a/doc/ld65.sgml
+++ b/doc/ld65.sgml
@@ -55,25 +55,41 @@ The linker is called as follows:
---------------------------------------------------------------------------
Usage: ld65 [options] module ...
Short options:
- -C name Use linker config file
- -Ln name Create a VICE label file
- -Lp Mark write protected segments as such (VICE)
- -S addr Set the default start address
- -V Print the linker version
- -h Help (this text)
- -m name Create a map file
- -o name Name the default output file
- -t sys Set the target system
- -v Verbose mode
- -vm Verbose map file
+ -( Start a library group
+ -) End a library group
+ -C name Use linker config file
+ -D sym=val Define a symbol
+ -L path Specify a library search path
+ -Ln name Create a VICE label file
+ -S addr Set the default start address
+ -V Print the linker version
+ -h Help (this text)
+ -m name Create a map file
+ -o name Name the default output file
+ -t sys Set the target system
+ -u sym Force an import of symbol `sym'
+ -v Verbose mode
+ -vm Verbose map file
Long options:
- --config name Use linker config file
- --help Help (this text)
- --mapfile name Create a map file
+ --cfg-path path Specify a config file search path
+ --config name Use linker config file
+ --dbgfile name Generate debug information
+ --define sym=val Define a symbol
+ --dump-config name Dump a builtin configuration
+ --end-group End a library group
+ --force-import sym Force an import of symbol `sym'
+ --help Help (this text)
+ --lib file Link this library
+ --lib-path path Specify a library search path
+ --mapfile name Create a map file
+ --module-id id Specify a module id
+ --obj file Link this object file
+ --obj-path path Specify an object file search path
--start-addr addr Set the default start address
- --target sys Set the target system
- --version Print the linker version
+ --start-group Start a library group
+ --target sys Set the target system
+ --version Print the linker version
---------------------------------------------------------------------------
@@ -84,6 +100,26 @@ Here is a description of all the command line options:
+
+Builtin configurations
+
+The builtin configurations are part of the linker source. They can be retrieved
+with Secondary configurations
+
+Several machine specific binary packages are distributed together with secondary
+configurations (in the cfg directory). These configurations can be used with
+Special segments
+
+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
+config files, you will need the following information.
+
+INIT
+
+The INIT segment is used for initialization code that may be reused once
+execution reaches main() - provided that the program runs in RAM. You
+may for example add the INIT segment to the heap in really memory
+constrained systems.
+
+LOWCODE
+
+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.
+
+STARTUP
+
+This segment contains the startup code which initializes the C software stack
+and the libraries. It is placed in its own segment because it needs to be
+loaded at the lowest possible program address on several platforms.
+
+ZPSAVE
+
+The ZPSAVE segment contains the original values of the zeropage locations used
+by the ZEROPAGE segment. It is placed in its own segment because it must not be
+initialized.
@@ -1037,7 +1023,7 @@ name="uz@cc65.org">).
Copyright
-ld65 (and all cc65 binutils) are (C) Copyright 1998-2001 Ullrich von
+ld65 (and all cc65 binutils) are (C) Copyright 1998-2005 Ullrich von
Bassewitz. For usage of the binaries and/or sources the following
conditions do apply:
@@ -1063,4 +1049,3 @@ freely, subject to the following restrictions:
-