Re: sandbox gendoc

2006-01-15 Thread Kev Jackson
Java does regex just fine, albeit more verbose (when is Java not verbose ;-), but my main point is that you already have (Java) tools allow you to have an XML view of the existing HTML manual (tagsoup, etc...). Leave the parsing to these tools, and concentrate of transforming the "loose" HTML sc

RE: sandbox gendoc

2006-01-13 Thread cstrong
>> I found the answer: use Docbook 5.0 (currently in beta). Docbook5 uses >> RelaxNG schemas and namespaces rather than DTDs. > Can one use RelaxNG Compact notation? It is so much simple and easy to > understand. > > That could be a very good selling point. Yes, Docbook 5 comes with both flavors

Re: sandbox gendoc

2006-01-13 Thread Dominique Devienne
> > Yes, I thought that would be the way to go as well down the line, > > parsing the HTML with tagsoup [...] > > when I say script here I'm talking about a ruby script (partially as I > saw this as being a converter for the manual for a limited amount of > time, not immediate throwaway, but not a

RE: sandbox gendoc

2006-01-13 Thread Jose Alberto Fernandez
Can one use RelaxNG Compact notation? It is so much simple and easy to understand. That could be a very good selling point. Jose Alberto > -Original Message- > From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED] > Sent: 12 January 2006 23:52 > To: dev@ant.apache.org > Subje

Re: sandbox gendoc

2006-01-12 Thread Kevin Jackson
> what does (sp?) means in this context? > Sorry, it means I wasn't sure I got the spelling of your name right. > Well, it's hardly official in any way, but it's a start. Note though > that there were objections regarding the verbosity of schema chosen, > which I tried to address in another versi

Re: sandbox gendoc

2006-01-12 Thread cstrong
>> Yes, DocBook, also a standard, is indeed very verbose and doesn't seem >> to have the favor among commiters. > > I think think docbook is interesting but something that should be hidden > from users by a docbook editor, not handwritten. Also its too low-level; > I want to mark something as a , n

Re: sandbox gendoc

2006-01-12 Thread Steve Loughran
Dominique Devienne wrote: I've had a look through the sandbox and I noticed Dominique's (sp?) xml'd version of the docs. what does (sp?) means in this context? probably (spelling?) As you know I had a play with DocBook-izing the manual last year and in the end the effort of manually alt

Re: sandbox gendoc

2006-01-12 Thread Dominique Devienne
> I've had a look through the sandbox and I noticed Dominique's (sp?) xml'd > version of the docs. what does (sp?) means in this context? > 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 d