=head1 VERSION HISTORY

=over 4

=item v0.4.11, 2003.10.26 - 14:58

extended the effet of --ascii: now also converts non-ASCII 
characters to ASCII equivalents

updated Html2cHtml with the code from Html2Wml 0.4.11

=item v0.4.11b2, 2003.02.14 - 01:00

added support for <base href="..."> in CGI mode

=item v0.4.11b1, 2003.02.11 - 02:00

corrected mishandling of URLs in xlate_url() and split_card()

added option -i as an alias for --ignore-images; 
also available in CGI mode

=item v0.4.10, Wednesday, 27th November 2002, 20:32

corrected a bug in the man page (Werner Heuser)

=item v0.4.10b6, Sunday, 24th November 2002, 16:54

added first hooks support for HTML form conversion; 
supported inputs are: text, password, hidden and select 

=item v0.4.10b5, Saturday, 9th November 2002, 0:51

added support for internal hardcoding of proxy server

=item v0.4.10b4, Monday, 4th novembern 2002, 19:18

added missing proxy support (Frank Schwarz)

=item v0.4.10b4.chtml.03, Sunday, 3rd November, 2002, 2:48

in Html2cHtml: the split_card() function has been partially fixed, 
but as I'm not satisfied with it (and it's may be impossible in 
cHTML the same way as in WML), the document splitting has been 
completly disabled

=item v0.4.10b4, Thursday, 31st October, 2002, 20:19

added a default "encoding" parameter (valued to "iso-8859-1")

=item v0.4.10b4, Wednesday, 30th October, 2002, 1:42

added a test to prevent incorrect auto-nesting (i.e.: <p><p>...); 
was also introduced a "unique" attribute in the tags tree

=item v0.4.10b4, Tuesday, 29th October, 2002, 2:10

corrected a bug in the syntax repair engine (reverse tags 
were incorrectly added) (signaled by Werner heuser)

=item v0.4.10b3, Saturday, 28th September, 2002, 17:10

added the "skip"/"end_skip" actions

added the "for" action parameter

=item v0.4.10b3, (don't remember when)

in comment_tag() handler: the "include" and "fsize" 
actions now take into account the size of the text 
being added to the output

=item v0.4.10b2, Thursday, 27th June, 2002, 0:37

xlate_url(): fixed two big bugs the URL translation 
in CGI mode

=item v0.4.10b2, Sunday, 9th June, 2002, 18:41

just saw that Getopt::Long::config() is deprecated; 
replaced by Getopt::Long::Configure()

=item v0.4.10b1, Friday, 5th April, 2002, 20:20

get_url(): fixed a stupid bug in the output (Ouyang)

=item v0.4.10b1, Friday, 5th April, 2002, 2:20

in start_tag() handler: rewrote the part of the 
syntax repair engine that tries to insert the good 
tags in order to restore a valid nesting; 
thanks for Ouyang for pointing me to the base of 
the problem

=item v0.4.9, Sunday, 24th February, 2002, 16:12

cgi_error(): changed the output so that the version 
number is printed

=item v0.4.9, Monday, 14th January, 2002, 23:44

corrected a bug pointed by Werner Heuser: other 
schemes were messed up

=item v0.4.8, Thursday, 27th December, 2001, 2:02

removed the XML::LibXML validation test as it is 
currently too unstable (it always segfaults when 
the doc is not valid..)

=item v0.4.8, Tuesday, 25th December, 2001, 13:25

added a small optimization when correcting incorrect 
entities

=item v0.4.8b4, Thursday, 13th December, 2001, 21:23

updated the security fix in get_url(); now "file:" 
schemes are also forbidden in the LWP UserAgent

=item v0.4.8b3, Tuesday, 27th November, 2001, 0:45

completed URL encoding

=item v0.4.8b3, Tuesday, 27th November, 2001, 23:30

tracked down and corrected a bug that occured with 
certain files: split_card() was incorrectly called 
in some cases

unknown entities are now converted in order to keep 
the document well-formed

=item v0.4.8b3, Tuesday, 27th November, 2001, 22:35

paths in include actions can now be relative

several special characters are escaped in URLs

=item v0.4.8b3, Sunday, 25th November, 2001, 18:46

align attribute are now always converted to lower case

=item v0.4.8b2, Thursday, 22nd November, 2001, 2:03

corrected several braindead bugs: upper case <title> 
weren't recognized; links conversion was broken in CGI 
mode; plus a few other stupid bugs

added warnings in read_file() and get_url()

=item v0.4.8b2, Wednesday, 21st November, 2001, 20:43

corrected a security issue pointed by Jukka Salomaa; 
URLs with the "file:" scheme are now forbidden

=item v0.4.8b1, Wednesday, 21st November, 2001, 1:18

corrected a bug in the cgi mode: options weren't kept 
through the links

changed some parts of the code to try to gain speed

accidentaly corrected a bug in CGI mode :-)

