X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=doc%2Fcl65.sgml;h=484c6e9664f89b0cbaa1fc91b143de4a05640ac4;hb=14030c08523a3493e03ecba82a0a378d50638cda;hp=ca56ae06d64e98bd51fd7a39e178649df4d695f1;hpb=13a2927e17258051596d7e2e98f072cfce484707;p=cc65 diff --git a/doc/cl65.sgml b/doc/cl65.sgml index ca56ae06d..484c6e966 100644 --- a/doc/cl65.sgml +++ b/doc/cl65.sgml @@ -40,9 +40,11 @@ Short options: -h Help (this text) -l Create an assembler listing -m name Create a map file + -mm model Set the memory model -o name Name the output file -r Enable register variables -t sys Set the target system + -u sym Force an import of symbol `sym' -v Verbose mode -vm Verbose map file -C name Use linker config file @@ -59,9 +61,13 @@ Short options: -T Include source as comment -V Print the version number -W Suppress warnings + -Wa options Pass options to the assembler + -Wl options Pass options to the linker Long options: --add-source Include source as comment + --asm-args options Pass options to the assembler + --asm-define sym[=v] Define an assembler symbol --asm-include-dir dir Set an assembler include directory --bss-label name Define and export a BSS segment label --bss-name seg Set the name of the BSS segment @@ -70,6 +76,7 @@ Long options: --code-label name Define and export a CODE segment label --code-name seg Set the name of the CODE segment --codesize x Accept larger code by factor x + --config name Use linker config file --cpu type Set cpu type --create-dep Create a make dependency file --data-label name Define and export a DATA segment label @@ -77,12 +84,18 @@ Long options: --debug Debug mode --debug-info Add debug info --feature name Set an emulation feature + --force-import sym Force an import of symbol `sym' + --forget-inc-paths Forget include search paths (compiler) --help Help (this text) --include-dir dir Set a compiler include directory path + --ld-args options Pass options to the linker --lib file Link this library --lib-path path Specify a library search path + --list-targets List all available targets --listing Create an assembler listing + --list-bytes n Number of bytes per assembler listing line --mapfile name Create a map file + --memory-model model Set the memory model --module Link as a module --module-id id Specify a module id for the linker --o65-model model Override the o65 model @@ -92,7 +105,7 @@ Long options: --register-vars Enable register variables --rodata-name seg Set the name of the RODATA segment --signed-chars Default characters are signed - --standard std Language standard (c89, c99, cc65) + --standard std Language standard (c89, c99, cc65) --start-addr addr Set the default start address --static-locals Make local variables static --target sys Set the target system @@ -144,9 +157,29 @@ There are a few remaining options that control the behaviour of cl65: The default for this option is different from the compiler and linker in the case that the option is missing: While the other tools (compiler, assembler and linker) will use the "none" system settings by default, cl65 will use - the C64 as a target system by default. This was choosen since most people + the C64 as a target system by default. This was chosen since most people seem to use cc65 to develop for the C64. + -Wa options, --asm-args options + + Pass options directly to the assembler. This may be used to pass options + that aren't directly supported by cl65. Several options may be separated by + commas, the commas are replaced by spaces when passing them to the + assembler. Beware: Passing arguments directly to the assembler may interfere + with some of the defaults, because cl65 doesn't parse the options passed. So + if cl65 supports an option by itself, do not pass this option to the + assembler by means of the -Wl options, --ld-args options + + Pass options directly to the linker. This may be used to pass options that + aren't directly supported by cl65. Several options may be separated by + commas, the commas are replaced by spaces when passing them to the linker. + Beware: Passing arguments directly to the linker may interfere with some of + the defaults, because cl65 doesn't parse the options passed. So if cl65 + supports an option by itself, do not pass this option to the linker by means + of the