[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
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

__NAME__ synopsis
<group choice='req'>
	<arg choice='plain'>Yes</arg>
	<arg choice='plain'>No</arg>

__NAME__ description
When disabled (set to <literal>No</literal>), 
configuration meta-directives such as 
<literal>#ifdef</literal> and
are treated as pure comments with no specific meaning.
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.
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.
To preserve compatibility, the default is still <literal>Yes</literal>,
but you should omit the '#' (hash) in new configuration files.

__NAME__ example
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

More information about the docs mailing list