Re: [DOCS] English Grammar question

2011-03-31 Thread Robert Haas 
On Wed, Mar 30, 2011 at 4:18 AM, Heikki Linnakangas
 wrote:
> On 30.03.2011 11:08, Susanne Ebrecht wrote:
>>
>> Hello,
>>
>> during translation the history.sgml - I found the following sentences in
>>
>> http://www.postgresql.org/docs/9.0/static/history.html
>>
>> "The design of the rule system at that time was described in /The design
>> of the POSTGRES rules system/
>> . The
>> rationale and architecture of the storage manager were detailed in /The
>> design of the POSTGRES storage system
>> /"
>>
>> I am not sure if the grammar is correct here.
>>
>> My feeling says it should be:
>>
>> "is decribed" and "are detailed" instead of "was and were"
>>
>> I am pretty sure these books still exist.
>
> Both would be correct, but with a slightly different meaning. What it means
> now is that someone wrote a description of (= described) the design in that
> book. If you change it to "is described", it means that there is a
> description on the (old) design, with nothing said about when the
> description was written.

I think this is a correct analysis of grammar - both are correct, with
slightly different meanings.  I actually find both phrasings a bit
awkward, though.  What we're really trying to do here is provide the
links, but that is sometimes better done in a footnote or bibliography
than in the middle of a body of text.

-- 
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

Re: [DOCS] found a very confusing and maybe outdated sentence

2011-03-31 Thread Robert Haas 
On Tue, Mar 29, 2011 at 3:07 PM, Susanne Ebrecht
 wrote:
> Hello,
>
> It is in start.sgml. You can see it here:
>
> http://www.postgresql.org/docs/9.0/static/tutorial-accessdb.html
>
> The last two sentences on the page:
>
> " If PostgreSQL is installed correctly you can also
> type man psql at the operating system shell prompt
> to see the documentation. In this tutorial we will not
> use these features explicitly, but you can use them
> yourself when it is helpful."
>
> Isn't that totally outdated?
>
> Is "man" really working on Windows?
>
> Also the sentence says that the whole product isn't correct
> installed just because docs aren't installed. Which also isn't
> really true.
>
> Honesty, I just would like to drop the whole sentences.
>
> What do you think?

+1 for deleting the entire sentence.

-- 
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

[DOCS] typofix for sysv_shmem.c

2011-03-31 Thread Josh Kupershmidt 
Fixing two missing spaces in messages from sysv_shmem.c

Josh


sysv_shmem.diff
Description: Binary data

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs