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