Shorten a URL.

[cc65] / doc / cl65.sgml

diff --git a/doc/cl65.sgml b/doc/cl65.sgml
index 1d32677db4c70b55ec0c6ddbe5397f65b8544ba6..eef6a12a34974b6a66e2cf5cf27cf0616c5b8ef5 100644 (file)
--- a/doc/cl65.sgml
+++ b/doc/cl65.sgml
@@ -2,7 +2,7 @@
 
 <article>
 <title>cl65 Users Guide
-<author>Ullrich von Bassewitz, <htmlurl url="mailto:uz@cc65.org" name="uz@cc65.org">
+<author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz">
 <date>01.08.2000, 27.11.2000, 02.10.2001
 
 <abstract>
@@ -38,7 +38,7 @@ Short options:
   -d                            Debug mode
   -g                            Add debug info
   -h                            Help (this text)
-  -l                            Create an assembler listing
+  -l name                       Create an assembler listing file
   -m name                       Create a map file
   -mm model                     Set the memory model
   -o name                       Name the output file
@@ -60,8 +60,9 @@ Short options:
   -S                            Compile but don't assemble and link
   -T                            Include source as comment
   -V                            Print the version number
-  -W                            Suppress warnings
+  -W name[,...]                 Supress compiler warnings
   -Wa options                   Pass options to the assembler
+  -Wc options                   Pass options to the compiler
   -Wl options                   Pass options to the linker
 
 Long options:
@@ -69,9 +70,10 @@ Long options:
   --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
-  --bin-include-dir dir         Set an assembker binary include directory
+  --bin-include-dir dir         Set an assembler binary include directory
   --bss-label name              Define and export a BSS segment label
   --bss-name seg                Set the name of the BSS segment
+  --cc-args options             Pass options to the compiler
   --cfg-path path               Specify a config file search path
   --check-stack                 Generate stack overflow checks
   --code-label name             Define and export a CODE segment label
@@ -87,14 +89,13 @@ Long options:
   --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
+  --listing name                Create an assembler listing file
   --list-bytes n                Number of bytes per assembler listing line
   --mapfile name                Create a map file
   --memory-model model          Set the memory model
@@ -103,6 +104,7 @@ Long options:
   --o65-model model             Override the o65 model
   --obj file                    Link this object file
   --obj-path path               Specify an object file search path
+  --print-target-path           Print the target file path
   --register-space b            Set space available for register variables
   --register-vars               Enable register variables
   --rodata-name seg             Set the name of the RODATA segment
@@ -154,6 +156,14 @@ There are a few remaining options that control the behaviour of cl65:
   shouldn't use -o when more than one output file is created.
 
 
+  <tag><tt>--print-target-path</tt></tag>
+
+  This option prints the absolute path of the target file directory and exits
+  then. It is supposed to be used with shell backquotes or the GNU make shell
+  function. This way you can write build scripts or Makefiles accessing target
+  files without any assumption about the cc65 installation path.
+
+
   <tag><tt>-t sys, --target sys</tt></tag>
 
   The default for this option is different from the compiler and linker in the
@@ -162,6 +172,7 @@ There are a few remaining options that control the behaviour of cl65:
   the C64 as a target system by default. This was chosen since most people
   seem to use cc65 to develop for the C64.
 
+
   <tag><tt>-Wa options, --asm-args options</tt></tag>
 
   Pass options directly to the assembler. This may be used to pass options
@@ -172,6 +183,18 @@ There are a few remaining options that control the behaviour of cl65:
   if cl65 supports an option by itself, do not pass this option to the
   assembler by means of the <tt/-Wa/ switch.
 
+
+  <tag><tt>-Wc options, --cc-args options</tt></tag>
+
+  Pass options directly to the compiler. 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
+  compiler. Beware: Passing arguments directly to the compiler 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
+  compiler by means of the <tt/-Wc/ switch.
+
+
   <tag><tt>-Wl options, --ld-args options</tt></tag>
 
   Pass options directly to the linker. This may be used to pass options that
@@ -266,14 +289,6 @@ to do this.
 
 
 
-<sect>Bugs/Feedback<p>
-
-If you have problems using the utility, if you find any bugs, or if you're
-doing something interesting with it, I would be glad to hear from you. Feel
-free to contact me by email (<htmlurl url="mailto:uz@cc65.org" name="uz@cc65.org">).
-
-
-
 <sect>Copyright<p>
 
 cl65 (and all cc65 binutils) are (C) Copyright 1998-2004 Ullrich von
@@ -302,4 +317,3 @@ freely, subject to the following restrictions:
 
 
 </article>
-