pgsql: Provide adequate documentation of the "table_name *" notation. - Mailing list pgsql-committers

From Tom Lane
Subject pgsql: Provide adequate documentation of the "table_name *" notation.
Date
Msg-id E1TDgYN-0003hw-Hr@gemulon.postgresql.org
Whole thread Raw
List pgsql-committers
Provide adequate documentation of the "table_name *" notation.

Somewhere along the line, somebody decided to remove all trace of this
notation from the documentation text.  It was still in the command syntax
synopses, or at least some of them, but with no indication what it meant.
This will not do, as evidenced by the confusion apparent in bug #7543;
even if the notation is now unnecessary, people will find it in legacy
SQL code and need to know what it does.

Branch
------
REL8_4_STABLE

Details
-------
http://git.postgresql.org/pg/commitdiff/c842673b86b1ad235e7296b47861e70f556eedab

Modified Files
--------------
doc/src/sgml/config.sgml          |   22 +++++++++++++++++-----
doc/src/sgml/ddl.sgml             |   37 +++++++++++++++++++++----------------
doc/src/sgml/queries.sgml         |   10 ++++++++++
doc/src/sgml/ref/alter_table.sgml |   12 +++++++-----
doc/src/sgml/ref/delete.sgml      |   27 ++++++++-------------------
doc/src/sgml/ref/lock.sgml        |   10 ++++++----
doc/src/sgml/ref/select.sgml      |   33 ++++++++++++++++++++++-----------
doc/src/sgml/ref/truncate.sgml    |   12 +++++++-----
doc/src/sgml/ref/update.sgml      |   14 ++++++--------
9 files changed, 104 insertions(+), 73 deletions(-)


pgsql-committers by date:

Previous
From: Tom Lane
Date:
Subject: pgsql: Provide adequate documentation of the "table_name *" notation.
Next
From: Tom Lane
Date:
Subject: pgsql: Provide adequate documentation of the "table_name *" notation.