		    =============================
		    HTML::TableParser Version 0.3
		    =============================

NAME
    HTML::TableParser - Extract data from an HTML table

DESCRIPTION
    HTML::TableParser uses HTML::Parser to extract data from an HTML
    table.  The data is returned via a series of user defined callback
    functions or methods.  Specific tables may be selected either by a
    unique table id or by matching against the column names.  Multiple
    tables may be parsed simultaneously in the document.

    The data are presented to the caller as the table is scanned,
    on a row-by-row basis.

INSTALLATION

    To install this module type the following:

       perl Makefile.PL
       make
       make test
       make install

DEPENDENCIES

    This module requires these other modules and libraries:

       HTML::Entities
       HTML::Parser
       Test::More


CHANGES

    Major changes only. See the Changes file for more details.

    0.3
    ---

    - table matching via id and column names is now more flexible and
      simplified.  The id and cols request keywords now take literals,
      regexps (via qr//), and subroutines (which are called to determine
      if a table matches) They can also take lists of matches.

    - colre is deprecated and will be removed eventually

    - requests can now explicitly exclude particular tables.  tables
      can now be explicitly skipped.

    0.2
    ---

    - the order in which the requests list was matched was
      indeterminate (and incorrect). it is now explicit
      (and hopefully correct).
    - the checks for whether a request had been used were
      mostly broken, causing requests to be reused when
      they shouldn't have been.
    - a nested table in the first row of a table was processed
      before the enclosing table had a chance to perform a
      column name match. this could cause the nested table to
      steal a use-once request from the parent table

COPYRIGHT AND LICENCE

    Copyright (C) 2001-2002 Smithsonian Astrophysical Observatory.
    All rights reserved.

    This program is free software; you can redistribute it and/or
    modify it under the terms of the GNU General Public License as
    published by the Free Software Foundation; either version 2 of the
    License, or (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
    02111-1307 USA

