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-0003ht-FY@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
------
REL9_1_STABLE

Details
-------
http://git.postgresql.org/pg/commitdiff/34405830517e2a4e5c3ab3f68cf3435f193944ae

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.