Re: Adding since-version tags to the docs?

Поиск
Список
Период
Сортировка
От Tom Lane
Тема Re: Adding since-version tags to the docs?
Дата
Msg-id 4575.1441029671@sss.pgh.pa.us
обсуждение исходный текст
Ответ на Adding since-version tags to the docs?  ("Shulgin, Oleksandr" <oleksandr.shulgin@zalando.de>)
Ответы Re: Adding since-version tags to the docs?  ("Shulgin, Oleksandr" <oleksandr.shulgin@zalando.de>)
Список pgsql-hackers
"Shulgin, Oleksandr" <oleksandr.shulgin@zalando.de> writes:
> I often find it pity that our docs are missing any information on since
> when a certain GUC setting, SQL-level command or function was introduced.
> It would be nice if we could make a script that would parse the sgml files
> and for every symbol it finds it would add a tag like "Since version 9.x".

TBH, I think this is a horrid idea.  We occasionally manually add remarks
like "since version x.y, Postgres does this".  Inevitably, that just bulks
up the documentation; and it starts to look seriously silly in a few years
when x.y and all its predecessors are out of support.  It'll be a real
mess if we do that for everything.

There might be a use-case for a table of this sort somewhere, but please
not in the main documentation.
        regards, tom lane



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

Предыдущее
От: YUriy Zhuravlev
Дата:
Сообщение: Re: WIP: About CMake v2
Следующее
От: Michael Paquier
Дата:
Сообщение: Re: Commitfest remaining "Needs Review" items