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-0003hz-It@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
------
REL8_3_STABLE

Details
-------
http://git.postgresql.org/pg/commitdiff/8bae564f6ac9c682960f181505e0025768a489d9

Modified Files
--------------
doc/src/sgml/config.sgml | 22 +++++++++++++++++-----
doc/src/sgml/ddl.sgml | 29 +++++++++++++++++------------
doc/src/sgml/queries.sgml | 10 ++++++++++
doc/src/sgml/ref/alter_table.sgml | 15 ++++++---------
doc/src/sgml/ref/delete.sgml | 27 ++++++++-------------------
doc/src/sgml/ref/select.sgml | 16 ++++++----------
doc/src/sgml/ref/update.sgml | 14 ++++++--------
7 files changed, 70 insertions(+), 63 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