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 DF7FCD9BA1; Wed, 28 Sep 2005 23:23:53 -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 26332-09; Thu, 29 Sep 2005 02:23:43 +0000 (GMT) Received: from mx1.surnet.cl (mx1.surnet.cl [216.155.73.180]) by svr1.postgresql.org (Postfix) with ESMTP id 3CFE8D9B8E; Wed, 28 Sep 2005 23:23:44 -0300 (ADT) Received: from unknown (HELO cluster.surnet.cl) ([216.155.73.165]) by mx1.surnet.cl with ESMTP; 28 Sep 2005 22:24:33 -0400 X-IronPort-AV: i="3.97,155,1125892800"; d="scan'208"; a="11896853:sNHT100361094" Received: from alvh.no-ip.org (200.85.218.101) by cluster.surnet.cl (7.0.043) (authenticated as alvherre@surnet.cl) id 433A601F0004E637; Wed, 28 Sep 2005 22:23:48 -0400 Received: by alvh.no-ip.org (Postfix, from userid 1000) id D78CDC5D00A; Wed, 28 Sep 2005 22:23:49 -0400 (CLT) Date: Wed, 28 Sep 2005 22:23:49 -0400 From: Alvaro Herrera To: Bruce Momjian Cc: PostgreSQL-development , PostgreSQL-documentation Subject: Re: Added documentation about caching, reliability Message-ID: <20050929022349.GB17404@surnet.cl> Mail-Followup-To: Bruce Momjian , PostgreSQL-development , PostgreSQL-documentation References: <20050928194933.GA16776@surnet.cl> <200509290208.j8T282b09583@candle.pha.pa.us> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <200509290208.j8T282b09583@candle.pha.pa.us> User-Agent: Mutt/1.5.10i X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, hits=1.95 required=5 tests=[AWL=-0.826, DNS_FROM_RFC_ABUSE=0.374, DNS_FROM_RFC_POST=1.376, RCVD_IN_NJABL_PROXY=1.026] X-Spam-Level: * X-Archive-Number: 200509/49 X-Sequence-Number: 3235 On Wed, Sep 28, 2005 at 10:08:02PM -0400, Bruce Momjian wrote: > 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? Is it considered good style to use acronyms in titles? I wouldn't do it. Maybe it could be left as 26.1. Write-Ahead Logging 26.2. Benefits of Write-Ahead Logging 26.3. WAL Configuration 26.4. WAL Internals because the former two talk about WAL in a general manner, while the latter two are about our implementation. I also wouldn't expand the acronym in a title. -- Alvaro Herrera Valdivia, Chile ICBM: S 39º 49' 17.7", W 73º 14' 26.8" Thou shalt study thy libraries and strive not to reinvent them without cause, that thy code may be short and readable and thy days pleasant and productive. (7th Commandment for C Programmers)