public inbox for [email protected]  

help / color / mirror / Atom feed

From: Tom Lane <[email protected]>
To: Alvaro Herrera <[email protected]>
Cc: Jonathan S. Katz <[email protected]>
Cc: Daniel Westermann (DWE) <[email protected]>
Cc: [email protected] <[email protected]>
Subject: Re: Link t the souce code
Date: Tue, 20 Jul 2021 20:09:04 -0400
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>

Alvaro Herrera <[email protected]> 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

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected], [email protected]
  Subject: Re: Link t the souce code
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox