agora inbox for pgsql-docs@postgresql.org
help / color / mirror / Atom feed[PATCH v2] Improve installation instructions a bit
5+ messages / 4 participants
[nested] [flat]
* [PATCH v2] Improve installation instructions a bit
@ 2021-07-13 17:06 Alvaro Herrera <alvherre@alvh.no-ip.org>
0 siblings, 0 replies; 5+ messages in thread
From: Alvaro Herrera @ 2021-07-13 17:06 UTC (permalink / raw)
Reported-by: Daniel Westermann
Discussion: https://postgr.es/m/GV0P278MB04835AAEACF894617574EB6BD25A9@GV0P278MB0483.CHEP278.PROD.OUTLOOK.COM
---
doc/src/sgml/installation.sgml | 18 ++++++++----------
1 file changed, 8 insertions(+), 10 deletions(-)
diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index 05b77ec8e6..005d84af3b 100644
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -356,19 +356,17 @@ su - postgres
<para>
The <productname>PostgreSQL</productname> &version; sources can be obtained from the
download section of our
- website: <ulink url="https://www.postgresql.org/download/"></ulink;. You
+ website: <ulink url="https://www.postgresql.org/ftp/source/"></ulink;. You
should get a file named <filename>postgresql-&version;.tar.gz</filename>
- or <filename>postgresql-&version;.tar.bz2</filename>. After
- you have obtained the file, unpack it:
+ or <filename>postgresql-&version;.tar.bz2</filename>.
+ (For the version currently in development, the file is named
+ <filename>postgresql-snapshot.tar.bz2</filename> and resides in
+ <ulink url="https://www.postgresql.org/ftp/snapshot/dev/"></ulink;;
+ but using the version control repository, below, is recommended.)
+ After you have obtained the file, unpack it:
<screen>
-<userinput>gunzip postgresql-&version;.tar.gz</userinput>
-<userinput>tar xf postgresql-&version;.tar</userinput>
+<userinput>tar xfa postgresql-&version;.tar.gz</userinput>
</screen>
- (Use <command>bunzip2</command> instead of <command>gunzip</command> if
- you have the <filename>.bz2</filename> file. Also, note that most
- modern versions of <command>tar</command> can unpack compressed archives
- directly, so you don't really need the
- separate <command>gunzip</command> or <command>bunzip2</command> step.)
This will create a directory
<filename>postgresql-&version;</filename> under the current directory
with the <productname>PostgreSQL</productname> sources.
--
2.30.2
--cukfwqd3x2sookv2
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
filename="v3-0001-Improve-installation-instructions-a-bit.patch"
^ permalink raw reply [nested|flat] 5+ messages in thread
* [PATCH v3] Improve installation instructions a bit
@ 2021-07-13 17:06 Alvaro Herrera <alvherre@alvh.no-ip.org>
0 siblings, 0 replies; 5+ messages in thread
From: Alvaro Herrera @ 2021-07-13 17:06 UTC (permalink / raw)
Reported-by: Daniel Westermann
Discussion: https://postgr.es/m/GV0P278MB04835AAEACF894617574EB6BD25A9@GV0P278MB0483.CHEP278.PROD.OUTLOOK.COM
---
doc/src/sgml/installation.sgml | 41 +++++++++++++++++++---------------
1 file changed, 23 insertions(+), 18 deletions(-)
diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index 05b77ec8e6..5a900da0a3 100644
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -354,32 +354,37 @@ su - postgres
<title>Getting the Source</title>
<para>
- The <productname>PostgreSQL</productname> &version; sources can be obtained from the
- download section of our
- website: <ulink url="https://www.postgresql.org/download/"></ulink;. You
- should get a file named <filename>postgresql-&version;.tar.gz</filename>
- or <filename>postgresql-&version;.tar.bz2</filename>. After
- you have obtained the file, unpack it:
+ The version control repository for <productname>PostgreSQL</productname>
+ can be obtained from
+ <ulink url="https://git.postgresql.org/gitweb/?p=postgresql.git;a=summary"></ulink;;
+ this is the recommended way to obtain the
+ <productname>PostgreSQL</productname> source code.
+ You can obtain a clone of the repository by running
<screen>
-<userinput>gunzip postgresql-&version;.tar.gz</userinput>
-<userinput>tar xf postgresql-&version;.tar</userinput>
+<userinput>git clone https://git.postgresql.org/git/postgresql.git</userinput;
+</screen>
+ This will create a directory <filename>postgresql</filename> under the current
+ directory with the <productname>PostgreSQL</productname> sources.
+ Change into that directory for the rest of the installation procedure.
+ See <xref linkend="git"/> for further information.
+ </para>
+
+ <para>
+ Alternatively,
+ the released versions can be obtained from the download section of our
+ website: <ulink url="https://www.postgresql.org/ftp/source/"></ulink;.
+ You should get a file named <filename>postgresql-&version;.tar.gz</filename>
+ or <filename>postgresql-&version;.tar.bz2</filename>.
+ After you have obtained the file, unpack it:
+<screen>
+<userinput>tar xfa postgresql-&version;.tar.gz</userinput>
</screen>
- (Use <command>bunzip2</command> instead of <command>gunzip</command> if
- you have the <filename>.bz2</filename> file. Also, note that most
- modern versions of <command>tar</command> can unpack compressed archives
- directly, so you don't really need the
- separate <command>gunzip</command> or <command>bunzip2</command> step.)
This will create a directory
<filename>postgresql-&version;</filename> under the current directory
with the <productname>PostgreSQL</productname> sources.
Change into that directory for the rest
of the installation procedure.
</para>
-
- <para>
- You can also get the source directly from the version control repository, see
- <xref linkend="sourcerepo"/>.
- </para>
</sect1>
<sect1 id="install-procedure">
--
2.30.2
--cukfwqd3x2sookv2--
^ permalink raw reply [nested|flat] 5+ messages in thread
* RE: Changes in CREATE EXTENSION from being an extension to statement
@ 2025-05-04 06:17 PG Doc comments form <noreply@postgresql.org>
0 siblings, 2 replies; 5+ messages in thread
From: PG Doc comments form @ 2025-05-04 06:17 UTC (permalink / raw)
To: pgsql-docs@lists.postgresql.org; +Cc: gurungswastik1990@gmail.com
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/17/sql-createextension.html
Description:
I wonder if it is appropriate to use "CREATE EXTENSION is a PostgreSQL
statement." instead of "CREATE EXTENSION is a PostgreSQL extension."
^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: Changes in CREATE EXTENSION from being an extension to statement
@ 2025-05-04 14:07 David G. Johnston <david.g.johnston@gmail.com>
parent: PG Doc comments form <noreply@postgresql.org>
1 sibling, 0 replies; 5+ messages in thread
From: David G. Johnston @ 2025-05-04 14:07 UTC (permalink / raw)
To: gurungswastik1990@gmail.com <gurungswastik1990@gmail.com>; pgsql-docs@lists.postgresql.org <pgsql-docs@lists.postgresql.org>
On Saturday, May 3, 2025, PG Doc comments form <noreply@postgresql.org>
wrote:
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/17/sql-createextension.html
> Description:
>
> I wonder if it is appropriate to use "CREATE EXTENSION is a PostgreSQL
> statement." instead of "CREATE EXTENSION is a PostgreSQL extension."
>
I can’t see changing everywhere how we word our note that something is not
part of the SQL standard just because this one instance is a bit odd to
read.
David J.
^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: Changes in CREATE EXTENSION from being an extension to statement
@ 2025-05-15 07:32 Tonny Hawk <tonnyhawk111@gmail.com>
parent: PG Doc comments form <noreply@postgresql.org>
1 sibling, 0 replies; 5+ messages in thread
From: Tonny Hawk @ 2025-05-15 07:32 UTC (permalink / raw)
To: gurungswastik1990@gmail.com; pgsql-docs@lists.postgresql.org
Delete my account!!!
Dne st 14. 5. 2025 22:52 uživatel PG Doc comments form <
noreply@postgresql.org> napsal:
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/17/sql-createextension.html
> Description:
>
> I wonder if it is appropriate to use "CREATE EXTENSION is a PostgreSQL
> statement." instead of "CREATE EXTENSION is a PostgreSQL extension."
>
^ permalink raw reply [nested|flat] 5+ messages in thread
end of thread, other threads:[~2025-05-15 07:32 UTC | newest]
Thread overview: 5+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2021-07-13 17:06 [PATCH v2] Improve installation instructions a bit Alvaro Herrera <alvherre@alvh.no-ip.org>
2021-07-13 17:06 [PATCH v3] Improve installation instructions a bit Alvaro Herrera <alvherre@alvh.no-ip.org>
2025-05-04 06:17 RE: Changes in CREATE EXTENSION from being an extension to statement PG Doc comments form <noreply@postgresql.org>
2025-05-04 14:07 ` Re: Changes in CREATE EXTENSION from being an extension to statement David G. Johnston <david.g.johnston@gmail.com>
2025-05-15 07:32 ` Re: Changes in CREATE EXTENSION from being an extension to statement Tonny Hawk <tonnyhawk111@gmail.com>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox