Add co65 options
git-svn-id: svn://svn.cc65.org/cc65/trunk@1978 b7a2c559-68d2-44c3-8de9-860c34a00d81
This commit is contained in:
cuz
142
doc/cl65.sgml
142
doc/cl65.sgml
@@ -7,8 +7,8 @@
|
|||||||
|
|
||||||
<abstract>
|
<abstract>
|
||||||
cl65 is the compile & link utility for cc65, the 6502 C compiler. It was
|
cl65 is the compile & link utility for cc65, the 6502 C compiler. It was
|
||||||
designed as a smart frontend for the C compiler (cc65), the assembler (ca65)
|
designed as a smart frontend for the C compiler (cc65), the assembler (ca65),
|
||||||
and the linker (ld65).
|
the object file converter (co65), and the linker (ld65).
|
||||||
</abstract>
|
</abstract>
|
||||||
|
|
||||||
<!-- Table of contents -->
|
<!-- Table of contents -->
|
||||||
@@ -18,75 +18,83 @@ and the linker (ld65).
|
|||||||
|
|
||||||
<sect>Overview<p>
|
<sect>Overview<p>
|
||||||
|
|
||||||
cl65 is a frontend for cc65, ca65 and ld65. While you may not use the full
|
cl65 is a frontend for cc65, ca65, co65 and ld65. While you may not use the
|
||||||
power of the tools when calling them through cl65, most features are
|
full power of the tools when calling them through cl65, most features are
|
||||||
available, and the use of cl65 is much simpler.
|
available, and the use of cl65 is much simpler.
|
||||||
|
|
||||||
|
|
||||||
<sect>Basic Usage<p>
|
<sect>Basic Usage<p>
|
||||||
|
|
||||||
The cl65 compile and link utility may be used to compile, assemble and
|
The cl65 compile and link utility may be used to convert, compile, assemble
|
||||||
link files. While the separate tools do just one step, cl65 knows how to
|
and link files. While the separate tools do just one step, cl65 knows how to
|
||||||
build object files from C files (by calling the compiler, then the
|
build object files from C files (by calling the compiler, then the assembler)
|
||||||
assembler) and other things.
|
and other things.
|
||||||
|
|
||||||
<tscreen><verb>
|
<tscreen><verb>
|
||||||
---------------------------------------------------------------------------
|
---------------------------------------------------------------------------
|
||||||
Usage: cl65 [options] file
|
Usage: cl65 [options] file [...]
|
||||||
Short options:
|
Short options:
|
||||||
-c Compiler and assemble but don't link
|
-c Compile and assemble but don't link
|
||||||
-d Debug mode
|
-d Debug mode
|
||||||
-g Add debug info
|
-g Add debug info
|
||||||
-h Help (this text)
|
-h Help (this text)
|
||||||
-l Create an assembler listing
|
-l Create an assembler listing
|
||||||
-m name Create a map file
|
-m name Create a map file
|
||||||
-o name Name the output file
|
-o name Name the output file
|
||||||
-r Enable register variables
|
-r Enable register variables
|
||||||
-t sys Set the target system
|
-t sys Set the target system
|
||||||
-v Verbose mode
|
-v Verbose mode
|
||||||
-vm Verbose map file
|
-vm Verbose map file
|
||||||
-A Strict ANSI mode
|
-A Strict ANSI mode
|
||||||
-C name Use linker config file
|
-C name Use linker config file
|
||||||
-Cl Make local variables static
|
-Cl Make local variables static
|
||||||
-D sym[=defn] Define a preprocessor symbol
|
-D sym[=defn] Define a preprocessor symbol
|
||||||
-I dir Set a compiler include directory path
|
-I dir Set a compiler include directory path
|
||||||
-Ln name Create a VICE label file
|
-Ln name Create a VICE label file
|
||||||
-O Optimize code
|
-O Optimize code
|
||||||
-Oi Optimize code, inline functions
|
-Oi Optimize code, inline functions
|
||||||
-Or Optimize code, honour the register keyword
|
-Or Optimize code, honour the register keyword
|
||||||
-Os Optimize code, inline known C funtions
|
-Os Optimize code, inline known C funtions
|
||||||
-S Compile but don't assemble and link
|
-S Compile but don't assemble and link
|
||||||
-T Include source as comment
|
-T Include source as comment
|
||||||
-V Print the version number
|
-V Print the version number
|
||||||
-W Suppress warnings
|
-W Suppress warnings
|
||||||
|
|
||||||
Long options:
|
Long options:
|
||||||
--add-source Include source as comment
|
--add-source Include source as comment
|
||||||
--ansi Strict ANSI mode
|
--ansi Strict ANSI mode
|
||||||
--asm-include-dir dir Set an assembler include directory
|
--asm-include-dir dir Set an assembler include directory
|
||||||
--bss-name seg Set the name of the BSS segment
|
--bss-label name Define and export a BSS segment label
|
||||||
--check-stack Generate stack overflow checks
|
--bss-name seg Set the name of the BSS segment
|
||||||
--code-name seg Set the name of the CODE segment
|
--check-stack Generate stack overflow checks
|
||||||
--codesize x Accept larger code by factor x
|
--code-label name Define and export a CODE segment label
|
||||||
--cpu type Set cpu type
|
--code-name seg Set the name of the CODE segment
|
||||||
--create-dep Create a make dependency file
|
--codesize x Accept larger code by factor x
|
||||||
--data-name seg Set the name of the DATA segment
|
--cpu type Set cpu type
|
||||||
--debug Debug mode
|
--create-dep Create a make dependency file
|
||||||
--debug-info Add debug info
|
--data-label name Define and export a DATA segment label
|
||||||
--feature name Set an emulation feature
|
--data-name seg Set the name of the DATA segment
|
||||||
--help Help (this text)
|
--debug Debug mode
|
||||||
--include-dir dir Set a compiler include directory path
|
--debug-info Add debug info
|
||||||
--listing Create an assembler listing
|
--feature name Set an emulation feature
|
||||||
--mapfile name Create a map file
|
--help Help (this text)
|
||||||
--register-space b Set space available for register variables
|
--include-dir dir Set a compiler include directory path
|
||||||
--register-vars Enable register variables
|
--listing Create an assembler listing
|
||||||
--rodata-name seg Set the name of the RODATA segment
|
--mapfile name Create a map file
|
||||||
--signed-chars Default characters are signed
|
--module Link as a module
|
||||||
--start-addr addr Set the default start address
|
--module-id id Specify a module id for the linker
|
||||||
--static-locals Make local variables static
|
--o65-model model Override the o65 model
|
||||||
--target sys Set the target system
|
--register-space b Set space available for register variables
|
||||||
--version Print the version number
|
--register-vars Enable register variables
|
||||||
--verbose Verbose mode
|
--rodata-name seg Set the name of the RODATA segment
|
||||||
|
--signed-chars Default characters are signed
|
||||||
|
--start-addr addr Set the default start address
|
||||||
|
--static-locals Make local variables static
|
||||||
|
--target sys Set the target system
|
||||||
|
--version Print the version number
|
||||||
|
--verbose Verbose mode
|
||||||
|
--zeropage-label name Define and export a ZEROPAGE segment label
|
||||||
|
--zeropage-name seg Set the name of the ZEROPAGE segment
|
||||||
---------------------------------------------------------------------------
|
---------------------------------------------------------------------------
|
||||||
</verb></tscreen>
|
</verb></tscreen>
|
||||||
|
|
||||||
@@ -159,6 +167,20 @@ package, it tries to be smart about several things.
|
|||||||
cases, just give the name of your "main" file as first input file.
|
cases, just give the name of your "main" file as first input file.
|
||||||
</itemize>
|
</itemize>
|
||||||
|
|
||||||
|
The type of an input file is derived from its extension:
|
||||||
|
|
||||||
|
<itemize>
|
||||||
|
<item>C files: <tt/.c/
|
||||||
|
<item>Assembler files: <tt/.s/, <tt/.asm/, <tt/.a65/
|
||||||
|
<item>Object files: <tt/.o/ <tt/.obj/
|
||||||
|
<item>Libraries: <tt/.a/, <tt/.lib/
|
||||||
|
<item>GEOS resource files: <tt/.grc/
|
||||||
|
<item>o65 files: <tt/.o65/, <tt/.emd/, <tt/.joy/, <tt/.tgi/
|
||||||
|
</itemize>
|
||||||
|
|
||||||
|
Please note that the program cannot handle input files with unknown file
|
||||||
|
extensions.
|
||||||
|
|
||||||
|
|
||||||
<sect>Examples<p>
|
<sect>Examples<p>
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user