pg.ddx.io  pgsql-performance@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Bruce Momjian <pgman@candle.pha.pa.us>
To: Michael Pohl <michael@newtopia.com>
Cc: pgsql-performance@postgresql.org
Subject: Re: Moving postgresql.conf tunables into 2003...
Date: Sun, 20 Jul 2003 15:21:06 -0400 (EDT)
Message-ID: <200307201921.h6KJL6a10673@candle.pha.pa.us> (raw)
In-Reply-To: <Pine.LNX.4.44.0307062249060.8634-100000@server1.techplant.com>

Michael Pohl wrote:
> On Sun, 6 Jul 2003, Matthew Nuzum wrote:
> 
> > At the very least, if there is good documentation for these parameters,
> > maybe the conf file should provide a link to this info. 
> 
> I believe that is what Josh is proposing:
> 
> http://archives.postgresql.org/pgsql-performance/2003-07/msg00102.php
> 
> > [Apache httpd] uses a three phase (if not more) documentation level.  
> > The .conf file contains detailed instructions in an easy to read and
> > not-to-jargon-ish structure.  The docs provide detailed tutorials and
> > papers that expand on configuration params in an easy to read format.  
> > Both of these refer to the thorough reference manual that breaks each
> > possible option down into it's nitty gritty details so that a user can
> > get more information if they so desire.
> 
> I agree that Apache's approach is primo.  Often the .conf comments are
> enough to jog my memory about a directive I haven't used for a while.  Or
> the comments are enough to let me know I don't need a directive, or that I
> need to go to the manual and read more.  I appreciate that.

Isn't that what we have now --- isn't postgresql.conf clear enough to
jog people's memory.

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073



view thread (45+ messages)  latest in thread

Message-ID: <200307201921.h6KJL6a10673@candle.pha.pa.us>
Permalink:  ../200307201921.h6KJL6a10673@candle.pha.pa.us/
Also on:    postgresql.org/message-id/200307201921.h6KJL6a10673@candle.pha.pa.us

 · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients from your mail client; the link fills in
  the headers below: reply via email
  Some clients, webmail especially, drop In-Reply-To and References from
  a link, and the reply then starts a new thread: use the mbox below.

  To: pgsql-performance@postgresql.org
  Cc: pgman@candle.pha.pa.us, michael@newtopia.com
  Subject: Re: Moving postgresql.conf tunables into 2003...
  In-Reply-To: <200307201921.h6KJL6a10673@candle.pha.pa.us>
  References: <Pine.LNX.4.44.0307062249060.8634-100000@server1.techplant.com> <200307201921.h6KJL6a10673@candle.pha.pa.us>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox