[docs] xmldocs - docelic modified refs/ConfigParseComments
docs at icdevgroup.org
docs at icdevgroup.org
Fri Oct 29 16:23:11 EDT 2004
User: docelic
Date: 2004-10-29 20:23:10 GMT
Added: refs ConfigParseComments
Log:
One directive added.
Some more I have are waiting for check-in, but I'd like you respond to
-core mails about CheckHTML and AllowGlobal first.
Revision Changes Path
1.1 xmldocs/refs/ConfigParseComments
rev 1.1, prev_rev 1.0
Index: ConfigParseComments
===================================================================
__NAME__ purpose
treat config meta-directives as plain comments
__END__
__NAME__ synopsis
<group choice='req'>
<arg choice='plain'>Yes</arg>
<arg choice='plain'>No</arg>
</group>
__END__
__NAME__ description
When disabled (set to <literal>No</literal>),
configuration meta-directives such as
<literal>#include</literal>,
<literal>#ifdef</literal> and
<literal>#ifndef</literal>,
are treated as pure comments with no specific meaning.
</para><para>
However, since those were originally borrowed from the C preprocessor,
and true to their C heritage - they started with an '#' (hash) character
in &IC; versions up to and including 4.6.
</para><para>
This was inconvenient for newcomers who were easily misguided by thinking
those were just comments, so Interchange versions 4.7 and up support
meta-directives without the hash prefix.
</para><para>
To preserve compatibility, the default is still <literal>Yes</literal>,
but you should omit the '#' (hash) in new configuration files.
__END__
__NAME__ example
<example>
<title></title>
<programlisting>
ConfigParseComments No
#include comment
# This, and the above line, are pure comments.
# You better prepare the file named 'comment' for the following one:
include comment
</programlisting>
</example>
__END__
More information about the docs
mailing list