Content-Type: text/plain;
	charset=us-ascii
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3696.120.41.1.3\))
Subject: Re: tables on pgbench man page look garbled
From: Daniel Gustafsson <daniel@yesql.se>
In-Reply-To: <68F02709-4027-4BF4-8666-ECDAE94655AB@yesql.se>
Date: Mon, 15 May 2023 14:35:36 +0200
Cc: Peter Eisentraut <peter.eisentraut@enterprisedb.com>,
 pgsql-docs <pgsql-docs@postgresql.org>
Content-Transfer-Encoding: quoted-printable
Message-Id: <FF518719-DC91-45ED-BF66-9F432F1D2624@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>
To: Tom Lane <tgl@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/FF518719-DC91-45ED-BF66-9F432F1D2624%40yesql.se>
Precedence: bulk

> On 10 May 2023, at 22:08, Daniel Gustafsson <daniel@yesql.se> wrote:
>=20
>> On 10 May 2023, at 17:35, Tom Lane <tgl@sss.pgh.pa.us> wrote:
>>=20
>> 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.
>>=20
>> Hmm, any chance of addressing this by expanding out the relevant =
macros?
>=20
> 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