[Jifty-commit] r7505 - in Template-Declare/trunk/lib/Template: .

[Jifty commits]

Author: theory
Date: Mon Oct  5 20:58:09 2009
New Revision: 7505

Modified:
   Template-Declare/trunk/lib/Template/Declare.pm
   Template-Declare/trunk/lib/Template/Declare/Tags.pm

Log:
Documented `show_page()` and moved `append_attr`. Gave the latter some docs, too, but they are commented out, as it seems like it should not be exposed.

Modified: Template-Declare/trunk/lib/Template/Declare.pm
==============================================================================
--- Template-Declare/trunk/lib/Template/Declare.pm	(original)
+++ Template-Declare/trunk/lib/Template/Declare.pm	Mon Oct  5 20:58:09 2009
@@ -430,9 +430,8 @@
 
   $td->new_buffer_frame();
 
-Creates a new buffer frame, using L<String::BufferStack/push> with
-C<private>.  This use is deprecated in favor of dealing with
-L</buffer>.directly.
+Creates a new buffer frame, using L<String::BufferStack/push> with C<private>.
+This use is deprecated in favor of dealing with L</buffer> directly.
 
 =cut
 
@@ -444,9 +443,8 @@
 
   my $buf = $td->end_buffer_frame();
 
-Deletes and returns the topmost buffer, using
-L<String::BufferStack/pop>.  This use is deprecated in favor of
-dealing with L</buffer>.directly..
+Deletes and returns the topmost buffer, using L<String::BufferStack/pop>. This
+use is deprecated in favor of dealing with L</buffer> directly..
 
 =cut
 

Modified: Template-Declare/trunk/lib/Template/Declare/Tags.pm
==============================================================================
--- Template-Declare/trunk/lib/Template/Declare/Tags.pm	(original)
+++ Template-Declare/trunk/lib/Template/Declare/Tags.pm	Mon Oct  5 20:58:09 2009
@@ -426,21 +426,6 @@
     return @_;
 }
 
-=begin comment
-
-=head2 append_attr
-
-How does this work?
-
-=end comment
-
-=cut
-
-sub append_attr {
-    die "Subroutine attr failed: $_[0] => '$_[1]'\n\t".
-        "(Perhaps you're using an unknown tag in the outer container?)";
-}
-
 =head2 xml_decl HASH
 
     xml_decl { 'xml', version => '1.0' };
@@ -774,13 +759,13 @@
 
 }
 
-=begin comment
-
 =head2 show_page
 
-A private function?
+    show_page( main => { user => 'Bob' } );
 
-=end comment
+Like C<show()>, but does not dispatch to private templates. It's used
+internally by C<show()> when when that method is called from outside a
+template class.
 
 =cut
 
@@ -908,6 +893,23 @@
 
 sub under ($) { return shift }
 
+=begin comment
+
+=head2 append_attr
+
+C<append_attr> is a helper function providing an interface for setting
+attributes from within tags. But it's better to use C<attr> or C<is> to set
+your attributes. Nohting to see here, really. Move along.
+
+=end comment
+
+=cut
+
+sub append_attr {
+    die "Subroutine attr failed: $_[0] => '$_[1]'\n\t".
+        "(Perhaps you're using an unknown tag in the outer container?)";
+}
+
 =head1 VARIABLES
 
 =over