From 2f253cfc85ffd55a8acb988e91f0bc5ab348124c Mon Sep 17 00:00:00 2001 From: Lorry Tar Creator Date: Wed, 8 May 2013 22:21:52 +0000 Subject: HTML-Parser-3.71 --- README | 65 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 README (limited to 'README') diff --git a/README b/README new file mode 100644 index 0000000..928d585 --- /dev/null +++ b/README @@ -0,0 +1,65 @@ +OVERVIEW + +The HTML-Parser distribution is is a collection of modules that parse +and extract information from HTML documents. The modules present in +this collection are: + + HTML::Parser - The parser base class. It receives arbitrary sized + chunks of the HTML text, recognizes markup elements, and + separates them from the plain text. As different kinds of markup + and text are recognized, the corresponding event handlers are + invoked. + + HTML::Entities - Provides functions to encode and decode text with + embedded HTML <entities>. + + HTML::HeadParser - A lightweight HTML::Parser subclass that extracts + information from the section of an HTML document. + + HTML::LinkExtor - An HTML::Parser subclass that extracts links from + an HTML document. + + HTML::PullParser - An alternative interface to the basic parser + that does not require event driven programming. + + HTML::TokeParser - An HTML::PullParser subclass with fixed + token setup and methods for extracting text. Many simple + parsing needs are probably best attacked with this module. + +In addition take a look at the HTML-Tree package that build on +HTML::Parser to create and extract information from HTML syntax trees +(similar to HTML DOM). + + +PREREQUISITES + +In order to install and use this package you will need Perl version +5.8 or better. The HTML::Tagset module should be installed. + +If you intend to use the HTML::HeadParser you probably want to install +libwww-perl too. + + +INSTALLATION + +Just follow the usual procedure: + + perl Makefile.PL + make + make test + make install + + +REPORTING BUGS + +Bug reports and issues for discussion about these modules can be sent +to the mailing list. + + +COPYRIGHT + + © 1995-2009 Gisle Aas. All rights reserved. + © 1999-2000 Michael A. Chase. All rights reserved. + +This library is free software; you can redistribute it and/or modify +it under the same terms as Perl itself. -- cgit v1.2.1