BUG #13445: 8.15.1 is missleading regarding array dimensionality

Lists: pgsql-bugs
From: brent(dot)n(dot)douglas(at)gmail(dot)com
To: pgsql-bugs(at)postgresql(dot)org
Subject: BUG #13445: 8.15.1 is missleading regarding array dimensionality
Date: 2015-06-15 16:16:09
Message-ID: 20150615161609.2737.79192@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-bugs

The following bug has been logged on the website:

Bug reference: 13445
Logged by: Brent Douglas
Email address: brent(dot)n(dot)douglas(at)gmail(dot)com
PostgreSQL version: 9.4.4
Operating system: docs only
Description:

Section 8.15.1 is slightly missleading regarding array dimensionality as the
first example and following comment both read like array declarations in
many programming languages where [] is a single dimensional array and [][]
is a two dimensional array while having different semantics.

To make it more obvious that arrays do not have dimensions the section
stating this could be moved before the example table sal_emp.

The words "one-dimensional" and "two-dimensional" in the comment on the
sal_emp example table could also be removed.


From: Bruce Momjian <bruce(at)momjian(dot)us>
To: brent(dot)n(dot)douglas(at)gmail(dot)com
Cc: pgsql-bugs(at)postgresql(dot)org
Subject: Re: BUG #13445: 8.15.1 is missleading regarding array dimensionality
Date: 2015-08-10 00:08:49
Message-ID: 20150810000849.GB6582@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-bugs

On Mon, Jun 15, 2015 at 04:16:09PM +0000, brent(dot)n(dot)douglas(at)gmail(dot)com wrote:
> The following bug has been logged on the website:
>
> Bug reference: 13445
> Logged by: Brent Douglas
> Email address: brent(dot)n(dot)douglas(at)gmail(dot)com
> PostgreSQL version: 9.4.4
> Operating system: docs only
> Description:
>
> Section 8.15.1 is slightly missleading regarding array dimensionality as the
> first example and following comment both read like array declarations in
> many programming languages where [] is a single dimensional array and [][]
> is a two dimensional array while having different semantics.
>
> To make it more obvious that arrays do not have dimensions the section
> stating this could be moved before the example table sal_emp.
>
> The words "one-dimensional" and "two-dimensional" in the comment on the
> sal_emp example table could also be removed.

Well, it's a little odd because while dimensionality is not enforced
when defining columns, it does have an effect when accessing values. I
am not sure that mentioning things in the opposite order would help as
we have to define dimensionality for us later.

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ Everyone has their own god. +