Adding a Column documentation is misleading

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: gavinflower(at)archidevsys(dot)co(dot)nz
Subject: Adding a Column documentation is misleading
Date: 2019-11-06 03:24:44
Message-ID: 157301068439.14260.3440469821975939421@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/12/ddl-alter.html
Description:

In 5.6.1. Adding a Column, there is a kind of example 'ALTER TABLE products
ADD COLUMN description text;'

The words 'description' and 'text' are misleading -- as according to the
formal documentation of the SQL command
(https://www.postgresql.org/docs/12/sql-altertable.html) they should be
'column_name' and 'data_type'.

A similar problem exists for removing a column, and other actions.

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2019-11-06 04:21:11 Re: Why 'infinity' is not in range '[2019-01-02, infinity]'?
Previous Message Bruce Momjian 2019-11-06 02:29:18 Re: Correction For PostgreSQL Manual