Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps
 (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1m5znX-0000r5-Hh
	for pgsql-docs@arkaria.postgresql.org; Wed, 21 Jul 2021 00:09:15 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1m5znW-0003gF-F4
	for pgsql-docs@arkaria.postgresql.org; Wed, 21 Jul 2021 00:09:14 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1m5znW-0003g4-99
	for pgsql-docs@lists.postgresql.org; Wed, 21 Jul 2021 00:09:14 +0000
Received: from sss.pgh.pa.us ([66.207.139.130])
	by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1m5znT-0001tS-Jj; Wed, 21 Jul 2021 00:09:13 +0000
Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1])
	by sss.pgh.pa.us (8.15.2/8.15.2) with ESMTP id 16L0947t647691;
	Tue, 20 Jul 2021 20:09:04 -0400
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Alvaro Herrera <alvherre@alvh.no-ip.org>
cc: "Jonathan S. Katz" <jkatz@postgresql.org>,
        "Daniel Westermann (DWE)" <daniel.westermann@dbi-services.com>,
        "pgsql-docs@lists.postgresql.org" <pgsql-docs@lists.postgresql.org>
Subject: Re: Link t the souce code
In-reply-to: <202107202345.imvyzt5yio5v@alvherre.pgsql>
References: <202107202345.imvyzt5yio5v@alvherre.pgsql>
Comments: In-reply-to Alvaro Herrera <alvherre@alvh.no-ip.org>
	message dated "Tue, 20 Jul 2021 19:45:55 -0400"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <647689.1626826144.1@sss.pgh.pa.us>
Date: Tue, 20 Jul 2021 20:09:04 -0400
Message-ID: <647690.1626826144@sss.pgh.pa.us>
List-Id: <pgsql-docs.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-docs@lists.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-docs>
Archived-At: 
 <https://www.postgresql.org/message-id/647690.1626826144%40sss.pgh.pa.us>
Precedence: bulk

Alvaro Herrera <alvherre@alvh.no-ip.org> writes:
> v3 rewrites the text more aggressively, so that it opens with
> instructions to clone the Git repo, and the released version tarballs
> are mentioned further down.  The bad thing about this one is that in the
> devel version it still talks about files that don't exist; for example
> in branch master it renders as:

> 	Alternatively, the released versions can be obtained from the download
> 	section of our website: https://www.postgresql.org/ftp/source/. You
> 	should get a file named postgresql-15devel.tar.gz or
> 	postgresql-15devel.tar.bz2. After you have obtained the file, unpack it:>
> 	tar xfa postgresql-15devel.tar.gz
> 	This will create a directory postgresql-15devel under the current
 	directory with the PostgreSQL sources. Change into that directory for
> 	the rest of the installation procedure.

ISTM that specifying an exact version number here is rather pointless
anyway.  Could we drop the reference to an exact file name, and write
something like

	Alternatively, source code for released versions can be obtained
	from the download section of our website:
	https://www.postgresql.org/ftp/source/.
	Download the postgresql-<replaceable>version</replaceable>.tar.gz or
	postgresql-<replaceable>version</replaceable>.tar.bz2 file for the
	version you are	interested in, then unpack it:
	tar xfa postgresql-<replaceable>version</replaceable>.tar.gz
	This will create a directory
	postgresql-<replaceable>version</replaceable> under the current ...

Admittedly, someone who doesn't grok that
<replaceable>version</replaceable> is a variable might be confused
initially, but I think they'd soon figure it out after seeing the
file names on the server.

			regards, tom lane