Re: documentation structure

Поиск
Список
Период
Сортировка
От David G. Johnston
Тема Re: documentation structure
Дата
Msg-id CAKFQuwZhikLAfG9ntU-611adW0AnnPFJ_wx7Hy3Lb_v7M7x27Q@mail.gmail.com
обсуждение исходный текст
Ответ на Re: documentation structure  (Tatsuo Ishii <ishii@postgresql.org>)
Ответы Re: documentation structure
Re: documentation structure
Список pgsql-hackers
Дерево обсуждения
On Thu, Jul 18, 2024 at 8:06 PM Tatsuo Ishii <ishii@postgresql.org> wrote:
> I'm opposed to having a separate file for every function. I think
> breaking up func.sgml into one piece per sect1 is about right. If that
> proves cumbersome still we can look at breaking it up further, but
> let's start with that.

That will create at least 30 func-xx.sgml files.

t-ishii$ grep '<sect1' func.sgml|wc -l
30

I am afraid that's too many?


The premise and the resultant number of files both seem reasonable to me.  I could get that number down to maybe 20 if pressed but I don't see any benefit to doing so. I look at a page on the website that needs updating then go open its source file.  Nice and tidy.

David J.

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

Предыдущее
От: Alexander Lakhin
Дата:
Сообщение: Re: Should consider materializing the cheapest inner path in consider_parallel_nestloop()
Следующее
От: Etsuro Fujita
Дата:
Сообщение: Re: d844cd75a and postgres_fdw