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-0003ht-FY@gemulon.postgresql.org
Views: Raw Message | Whole Thread | 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_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(-)

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