diff doc/manual.docbook.sgml @ 235:aa0056ca7319

Added a padding value for the ALIGN directive
author lost
date Fri, 12 Jun 2009 05:25:41 +0000
parents efda73d44e1b
children dca5938a64aa
line wrap: on
line diff
--- a/doc/manual.docbook.sgml	Fri Jun 12 04:55:16 2009 +0000
+++ b/doc/manual.docbook.sgml	Fri Jun 12 05:25:41 2009 +0000
@@ -649,15 +649,24 @@
 </varlistentry>
 
 <varlistentry>
-<term>ALIGN <parameter>expr</parameter></term>
+<term>ALIGN <parameter>expr</parameter>[,<parameter>value</parameter>]</term>
 <listitem>
-<para>Force the current assembly address to be a multiple of <parameter>expr</parameter>.
-A series of NUL bytes is output to force the alignment, if required. The
-alignment value must be fully resolved on the first pass because it affects
-the addresses of subsquent instructions.</para>
-<para>This directive is not suitable for inclusion in the middle of actual
-code. It is intended to appear where the bytes output will not be executed.
-</para>
+
+<para>Force the current assembly address to be a multiple of
+<parameter>expr</parameter>.  If <parameter>value</parameter> is not
+specified, a series of NUL bytes is output to force the alignment, if
+required.  Otherwise, the low order 8 bits of <parameter>value</parameter>
+will be used as the fill.  The alignment value must be fully resolved on the
+first pass because it affects the addresses of subsquent instructions. 
+However, <parameter>value</parameter> may include forward references; as
+long as it resolves to a constant for the second pass, the value will be
+accepted.</para>
+
+<para>Unless <parameter>value</parameter> is specified as something like $12,
+this directive is not suitable for inclusion in the middle of actual code. 
+The default padding value is $00 which is intended to be used within data
+blocks.  </para>
+
 </listitem>
 </varlistentry>