Re: create_help.pl treats as replaceable

Поиск
Список
Период
Сортировка
От Tom Lane
Тема Re: create_help.pl treats as replaceable
Дата
Msg-id 17623.1652891345@sss.pgh.pa.us
обсуждение исходный текст
Ответ на Re: create_help.pl treats as replaceable  (Peter Eisentraut <peter.eisentraut@enterprisedb.com>)
Ответы Re: create_help.pl treats as replaceable  (Peter Eisentraut <peter.eisentraut@enterprisedb.com>)
Список pgsql-hackers
Peter Eisentraut <peter.eisentraut@enterprisedb.com> writes:
> On 17.05.22 17:09, Tom Lane wrote:
>> Isn't that a documentation bug rather than a problem with create_help?

> Yeah, there is no need for a <literal> inside a <synopsis>.  So I just 
> removed it.

I think you should have upper-cased MATCH while at it, to make it clear
that it acts like a keyword in this context.  The current situation is
quite unreadable in plain-ASCII output:

regression=# \help copy
Command:     COPY
...
    HEADER [ boolean | match ]
...

Since "boolean" is a metasyntactic variable here, it's absolutely
not obvious that "match" isn't.

            regards, tom lane



В списке pgsql-hackers по дате отправления:

Предыдущее
От: Peter Eisentraut
Дата:
Сообщение: Re: create_help.pl treats as replaceable
Следующее
От: Alvaro Herrera
Дата:
Сообщение: Re: support for MERGE