Skip site navigation (1) Skip section navigation (2)

Re: [pgsql-www] 8.1 PDF Documentation.

From: Alvaro Herrera <alvherre(at)commandprompt(dot)com>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>
Cc: pgsql-docs(at)postgresql(dot)org, Bruce Momjian <pgman(at)candle(dot)pha(dot)pa(dot)us>
Subject: Re: [pgsql-www] 8.1 PDF Documentation.
Date: 2005-11-15 15:30:12
Message-ID: 20051115153012.GD5868@surnet.cl (view raw or flat)
Thread:
Lists: pgsql-docspgsql-www
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.

In response to

pgsql-docs by date

Next:From: Stephan FischerDate: 2005-11-15 16:21:26
Subject: [postgres] pgcluster
Previous:From: Peter EisentrautDate: 2005-11-15 15:08:08
Subject: Re: [pgsql-www] 8.1 PDF Documentation.

pgsql-www by date

Next:From: Josh BerkusDate: 2005-11-15 18:11:05
Subject: Re: GUI guide
Previous:From: Peter EisentrautDate: 2005-11-15 15:08:08
Subject: Re: [pgsql-www] 8.1 PDF Documentation.

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group