[docs] xmldocs - jon modified refs/no_default_reparse
docs at icdevgroup.org
docs at icdevgroup.org
Sat Aug 20 13:12:23 EDT 2005
User: jon
Date: 2005-08-20 17:12:22 GMT
Modified: refs no_default_reparse
Log:
Expand on pragma no_default_reparse documentation. Davor, let me know if
any of this is misformatted.
Revision Changes Path
1.2 +21 -4 xmldocs/refs/no_default_reparse
rev 1.2, prev_rev 1.1
Index: no_default_reparse
===================================================================
RCS file: /var/cvs/xmldocs/refs/no_default_reparse,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -u -r1.1 -r1.2
--- no_default_reparse 20 Aug 2005 11:10:16 -0000 1.1
+++ no_default_reparse 20 Aug 2005 17:12:22 -0000 1.2
@@ -17,19 +17,36 @@
__NAME__ description
-This &glos-pragma; disables default &glos-reparse; of Interchange output.
+This &glos-pragma; disables default &glos-reparse; of Interchange output
+from container tags.
</para><para>
-Reparsing can, of course, still be enforced by the
+Reparsing can, of course, still be requested by the
<literal>Reparse</literal> setting
-in individual &glos-ITL; tag definition, or by providing
+in individual &glos-ITL; tag definition, or by providing the
<literal>reparse=1</literal> attribute to the tag.
+</para><para>
+Because this pragma exists, and can be set at the page- or even
+catalog-wide level, it is wise to always specify reparse=1 when you
+really need the output from a container tag to be reparsed, so it will
+work regardless of later changes to this pragma setting.
__END__
__NAME__ example: Enable no_default_reparse pragma page-wide
-Put the following anywhere on your page:
+Put the following anywhere on your page (at the top, to be most polite
+to other developers):
<programlisting>
[pragma no_default_reparse]
</programlisting>
+__END__
+
+
+__NAME__ example: Enable no_default_reparse pragma catalog-wide
+Put this directive in catalog.cfg (or any file included from it):
+<programlisting>
+Pragma no_default_reparse
+</programlisting>
+If you experience any unexpected reparse behavior, check catalog.cfg
+and any included files, to see if someone added or removed this pragma.
__END__
More information about the docs
mailing list