public inbox for [email protected]  

help / color / mirror / Atom feed

From: Alvaro Herrera <[email protected]>
To: Jonathan S. Katz <[email protected]>
Cc: Tom Lane <[email protected]>
Cc: Daniel Westermann (DWE) <[email protected]>
Cc: [email protected] <[email protected]>
Subject: Re: Link t the souce code
Date: Thu, 6 May 2021 19:22:43 -0400
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>

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

> On 5/6/21 6:05 PM, Tom Lane wrote:
> > Alvaro Herrera <[email protected]> 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

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