| 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: | Whole Thread | Raw Message | 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 |