Re: Adding since-version tags to the docs? - Mailing list pgsql-hackers

From Tom Lane
Subject Re: Adding since-version tags to the docs?
Date
Msg-id 4575.1441029671@sss.pgh.pa.us
Whole thread Raw
In response to Adding since-version tags to the docs?  ("Shulgin, Oleksandr" <oleksandr.shulgin@zalando.de>)
Responses Re: Adding since-version tags to the docs?  ("Shulgin, Oleksandr" <oleksandr.shulgin@zalando.de>)
List 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 by date:

Previous
From: YUriy Zhuravlev
Date:
Subject: Re: WIP: About CMake v2
Next
From: Michael Paquier
Date:
Subject: Re: Commitfest remaining "Needs Review" items