Add ARM files
[dh-make-perl] / dev / arm / libhtml-tree-perl / libhtml-tree-perl-3.23 / debian / libhtml-tree-perl / usr / share / doc / libhtml-tree-perl / README
diff --git a/dev/arm/libhtml-tree-perl/libhtml-tree-perl-3.23/debian/libhtml-tree-perl/usr/share/doc/libhtml-tree-perl/README b/dev/arm/libhtml-tree-perl/libhtml-tree-perl-3.23/debian/libhtml-tree-perl/usr/share/doc/libhtml-tree-perl/README
new file mode 100644 (file)
index 0000000..6f89b65
--- /dev/null
@@ -0,0 +1,97 @@
+# Time-stamp: "2006-08-06 19:00:00 CDT"
+
+HTML-Tree
+---------
+
+This distribution contains a suite of modules for representing,
+creating, and extracting information from HTML syntax trees; there is
+also relevent documentation.  These modules used to be part of the
+libwww-perl distribution, but are now unbundled in order to facilitate
+a separate development track.  Bug reports and discussions about these
+modules can be sent to the RT queue at <bug-html-tree@rt.cpan.org>.
+
+The modules and documentation present in this collection are:
+
+  HTML::Tree -- overview of the modules.
+
+  HTML::Tree::AboutObjects -- an article by Sean M. Burke from
+    The Perl Journal #17: "User's View of Object-Oriented Modules"
+
+  HTML::Tree::AboutTrees -- an article by Sean M. Burke from
+    The Perl Journal #18: "Trees", about tree-shaped data
+    structures in Perl.
+
+  HTML::Tree::Scanning -- an article by Sean M. Burke from
+    The Perl Journal #19: "Scanning HTML".
+
+
+  HTML::Element - class for representing the nodes of the HTML syntax
+        trees.  The elements have other elements and text segments
+        as children.  The HTML::Element class has methods to build,
+        alter, and traverse the structure of the tree.
+
+  HTML::TreeBuilder - a class that uses HTML::Parser to read HTML
+        document text and build from it a syntax tree made of
+        HTML::Element nodes.
+
+  HTML::Parse - deprecated module.  Now just a wrapper around
+        HTML::TreeBuilder
+
+  HTML::AsSubs - module providing an easy way to build an HTML syntax
+        tree by nesting functions.
+
+
+
+PREREQUISITES
+
+In order to install and use this package you will need Perl version
+5.004 or better.  You will also need to have an HTML-Parser and
+HTML-Tagset distributions installed.  All of these should be available
+from CPAN.
+
+
+
+INSTALLATION
+
+Just follow the usual procedure:
+
+   perl Makefile.PL
+   make
+   make test
+   make install
+
+Or see also "perldoc perlmodinstall"
+
+
+
+SUBLIMINAL MESSAGE: BUY THE BOOK!
+
+The book /Perl & LWP/ by Sean M. Burke is published by
+O'Reilly and Associates, 2002.  ISBN: 0-596-00178-9
+
+It has several chapters to do with HTML processing in general,
+and HTML-Tree specifically.  There's more info at:
+
+  http://www.oreilly.com/catalog/perllwp/
+  http://www.amazon.com/exec/obidos/ASIN/0596001789
+
+
+
+COPYRIGHT
+
+Copyright 1995-1998 Gisle Aas; 1999-2004 Sean M. Burke; 
+2005 Andy Lester; 2006 Pete Krawczyk.  (Except the articles
+contained in HTML::Tree::AboutObjects, HTML::Tree::AboutTrees, and
+HTML::Tree::Scanning, which are all copyright 2000 The Perl Journal.)
+
+Except for those three TPJ articles, the whole HTML-Tree distribution,
+of which this file is a part, is free software; you can redistribute
+it and/or modify it under the same terms as Perl itself.
+
+Those three TPJ articles may be distributed under the same terms as
+Perl itself.
+
+The programs in this library are distributed in the hope that they
+will be useful, but without any warranty; without even the implied
+warranty of merchantability or fitness for a particular purpose.
+