Add co65 options

git-svn-id: svn://svn.cc65.org/cc65/trunk@1978 b7a2c559-68d2-44c3-8de9-860c34a00d81

doc/cl65.sgml

@@ -7,8 +7,8 @@
 
 <abstract>
 cl65 is the compile &amp; link utility for cc65, the 6502 C compiler. It was
-designed as a smart frontend for the C compiler (cc65), the assembler (ca65)
-and the linker (ld65).
+designed as a smart frontend for the C compiler (cc65), the assembler (ca65),
+the object file converter (co65), and the linker (ld65).
 </abstract>
 
 <!-- Table of contents -->
@@ -18,23 +18,23 @@ and the linker (ld65).
 
 <sect>Overview<p>
 
-cl65 is a frontend for cc65, ca65 and ld65. While you may not use the full
-power of the tools when calling them through cl65, most features are
+cl65 is a frontend for cc65, ca65, co65 and ld65. While you may not use the
+full power of the tools when calling them through cl65, most features are
 available, and the use of cl65 is much simpler.
 
 
 <sect>Basic Usage<p>
 
-The cl65 compile and link utility may be used to compile, assemble 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
-assembler) and other things.
+The cl65 compile and link utility may be used to convert, compile, assemble
+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 assembler)
+and other things.
 
 <tscreen><verb>
 ---------------------------------------------------------------------------
-Usage: cl65 [options] file
+Usage: cl65 [options] file [...]
 Short options:
-  -c                    Compiler and assemble but don't link
+  -c			Compile and assemble but don't link
   -d			Debug mode
   -g			Add debug info
   -h			Help (this text)
@@ -64,12 +64,15 @@ Long options:
   --add-source		Include source as comment
   --ansi		Strict ANSI mode
   --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
   --check-stack		Generate stack overflow checks
+  --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
   --cpu type		Set cpu type
   --create-dep		Create a make dependency file
+  --data-label name	Define and export a DATA segment label
   --data-name seg	Set the name of the DATA segment
   --debug		Debug mode
   --debug-info		Add debug info
@@ -78,6 +81,9 @@ Long options:
   --include-dir dir	Set a compiler include directory path
   --listing		Create an assembler listing
   --mapfile name	Create a map file
+  --module		Link as a module
+  --module-id id	Specify a module id for the linker
+  --o65-model model	Override the o65 model
   --register-space b	Set space available for register variables
   --register-vars	Enable register variables
   --rodata-name seg	Set the name of the RODATA segment
@@ -87,6 +93,8 @@ Long options:
   --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>
 
@@ -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.
 </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>