Re: Adding since-version tags to the docs?

On Mon, Aug 31, 2015 at 3:30 PM, Andres Freund <andres(at)anarazel(dot)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