comparison 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
comparison
equal deleted inserted replaced
234:4e25aa2af73c 235:aa0056ca7319
647 </para> 647 </para>
648 </listitem> 648 </listitem>
649 </varlistentry> 649 </varlistentry>
650 650
651 <varlistentry> 651 <varlistentry>
652 <term>ALIGN <parameter>expr</parameter></term> 652 <term>ALIGN <parameter>expr</parameter>[,<parameter>value</parameter>]</term>
653 <listitem> 653 <listitem>
654 <para>Force the current assembly address to be a multiple of <parameter>expr</parameter>. 654
655 A series of NUL bytes is output to force the alignment, if required. The 655 <para>Force the current assembly address to be a multiple of
656 alignment value must be fully resolved on the first pass because it affects 656 <parameter>expr</parameter>. If <parameter>value</parameter> is not
657 the addresses of subsquent instructions.</para> 657 specified, a series of NUL bytes is output to force the alignment, if
658 <para>This directive is not suitable for inclusion in the middle of actual 658 required. Otherwise, the low order 8 bits of <parameter>value</parameter>
659 code. It is intended to appear where the bytes output will not be executed. 659 will be used as the fill. The alignment value must be fully resolved on the
660 </para> 660 first pass because it affects the addresses of subsquent instructions.
661 However, <parameter>value</parameter> may include forward references; as
662 long as it resolves to a constant for the second pass, the value will be
663 accepted.</para>
664
665 <para>Unless <parameter>value</parameter> is specified as something like $12,
666 this directive is not suitable for inclusion in the middle of actual code.
667 The default padding value is $00 which is intended to be used within data
668 blocks. </para>
669
661 </listitem> 670 </listitem>
662 </varlistentry> 671 </varlistentry>
663 672
664 </variablelist> 673 </variablelist>
665 674