Re: Adding since-version tags to the docs?

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
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 14:01:11
Message-ID: 4575.1441029671@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

"Shulgin, Oleksandr" <oleksandr(dot)shulgin(at)zalando(dot)de> writes:
> 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.
> 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".

TBH, I think this is a horrid idea. We occasionally manually add remarks
like "since version x.y, Postgres does this". Inevitably, that just bulks
up the documentation; and it starts to look seriously silly in a few years
when x.y and all its predecessors are out of support. It'll be a real
mess if we do that for everything.

There might be a use-case for a table of this sort somewhere, but please
not in the main documentation.

regards, tom lane

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Michael Paquier 2015-08-31 14:04:25 Re: Commitfest remaining "Needs Review" items
Previous Message YUriy Zhuravlev 2015-08-31 13:57:04 Re: WIP: About CMake v2