Date: Thu, 6 May 2021 19:22:43 -0400
From: Alvaro Herrera <alvherre@alvh.no-ip.org>
To: "Jonathan S. Katz" <jkatz@postgresql.org>
Cc: Tom Lane <tgl@sss.pgh.pa.us>,
	"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
Message-ID: <20210506232243.GA7460@alvherre.pgsql>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <13ed358b-76ae-f834-dc63-875f5142eb04@postgresql.org>
User-Agent: Mutt/1.10.1 (2018-07-13)
Archived-At: 
 <https://www.postgresql.org/message-id/20210506232243.GA7460%40alvherre.pgsql>
Precedence: bulk

On 2021-May-06, Jonathan S. Katz wrote:

> On 5/6/21 6:05 PM, Tom Lane wrote:
> > Alvaro Herrera <alvherre@alvh.no-ip.org> writes:
> >> I agree -- if the user wanted packages, they would not be reading that
> >> page of the docs.  I'd just have it point to the same page that the
> >> download page points to for source downloads, not a version-specific
> >> one, as in the attached patch.
> > 
> > +1.  I think people reading this may have their own ideas about
> > which version they want.  Also, getting the link to be sane in
> > the devel docs might be problematic.
> 
> +1 on all of the above.

This text seems to work fine for released versions, but not very well
for development, because it says this:

	The PostgreSQL 14devel sources can be obtained from the download section
	of our website: https://www.postgresql.org/ftp/source/. You should get a
	file named postgresql-14devel.tar.gz or postgresql-14devel.tar.bz2.

and no such thing as postgresql-14devel.tar.gz can be found anywhere as
far as I can see.  What we do have is postgresql-snapshot.tar.gz, but
that's not located in /ftp/source/ but /ftp/snapshot/dev/.

I think if we wanted to be tense about these instructions being correct
for the devel version, we need more work.  Options I can see:

1. add a directory for the current devel version in the FTP area.

2. use conditional XML markup that points to the snapshot dir when doing
the devel build

3. add a separate paragraph that says to obtain the source from the
other dir if it's the development one.


I kinda prefer the last one, because then we could also suggest to use a
Git repo instead of a tarball, which I suppose is the best option anyway.

-- 
Álvaro Herrera                            39°49'30"S 73°17'W