pgsql: Provide adequate documentation of the "table_name *" notation.

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: pgsql-committers(at)postgresql(dot)org
Subject: pgsql: Provide adequate documentation of the "table_name *" notation.
Date: 2012-09-17 19:00:19
Message-ID: E1TDgYN-0003hq-EQ@gemulon.postgresql.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: 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(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Simon Riggs 2012-09-17 21:04:18 Re: [COMMITTERS] pgsql: Fix bufmgr so CHECKPOINT_END_OF_RECOVERY behaves as a shutdown c
Previous Message Andres Freund 2012-09-17 15:14:51 Re: [COMMITTERS] pgsql: Fix bufmgr so CHECKPOINT_END_OF_RECOVERY behaves as a shutdown c