public inbox for [email protected]  

help / color / mirror / Atom feed

From: Ray Stell <[email protected]>
To: [email protected]
Subject: configuration parameter descriptions
Date: Wed, 27 Apr 2011 11:48:40 -0400
Message-ID: <[email protected]> (raw)

I'd like to make a general suggestion on configuration parameter
documentation.  I'd like to see a high level entry as to whether the
parameter can be changed on the fly or not.  I think the Oracle docs refer
to this as static/dynamic.  

Currently, dynamic parameters, those that can be changed in a running
cluster, can be identified by the fact that no statement is made.  This
can be confusing.  

An example of the "static" entry follows:

 listen_addresses (string)

   parmater description .........
   This parameter can only be set at server start.

This might be communicated with something like:

  listen_addresses (string) /static

The current entry for maintenance_work_mem looks like this:

 maintenance_work_mem (integer)

     Specifies the maximum amount of memory...

which might look something like this:

 maintenance_work_mem (integer)  /dynamic

     Specifies the maximum amount of memory

I'd be willing to work on this adaptation if you need help.
I'd need some introduction to your text management.

Thanks,
Ray

view thread (2+ messages)  latest in thread

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 using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected]
  Subject: Re: configuration parameter descriptions
  In-Reply-To: <[email protected]>

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

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