Mercurial > hg > index.cgi
diff docs/manual.docbook.sgml @ 207:07e1fac76321
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 |
line wrap: on
line diff
--- a/docs/manual.docbook.sgml Thu May 24 17:28:15 2012 -0600 +++ b/docs/manual.docbook.sgml Sat Jun 09 15:47:22 2012 -0600 @@ -1496,11 +1496,12 @@ </varlistentry> </variablelist> -<para>Each pragma supported has a positive version and a negative version. +<para>Each pragma supported has a positive version and a negative version. The positive version enables the pragma while the negative version disables -it. The negatitve version is simply the positive version with "no" prefixed -to it. For instance, "pragma" vs. "nopragma". Only the positive version is -listed below.</para> +it. The negatitve version is simply the positive version with "no" prefixed +to it. For instance, "pragma" vs. "nopragma". When only one version is +listed below, its opposite can be obtained by prepending "no" if it is not +present or removing "no" from the beginning if it is present.</para> <para>Pragmas are not case sensitive.</para> @@ -1657,9 +1658,20 @@ assemblers, it is strongly recommended that it be invoked using the PRAGMA directive within the source code rather than on the command line or via the *PRAGMA directive. This way, an error will be raised if someone tries to -* assemble the code under a different assembler.</para> +assemble the code under a different assembler.</para> + +<varlistentry> +<term>nosymbolcase</term> +<term>symbolnocase</term> +<listitem> +<para>Any symbol defined while this pragma is in force will be treated as +case insensitive, regardless whether the pragma is in force when the symbol +is referenced.</para> +<para>It is important to note that this pragma will not work as expected in +all cases when using the object file assembly target. It is intended for +use only when the assembler will be producing the final binary.</para> </listitem> </varlistentry>