Re: tables on pgbench man page look garbled

Поиск
Список
Период
Сортировка
От Daniel Gustafsson
Тема Re: tables on pgbench man page look garbled
Дата
Msg-id FF518719-DC91-45ED-BF66-9F432F1D2624@yesql.se
обсуждение исходный текст
Ответ на Re: tables on pgbench man page look garbled  (Daniel Gustafsson <daniel@yesql.se>)
Список 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 по дате отправления:

Предыдущее
От: Daniel Gustafsson
Дата:
Сообщение: Re: tables on pgbench man page look garbled
Следующее
От: PG Doc comments form
Дата:
Сообщение: pg_basebackup application does not dump all database objects