From 39011ef8250a8a1f46816a074a4ad03e9b7563ff Mon Sep 17 00:00:00 2001
From: cuz <cuz@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Sat, 2 Sep 2000 11:46:39 +0000
Subject: [PATCH] Added --feature and -target

git-svn-id: svn://svn.cc65.org/cc65/trunk@313 b7a2c559-68d2-44c3-8de9-860c34a00d81
---
 doc/ca65.sgml | 43 +++++++++++++++++++++++++++++++++++++------
 doc/cl65.sgml |  1 +
 doc/ld65.txt  |  3 ++-
 3 files changed, 40 insertions(+), 7 deletions(-)

diff --git a/doc/ca65.sgml b/doc/ca65.sgml
index da9d96e41..33c40b470 100644
--- a/doc/ca65.sgml
+++ b/doc/ca65.sgml
@@ -83,7 +83,8 @@ Short options:
   -i	 		Ignore case of symbols
   -l	 		Create a listing if assembly was ok
   -o name		Name the output file
-  -s	 		Enable smart mode
+  -s	 		Enable smart mode    
+  -t sys                Set the target system
   -v	 		Increase verbosity
   -D name[=value]	Define a symbol
   -I dir 		Set an include directory search path
@@ -95,12 +96,14 @@ Long options:
   --auto-import		Mark unresolved symbols as import
   --cpu type		Set cpu type
   --debug-info		Add debug info to object file
+  --feature name        Set an emulation feature
   --help      		Help (this text)
   --ignore-case		Ignore case of symbols
   --include-dir dir	Set an include directory search path
   --listing  		Create a listing if assembly was ok
   --pagelength n	Set the page length for the listing
   --smart    		Enable smart mode
+  --target sys          Set the target system
   --verbose  		Increase verbosity
   --version   		Print the assembler version
 ---------------------------------------------------------------------------
@@ -120,6 +123,17 @@ Here is a description of all the command line options:
   (the latter is not available in the freeware version).
 
 
+  <tag><tt>--feature name</tt></tag>
+
+  Enable an emulation feature. This is identical as using <tt/.FEATURE/
+  in the source with two exceptions: Feature names must be lower case, and
+  each feature must be specified by using an extra <tt/--feature/ option,
+  comma separated lists are not allowed.
+
+  See the discussion of the <tt/.FEATURE/ command for a list of emulation 
+  features.
+
+
   <tag><tt>-g, --debug-info</tt></tag>
 
   When this option (or the equivalent control command <tt/.DEBUGINFO/) is
@@ -177,6 +191,15 @@ Here is a description of all the command line options:
   mode is off by default.
 
 
+  <tag><tt>-t sys, --target sys</tt></tag>
+
+  Set the target system. This will enable translation of character strings
+  and character constants into the character set of the target platform.
+  The default for the target system is "none", which means that no translation
+  will take place. The assembler supports the same target systems as the 
+  compiler, see there for a list.
+
+
   <tag><tt>-v, --verbose</tt></tag>
 
   Increase the assembler verbosity. Usually only needed for debugging
@@ -985,34 +1008,42 @@ Here's a list of all control commands and a description, what they do:
 
   <descrip>
 
-  <tag><tt<idx>>dollar_is_pc</idx></tt></tag>
+  <tag><tt><idx>dollar_is_pc</idx></tt></tag>
 
     The dollar sign may be used as an alias for the star (`*'), which
     gives the value of the current PC in expressions.
     Note: Assignment to the pseudo variable is not allowed.
 
-  <tag><tt<idx>>labels_without_colons</idx></tt></tag>
+  <tag><tt><idx>labels_without_colons</idx></tt></tag>
 
     Allow labels without a trailing colon. These labels are only accepted,
     if they start at the beginning of a line (no leading white space).
 
-  <tag><tt<idx>>loose_string_term</idx></tt></tag>
+  <tag><tt><idx>loose_string_term</idx></tt></tag>
 
     Accept single quotes as well as double quotes as terminators for string
     constants.
 
-  <tag><tt<idx>>at_in_identifiers</idx></tt></tag>
+  <tag><tt><idx>at_in_identifiers</idx></tt></tag>
 
     Accept the at character (`@') as a valid character in identifiers. The
     at character is not allowed to start an identifier, even with this
     feature enabled.
 
-  <tag><tt<idx>>dollar_in_identifiers</idx></tt></tag>
+  <tag><tt><idx>dollar_in_identifiers</idx></tt></tag>
 
     Accept the dollar sign (`&dollar;') as a valid character in identifiers. The
     at character is not allowed to start an identifier, even with this
     feature enabled.
 
+  <tag><tt><idx>pc_assignment</idx></tt></tag>
+
+    Allow assignments to the PC symbol (`*' or `&dollar;' if dollar_is_pc is
+    enabled). Such an assignment is handled identical to the <tt/.ORG/
+    command (which is usually not needed, so just removing the lines with
+    the assignments may also be an option when porting code written for older
+    assemblers).
+
   </descrip>
 
 
diff --git a/doc/cl65.sgml b/doc/cl65.sgml
index fb2516c11..2a7fce4bf 100644
--- a/doc/cl65.sgml
+++ b/doc/cl65.sgml
@@ -58,6 +58,7 @@ Long options:
   --asm-include-dir dir	Set an assembler include directory
   --debug      		Debug mode
   --debug-info 		Add debug info
+  --feature name        Set an emulation feature
   --help       		Help (this text)
   --include-dir dir	Set a compiler include directory path
   --mapfile name	Create a map file
diff --git a/doc/ld65.txt b/doc/ld65.txt
index 294cb78d5..338a9ba90 100644
--- a/doc/ld65.txt
+++ b/doc/ld65.txt
@@ -92,7 +92,7 @@ Long options:
 
   -m name
   --mapfile name
-	      
+
   This option (which needs an argument that will used as a filename for
   the generated map file) will cause the linker to generate a map file.
   The map file does contain a detailed overview over the modules used, the
@@ -169,6 +169,7 @@ Long options:
 
 
   -S addr
+  --start-addr addr
 
   Using -S you may define the default starting address. If and how this
   address is used depends on the config file in use. For the builtin
-- 
2.39.5