[Firebird-docs] DocBook

[Andy C. <an...@ad...>]

David Jencks has suggested that we use the SXML (Standard Extensible =
Markup Language) DTD (Document Type Definition) DocBook as source for =
the documentation. Do others here have opinions on DocBook?

If I write something and John Doe sees that it's wrong, I want John to =
be able to correct my mistake in ten minutes. The web page he's reading =
has a link labelled "Click here to edit this page." John gets something =
he can edit on his present computer, Linux or UNIX or Mac or Windows. =
John doesn't need to have memorized a markup language in order to fix =
typos, add a sentence or two, remove a mistake. Following simple =
embedded instructions (e.g. "mailto:..." ) he can send his alterations =
in after only a few minutes. If it takes more than ten minutes John =
won't bother and we'll lose out on his corrections.

David Jencks wrote:
> 1. get ant, you'll need it for the compilation stuff. =20
> http://jakarta.apache.org/builds/ant/release/v1.3/bin/
> You will need java, probably jdk 1.3 for ant and the xml/xsl
> parsing/transformation.

I only have Windows. So far I think that I want three pieces:
[1] ANT: I downloaded jakarta-ant-1.3-bin.zip; installed 17 MB.
[2] JDK (1.3?) Do you have a link for the source to jdk ?
[3] DOCBOOK: I downloaded docbk41.zip; installed 1 MB.
[4] JBOSS: can't get it until I get JDK and get ANT working.
Do I need any other pieces?