From: cuz <cuz@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Sat, 8 Jan 2005 20:33:27 +0000 (+0000)
Subject: Describe the new asminc feature
X-Git-Tag: V2.12.0~480
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=696f664050d6046ec1b181fed175ac2dd674c41b;p=cc65

Describe the new asminc feature


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

diff --git a/doc/da65.sgml b/doc/da65.sgml
index fe15f21ed..153ce8573 100644
--- a/doc/da65.sgml
+++ b/doc/da65.sgml
@@ -402,6 +402,46 @@ code. The following attributes are recognized:
 </descrip>
 
 
+<sect1>Specifying Assembler Includes<label id="infofile-asminc"><p>
+
+The <tt/ASMINC/ directive is used to give the names of input files containing
+symbol assignments in assembler syntax:
+
+<tscreen><verb>
+       	Name = value
+	Name := value
+</verb></tscreen>
+
+The usual conventions apply for symbol names. Values may be specified as hex
+(leading &dollar;), binary (leading %) or decimal. The values may optionally
+be signed.
+
+NOTE: The include file parser is very simple. Expressions are not allowed, and
+anything but symbol assignments is flagged as an error (but see the
+<tt/IGNOREUNKNOWN/ directive below).
+
+The following attributes are recognized:
+
+<descrip>
+
+  <tag><tt>FILE</tt></tag>
+  Followed by a string value. Specifies the name of the file to read.
+
+  <tag><tt>COMMENTSTART</tt></tag>
+  The optional attribute is followed by a character constant. It specifies the
+  character that starts a comment. The default value is a semicolon. This
+  value is ignored if <tt/IGNOREUNKNOWN/ is true.
+
+  <tag><tt>IGNOREUNKNOWN</tt></tag>
+  This attribute is optional and is followed by a boolean value. It allows to
+  ignore input lines that don't have a valid syntax. This allows to read in
+  assembler include files that contain more than just symbol assignments.
+  Note: When this attribute is used, the disassembler will ignore any errors
+  in the given include file. This may have undesired side effects.
+
+</descrip>
+
+
 <sect1>An Info File Example<p>
 
 The following is a short example for an info file that contains most of the