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
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 |