Re: [PATCHES] doc patch for savepoints - Mailing list pgsql-hackers

From Joshua D. Drake
Subject Re: [PATCHES] doc patch for savepoints
Date
Msg-id 1164670020.6398.31.camel@localhost.localdomain
Whole thread Raw
In response to Re: [PATCHES] doc patch for savepoints  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-hackers
On Mon, 2006-11-27 at 17:58 -0500, Tom Lane wrote:
> "Joshua D. Drake" <jd@commandprompt.com> writes:
> > On Mon, 2006-11-27 at 17:48 -0500, Tom Lane wrote:
> >> I do not see the point of this.  Shall we put equivalent disclaimers
> >> into every single construct that consumes shared memory?
>
> > Stating that it uses shared memory? Absolutely. Stating that you may run
> > out? No, ...
>
> Well, the fact that it uses shared memory is an uninteresting
> implementation detail --- at least, it's uninteresting until you run
> out.  When/if that happens, ISTM the error message and HINT are plenty
> good enough to tell you what to do about it.  If we tried to document
> every possible error message and appropriate corrective action for same
> the docs would become bloated to the point of unreadability.  So to me
> the question is why this particular case deserves a paragraph of its own.

I would agree that it likely does not need a paragraph on its own.

Hmm... but a shared memory reference page? Something that says, "What
uses shared memory with PostgreSQL?" That might be useful.

Sincerely,

Joshua D. Drake


>
>             regards, tom lane
>
--

      === The PostgreSQL Company: Command Prompt, Inc. ===
Sales/Support: +1.503.667.4564 || 24x7/Emergency: +1.800.492.2240
Providing the most comprehensive  PostgreSQL solutions since 1997
             http://www.commandprompt.com/

Donate to the PostgreSQL Project: http://www.postgresql.org/about/donate




pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: [PATCHES] doc patch for savepoints
Next
From: Tom Lane
Date:
Subject: Re: Configuring BLCKSZ and XLOGSEGSZ (in 8.3)