Re: BUG #2870: incorrect man page for postgres

From: "Dmitry D(dot) Khlebnikov" <galaxy(at)openwall(dot)com>
To: Euler Taveira de Oliveira <euler(at)timbira(dot)com>
Cc: pgsql-bugs(at)postgresql(dot)org
Subject: Re: BUG #2870: incorrect man page for postgres
Date: 2007-01-04 00:24:11
Message-ID: 20070104002411.GA24998@openwall.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-bugs

Euler,

On Wed, Jan 03, 2007 at 09:50:15PM -0200, Euler Taveira de Oliveira wrote:
> Dmitry D. Khlebnikov wrote:
>
> > The man page for postgres(1) has a wrong description of the '-S' option.
> > Previously, the '-S' option means that postgres will start in the 'silent'
> > mode, but in version 8.2 the '-S' option describes the amount of memory for
> > sorts.
> >
> I think you change the order, in 8.1 -S option describes the amount of
> memory but in 8.2 it describes the silent mode. This is because there

Perhaps. However, when I tried to follow the man page and run
'postgres' with '-S' it responded with:

db!pgsql:~$ postgres --version
postgres (PostgreSQL) 8.2.0
db!pgsql:~$ postgres -D /var/lib/pgsql -S
postgres: option requires an argument -- S
Try "postgres --help" for more information.
db!pgsql:~$ postgres --help | fgrep -- -S
-S WORK-MEM set amount of memory for sorts (in kB)
db!pgsql:~$ zcat /usr/share/man/man1/postgres.1.gz | fgrep -A 3 -- -S
\fB-S\fR
Specifies that the \fBpostgres\fR
process should start up in silent mode. That is, it will
disassociate from the user's (controlling) terminal, start its
db!pgsql:~$

All in all, I don't know how it was in the previous versions of
PostgreSQL (I was using 7.x versions), I just merely want to point out
that the man page provides the incorrect information wrt the '-S'
option.

--
(GM)

In response to

Browse pgsql-bugs by date

  From Date Subject
Next Message Tom Lane 2007-01-04 01:02:34 Re: BUG #2870: incorrect man page for postgres
Previous Message Euler Taveira de Oliveira 2007-01-03 23:50:15 Re: BUG #2870: incorrect man page for postgres