Re: doc: where best to add ~ 400 words to the manual?

Поиск
Список
Период
Сортировка
От Chapman Flack
Тема Re: doc: where best to add ~ 400 words to the manual?
Дата
Msg-id 5C382766.2080409@anastigmatix.net
обсуждение исходный текст
Ответ на Re: doc: where best to add ~ 400 words to the manual?  (Chapman Flack <chap@anastigmatix.net>)
Ответы House style for DocBook documentation?  (Chapman Flack <chap@anastigmatix.net>)
Список pgsql-hackers
On 01/10/19 23:48, Chapman Flack wrote:
> On 12/30/18 22:23, Chapman Flack wrote:
> (3) seems to be supported by (the only) precedent, the "Limits and
> Compatibility" sect3 within functions-posix-regexp.
> 
> So, absent objection, I'll work on a Limits and Compatibility sect2
> within functions-xml.

One fly in the ointment: tables of contents seem to list sect1 and sect2
elements, but not sect3. So the "Limits and Compatibility" sect3 under
functions-posix-regexp does not clutter the overall "Functions and
Operators" ToC, but a "Limits and Compatibility" sect2 under
functions-xml would be visible there. Tucking it as a sect3 within an
existing sect2 would prevent that, but it is common information that
pertains to more than one of them, so that doesn't seem quite right.

Or is it ok to have a "Limits and Compatibility" visible in the ToC
under XML Functions?

-Chap


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

Предыдущее
От: Haribabu Kommi
Дата:
Сообщение: Re: What to name the current heap after pluggable storage / what to rename?
Следующее
От: "Imai, Yoshikazu"
Дата:
Сообщение: RE: speeding up planning with partitions