Re: Need help with SGML again

From: Bruce Momjian <pgman(at)candle(dot)pha(dot)pa(dot)us>
To: josh(at)agliodbs(dot)com
Cc: pgsql-docs(at)postgresql(dot)org
Subject: Re: Need help with SGML again
Date: 2003-10-14 20:31:56
Message-ID: 200310142031.h9EKVup28647@candle.pha.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs


I see vacuum_mem in "runtime-config-resource-memory". I assume you just
have to point to that section heading.

---------------------------------------------------------------------------

Josh Berkus wrote:
> 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
>

--
Bruce Momjian | http://candle.pha.pa.us
pgman(at)candle(dot)pha(dot)pa(dot)us | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Josh Berkus 2003-10-14 21:01:53 Re: Need help with SGML again
Previous Message Josh Berkus 2003-10-14 20:26:08 Re: Need help with SGML again