Re: Can extension build own SGML document? - Mailing list pgsql-hackers

From Tom Lane
Subject Re: Can extension build own SGML document?
Date
Msg-id 22642.1442324622@sss.pgh.pa.us
Whole thread Raw
In response to Re: Can extension build own SGML document?  (Jim Nasby <Jim.Nasby@BlueTreble.com>)
Responses Re: Can extension build own SGML document?
Re: Can extension build own SGML document?
List pgsql-hackers
Jim Nasby <Jim.Nasby@BlueTreble.com> writes:
> I'm not sure SGML is the way to go anymore anyways. Asciidoc offers a 
> lot of what our SGML does in a much easier to support toolchain. It's 
> also natively supported by github, which makes it nice for others to 
> view the output (see [1] as an exmaple). If asciidoc isn't powerful 
> enough for what you need you can switch to asciidoctor which is even 
> more powerful[2].

AFAICT from a quick look at its documentation, asciidoc can produce
either html or docbook output; so as soon as you want something other
than html output (in particular, PDF), you're back to relying on the
exact same creaky docbook toolchain we use now.  Only with one extra
dependency in front of it.

Personally I never look at anything but the HTML rendering, but I doubt
that dropping support for all other output formats would fly :-(

I do agree that the SGML toolchain is getting pretty long in the tooth
and we need to be looking for something else.
        regards, tom lane



pgsql-hackers by date:

Previous
From: Jan Wieck
Date:
Subject: Re: [COMMITTERS] pgsql: Fix an O(N^2) problem in foreign key references.
Next
From: Tom Lane
Date:
Subject: Re: Could the configure script detect the endianness for a Power CPU with endianness mode change