Re: pg_standby supported versions - Mailing list pgsql-docs

From Mark Kirkwood
Subject Re: pg_standby supported versions
Date
Msg-id 492EED49.6060707@paradise.net.nz
Whole thread Raw
In response to Re: pg_standby supported versions  (Simon Riggs <simon@2ndQuadrant.com>)
List pgsql-docs
Simon Riggs wrote:
> On Wed, 2008-11-26 at 22:14 +1300, Mark Kirkwood wrote:
>
>>
>> Exactly, after posting this I discovered the relevant CVS logs for
>> changes to support restartable recovery. It seems to me that perhaps a
>> little more detail in the docs would be good here.
>>
>
> I would hope that the complete absence of anything would be all that is
> required to dissuade people. We don't ever update the docs to say "BTW
> feature X is not supported until next release". Not sure we should start
> now.
>
>

While I understand, I also think it is perfectly reasonable to clarify
why a specific minimum version is being recommended. To me this conforms
to the open source spirit of telling folk why something is true, as
opposed to stating that it is.

I'm thinking of something like:

<para>

pg_standby is designed to work with PostgreSQL 8.2 and later, as it
requires the ability to interrupt and restart recovery (absent in
earlier server versions).

</para>

pgsql-docs by date:

Previous
From: Simon Riggs
Date:
Subject: Re: pg_standby supported versions
Next
From: Peter Eisentraut
Date:
Subject: contact details in contrib module documentation