Improve installation instructions a bit

Reported-by: Daniel Westermann
Discussion: https://postgr.es/m/GV0P278MB04835AAEACF894617574EB6BD25A9@GV0P278MB0483.CHEP278.PROD.OUTLOOK.COM

diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index 05b77ec8e66437f23724221f7f98e322985b0bfb..fddd7d3905116141b6a910ba9e48729cd862cd75 100644 (file)
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -354,31 +354,36 @@ su - postgres
   Getting the Source
 
   
-   The PostgreSQL &version; sources can be obtained from the
-   download section of our
-   website: .  You
-   should get a file named postgresql-&version;.tar.gz
-   or postgresql-&version;.tar.bz2. After
-   you have obtained the file, unpack it:
+   The version control repository for PostgreSQL
+   can be obtained from
+   ;
+   this is the recommended way to obtain the
+   PostgreSQL source code.
+   You can obtain a clone of the repository by running
 
-gunzip postgresql-&version;.tar.gz
-tar xf postgresql-&version;.tar
+git clone https://git.postgresql.org/git/postgresql.git
 
-   (Use bunzip2 instead of gunzip if
-   you have the .bz2 file.  Also, note that most
-   modern versions of tar can unpack compressed archives
-   directly, so you don't really need the
-   separate gunzip or bunzip2 step.)
-   This will create a directory
-   postgresql-&version; under the current directory
-   with the PostgreSQL sources.
-   Change into that directory for the rest
-   of the installation procedure.
+   This will create a directory postgresql under the current
+   directory with the PostgreSQL sources.
+   Change into that directory for the rest of the installation procedure.
+   See  for further information.
   
 
   
-   You can also get the source directly from the version control repository, see
-   .
+   Alternatively, source code for the released versions can be obtained
+   from the download section of our website:
+   .
+   Download then
+   postgresql-version.tar.gz
+   or postgresql-version.tar.bz2
+   you're interested in, then unpack it:
+
+tar xf postgresql-version.tar.bz2
+
+   This will create a directory
+   postgresql-version under
+   the current directory with the PostgreSQL sources.
+   Change into that directory for the rest of the installation procedure.