[docs] xmldocs - docelic modified refs/Cookies

docs at icdevgroup.org docs at icdevgroup.org
Sat Jun 11 04:54:30 EDT 2005


User:      docelic
Date:      2005-06-11 08:54:30 GMT
Added:     refs     Cookies
Log:
- Cookies directive

Revision  Changes    Path
1.1                  xmldocs/refs/Cookies


rev 1.1, prev_rev 1.0
Index: Cookies
===================================================================
__NAME__ purpose
specify whether Interchange will try to land session cookies in client browsers
__END__


__NAME__ synopsis
<group choice='req'>
	<arg choice='plain'>1</arg>
	<arg choice='plain'>0</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: 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__









More information about the docs mailing list