| From: | Simon Riggs <simon(at)2ndquadrant(dot)com> |
|---|---|
| To: | pgsql-docs(at)postgresql(dot)org |
| Subject: | Confusing names |
| Date: | 2005-10-20 21:21:32 |
| Message-ID: | 1129843292.8300.791.camel@localhost.localdomain |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-docs |
Once before I mentioned that the Server Run-time Configuration chapter
was probably my most visited locations in the manual...
I like very much the split of that into two sections, but I think the
new chapter names are somewhat confusing.
My proposal would be to rename the chapters called
Server Run-time Environment
Run-time Configuration
to be
Server and Operating System Environment
Server Configuration Parameters
The first of these chapters is devoted exclusively to OS issues, some of
which are *not* run-time issues e.g. creating a database cluster, re-
configuring the OS kernel for various resources. Hence, I suggest
replacing the phrase Run-time with something associated with OS.
The second chapter is the server configuration chapter. It doesn't refer
to run-time *client* configuration, for example. Also the whole chapter
refers to "parameters" throughout, yet this is not mentioned in the
title. Also, the preset options section actually refers to settings that
are build-time parameters exposed at run-time, so perhaps the phrase
run-time is misleading.
Best Regards, Simon Riggs
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Neil Conway | 2005-10-20 21:59:34 | Re: Confusing names |
| Previous Message | David Fetter | 2005-10-20 05:49:47 | Re: [PATCHES] Caveat for Domains |