home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2007 September / PCWSEP07.iso / Software / Linux / Linux Mint 3.0 Light / LinuxMint-3.0-Light.iso / casper / filesystem.squashfs / usr / share / doc / libhtml-tree-perl / README < prev    next >
Encoding:
Text File  |  2005-11-09  |  3.0 KB  |  99 lines
  1. # Time-stamp: "2002-07-30 00:44:56 MDT"
  2.  
  3. HTML-Tree
  4. ---------
  5.  
  6. This distribution contains a suite of modules for representing,
  7. creating, and extracting information from HTML syntax trees; there is
  8. also relevent documentation.  These modules used to be part of the
  9. libwww-perl distribution, but are now unbundled in order to facilitate
  10. a separate development track.  Bug reports and discussions about these
  11. modules can still be sent to the <libwww@perl.org> mailing list, or to
  12. <sburke@cpan.org>.
  13.  
  14. The modules and documentation present in this collection are:
  15.  
  16.   HTML::Tree -- overview of the modules.
  17.  
  18.   HTML::Tree::AboutObjects -- an article by Sean M. Burke from
  19.     The Perl Journal #17: "User's View of Object-Oriented Modules"
  20.  
  21.   HTML::Tree::AboutTrees -- an article by Sean M. Burke from
  22.     The Perl Journal #18: "Trees", about tree-shaped data
  23.     structures in Perl.
  24.  
  25.   HTML::Tree::Scanning -- an article by Sean M. Burke from
  26.     The Perl Journal #19: "Scanning HTML".
  27.  
  28.  
  29.   HTML::Element - class for representing the nodes of the HTML syntax
  30.         trees.  The elements have other elements and text segments
  31.         as children.  The HTML::Element class has methods to build,
  32.         alter, and traverse the structure of the tree.
  33.  
  34.   HTML::TreeBuilder - a class that uses HTML::Parser to read HTML
  35.         document text and build from it a syntax tree made of
  36.         HTML::Element nodes.
  37.  
  38.   HTML::Parse - deprecated module.  Now just a wrapper around
  39.         HTML::TreeBuilder
  40.  
  41.   HTML::AsSubs - module providing an easy way to build an HTML syntax
  42.         tree by nesting functions.
  43.  
  44.  
  45.  
  46. PREREQUISITES
  47.  
  48. In order to install and use this package you will need Perl version
  49. 5.004 or better.  You will also need to have an HTML-Parser and
  50. HTML-Tagset distributions installed.  All of these should be available
  51. from CPAN.
  52.  
  53.  
  54.  
  55. INSTALLATION
  56.  
  57. Just follow the usual procedure:
  58.  
  59.    perl Makefile.PL
  60.    make
  61.    make test
  62.    make install
  63.  
  64. Or see also "perldoc perlmodinstall"
  65.  
  66.  
  67.  
  68. SUBLIMINAL MESSAGE: BUY THE BOOK!
  69.  
  70. The book /Perl & LWP/ by me, Sean M. Burke, is published by
  71. O'Reilly and Associates, 2002.  ISBN: 0-596-00178-9
  72.  
  73. It has several chapters to do with HTML processing in general,
  74. and HTML-Tree specifically.  There's more info at:
  75.  
  76.   http://www.oreilly.com/catalog/perllwp/
  77.   http://www.amazon.com/exec/obidos/ASIN/0596001789
  78.  
  79.  
  80.  
  81. COPYRIGHT
  82.  
  83. Copyright 1995-1998 Gisle Aas; copyright 1999-2002 Sean M. Burke.
  84. (Except the articles contained in HTML::Tree::AboutObjects,
  85. HTML::Tree::AboutTrees, and HTML::Tree::Scanning, which are all
  86. copyright 2000 The Perl Journal.)
  87.  
  88. Except for those three TPJ articles, the whole HTML-Tree distribution,
  89. of which this file is a part, is free software; you can redistribute
  90. it and/or modify it under the same terms as Perl itself.
  91.  
  92. Those three TPJ articles may be distributed under the same terms as
  93. Perl itself.
  94.  
  95. The programs in this library are distributed in the hope that they
  96. will be useful, but without any warranty; without even the implied
  97. warranty of merchantability or fitness for a particular purpose.
  98.  
  99.