=item v0.4.7r2, Wednesday, 14th November, 2001, 0:25

corrected mistakes in the package

small bug corrected

=item v0.4.7, Sunday, 11th November, 2001, 20:42

documentation updates

Html2Wml comment deleted

=item v0.4.7, Sunday, 11th November, 2001, 2:01

convert_entities(): corrected a small bug

=item v0.4.7, Saturday, 10th November, 2001, 23:11

added small optimizations in the URLs constructions

=item v0.4.7, Friday, 9th November, 2001, 1:03

documentation has been updated

added a workaround: wmlc doesn't like &lt; in attributes

=item v0.4.7, Wednesday, 7th November, 2001, 22:15

WML compilation now correctly works

=item v0.4.7, Thursday, 2nd November, 2001, 1:21

corrected several minor things

=item v0.4.7 beta 2, Thursday, 1st November, 2001, 16:23

end() handler: the card tag now cleans up the stack; the prev link 
is added before the last card tag

output handling didn't work, it's corrected now

usage message has been updated

small optimization in the generation of the static part of self 
URLs in CGI mode

corrected a small bug in the entities conversion

corrected a warning

=item v0.4.7 beta 1, Saturday, 11, August, 2001, 0:21

apply_options(): added security checks to forbid dangerous functions 
in href and src templates

=item v0.4.7 beta 1, Friday, 10 August, 2001, 23:50

convert_entities(): corrected another bug in the regexp that close 
incorrect named entities; now it should work in most cases

=item v0.4.7 beta 1, Thursday, 9 August, 2001, 21:54

get_url(): corrected a bug reported by Igor Khristophorov

convert_entities(): corrected a bug in the regexp that close 
incorrect named entities

html2wml(): added a fix for badly formed DOCTYPE (pointed by Igor 
Khristophorov)

=item v0.4.6, Tuesday, 31 July, 2001, 15:17

some clean-ups

=item v0.4.6, Tuesday, 31 July, 2001, 13:34

added code to handle unclosed named entities

corrected a small bug in the code that handle unclosed numeric entities

=item v0.4.6, Tuesday, 31 July, 2001, 12:14

corrected a mistake in the handling of frames and image maps links 
(pointed by Igor Khristophorov)

=item v0.4.6 pre 6, Tuesday, 15 July, 2001, 0:18

in CGI mode, now always converts options to their short names

split_card(): corrected a small bug: respect server port

=item v0.4.6 pre 6, Sunday, 15 July, 2001, 1:04

changed a few things to clearly indicate the static configurable 
part of the code

=item v0.4.6 pre 6, Thursday, 12 July, 2001, 22:22

corrected a stupid bug (pointed by Werner Heuser)

=item 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

=item 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

=item 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

=item v0.4.6 pre 3, Wednesday, 4 July, 2001, 0:56

work in progress: HTTP authentication support

=item v0.4.6 pre 3, Tuesday, 3rd July, 2001, 23:42

added function cgi_error()

=item 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

=item v0.4.6 pre 1, Tuesday, 26 June, 2001, 0:53

opening tags forbidden inside <a> tags

=item v0.4.5r2, Tuesday, 26 June, 2001, 1:12

split_card(): corrected a bug (deck-split in non-cgi mode)

some warnings were corrected

=item v0.4.5, Friday, 21st June, 2001, 1:27

corrected several warnings; this also add another correction for very 
bad HTML documents

=item v0.4.5, Friday, 21st June, 2001, 0:35

added support for rendering <frameset> and <area> tags

=item v0.4.5, Thursday, 20 June, 2001, 0:36

added full support for Latin Extended-A entities plus some other 
non standard entities

=item 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

=item v0.4.4r2, Wednesday, 20 June, 2001, 22:50

id bug corrected (Igor Khristophorov)

=item v0.4.4, Tuesday, 19 June, 2001, 1:56

corrected a bug when closing anchor tags

