X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org Received: from localhost (av.hub.org [200.46.204.144]) by svr1.postgresql.org (Postfix) with ESMTP id 98FABD9B83 for ; Wed, 28 Sep 2005 23:16:09 -0300 (ADT) Received: from svr1.postgresql.org ([200.46.204.71]) by localhost (av.hub.org [200.46.204.144]) (amavisd-new, port 10024) with ESMTP id 26662-05 for ; Thu, 29 Sep 2005 02:16:00 +0000 (GMT) Received: from rproxy.gmail.com (rproxy.gmail.com [64.233.170.206]) by svr1.postgresql.org (Postfix) with ESMTP id 5E3FFD9B66 for ; Wed, 28 Sep 2005 23:16:01 -0300 (ADT) Received: by rproxy.gmail.com with SMTP id 40so96391rnz for ; Wed, 28 Sep 2005 19:16:06 -0700 (PDT) DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com; h=received:message-id:date:from:reply-to:to:subject:cc:in-reply-to:mime-version:content-type:references; b=hASitIvwV+YgD+LLcehaPIFFaUkQuAykkozMwKb/TIQvE+EOS3P5v9ALa1pXBgKvrBGUyNWOlCfWjxdnuwQI34xMEvHC3Hq5GLkzDFCD5W5bNcGtlw1laKOD5F1GWvAnrLr1wEDmV3O5GN3tlxV7TlBvtsKoe3WLqIleMi8BXw4= Received: by 10.11.122.56 with SMTP id u56mr5103cwc; Wed, 28 Sep 2005 19:16:06 -0700 (PDT) Received: by 10.11.119.38 with HTTP; Wed, 28 Sep 2005 19:16:06 -0700 (PDT) Message-ID: <36e682920509281916x79ff32ecp8ede61bd41d1410a@mail.gmail.com> Date: Wed, 28 Sep 2005 20:16:06 -0600 From: "Jonah H. Harris" Reply-To: "Jonah H. Harris" To: Bruce Momjian Subject: Re: [HACKERS] Added documentation about caching, reliability Cc: Alvaro Herrera , PostgreSQL-development , PostgreSQL-documentation In-Reply-To: <200509290208.j8T282b09583@candle.pha.pa.us> MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="----=_Part_45_21973392.1127960166024" References: <20050928194933.GA16776@surnet.cl> <200509290208.j8T282b09583@candle.pha.pa.us> X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, hits=0.261 required=5 tests=[AWL=0.141, HTML_50_60=0.095, HTML_MESSAGE=0.001, RCVD_BY_IP=0.024] X-Spam-Level: X-Archive-Number: 200510/4 X-Sequence-Number: 3249 ------=_Part_45_21973392.1127960166024 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Content-Disposition: inline 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 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@candle.pha.pa.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@postgresql.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/ ------=_Part_45_21973392.1127960166024 Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Content-Disposition: inline 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 <pgm= an@candle.pha.pa.us> wrote:
Alvaro Herrera wrote:
> On Wed, Sep 28, 2005 at 02:26:24PM -0400, Bru= ce 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/writi= ngs/pgsql/sgml/reliability.html
> >
> > I also rename= d the chapter "Reilability" rather than "WAL."
>
> While you are re-titling the docs, maybe the sections on t= hat chapter
> could be titled "Benefits of Write-Ahead Log"= instead of "Benefits of
> WAL", etc.

The chapter se= ctions are:

        Table of Contents        26.1. Write-Ahead Logging= (WAL)
        26.2. Benefits of= WAL
        26.3. WAL Configura= tion
        26.4. WAL Internals=

Are you suggesting we spell out Write-Ahead Logging for all section
titles?

--
  Bruce Momjian           &n= bsp;            = ;|  http://candle.pha.pa.us
  
pgman@candle.ph= a.pa.us          &nbs= p;    |  (610) 359-1001
  +  If your life is a h= ard drive,     |  13 Roberts Road
 &n= bsp;+  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073

---------------------------(end of broadc= ast)---------------------------
TIP 1: if posting/reading through Usenet= , please send an appropriate
       subscr= ibe-nomail command to majordomo@postgresql.org so that your
     =   message can get through to the mailing list cleanly
=



--
Respectfully,

Jonah H. Harris= , Database Internals Architect
EnterpriseDB Corporation
ht= tp://www.enterprisedb.com/
------=_Part_45_21973392.1127960166024--