public inbox for [email protected]  

help / color / mirror / Atom feed

From: Josh Berkus <[email protected]>
To: Bruce Momjian <[email protected]>
Cc: [email protected]
Subject: Re: Need help with SGML again
Date: Tue, 14 Oct 2003 13:26:08 -0700
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>

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 
material cannot be presented sequentially, it's too complicated. 
> 151255111: ok

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

What I have currently is:

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

    <para>
    PostgreSQL's default runtime setup is very conservative, and more 
appropriate to an
    old workstation than a modern server machine.  As such, you will certainly 
want to
    change some of the runtime settings before running PostgreSQL for the 
first time.
    After INITDB, database administrators should change most or all of the 
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 
the listitem below for the individual setting.  My only other choice would be 
to *repeat* the configuration text in the "Basic Setup" section, identical 
with the text below where the settings are defined.  This does *not* seem 
effective to me.

-- 
-Josh Berkus
 Aglio Database Solutions
 San Francisco

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]
  Subject: Re: Need help with SGML again
  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