RE: [Fwd: [Fwd: First Open Source Documentation Summit at the O'Reilly Open Source Convention]]

[Gregory Leblanc <GLeblanc@cu-portland.edu>]

> -----Original Message-----
> From: Guylhem Aznar [mailto:guylhem@bigfoot.com]
> Sent: Wednesday, July 19, 2000 6:10 AM
> To: Stephane Bortzmeyer
> Cc: Camille Bégnis; docbook-apps; LDP; docbook-tools list
> Subject: Re: [Fwd: [Fwd: First Open Source Documentation Summit at the
> O'Reilly Open Source Convention]]
> 
> On Wed, Jul 19, 2000 at 10:55:38AM +0200, Stephane Bortzmeyer wrote:
> > > Do you use something else?
> > 
> > For smaller DTDs, I developed my own XML->LaTeX translator.
> 
> The LDP currently uses its own set of tools, the linuxdoctools
> (the former sgmltools1) since docbook is not considered ready to use.

WHAT?!?!?!?  DocBook is in use for quite a few of the LDP documents.  The
LDP Author Guide, the Cable-Modem HOWTO, the Linux FAQ, and others.  These
are all DocBook native documents.  We have satisfactory output for all of
the formats that we could produce from Linuxdoc, although we're still making
improvements.  

> It's easier to add what we want in working tools (sgml2pdf, 
> sgml2rpm for
> ex) than waiting on docbook to be usable by each of our authors.

The tools work fine on metalab where the processing is done, and for the
most part, are easy to get running using the instructions in the LAG.  You
need to go read that, and keep up on the LDP list a little better.

> However, we have a team working on the docbook integration within the
> LDP (docbooktools), and we provide docbook output from the current
> linuxdoctools documents.

Yes, and this team will continue to be in existence for a very long time, as
long as we're still using DocBook.  Things will evolve, and we'll have to
change the tools to make things better.  

> In the future, when docbook will be considered ready for 
> production use
> we will support both linuxdoctools and docbooktools, after 
> which all our
> documents will be in docbook.

We support both RIGHT NOW, and all of our documents are available in
DocBook.  The documents written in Linuxdoc are run through a primitive
conversion script that creates DocBook from that, in order to make it easier
for authors to make the transition to DocBook.

> Docbook documents are already accepted, but they are 
> separated from the
> linuxdoc HOWTOs.

Not really, they're part of the LDP repository just like everything else.
They have the same output formats available as the LinuxDoc HOWTOs, so for
the end user, they are the same.
	Grego


--  
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org