[Jifty-commit] r7498 - in Template-Declare/trunk: .
Jifty commits
jifty-commit at lists.jifty.org
Wed Sep 23 18:28:15 EDT 2009
Author: theory
Date: Wed Sep 23 18:28:14 2009
New Revision: 7498
Modified:
Template-Declare/trunk/Changes
Template-Declare/trunk/lib/Template/Declare.pm
Log:
Filled out documentation for `buffer`. From Alex Vandiver.
Modified: Template-Declare/trunk/Changes
==============================================================================
--- Template-Declare/trunk/Changes (original)
+++ Template-Declare/trunk/Changes Wed Sep 23 18:28:14 2009
@@ -1,7 +1,7 @@
0.41
* Documented aliasing and template importing (mixins).
-* Reworked all the documentation, neatening things and fixing bugs in the
- examples.
+* Reworked all the documentation, neatening things, fixing bugs in the
+ examples, and adding missing docs for various functions and methods.
0.40_01 2009-08-12
* Support for inline tagset definitions. Thanks to Olivier 'dolmen' Mengué
Modified: Template-Declare/trunk/lib/Template/Declare.pm
==============================================================================
--- Template-Declare/trunk/lib/Template/Declare.pm (original)
+++ Template-Declare/trunk/lib/Template/Declare.pm Wed Sep 23 18:28:14 2009
@@ -330,7 +330,7 @@
<h1>Hello</h1>
<div>first post</div>
-=head2 Aliasing
+=head2 Aliasing and Mixins
=head2 Multiple template roots (search paths)
@@ -389,8 +389,42 @@
=head2 buffer
-Gets or sets the L<String::BufferStack> object; this is a class
-method.
+Gets or sets the L<String::BufferStack> object; this is a class method. You
+can use it to manipulate the output from tags as they are output. It's used
+internally to make the tags nest correctly, and be output to the right place.
+We're not sure if there's ever a need for you to frob it by hand, but it does
+enable things like the following:
+
+ template simple => sub {
+ html {
+ head {}
+ body {
+ Template::Declare->buffer->set_filter( sub {uc shift} );
+ p { 'Whee!' }
+ p { 'Hello, world wide web!' }
+ Template::Declare->buffer->clear_top if rand() < 0.5;
+ }
+ }
+ };
+
+...which outputs, with equal regularity, either:
+
+ <html>
+ <head></head>
+ <body>
+ <P>WHEE!</P>
+ <P>HELLO, WORLD WIDE WEB!</P>
+ </body>
+ </html>
+
+...or:
+
+ <html>
+ <head></head>
+ <body></body>
+ </html>
+
+We'll leave it to you to judge whether or not that's actually useful.
=head2 new_buffer_frame
More information about the Jifty-commit
mailing list