Skip site navigation (1) Skip section navigation (2)

Confusing names

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 (view raw or flat)
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


Responses

pgsql-docs by date

Next:From: Neil ConwayDate: 2005-10-20 21:59:34
Subject: Re: Confusing names
Previous:From: David FetterDate: 2005-10-20 05:49:47
Subject: Re: [PATCHES] Caveat for Domains

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group