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

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

pgsql-docs by date

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

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