=item v0.4.4, Sunday, 17 June, 2001, 23:17

collapse_spaces(): some improvments

=item v0.4.4, Sunday, 17 June, 2001, 22:15

added support for some non-standard entities

=item 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)

=item v0.4.4 pre 1, Thursday, 13rd June, 2001, 1:53

some bugs corrections

=item 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

=item 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 '&'

=item v0.4.4 beta 3, Thursday, 13rd June, 2001, 1:08

early support for deck splitting (in CGI mode only)

=item v0.4.4 beta 2, Thursday, 13rd June, 2001, 0:39

small changes in the settings of the HTML parser 

=item 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

=item v0.4.3, Sunday, June 3rd, 2001

split_card(): added a [prev] link; label is controled by the 
C<--prev-card-label> option

documentation updated

=item 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

=item 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

=item v0.4.3 pre 3, Wednesday, May 30, 2001

unclosed numeric entites are now closed (after a question from Daniele Frijia) 

=item 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

=item v0.4.3 pre 2, Sunday, May 27, 2001

the C<--img-alt-text> option should now work correctly

doc updated

=item v0.4.3 pre 2, Saturday, May 26, 2001

first attempts to fix some new bugs found by Igor Khristophorov

=item v0.4.3 pre 1, Friday, May 25, 2001

added the C<--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

=item v0.4.3 pre 1, Thursday, May 24, 2001

cleaned up my debugging code; added the C<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 C<--numeric-non-ascii> option to control whether the non-ASCII 
characters are converted into numeric entities; off by default

=item 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 

=item 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

=item 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

=item 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, C<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 C<--ignore-images> option

=item v0.4.0, Friday, March 9, 2001

corrected a small bug in doc/Makefile

added a section to the documentation

=item v0.4.0, Thursday, March 8, 2001

complete update of the documentation

=item v0.4.0 beta 4, Monday, January 24, 2001

improved the debug mode: now use Text::Wrap to avoid very long lines

=item 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 C<max-card-size> value to 1,500 bytes

=item v0.4.0 beta 2, Saturday, January 20, 2001

added attributes conversion

=item 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

=item v0.3.9, Sunday, January 07, 2001

added support to compile WML using the compiler from WML Tools

=item v0.3.9 beta 1, Tuesday, January 02, 2001

corected a small internal flaw: now, in CGI mode, if the C<url> parameter has 
no value, use / as a default value

=item v0.3.8, Saturday, December 30, 2000

corrected a small bug in the link reconstruction engine

the C<card-split-threshold> was not available because of a mistake; this is 
correctd

the way spaces are collapsed has been changed a little 

the C<no-pre> option is now C<nopre>

=item 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 C<no-pre> option to disable the use of the C<pre> tag

=item 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

=item 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

=item v0.3.5 beta 1, Thursday, December 21, 2000

new feature: the size of the cards can be limited using the C<max-card-size>
option

=item 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

=item v0.3.3, Monday, December 18, 2000

named entities are converted to real Unicode characters

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

=item v0.3.3 beta 4, Friday, December 15, 2000

links reconstruction is finalized

=item v0.3.3 beta 3, Friday, December 15, 2000

added the C<ascii> option to convert entities to US-ASCII

=item v0.3.3 beta 2, Friday, December 15, 2000

named entities conversion is finalized

=item v0.3.3 beta 1, Friday, December 14, 2000

added preliminary support for named entities conversion and images support

=item 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

=item 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

=item 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)

=item v0.3.0 beta 6, Saturday, December 9, 2000

corrected a stupid bug in the CGI mode

added the C<debug> option

corrected some mistakes in the documentation

added the LINKS section in the documentation

added several improvements and corrected several bugs

=item v0.3.0 beta 5, Thursday, December 6, 2000

added the C<collapse> option to control whether redundant white space 
chars are kept or not

added the documentation for the options

=item v0.3.0 beta 4, Monday, December 4, 2000

added the C<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

=item v0.3.0 beta 3, Sunday, November 19, 2000

first try to add syntax check/repair

=item v0.2.3, Saturday, November 18, 2000

added URI translation

=item 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)

=item v0.2.1, Tuesday, November 14, 20000

cleaned up a few things;

added some attributes to the allow list

added url resolution

=item v0.2.0, Saturday, November 11, 2000

first functional version; now uses HTML::Parser v3

=item v0.1.0, Friday, November 10, 2000

prototype version

=back