]> git.sur5r.net Git - cc65/blobdiff - doc/cl65.sgml
Fixed _textcolor definition.
[cc65] / doc / cl65.sgml
index ca5f9d2af84d45dc1424c8b8116627cc14f0207c..0291f2eb31cc22ab423cab2b07459006f7868b09 100644 (file)
@@ -4,7 +4,6 @@
 <title>cl65 Users Guide
 <author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz">,<newline>
 <url url="mailto:greg.king5@verizon.net" name="Greg King">
-<date>2017-10-16
 
 <abstract>
 cl65 is the compile &amp; link utility for cc65, the 6502 C compiler. It was
@@ -45,7 +44,7 @@ Short options:
   -o name                       Name the output file
   -r                            Enable register variables
   -t sys                        Set the target system
-  -u sym                        Force an import of symbol `sym'
+  -u sym                        Force an import of symbol 'sym'
   -v                            Verbose mode
   -vm                           Verbose map file
   -C name                       Use linker config file
@@ -91,7 +90,7 @@ 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'
+  --force-import sym            Force an import of symbol 'sym'
   --help                        Help (this text)
   --include-dir dir             Set a compiler include directory path
   --ld-args options             Pass options to the linker
@@ -104,6 +103,7 @@ Long options:
   --memory-model model          Set the memory model
   --module                      Link as a module
   --module-id id                Specify a module id for the linker
+  --no-target-lib               Don't link the target library
   --o65-model model             Override the o65 model
   --obj file                    Link this object file
   --obj-path path               Specify an object file search path
@@ -186,6 +186,13 @@ There are a few remaining options that control the behaviour of cl65:
   seem to use cc65 to develop for the C64.
 
 
+  <tag><tt>--no-target-lib</tt></tag>
+
+  This option tells the cl65 to not include the target library into the list
+  of libraries.
+
+
+
   <tag><tt>-Wa options, --asm-args options</tt></tag>
 
   Pass options directly to the assembler. This may be used to pass options
@@ -229,14 +236,14 @@ package, it tries to be smart about several things.
 
 <itemize>
 
-<item> If you don't give a target system on the command line, cl65
-       defaults to the C64.
+<item>  If you don't give a target system on the command line, cl65
+        defaults to the C64.
 
 <item>  When linking, cl65 will supply the name of the library file for
         the target system to the linker; so, you don't have to do that.
 
-<item> If the final step is the linker, and the name of the output file was
-       not explicitly given, cl65 will use the name of the first input file
+<item>  If the final step is the linker, and the name of the output file was
+        not explicitly given, cl65 will use the name of the first input file
         without the extension, provided that the name of that file has an
         extension. So, you don't need to give the executable name in most
         cases; just give the name of your "main" file as the first input file.
@@ -277,24 +284,24 @@ assembler file (irq.s) will need the following separate steps to compile
 into an executable named morse:
 
 <tscreen><verb>
-       cc65 -g -Oi -t c64 morse.c
-       ca65 -g morse.s
-       ca65 -g irq.s
-       ld65 -o morse -t c64 c64.o morse.o irq.o c64.lib
+        cc65 -g -Oi -t c64 morse.c
+        ca65 -g morse.s
+        ca65 -g irq.s
+        ld65 -o morse -t c64 c64.o morse.o irq.o c64.lib
 </verb></tscreen>
 
 When using cl65, this is simplified to
 
 <tscreen><verb>
-       cl65 -g -Oi morse.c irq.s
+        cl65 -g -Oi morse.c irq.s
 </verb></tscreen>
 
 As a general rule, you may use cl65 instead of cc65 at most times,
 especially in makefiles to build object files directly from C files. Use
 
 <tscreen><verb>
-       .c.o:
-               cl65 -g -Oi $<
+        .c.o:
+                cl65 -g -Oi $<
 </verb></tscreen>
 
 to do this.
@@ -316,14 +323,14 @@ including commercial applications, and to alter it and redistribute it
 freely, subject to the following restrictions:
 
 <enum>
-<item>         The origin of this software must not be misrepresented; you must not
-               claim that you wrote the original software. If you use this software
-               in a product, an acknowledgment in the product documentation would be
-       appreciated but is not required.
-<item> Altered source versions must be plainly marked as such, and must not
-       be misrepresented as being the original software.
-<item> This notice may not be removed or altered from any source
-       distribution.
+<item>  The origin of this software must not be misrepresented; you must not
+        claim that you wrote the original software. If you use this software
+        in a product, an acknowledgment in the product documentation would be
+        appreciated but is not required.
+<item>  Altered source versions must be plainly marked as such, and must not
+        be misrepresented as being the original software.
+<item>  This notice may not be removed or altered from any source
+        distribution.
 </enum>