Mercurial > genshi > mirror
comparison doc/xml-templates.txt @ 700:08f22328303d trunk
Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190.
author | cmlenz |
---|---|
date | Fri, 28 Mar 2008 14:14:26 +0000 |
parents | 07e3f6f0ef57 |
children | 85ff66a8f453 |
comparison
equal
deleted
inserted
replaced
699:cfe3b4f02d77 | 700:08f22328303d |
---|---|
356 The following optimization hints are recognized: | 356 The following optimization hints are recognized: |
357 | 357 |
358 +---------------+-----------+-----------------------------------------------+ | 358 +---------------+-----------+-----------------------------------------------+ |
359 | Attribute | Default | Description | | 359 | Attribute | Default | Description | |
360 +===============+===========+===============================================+ | 360 +===============+===========+===============================================+ |
361 | ``buffer`` | ``true`` | Whether the matched content should be | | |
362 | | | buffered in memory. Buffering can improve | | |
363 | | | performance a bit at the cost of needing more | | |
364 | | | memory during rendering. Buffering is | | |
365 | | | ''required'' for match templates that contain | | |
366 | | | more than one invocation of the ``select()`` | | |
367 | | | function. If there is only one call, and the | | |
368 | | | matched content can potentially be very long, | | |
369 | | | consider disabling buffering to avoid | | |
370 | | | excessive memory use. | | |
371 +---------------+-----------+-----------------------------------------------+ | |
361 | ``once`` | ``false`` | Whether the engine should stop looking for | | 372 | ``once`` | ``false`` | Whether the engine should stop looking for | |
362 | | | more matching elements after the first match. | | 373 | | | more matching elements after the first match. | |
363 | | | Use this on match templates that match | | 374 | | | Use this on match templates that match | |
364 | | | elements that can only occur once in the | | 375 | | | elements that can only occur once in the | |
365 | | | stream, such as the ``<head>`` or ``<body>`` | | 376 | | | stream, such as the ``<head>`` or ``<body>`` | |