public inbox for [email protected]  

help / color / mirror / Atom feed

From: Bruce Momjian <[email protected]>
To: Alvaro Herrera <[email protected]>
Cc: Scott Marlowe <[email protected]>
Cc: Tom Lane <[email protected]>
Cc: [email protected]
Subject: Re: order of entries in admin docs
Date: Wed, 7 May 2008 17:34:47 -0400 (EDT)
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>

Alvaro Herrera wrote:
> > > Perhaps it would be better to have prose explaining all the stuff
> > > structured like Scott proposes, and make the postgresql.conf be just a
> > > reference linking to that.  I don't think making postgresql.conf be the
> > > primary documentation is very nice.
> > 
> > So you are suggesting splitting out the postgresql.conf content into its
> > relevant sections and just linking to it?  That would work.
> 
> Yes, or something like that.  I don't think leaving _just_ the links on
> the postgresql.conf would be enough.  But a comprehensive, verbose
> explanation should be elsewhere; a short blurb and the link would remain
> on the postgresql.conf reference.

Yea, that's certainly possible, though right now we pretty much have
_all_ the information about each configuration value in one place.  We
would lose that.  Looking at the connection postgresql.conf docs:

	http://developer.postgresql.org/pgdocs/postgres/runtime-config-connection.html

There isn't much additional text except a description of each item.

-- 
  Bruce Momjian  <[email protected]>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

  + If your life is a hard drive, Christ can be your backup. +

view thread (17+ 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], [email protected], [email protected], [email protected]
  Subject: Re: order of entries in admin docs
  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