Mailing-List: contact dev-help@ant.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Ant Developers List" <dev@ant.apache.org>
Received-SPF: pass (asf.osuosl.org: local policy)
Message-ID: <43C5E5D8.7050502@it.fts-vn.com>
Date: Thu, 12 Jan 2006 12:15:04 +0700
From: Kev Jackson <kevin.jackson@it.fts-vn.com>
User-Agent: Mozilla Thunderbird 1.0.6 (Windows/20050716)
MIME-Version: 1.0
To: Ant Developers List <dev@ant.apache.org>
Subject: sandbox gendoc
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit

Hi,

I've had a look through the sandbox and I noticed Dominque's (sp?) xml'd 
version of the docs.

As you know I had a play with DocBook-izing the manual last year and in 
the end the effort of manually altering every html page to be valid 
DocBook xml drove me mad (gibber etc).  Also there seemed to be a 
consensus (or rather a few well informed arguments against DocBook in 
general) that DocBook was not the way to go for the ant manual[1]

So I've had a look at the gendoc version (all 2 manual pages + whatsnew) 
and I thought that if this is at least in the sandbox, it's 99% more 
official than choosing a.n.other xml.

Given this I'm preparing a little script to automate the conversion of 
the html docs to the xmlised version in the sandbox.

So far I'm trying to get it to work correctly with echo, but most of the 
code is generic so when I get a passable version of that I'll refactor 
(a lot) and run it against the doc directory.

Given the formatting issues of html, I expect at least a little manual 
intervention along the way, but manually converting all the docs would 
be insane (there's over 400 in the core tasks directory alone)

Anyone interested in the results?

Kev

[1] http://marc.theaimsgroup.com/?l=ant-dev&m=111035433410638&w=2

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org