public inbox for [email protected]  

help / color / mirror / Atom feed

From: Alvaro Herrera <[email protected]>
To: Peter Eisentraut <[email protected]>
Cc: [email protected]
Cc: Bruce Momjian <[email protected]>
Subject: Re: [pgsql-www] 8.1 PDF Documentation.
Date: Tue, 15 Nov 2005 12:30:12 -0300
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>

Peter Eisentraut wrote:
> Am Dienstag, 15. November 2005 12:23 schrieb Alvaro Herrera:
> > There is no SGML toolchain because SGML has been abandoned as the
> > DocBook markup language.  The toolchain that everybody else uses is
> > based on XML DocBook.  It has been proposed that we abandon SGML and
> > jump to XML, but the idea has been shot down.  And it's possible to
> > convert our SGML to XML automatically and process it with the newer
> > toolchain.
> 
> Oh, what is this stable and mature DocBook XML to print output conversion tool 
> that you seem to be referring to?

I'm not saying there's any -- I'm just saying nobody else uses SGML.

That said, I just looked at a Gnome book that is published as PDF and
written using XML DocBook, and they seem to use "docbook2pdf" which in
turns appears to be this:

http://sourceware.org/docbook-tools/

One drawback that I can see in that book is that the HTML pages do not
have the nice names our current docs have.  Not sure if that's an
inherent property of the XML tools.

That said, I don't have much interest in messing with all this.
Personally I'm pretty happy using the HTML docs (I even read the SGML
directly at times.)

-- 
Alvaro Herrera                                http://www.CommandPrompt.com/
The PostgreSQL Company - Command Prompt, Inc.

view thread (18+ messages)

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected]
  Subject: Re: [pgsql-www] 8.1 PDF Documentation.
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox