Skip to content
Find file
Fetching contributors…
Cannot retrieve contributors at this time
50 lines (39 sloc) 1.34 KB
__NAME__ purpose
(obsolete) treat config meta-directives as plain comments
__END__
__NAME__ synopsis
<group choice='plain'>
<arg choice='plain'>Yes</arg>
<arg choice='plain'>No</arg>
</group>
__END__
__NAME__ notes
This directive is obsolete as of &IC; 5.5.0, and the behavior is
as if <code>ConfigParseComments No</code> was specified.
__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 '<literal>#</literal>'
(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 were changed
to use the meta-directives <emphasis role='bold'>without the hash
prefix</emphasis>.
__END__
__NAME__ example: Config parser behavior with ConfigParseComments disabled
<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>
__END__
Jump to Line
Something went wrong with that request. Please try again.