X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org
Received: from localhost (unknown [200.46.204.2])
	by svr1.postgresql.org (Postfix) with ESMTP id E7A21D1B4ED
	for <pgsql-docs-postgresql.org@localhost.postgresql.org>;
	Tue, 14 Oct 2003 20:29:01 +0000 (GMT)
Received: from svr1.postgresql.org ([200.46.204.71])
	by localhost (neptune.hub.org [200.46.204.2]) (amavisd-new, port 10024)
	with ESMTP id 86206-02
	for <pgsql-docs-postgresql.org@localhost.postgresql.org>;
	Tue, 14 Oct 2003 17:28:32 -0300 (ADT)
Received: from davinci.ethosmedia.com (unknown [209.128.84.228])
	by svr1.postgresql.org (Postfix) with ESMTP id CEBA7D1B510
	for <pgsql-docs@postgresql.org>; Tue, 14 Oct 2003 17:28:25 -0300 (ADT)
Received: from [66.219.92.2] (HELO temoku)
	by davinci.ethosmedia.com (CommuniGate Pro SMTP 4.0.2)
	with ESMTP id 3768183; Tue, 14 Oct 2003 13:28:59 -0700
Content-Type: text/plain;
  charset="iso-8859-1"
From: Josh Berkus <josh@agliodbs.com>
Reply-To: josh@agliodbs.com
Organization: Aglio Database Solutions
To: Bruce Momjian <pgman@candle.pha.pa.us>
Subject: Re: Need help with SGML again
Date: Tue, 14 Oct 2003 13:26:08 -0700
User-Agent: KMail/1.4.3
References: <200310142014.h9EKETN26790@candle.pha.pa.us>
In-Reply-To: <200310142014.h9EKETN26790@candle.pha.pa.us>
Cc: pgsql-docs@postgresql.org
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
Message-Id: <200310141326.08620.josh@agliodbs.com>
X-Virus-Scanned: by amavisd-new at postgresql.org
X-Archive-Number: 200310/10
X-Sequence-Number: 2030

Bruce,

> I have Peter on IM.  Here is his reply:

If he can come over to IRC, we can have a 3-way.

> Peter Eisentraut: linking is bad anyway.  tell him not to do it.  if the=
=20
material cannot be presented sequentially, it's too complicated.=20
> 151255111: ok

??? Do we want linking or do we want lots of duplicate text?=20=20=20=20

What I have currently is:

   <sect2 id=3D"runtime-config-basics">
    <title>Basic Runtime Setup</title>

    <para>
    PostgreSQL's default runtime setup is very conservative, and more=20
appropriate to an
    old workstation than a modern server machine.  As such, you will certai=
nly=20
want to
    change some of the runtime settings before running PostgreSQL for the=
=20
first time.
    After INITDB, database administrators should change most or all of the=
=20
following settings,
    listed in order of how frequently they need adjustment.
    </para>
    <itemizedlist>
    <listitem>tcpip_socket</listitem>
    <listitem>max_connections</listitem>
    <listitem>shared_buffers</listitem>
    <listitem>sort_mem</listitem>
    <listitem>effective_cache_size</listitem>
    <listitem>random_tuple_cost</listitem>
    <listitem>vacuum_mem</listitem>
    <listitem>max_fsm_pages</listitem>
    <listitem>checkpoint_segments</listitem>
    </itemizedlist>

etc.

It's obvious to me that for this each of the setting names should be linked=
 to=20
the listitem below for the individual setting.  My only other choice would =
be=20
to *repeat* the configuration text in the "Basic Setup" section, identical=
=20
with the text below where the settings are defined.  This does *not* seem=
=20
effective to me.

--=20
-Josh Berkus
 Aglio Database Solutions
 San Francisco