Mercurial > hg-old > index.cgi
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>