The use "Postgres" in docs

Started by Daniel Gustafssonabout 3 years ago6 messagesdocs
Jump to latest
#1Daniel Gustafsson
daniel@yesql.se

The docs use PostgreSQL and not Postgres in all but two places, which I think
we should change like in the attached to be consistent. Any objections to this?

--
Daniel Gustafsson

Attachments:

postgres_title.diffapplication/octet-stream; name=postgres_title.diff; x-unix-mode=0644Download+4-2
#2Alvaro Herrera
alvherre@2ndquadrant.com
In reply to: Daniel Gustafsson (#1)
Re: The use "Postgres" in docs

On 2023-Mar-14, Daniel Gustafsson wrote:

The docs use PostgreSQL and not Postgres in all but two places, which I think
we should change like in the attached to be consistent. Any objections to this?

Both are very new. No objection to the change.

--
Álvaro Herrera Breisgau, Deutschland — https://www.EnterpriseDB.com/

#3Jonathan S. Katz
jkatz@postgresql.org
In reply to: Alvaro Herrera (#2)
Re: The use "Postgres" in docs

On 3/14/23 7:31 AM, Alvaro Herrera wrote:

On 2023-Mar-14, Daniel Gustafsson wrote:

The docs use PostgreSQL and not Postgres in all but two places, which I think
we should change like in the attached to be consistent. Any objections to this?

Both are very new. No objection to the change.

+1 -- good catch.

Jonathan

#4Daniel Gustafsson
daniel@yesql.se
In reply to: Jonathan S. Katz (#3)
Re: The use "Postgres" in docs

On 14 Mar 2023, at 13:55, Jonathan S. Katz <jkatz@postgresql.org> wrote:

On 3/14/23 7:31 AM, Alvaro Herrera wrote:

On 2023-Mar-14, Daniel Gustafsson wrote:

The docs use PostgreSQL and not Postgres in all but two places, which I think
we should change like in the attached to be consistent. Any objections to this?

Both are very new. No objection to the change.

+1 -- good catch.

Applied, thanks!

--
Daniel Gustafsson

#5Kirk Parker
khp@equatoria.us
In reply to: Daniel Gustafsson (#1)
Nulls Not Distinct in Unique Indexes secton

The Unique Indexes section (
https://www.postgresql.org/docs/15/indexes-unique.html) does not mention
the new NULLS [ NOT ] DISTINCT capability of indexes (
https://www.postgresql.org/docs/15/sql-createindex.html), and it probably
should.

Specifically, it has the exact wording from previous versions (emphasis
added):

When an index is declared unique, multiple table
rows with equal indexed values are not allowed.
*Null values are not considered equal*.

We should consider adding "unless the NULLS NOT DISTINCT clause is used
when creating the index", or something to that effect.

#6Laurenz Albe
laurenz.albe@cybertec.at
In reply to: Kirk Parker (#5)
Re: Nulls Not Distinct in Unique Indexes secton

On Tue, 2023-03-14 at 08:24 -0700, Kirk Parker wrote:

The Unique Indexes section (https://www.postgresql.org/docs/15/indexes-unique.html)
does not mention the new NULLS [ NOT ] DISTINCT capability of indexes
(https://www.postgresql.org/docs/15/sql-createindex.html), and it probably should.

Specifically, it has the exact wording from previous versions (emphasis added):

    When an index is declared unique, multiple table
    rows with equal indexed values are not allowed.
    *Null values are not considered equal*.

We should consider adding "unless the NULLS NOT DISTINCT clause is used when
creating the index", or something to that effect.

+1

Here is a patch for that.

Yours,
Laurenz Albe

Attachments:

0001-Mention-NULLS-NOT-DISTINCT-in-the-SQL-documentation.patchtext/x-patch; charset=UTF-8; name=0001-Mention-NULLS-NOT-DISTINCT-in-the-SQL-documentation.patchDownload+3-3