Mercurial > hg > index.cgi

comparison docs/manual.docbook.sgml @ 207:07e1fac76321

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added pragma to allow non case sensitive symbols Added "nosymbolcase" and "symbolnocase" pragmas to cause symbols defined while the pragma is in effect to be treated as case insensitive. Also documented the new pragma.
author William Astle <lost@l-w.ca>
date Sat, 09 Jun 2012 15:47:22 -0600
parents 1e0a0e6cd918
children 5d969517db74
comparison
equal deleted inserted replaced
206:080bb67d84f2 207:07e1fac76321
1494 1494
1495 </listitem> 1495 </listitem>
1496 </varlistentry> 1496 </varlistentry>
1497 </variablelist> 1497 </variablelist>
1498 1498
1499 <para>Each pragma supported has a positive version and a negative version. 1499 <para>Each pragma supported has a positive version and a negative version.
1500 The positive version enables the pragma while the negative version disables 1500 The positive version enables the pragma while the negative version disables
1501 it. The negatitve version is simply the positive version with "no" prefixed 1501 it. The negatitve version is simply the positive version with "no" prefixed
1502 to it. For instance, "pragma" vs. "nopragma". Only the positive version is 1502 to it. For instance, "pragma" vs. "nopragma". When only one version is
1503 listed below.</para> 1503 listed below, its opposite can be obtained by prepending "no" if it is not
1504 present or removing "no" from the beginning if it is present.</para>
1504 1505
1505 <para>Pragmas are not case sensitive.</para> 1506 <para>Pragmas are not case sensitive.</para>
1506 1507
1507 <variablelist> 1508 <variablelist>
1508 <varlistentry> 1509 <varlistentry>
1655 1656
1656 <para>Because this pragma leads to source that is incompatible with other 1657 <para>Because this pragma leads to source that is incompatible with other
1657 assemblers, it is strongly recommended that it be invoked using the PRAGMA 1658 assemblers, it is strongly recommended that it be invoked using the PRAGMA
1658 directive within the source code rather than on the command line or via the 1659 directive within the source code rather than on the command line or via the
1659 *PRAGMA directive. This way, an error will be raised if someone tries to 1660 *PRAGMA directive. This way, an error will be raised if someone tries to
1660 * assemble the code under a different assembler.</para> 1661 assemble the code under a different assembler.</para>
1661 1662
1662 1663 <varlistentry>
1664 <term>nosymbolcase</term>
1665 <term>symbolnocase</term>
1666 <listitem>
1667
1668 <para>Any symbol defined while this pragma is in force will be treated as
1669 case insensitive, regardless whether the pragma is in force when the symbol
1670 is referenced.</para>
1671
1672 <para>It is important to note that this pragma will not work as expected in
1673 all cases when using the object file assembly target. It is intended for
1674 use only when the assembler will be producing the final binary.</para>
1663 1675
1664 </listitem> 1676 </listitem>
1665 </varlistentry> 1677 </varlistentry>
1666 1678
1667 </variablelist> 1679 </variablelist>