summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorLorry Tar Creator <lorry-tar-importer@lorry>2013-05-08 22:21:52 +0000
committerLorry Tar Creator <lorry-tar-importer@lorry>2013-05-08 22:21:52 +0000
commit2f253cfc85ffd55a8acb988e91f0bc5ab348124c (patch)
tree4734ccd522c71dd455879162006742002f8c1565 /README
downloadHTML-Parser-tarball-master.tar.gz
Diffstat (limited to 'README')
-rw-r--r--README65
1 files changed, 65 insertions, 0 deletions
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 &lt;entities&gt;.
+
+ HTML::HeadParser - A lightweight HTML::Parser subclass that extracts
+ information from the <HEAD> 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 <libwww@perl.org> 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.