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-0003hw-Hr@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
------
REL8_4_STABLE

Details
-------
http://git.postgresql.org/pg/commitdiff/c842673b86b1ad235e7296b47861e70f556eedab

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