Re: Adding since-version tags to the docs?

From: Andres Freund <andres(at)anarazel(dot)de>
To: "Shulgin, Oleksandr" <oleksandr(dot)shulgin(at)zalando(dot)de>
Cc: PostgreSQL Hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Adding since-version tags to the docs?
Date: 2015-08-31 13:30:29
Message-ID: 20150831133029.GV31526@awork2.anarazel.de
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: 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

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Andres Freund 2015-08-31 13:31:34 Re: Commitfest remaining "Needs Review" items
Previous Message Alexander Korotkov 2015-08-31 13:22:54 Re: Commitfest remaining "Needs Review" items