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

From Shulgin, Oleksandr
Subject Re: Adding since-version tags to the docs?
Date
Msg-id CACACo5Ra-RHK_sRCZG1GP=TX5ugZ0mPbeq-nNmn56NXsEoWHBw@mail.gmail.com
Whole thread Raw
In response to Re: Adding since-version tags to the docs?  (Andres Freund <andres@anarazel.de>)
List pgsql-hackers
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.

I'll try to see if that's feasible. :-)

Perhaps we could start doing it going forward?

I would be all for that.

--
Alex

pgsql-hackers by date:

Previous
From: "Shulgin, Oleksandr"
Date:
Subject: Re: Adding since-version tags to the docs?
Next
From: YUriy Zhuravlev
Date:
Subject: Re: WIP: About CMake v2