Re: Documentation of server configuration - Mailing list pgsql-docs

From Josh Berkus
Subject Re: Documentation of server configuration
Date
Msg-id 200411151016.53648.josh@agliodbs.com
Whole thread Raw
In response to Re: Documentation of server configuration  (Neil Conway <neilc@samurai.com>)
Responses Re: Documentation of server configuration
PostgreSQL on Guest Host (VMWare)
Re: Documentation of server configuration
List pgsql-docs
Neil,

> I agree that this section is frequently accessed. Given that, I think it
> is somewhat difficult to find -- we've all memorized that it is in the
> "Server Run-time Environment" chapter, but I don't think that's the
> first place most people would look. What do people think about
> separating the configuration section out to be a new top-level chapter?

I'd be up for that.   The trick will be getting it done before 8.0 ...
although if we're going into another beta, maybe time isn't precious yet.

Actually, what I'd see is:

1) a section explaining the most frequently modified options, and links;
2) a section grouping options by general purpose (like our current
categories), with links;
3) a dictionary of config options, which personally I would prefer to be one
per page like the SQL commands.

If we were to do the above, then re-ordering the "dictionary" to pure
alphabetical would make perfect sense.

--
Josh Berkus
Aglio Database Solutions
San Francisco

pgsql-docs by date:

Previous
From: elein
Date:
Subject: Re: ANSI SQL-2003 conformance
Next
From: elein
Date:
Subject: Re: Documentation of server configuration