Re: Adding since-version tags to the docs?

On Mon, Aug 31, 2015 at 3:30 PM, Andres Freund <andres@anarazel.de> wrote:

Hi,

On 2015-08-31 13:06:04 +0200, Shulgin, Oleksandr wrote:
> 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.

Same here. Not sure how to display it without getting disturbing the
'flow' of the docs too much though.

> 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".
> Such a script could start by checking out REL9_0_STABLE and looking through
> all symbols it can find, tagging them "Since 9.0".  Then it could commit
> the result, check out the next version branch and apply said commit (some
> manual effort to merge it might be required), and repeat the process,
> assuming all newly found symbols must be introduced in this new version.

I doubt that this can easily be done automatedly. But it'd be cool if
so.

Perhaps we could start doing it going forward?