Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from ) id 1WC12r-0004Mu-56 for pgsql-docs@arkaria.postgresql.org; Sat, 08 Feb 2014 06:05:41 +0000 Received: from localhost ([127.0.0.1] helo=postgresql.org) by malur.postgresql.org with smtp (Exim 4.80) (envelope-from ) id 1WC12p-0002nt-JM for pgsql-docs@arkaria.postgresql.org; Sat, 08 Feb 2014 06:05:39 +0000 Received: from makus.postgresql.org ([2001:4800:7903:4::125]) by malur.postgresql.org with esmtp (Exim 4.80) (envelope-from ) id 1WC12o-0002nh-Kz; Sat, 08 Feb 2014 06:05:38 +0000 Received: from sss.pgh.pa.us ([66.207.139.130]) by makus.postgresql.org with esmtp (Exim 4.80) (envelope-from ) id 1WC12m-000490-DI; Sat, 08 Feb 2014 06:05:38 +0000 Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1]) by sss.pgh.pa.us (8.14.4/8.14.4) with ESMTP id s1865VlU018084; Sat, 8 Feb 2014 01:05:31 -0500 From: Tom Lane To: Peter Eisentraut cc: Robert Haas , pgsql-hackers@postgreSQL.org, pgsql-docs@postgreSQL.org Subject: Re: [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.) In-reply-to: <52F58CE8.4090902@gmx.net> References: <22438.1391463522@sss.pgh.pa.us> <28834.1391478486@sss.pgh.pa.us> <52F58CE8.4090902@gmx.net> Comments: In-reply-to Peter Eisentraut message dated "Fri, 07 Feb 2014 20:48:24 -0500" Date: Sat, 08 Feb 2014 01:05:31 -0500 Message-ID: <18083.1391839531@sss.pgh.pa.us> X-Pg-Spam-Score: -2.5 (--) List-Archive: List-Help: List-ID: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-Mailing-List: pgsql-docs Precedence: bulk Sender: pgsql-docs-owner@postgresql.org Peter Eisentraut writes: > On 2/3/14, 8:48 PM, Tom Lane wrote: >> That's a very fair question. It's a reasonable bet that pretty much >> nobody actually looks at the text versions of either HISTORY or >> regress_README anymore. It's conceivable that somebody somewhere makes >> use of the text version of INSTALL when trying to get PG going on some >> bare-bones platform ... but really, can't they look it up on the net? >> How'd they get the PG sources they're installing, anyway? > I think having an INSTALL file is good form, and it costs us little to > maintain it. > The other files could be removed, IMO. That seems like a reasonable compromise to me. The HISTORY file is certainly the worst pain-in-the-rear among these, since it's generated from files that we change constantly, and so we're always tripping over the link restrictions. regards, tom lane -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs