HTML Generator Readme
--------------------- 

Program Name ... :  Java HTML Generator
Current Version  :  1.0
Date ........... :  2014-07-04
Author ......... :  Cyrille Artho (cyrille.artho@gmail.com)


What is this HTML Generator?

	It is a very simple, yet incredibly versatile HTML generator
package for Java. All the handling of the data structures is done in
the java.util.LinkedList class; this package only adds some HTML-ish
properties to that. For more information, go to
	http://artho.com/webtools/java-html-gen/

How do I install it?

	Simply untar the sources into /tmp. A new directory (java) is
created. Inside, there is the directory of the package (java/html).
You can move that directory so it is in your CLASSPATH:
	cp -r java/html (some directory in your CLASSPATH)
	The example programs java/example.html and java/calendar.html
are already compiled. You can remove those files later or keep them for
reference.

Where is the documentation?

	The documentation is not finished yet, but there is an example
program (java/HtmlExample.java) which is well documented and shows the
basics of the usage. The second example (java/HtmlCalendar.java) is more
elaborate and shows some bells and whistles (such as adding options to a
tag after instantiation).

Why should I use this generator package?

	- It's generic: any HTML code is supported; the library takes
care of correct nesting.

	- It's versatile: You cannot only add instances of the Tag
class to the content of a tag for nesting, but anything that supports
a toString() method, so you can add strings directly, or any other
extension you can think of.

	- It's flexible: you can "fill in" HTML content, e. g. a table,
and manipulate - even remove - content later. This is especially useful
for more complicated pages (see the calendar example).

	- It's easy to learn: all the method to manipulate the tags are
from java.util.List.

	- It's practical: you do not need to generate a neat data
structure for all the attributes of a tag (though you can if you like).
A parser is built-in, so you can simply pass all tag options as a string,
e. g.: Tag td = new Tag("td", "align=left width=42%").
