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

From Andres Freund
Subject Re: Adding since-version tags to the docs?
Date
Msg-id 20150831133029.GV31526@awork2.anarazel.de
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
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?

Greetings,

Andres Freund



pgsql-hackers by date:

Previous
From: Alexander Korotkov
Date:
Subject: Re: Commitfest remaining "Needs Review" items
Next
From: Andres Freund
Date:
Subject: Re: Commitfest remaining "Needs Review" items