Received: from malur.postgresql.org ([217.196.149.56])
 by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from
 <pgsql-committers-owner+M53317=pgsql-committers-ark@postgresql.org>)
 id 1WAUVg-0007WQ-Gs
 for pgsql-committers@arkaria.postgresql.org; Tue, 04 Feb 2014 01:09:08 +0000
Received: from localhost ([127.0.0.1] helo=postgresql.org)
 by malur.postgresql.org with smtp (Exim 4.80) (envelope-from
 <pgsql-committers-owner+M53317=pgsql-committers-ark@postgresql.org>)
 id 1WAUVf-0003Oy-W5
 for pgsql-committers@arkaria.postgresql.org; Tue, 04 Feb 2014 01:09:08 +0000
Received: from makus.postgresql.org ([2001:4800:7903:4::125])
 by malur.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <robertmhaas@gmail.com>) id 1WAUVe-0003Or-SN
 for pgsql-committers@postgresql.org; Tue, 04 Feb 2014 01:09:07 +0000
Received: from mail-we0-x233.google.com ([2a00:1450:400c:c03::233])
 by makus.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <robertmhaas@gmail.com>)
 id 1WAUVb-0003JJ-92; Tue, 04 Feb 2014 01:09:06 +0000
Received: by mail-we0-f179.google.com with SMTP id q58so3380204wes.24
 for <multiple recipients>; Mon, 03 Feb 2014 17:09:01 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;
 h=mime-version:in-reply-to:references:date:message-id:subject:from:to
 :cc:content-type;
 bh=R1ej2Uo9zq8bXNnDLTx7lDPanaUgOFKeHM/h+UXzR4g=;
 b=wDjYZROTB3n4SJ5FP5rciaob6Y0lrWHGUEfPbzGbq8TGxg4Ts7YFJHKPdzxvzB9/hQ
 q/X4GL392qF+J9m/hX+6j2mUWlcV0SImOwa8gJYexQyESoFW05Hnopjz+RwwHkVtQ333
 j//KPH57NbGer1ur2p58gZQcDXH/yNJnuwAUsfPZ76DGMFdn5Do7oOiqPX37noYMYMkE
 TmUPoApm6t85Ux5qYxX4qSrLjl6rmH0Aor1RQUEvH9pxaYhVwrxyzRUYXtbGiBESwdty
 DyDxG2fs+et6DAknIyyAjIvxDJx8pB+9dXxxkTKuMV1bFLWb6CP2VBLeyuQiPzh0AKSR
 Exjw==
MIME-Version: 1.0
X-Received: by 10.180.13.197 with SMTP id j5mr10730443wic.14.1391476141901;
 Mon, 03 Feb 2014 17:09:01 -0800 (PST)
Received: by 10.227.158.4 with HTTP; Mon, 3 Feb 2014 17:09:01 -0800 (PST)
In-Reply-To: <22438.1391463522@sss.pgh.pa.us>
References: <E1WALm6-0000nT-M0@gemulon.postgresql.org>
 <22438.1391463522@sss.pgh.pa.us>
Date: Mon, 3 Feb 2014 20:09:01 -0500
Message-ID: 
 <CA+Tgmob0Jx_9v9KK95gojkjojeP2hTa38_P8JtOFXVDjjSkT=A@mail.gmail.com>
Subject: Re: pgsql: Document a few more regression test hazards.
From: Robert Haas <robertmhaas@gmail.com>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Robert Haas <rhaas@postgresql.org>,
 pgsql-committers <pgsql-committers@postgresql.org>
Content-Type: text/plain; charset=ISO-8859-1
X-Pg-Spam-Score: -2.0 (--)
List-Archive: <http://archives.postgresql.org/pgsql-committers>
List-Help: <mailto:majordomo@postgresql.org?body=help>
List-ID: <pgsql-committers.postgresql.org>
List-Owner: <mailto:pgsql-committers-owner@postgresql.org>
List-Post: <mailto:pgsql-committers@postgresql.org>
List-Subscribe: <mailto:majordomo@postgresql.org?body=sub%20pgsql-committers>
List-Unsubscribe: 
 <mailto:majordomo@postgresql.org?body=unsub%20pgsql-committers>
X-Mailing-List: pgsql-committers
Precedence: bulk
Sender: pgsql-committers-owner@postgresql.org

On Mon, Feb 3, 2014 at 4:38 PM, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> Robert Haas <rhaas@postgresql.org> writes:
>> Document a few more regression test hazards.
>
> guaibasaurus doesn't like this patch: you need to be more careful
> about links, because the regression instructions are supposed to
> compile as a standalone document.
>
> Easy answer is to get rid of the link to RUNTIME-CONFIG-QUERY-ENABLE.
> I think there's some hack you can use to make it sort-of-work standalone
> too; look at the release notes for examples.

Fascinating.  I knew that there was a HISTORY file that got built from
the release notes, but I didn't realize there was something similar
being built from regress.sgml.  I'll rephase that passage to avoid the
link.

I wonder if these standalone things are really worthwhile.  The whole
point of this, ten years ago, was that people who were trying to get
started with PostgreSQL might not have had neither the doc toolchain
nor convenient Internet access available.  Plain text documentation
was essential for getting off the ground.  This seems much less
relevant today; is the annoyance of not being able to use links
everywhere really buying us anything at this point?

-- 
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company


-- 
Sent via pgsql-committers mailing list (pgsql-committers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-committers