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