Re: [PATCH] Largeobject Access Controls (r2432)

Robert Haas wrote:
> On Thu, Dec 3, 2009 at 12:49 PM, Jaime Casanova
> <jcasanov@systemguards.com.ec> wrote:
>   
>> This manual will be specific for 8.5 so i think all mentions to the
>> version should be removed
>>     
>
> Not sure I agree on this point.  We have similar mentions elsewhere.
>   
In this particular example, it's bad form because it's even possible 
that 8.5 will actually be 9.0.  You don't want to refer to a version 
number that doesn't even exist for sure yet, lest it leave a loose end 
that needs to be cleaned up later if that number is changed before release.

Rewriting in terms like "in earlier versions..." instead is one 
approach.  Then people will have to manually scan earlier docs to sort 
that out, I know I end up doing that all the time.  If you want to keep 
the note specific, saying "in 8.4 and earlier versions [old behavior]" 
is better than "before 8.5 [old behavior]" because it only mentions 
version numbers that are historical rather than future.

-- 
Greg Smith    2ndQuadrant   Baltimore, MD
PostgreSQL Training, Services and Support
greg@2ndQuadrant.com  www.2ndQuadrant.com