all tests pass

[html-element-library.git] / lib / HTML / Element / Library.pod

diff --git a/lib/HTML/Element/Library.pod b/lib/HTML/Element/Library.pod
index c7cde764c2da5f3504d1b0e54570382bd6167287..909aa9ecefccf2f15a86ed00ae6cfa57a7b86120 100644 (file)
--- a/lib/HTML/Element/Library.pod
+++ b/lib/HTML/Element/Library.pod
@@ -1089,27 +1089,89 @@ to display:
        </span>
 
 
+=head2 Tree-Killing Methods
 
+=head3 $tree->prune
 
-=head1 SEE ALSO
+This removes any nodes from the tree which consist of nothing or nothing but whitespace.
+See also delete_ignorable_whitespace in L<HTML::Element>.
 
-=over
+=head2 Loltree Functions
+
+A loltree is an arrayref consisting of arrayrefs which is used by 
+C<< new_from__lol >> in L<HTML::Element> to produce HTML trees.
+The CPAN distro L<XML::Element::Tolol> creates such XML trees by parsing XML files,
+analagous to L<XML::Toolkit>. The purpose of the functions in this section is to allow 
+you manipulate a loltree programmatically. 
 
-=item * L<HTML::Tree>
+These could not be methods because if you bless a loltree, then HTML::Tree will barf.
 
-A perl package for creating and manipulating HTML trees
+=head3 HTML::Element::replace_node($lol, $node_label, $new_node)
 
-=item * L<HTML::ElementTable>
+Given this initial loltree:
+
+    my $initial_lol = [ note => [ shopping => [ item => 'sample' ] ] ];
+
+This code:
+
+    sub shopping_items {
+      my @shopping_items = map { [ item => _ ] } qw(bread butter beans) ;
+      \@shopping_items;
+    }
+
+    my $new_lol = HTML::Element::newnode($initial_lol, item => shopping_items());
+
+ will replace the single sample with a list of shopping items:
+
+
+     [
+          'note',
+          [
+            'shopping',
+            [
+              [
+                'item',
+                'bread'
+              ],
+              [
+                'item',
+                'butter'
+              ],
+              [
+                'item',
+                'beans'
+              ]
+            ]
+          ]
+        ];
+
+Thanks to kcott and the other Perlmonks in this thread:
+http://www.perlmonks.org/?node_id=912416
+
+
+=head1 SEE ALSO
+
+=head2 L<HTML::Tree>
+
+A perl package for creating and manipulating HTML trees. 
+
+=head2 L<HTML::ElementTable>
 
 An L<HTML::Tree> - based module which allows for manipulation of HTML
 trees using cartesian coordinations. 
 
-=item * L<HTML::Seamstress>
+=head2 * L<HTML::Seamstress>
 
 An L<HTML::Tree> - based module inspired by 
 XMLC (L<http://xmlc.enhydra.org>), allowing for dynamic
 HTML generation via tree rewriting.
 
+=head2 Push-style tmeplating systems
+
+A comprehensive cross-language 
+L<list of push-style templating systems|http://perlmonks.org/?node_id=674225>.
+
+
 =head1 TODO
 
 =over