Re: documentation is now XML

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>, pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: documentation is now XML
Date: 2018-01-24 00:59:24
Message-ID: 20180124005924.GD26207@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Thu, Nov 23, 2017 at 03:39:24PM -0500, Tom Lane wrote:
> Also, we're way overdue for getting out from under the creaky TeX-based
> toolchain for producing PDFs. Every time we make releases, I worry
> whether we're going to get blindsided by its bugs with hotlinks that get
> split across pages, since page breaks tend to vary in position depending
> on exactly whose version of the toolchain and style sheets you build with.
> I've also been living in fear of the day we hit some hardwired TeX limit
> that we can't increase or work around. We've had to hack around such
> limits repeatedly in the past (eg commit 944b41fc0). Now, it's probably
> unlikely that growth of the release notes would be enough to put us over
> the top in any back branch --- but if it did happen, we'd find out about
> it at a point in the release cycle where there's very little margin for
> error.

I am coming in late here, but I am not aware of any open source
professional typesetting software that has output quality as good as
TeX.

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ As you are, so once was I. As I am, so you will be. +
+ Ancient Roman grave inscription +

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Tsunakawa, Takayuki 2018-01-24 01:07:53 RE: [HACKERS][PATCH] Applying PMDK to WAL operations for persistent memory
Previous Message Tom Lane 2018-01-24 00:42:25 Re: [PATCH] fix for C4141 warning on MSVC