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

2011-04-03 Thread Robert Haas
On Sat, Apr 2, 2011 at 3:31 AM, Susanne Ebrecht  wrote:
>>> 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.
>>
>
> Here is the patch for removing the whole sentence.

Hmm... this actually removes two sentences.  I've committed the
removal of the one we talked about; I don't particularly see any
reason to remove the following one also.

-- 
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] psql's \h MOVE

2011-04-03 Thread Robert Haas
On Sat, Apr 2, 2011 at 12:53 PM, Tom Lane  wrote:
> Alvaro Herrera  writes:
>> I just noticed that \h MOVE is particularly unhelpful:
>>       alvherre=# \h move
>>       Command:     MOVE
>>       Description: position a cursor
>>       Syntax:
>>       MOVE [ direction { FROM | IN } ] cursorname
>
>> The problem is that it doesn't specify what "direction" is.  The doc
>> text tells you to look into FETCH for details, but in \h you have to
>> guess.
>
>> We could fix this by including a note about fetch in the ,
>> so that it'd look like this:
>
>>       alvherre=# \h move
>>       Command:     MOVE
>>       Description: position a cursor
>>       Syntax:
>>       MOVE [ direction [ FROM | IN ] ] cursor_name
>
>>       See FETCH for details on direction
>
> -1 ... if this annoys you, just duplicate the definition of direction
> from FETCH.

+1 for duplicating the definition.

-- 
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] Migration page is out of date

2011-04-03 Thread Robert Haas
On Tue, Mar 22, 2011 at 12:56 PM, Josh Berkus  wrote:
> http://www.postgresql.org/docs/9.0/static/migration.html
>
> This page:
>
> a) has insufficient coverage of pg_upgrade
> b) ignores parallel pg_restore
> c) piping pg_dump is by no means always the fastest method
>
> I'll write up a new version later, just wanted to put this note on the
> ML so that somebody would bug me before the end of 9.1 beta.

Hey, you!

-- 
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