Re: [HACKERS] Added documentation about caching, reliability

From: "Jonah H(dot) Harris" <jonah(dot)harris(at)gmail(dot)com>
To: Bruce Momjian <pgman(at)candle(dot)pha(dot)pa(dot)us>
Cc: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>, PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>, PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>
Subject: Re: [HACKERS] Added documentation about caching, reliability
Date: 2005-09-29 02:16:06
Message-ID: 36e682920509281916x79ff32ecp8ede61bd41d1410a@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

IMHO, spelling out each one is redundant... the first one "Write-Ahead
Logging (WAL)" seems to define WAL for use later in the text.

On 9/28/05, Bruce Momjian <pgman(at)candle(dot)pha(dot)pa(dot)us> wrote:
>
> Alvaro Herrera wrote:
> > On Wed, Sep 28, 2005 at 02:26:24PM -0400, Bruce Momjian wrote:
> > > I have added a section to the top of the WAL docs explaining caching
> and
> > > reliability issues:
> > >
> > > http://candle.pha.pa.us/main/writings/pgsql/sgml/reliability.html
> > >
> > > I also renamed the chapter "Reilability" rather than "WAL."
> >
> > While you are re-titling the docs, maybe the sections on that chapter
> > could be titled "Benefits of Write-Ahead Log" instead of "Benefits of
> > WAL", etc.
>
> The chapter sections are:
>
> Table of Contents
> 26.1. Write-Ahead Logging (WAL)
> 26.2. Benefits of WAL
> 26.3. WAL Configuration
> 26.4. WAL Internals
>
> Are you suggesting we spell out Write-Ahead Logging for all section
> titles?
>
> --
> 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
>
> ---------------------------(end of broadcast)---------------------------
> TIP 1: if posting/reading through Usenet, please send an appropriate
> subscribe-nomail command to majordomo(at)postgresql(dot)org so that your
> message can get through to the mailing list cleanly
>

--
Respectfully,

Jonah H. Harris, Database Internals Architect
EnterpriseDB Corporation
http://www.enterprisedb.com/

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Rich Morin 2005-09-29 02:22:14 Re: INSTALL file nits
Previous Message Bruce Momjian 2005-09-29 02:08:02 Re: Added documentation about caching, reliability

Browse pgsql-hackers by date

  From Date Subject
Next Message Bruce Momjian 2005-09-29 02:21:00 Re: Found small issue with OUT params
Previous Message Bruce Momjian 2005-09-29 02:08:02 Re: Added documentation about caching, reliability