Re: tables on pgbench man page look garbled - Mailing list pgsql-docs

From Daniel Gustafsson
Subject Re: tables on pgbench man page look garbled
Date
Msg-id FF518719-DC91-45ED-BF66-9F432F1D2624@yesql.se
Whole thread Raw
In response to Re: tables on pgbench man page look garbled  (Daniel Gustafsson <daniel@yesql.se>)
List pgsql-docs
> 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




pgsql-docs by date:

Previous
From: Daniel Gustafsson
Date:
Subject: Re: tables on pgbench man page look garbled
Next
From: PG Doc comments form
Date:
Subject: pg_basebackup application does not dump all database objects