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-0003hn-Bm@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
------
master

Details
-------
http://git.postgresql.org/pg/commitdiff/3c64342c861c77504df6c195c9db3e166d0c7491

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: Peter Eisentraut
Date:
Subject: pgsql: libpq: Add missing directory to installdirs target