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-0003hq-EQ@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_2_STABLE

Details
-------
http://git.postgresql.org/pg/commitdiff/634d80ab2a61d8c29ce763018bd8790dffcb2bd6

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: Peter Eisentraut
Date:
Subject: pgsql: PL/Python: Improve Python 3 regression test setup
Next
From: Tom Lane
Date:
Subject: pgsql: Provide adequate documentation of the "table_name *" notation.