Re: Cannot - Mailing list pgsql-hackers

From Andrew Dunstan
Subject Re: Cannot
Date
Msg-id 4EA879B0.8050607@dunslane.net
Whole thread Raw
In response to Re: Cannot  ("David E. Wheeler" <david@kineticode.com>)
List pgsql-hackers

On 10/26/2011 05:15 PM, David E. Wheeler wrote:
> On Oct 26, 2011, at 2:06 PM, Andrew Dunstan wrote:
>
>>> Suggested doc “patch”:
>>>
>>>      grep -lri 'can not' doc | xargs perl -i -pe 's/can not/cannot/g'
>> Why? "can not" is perfectly grammatical AFAIK.
> True, but there's a logic issue. Take this example from doc/src/sgml/func.sgml:
>
>>     <para>
>>       <function>pg_advisory_xact_lock</>  works the same as
>>       <function>pg_advisory_lock</>, expect the lock is automatically released
>>       at the end of the current transaction and can not be released explicitly.
>>      </para>
> I read this as equivalent to "can be not released." Which of course is silly, so as I read it I realize what it
means,but it trips up my overly logical brain. It interrupts the flow. There is no such confusion in "cannot be
released"and thus no tripping up on meaning.
 
>
>

Here's what I would do:

1. s/expect/except that/

2. s/can not be released explicitly/can not be explicitly released/

cheers

andrew



pgsql-hackers by date:

Previous
From: "David E. Wheeler"
Date:
Subject: Re: Cannot
Next
From: Tom Lane
Date:
Subject: Re: Cannot