Re: Re: No printable 7.1 docs?

From: Thomas Lockhart <lockhart(at)alumni(dot)caltech(dot)edu>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: lockhart(at)fourpalms(dot)org, Christopher Masto <chris+pg-hackers(at)netmonger(dot)net>, pgsql-hackers(at)postgresql(dot)org
Subject: Re: Re: No printable 7.1 docs?
Date: 2001-04-17 16:16:39
Message-ID: 3ADC6C67.C9DB1074@alumni.caltech.edu
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

> It seems to me that all of the other problems you enumerate are simply
> bugs in the doc toolchain. We've worked around them rather than tried
> to fix them because that was the shortest path to a result, but if Chris
> wants to tackle actually fixing them, that would sure be nice. Based on
> your comments here, my recommendation would be to forget RTF entirely;
> instead, work on getting out the kinks in the TeX pathway.

That is at odds with the current thinking of the jade/dsssl community
(which uses both TeX and RTF), but if someone wants to try it would not
hurt I suppose.

The problem with TeX output is that it is *not* adjustable after the
fact, and that the jade support for things like tables is not adequate
for a real-world document. The jadetex author had concluded that really
fixing it was too much work. Many of the original development community
has moved on to XML tools development, but afaik none are ready for use.

One might want to research the current state of the tools as a starting
point for improvements. At the moment, I'd love someone to dive in to
the RTF reference page problem; I can send samples on request :)

- Thomas

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Jeroen Habets 2001-04-17 16:38:20 Modified driver to better handle NULL values...
Previous Message Peter Eisentraut 2001-04-17 16:15:16 Re: Re: No printable 7.1 docs?