Re: pgsql: Improve wording. - Mailing list pgsql-hackers

From Alvaro Herrera
Subject Re: pgsql: Improve wording.
Date
Msg-id 20071218123251.GD5319@alvh.no-ip.org
Whole thread Raw
Responses Re: pgsql: Improve wording.  (Martijn van Oosterhout <kleptog@svana.org>)
Re: pgsql: Improve wording.  (Bruce Momjian <bruce@momjian.us>)
List pgsql-hackers
Martijn van Oosterhout wrote:
> On Mon, Dec 17, 2007 at 01:48:31PM +0000, Alvaro Herrera wrote:
> > Log Message:
> > -----------
> > Improve wording.

> I'd suggest removing everything between the parentheses, or perhaps
> something like: By tracking allocated memory  rather than used memory
> it removes the possibilty of failing in a page fault. This option also
> require you allocate enoghh swap to cover all possible eventualities,
> though in production it will not be used.

I agree that the parenthised phrase should be removed.

http://developer.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/runtime.sgml?r1=1.387&r2=1.391

I think your proposed wording is removed enough from what the
complainant was saying that it is not worth to stick it in.  The point
here is, to what extent do we want to spoon-feed careless sysadmins?

-- 
Alvaro Herrera                                http://www.CommandPrompt.com/
The PostgreSQL Company - Command Prompt, Inc.


pgsql-hackers by date:

Previous
From: Gregory Stark
Date:
Subject: Re: EXPLAIN ANALYZE printing logical and hardware I/O per-node
Next
From: peter.trautmeier@gmx.de
Date:
Subject: Re: ecxt_scantuple has wrong TupleDesc