From: Daniel Gustafsson <daniel@yesql.se>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
Cc: pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: tables on pgbench man page look garbled
Date: Mon, 15 May 2023 14:35:36 +0200
Message-ID: <FF518719-DC91-45ED-BF66-9F432F1D2624@yesql.se> (raw)
In-Reply-To: <68F02709-4027-4BF4-8666-ECDAE94655AB@yesql.se>
References: <3e17d64b-863d-aa8d-334d-0d857e571b63@enterprisedb.com>
<DA328B59-64EC-499B-AD6C-03FC0073DBD0@yesql.se>
<f574fa79-d56c-2c99-f623-8d965833eb5d@enterprisedb.com>
<EABCE89B-3A6D-4D9D-B2A3-FCF7C801C74D@yesql.se>
<894867.1683732908@sss.pgh.pa.us>
<68F02709-4027-4BF4-8666-ECDAE94655AB@yesql.se>
> On 10 May 2023, at 22:08, Daniel Gustafsson <daniel@yesql.se> wrote:
>
>> On 10 May 2023, at 17:35, Tom Lane <tgl@sss.pgh.pa.us> wrote:
>>
>> Daniel Gustafsson <daniel@yesql.se> writes:
>>> I took a look at this using macOS as the initial testbed; the TLDR is that
>>> mandoc doesn't support macros in tables, and our single-column function
>>> signature tables rely on that. macOS switched to mandoc in v11 I think, but I
>>> don't have an older box handy to doublecheck.
>>
>> Hmm, any chance of addressing this by expanding out the relevant macros?
>
> Maybe, but I'm not too optimistic about that since I was unable to coerce
> mandoc into accepting any form of explicit linebreaks in T{T} text blocks.
Having spent some more time on this I've been unsuccessful in getting anything
to look better than the originally proposed diff upthread; which is far from
good but a) better than the current garbled output and b) fixes the warnings
from mandoc. Not sure how to make progress on this.
--
Daniel Gustafsson
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: pgsql-docs@postgresql.org
Cc: daniel@yesql.se, tgl@sss.pgh.pa.us, peter.eisentraut@enterprisedb.com
Subject: Re: tables on pgbench man page look garbled
In-Reply-To: <FF518719-DC91-45ED-BF66-9F432F1D2624@yesql.se>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox