From: cuz <cuz@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Fri, 6 Jun 2003 21:09:20 +0000 (+0000)
Subject: Added the new .ASSERT command
X-Git-Tag: V2.12.0~1514
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=3853a881276e522154605e1848b122f38ef32d2a;p=cc65

Added the new .ASSERT command


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

diff --git a/doc/ca65.sgml b/doc/ca65.sgml
index f08fe8f67..8e2536617 100644
--- a/doc/ca65.sgml
+++ b/doc/ca65.sgml
@@ -689,6 +689,28 @@ Here's a list of all control commands and a description, what they do:
   the binary zero is only appended once (after the last one).
 
 
+<sect1><tt>.ASSERT</tt><label id=".ASSERT"><p>
+
+  Add an assertion. The command is followed by an expression, an action
+  specifier and a message that is output in case the assertion fails. The
+  action specifier may be one of <tt/warning/ or <tt/error/. The assertion
+  is passed to the linker and will be evaluated when segment placement has
+  been done.
+
+  Example:
+
+  <tscreen><verb>
+       	.assert         * = $8000, error, "Code not at $8000"
+  </verb></tscreen>
+
+  The example assertion will check that the current location is at $8000,
+  when the output file is written, and abort with an error if this is not
+  the case. More complex expressions are possible. The action specifier
+  <tt/warning/ outputs a warning, while the <tt/error/ specifier outputs
+  an error message. In the latter case, generation if the output file is
+  suppressed.
+
+
 <sect1><tt>.AUTOIMPORT</tt><label id=".AUTOIMPORT"><p>
 
   Is followed by a plus or a minus character. When switched on (using a
@@ -762,7 +784,7 @@ Here's a list of all control commands and a description, what they do:
   Example:
 
   <tscreen><verb>
-       	.case	-	    	; Identifiers are not case sensitive
+       	.case	-   	    	; Identifiers are not case sensitive
   </verb></tscreen>