[Lcd4linux-devel] Documentation framework updated

[Xavier V. <xav...@fr...>]

Hello to all documentation writers !

I've reworked the DTDs so that xsltproc generates valid XHTML 1.0 Strict
pages (and it should be XHTML 1.1 valid). I've introduced another
helper : <intro> to add an introduction text, and reworked the <index>
helper and the CSS. Moreover, the xsltproc output is passed through
xmllint to indent it and write a good-looking html, not the uggly things
it used to trow. And little bonus, the h* are numbered !!
I've updated write_doc.xml according to the new helper and started
hd44780 (even if it isn't in the archive).

BTW: Jerry, have you started writing ? I think this will be alot harder
to write the doc than the corresponding code :/ Doc writing is not very
exciting.

Last but not least, here's a list of allowed "toplevel" elements, as
XHTML-strict is quite, ... strict about this ;)
intro, h2, h3, h4, p, index, div, warn, note, cmd, conf, ul
You must put your text in <p></p>, but the div/warn/note/cmd/conf must
be a "toplevel", that's what XHTML wants.

Bye !
-- 
Xavier VELLO <xav...@fr...>