VERSION HISTORY
    v0.4.6 pre 5, Tuesday, 10 July, 2001, 0:53
        corrected some bugs that were occuring when processing image
        maps

        corrected a few other bugs

        changed a little the presentation of the source code

    v0.4.6 pre 5, Monday, 9 July, 2001, 23:26
        html2wml(): corrected a bug: https urls weren't handled
        correctly

        the LWP agent is now created only once per session

        added a few collapsing rules

    v0.4.6 pre 4, Monday, 9 July, 2001, 1:04
        get_url(): corrected two bugs; HTTP authentication is
        beginning to work

        xlate_url(): corrected a bug: respect server port when
        creating relative URLs in CGI mode

    v0.4.6 pre 3, Wednesday, 4 July, 2001, 0:56
        work in progress: HTTP authentication support

    v0.4.6 pre 3, Tuesday, 3rd July, 2001, 23:42
        added function cgi_error()

    v0.4.6 pre 2, Tuesday, 26 June, 2001, 1:35
        added option -o, --output to write result to the given file
        instead of stdout

    v0.4.6 pre 1, Tuesday, 26 June, 2001, 0:53
        opening tags forbidden inside <a> tags

    v0.4.5r2, Tuesday, 26 June, 2001, 1:12
        split_card(): corrected a bug (deck-split in non-cgi mode)

        some warnings were corrected

    v0.4.5, Friday, 21st June, 2001, 1:27
        corrected several warnings; this also add another correction
        for very bad HTML documents

    v0.4.5, Friday, 21st June, 2001, 0:35
        added support for rendering <frameset> and <area> tags

    v0.4.5, Thursday, 20 June, 2001, 0:36
        added full support for Latin Extended-A entities plus some
        other non standard entities

    v0.4.4r3, Wednesday, 20 June, 2001, 23:19
        split_card(): doc_uri is a server-relative URL whenever
        possible in order to save up a few bytes

    v0.4.4r2, Wednesday, 20 June, 2001, 22:50
        id bug corrected (Igor Khristophorov)

    v0.4.4, Tuesday, 19 June, 2001, 1:56
        corrected a bug when closing anchor tags

    v0.4.4, Sunday, 17 June, 2001, 23:17
        collapse_spaces(): some improvments

    v0.4.4, Sunday, 17 June, 2001, 22:15
        added support for some non-standard entities

    v0.4.4 pre 2, Thursday, 13rd June, 2001, 21:32
        post_conversion_cleanup(): special characters present in a
        title are now converted (bug pointed by Igor Khristophorov)

    v0.4.4 pre 1, Thursday, 13rd June, 2001, 1:53
        some bugs corrections

    v0.4.4 beta 4, Thursday, 13rd June, 2001, 1:53
        xlate_url(): a part of the link is now generated only once,
        which should give a nice code speedup

    v0.4.4 beta 3, Thursday, 13rd June, 2001, 1:27
        htmlize(): links are now clickable

        xlate_url(): now uses ';' as parameter separator instead of
        '&'

    v0.4.4 beta 3, Thursday, 13rd June, 2001, 1:08
        early support for deck splitting (in CGI mode only)

    v0.4.4 beta 2, Thursday, 13rd June, 2001, 0:39
        small changes in the settings of the HTML parser

    v0.4.4 beta 1, Thursday, 13rd June, 2001, 23:32
        bug correction: HTML pure anchors (tag A with only a NAME
        attribute) are now correctly converted to WML anchors

    v0.4.3, Sunday, June 3rd, 2001
        split_card(): added a [prev] link; label is controled by the
        `--prev-card-label' option

        documentation updated

    v0.4.3 pre 4, Saturday, June 2nd, 2001
        short options are available; they sould be used in the CGI
        mode in order to save up some bytes

        xlate_url(): in CGI mode, generated URLs use server-relative
        URLs in order to save up a few bytes per link

        htmlize(): small improvments in the syntax highlighting

    v0.4.3 pre 3, Thursday, May 30, 2001
        HTTP headers: corrected the charset attribute; added the
        Content-Length header

        added timing in the debug mode

    v0.4.3 pre 3, Wednesday, May 30, 2001
        unclosed numeric entites are now closed (after a question
        from Daniele Frijia)

    v0.4.3 pre 3, Tuesday, May 29, 2001
        xlate_url(): in CGI mode, generated URLs no longer use the
        absolute URL of the CGI in order to save up a few bytes per
        link; suggestion of Igor Khristophorov

    v0.4.3 pre 2, Sunday, May 27, 2001
        the `--img-alt-text' option should now work correctly

        doc updated

    v0.4.3 pre 2, Saturday, May 26, 2001
        first attempts to fix some new bugs found by Igor
        Khristophorov

    v0.4.3 pre 1, Friday, May 25, 2001
        added the `--img-alt-text' option to control whether the
        images are replaced by their alternative text; on by
        default; thanks to Igor Khristophorov for the suggestion

    v0.4.3 pre 1, Thursday, May 24, 2001
        cleaned up my debugging code; added the `debug()' function

        corrected a weird bug pointed by Igor Khristophorov

        several internal cleans-up

        added support for sending compiled WML

        added support for sending encoding information (from the
        patch submitted by Igor Khristophorov)

        added the `--numeric-non-ascii' option to control whether
        the non-ASCII characters are converted into numeric
        entities; off by default

    v0.4.2, Saturday, May 12, 2001
        non-ASCII characters are now converted to numeric entities

        alone ampersand characters are now converted to the
        corresponding entity

    v0.4.2, Tuesday, May 8, 2001
        corrected a small bug that prevent proper handling of https
        URLs

        corrected a small mistake in the HTML syntax highlight

        changed a few things in the doc

    v0.4.1, Saturday, April 21st, 2001
        changed the default maximum size of a card to 1,000 bytes

        corrected a mistake in the doc

    v0.4.1, Sunday, April 1st, 2001
        debug mode doesn't use Text::Wrap anymore, it's really too
        messy. I've written a small function, `simple_wrap()', that
        does what I had in mind

        added support for very bad-formed HTML documents (with no
        HTML or BODY tags)

        added the `--ignore-images' option

    v0.4.0, Friday, March 9, 2001
        corrected a small bug in doc/Makefile

        added a section to the documentation

    v0.4.0, Thursday, March 8, 2001
        complete update of the documentation

    v0.4.0 beta 4, Monday, January 24, 2001
        improved the debug mode: now use Text::Wrap to avoid very
        long lines

    v0.4.0 beta 3, Monday, January 22, 2001
        corrected the parts of the code that generated the bunch of
        warnings; some of the bugfixes should speed up the code a
        little

        lowered the default `max-card-size' value to 1,500 bytes

    v0.4.0 beta 2, Saturday, January 20, 2001
        added attributes conversion

    v0.4.0 beta 1, Friday, January 19, 2001
        the software is now correctly packaged, and has a Makefile
        that checks the system configuration and installs the
        software and the documentation

        changed the link reconstruction engine: it now uses
        Text::Template, so you can do whatever you want with the
        links

    v0.3.9, Sunday, January 07, 2001
        added support to compile WML using the compiler from WML
        Tools

    v0.3.9 beta 1, Tuesday, January 02, 2001
        corected a small internal flaw: now, in CGI mode, if the
        `url' parameter has no value, use / as a default value

    v0.3.8, Saturday, December 30, 2000
        corrected a small bug in the link reconstruction engine

        the `card-split-threshold' was not available because of a
        mistake; this is correctd

        the way spaces are collapsed has been changed a little

        the `no-pre' option is now `nopre'

    v0.3.7, Friday, December 29, 2000
        corrected a bug when getting the document title

        corrected a bug in the text handler (skip mode was ignored)

        ampersand characters are now escaped in URLs

        added the `no-pre' option to disable the use of the `pre'
        tag

    v0.3.6, Saturday, December 23, 2000
        cleaned up things in the card splitting process; this
        correct a bug that could occur in certain circumstances

        documentation has been updated

    v0.3.5, Saturday, December 23, 2000
        dollar caracters are now escaped

        added a small HTML syntax highlighting when debugging in CGI
        mode

        several bug corrections and improvments in the syntax
        correction engine

        named HTML entities are now converted to numeric entities,
        this is safer because direct conversion to Unicode didn't
        seem to work

        corrected the links reconstruction engine

        named entities are now also converted when in attributes

    v0.3.5 beta 1, Thursday, December 21, 2000
        new feature: the size of the cards can be limited using the
        `max-card-size' option

    v0.3.4, Wednesday, December 20, 2000
        corrected a bug in the de-nesting process

        added features to the links reconstruction engine

        corrected the local file disclosure vulnerability

        until now, captions tags were always skipped; now they
        appears when tables are linearized

    v0.3.3, Monday, December 18, 2000
        named entities are converted to real Unicode characters

        non-breaking spaces (&nbsp;) are converted to spaces

    v0.3.3 beta 4, Friday, December 15, 2000
        links reconstruction is finalized

    v0.3.3 beta 3, Friday, December 15, 2000
        added the `ascii' option to convert entities to US-ASCII

    v0.3.3 beta 2, Friday, December 15, 2000
        named entities conversion is finalized

    v0.3.3 beta 1, Friday, December 14, 2000
        added preliminary support for named entities conversion and
        images support

    v0.3.2, Thursday, December 13, 2000
        oops! file download was broken in 0.3.1; this is corrected
        now

        ampersand are now coded as &amp; in links

        a long standing bug that appeared in some cirumstances has
        been fixed

    v0.3.1, Tuesday, December 12, 2000
        added a small SSI-like engine (not heavily tested)

        corrected a stupid bug: I forgot to add the line that
        translate the internal links so that the urls point to the
        CGI

        modification of the user agent signature so that it includes
        the signature of the original client

        rendering of header tags H1, H2 and H3 has been improved

        added a links reconstruction engine (currently unfinished)

        improved the debug mode when launched from shell

    v0.3.0, Sunday, December 10, 2000
        the syntax repair engine has been improved and should now be
        able to correct most usual HTML pages (I hope)

    v0.3.0 beta 6, Saturday, December 9, 2000
        corrected a stupid bug in the CGI mode

        added the `debug' option

        corrected some mistakes in the documentation

        added the LINKS section in the documentation

        added several improvements and corrected several bugs

    v0.3.0 beta 5, Thursday, December 6, 2000
        added the `collapse' option to control whether redundant
        white space chars are kept or not

        added the documentation for the options

    v0.3.0 beta 4, Monday, December 4, 2000
        added the `linearize' option (on by default) so that it
        linearizes tables

        normal texts (i.e. not inside <pre> tags) are cleaned by
        stripping multiples spaces and lines

        the syntax repair engine has been rewritten, but it does not
        work in all cases

    v0.3.0 beta 3, Sunday, November 19, 2000
        first try to add syntax check/repair

    v0.2.3, Saturday, November 18, 2000
        added URI translation

    v0.2.2, Thursday, November 15, 2000
        added XML checker; the output is given to Expat to check
        that it is well-formed XML. Note that XML::Parser is loaded
        on demand.

        added options support (using Getopt::Long)

    v0.2.1, Tuesday, November 14, 20000
        cleaned up a few things;

        added some attributes to the allow list

        added url resolution

    v0.2.0, Saturday, November 11, 2000
        first functional version; now uses HTML::Parser v3

    v0.1.0, Friday, November 10, 2000
        prototype version