Received: from malur.postgresql.org ([217.196.149.56])
 by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from
 <pgsql-docs-owner+M7872=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1W23pc-0007GG-2j
 for pgsql-docs@arkaria.postgresql.org; Sat, 11 Jan 2014 19:02:52 +0000
Received: from localhost ([127.0.0.1] helo=postgresql.org)
 by malur.postgresql.org with smtp (Exim 4.80) (envelope-from
 <pgsql-docs-owner+M7872=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1W23pb-0007Lu-Iy
 for pgsql-docs@arkaria.postgresql.org; Sat, 11 Jan 2014 19:02:51 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
 by malur.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <bruce@momjian.us>) id 1W23pb-0007Lo-0G
 for pgsql-docs@postgresql.org; Sat, 11 Jan 2014 19:02:51 +0000
Received: from momjian.us ([72.94.173.45])
 by magus.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <bruce@momjian.us>) id 1W23pY-0000P0-1a
 for pgsql-docs@postgresql.org; Sat, 11 Jan 2014 19:02:50 +0000
Received: from bruce by momjian.us with local (Exim 4.72)
 (envelope-from <bruce@momjian.us>)
 id 1W23pW-0000cV-9G; Sat, 11 Jan 2014 14:02:46 -0500
Date: Sat, 11 Jan 2014 14:02:46 -0500
From: Bruce Momjian <bruce@momjian.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Pavel Stehule <pavel.stehule@gmail.com>,
 pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: remove undocumented assign syntax from plpgsql doc
Message-ID: <20140111190246.GG28089@momjian.us>
References: 
 <CAFj8pRDHJqRwZd-GO1t3WnLnS--E943xPrEUSOT_nL8xr9mE2g@mail.gmail.com>
 <20140111184106.GF28089@momjian.us>
 <24220.1389466350@sss.pgh.pa.us>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="bg08WKrSYDhXBjb5"
Content-Disposition: inline
In-Reply-To: <24220.1389466350@sss.pgh.pa.us>
User-Agent: Mutt/1.5.20 (2009-06-14)
X-Pg-Spam-Score: -2.0 (--)
List-Archive: <http://archives.postgresql.org/pgsql-docs>
List-Help: <mailto:majordomo@postgresql.org?body=help>
List-ID: <pgsql-docs.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@postgresql.org>
List-Post: <mailto:pgsql-docs@postgresql.org>
List-Subscribe: <mailto:majordomo@postgresql.org?body=sub%20pgsql-docs>
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-docs>
X-Mailing-List: pgsql-docs
Precedence: bulk
Sender: pgsql-docs-owner@postgresql.org


--bg08WKrSYDhXBjb5
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

On Sat, Jan 11, 2014 at 01:52:30PM -0500, Tom Lane wrote:
> Bruce Momjian <bruce@momjian.us> writes:
> > On Wed, May 29, 2013 at 10:02:20AM +0200, Pavel Stehule wrote:
> >> remove undocumented syntax for assign statements in plpgsql doc examples
> 
> > Applied.
> 
> I thought the consensus in the referenced thread had been to go the other
> way.  We're not going to remove the syntax option to use "=", so shouldn't
> we document it rather than pretending it doesn't exist?
> 
> The end of the other thread was
> http://www.postgresql.org/message-id/1370122048.6266.YahooMailNeo@web162902.mail.bf1.yahoo.com

Oh, I think you are right.  I have reverted the patch.  Attached is
proposed documentation for '='.

-- 
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

  + Everyone has their own god. +

--bg08WKrSYDhXBjb5
Content-Type: text/x-diff; charset=us-ascii
Content-Disposition: attachment; filename="assign.diff"

diff --git a/doc/src/sgml/plpgsql.sgml b/doc/src/sgml/plpgsql.sgml
new file mode 100644
index ca2c2b5..6c83789
*** a/doc/src/sgml/plpgsql.sgml
--- b/doc/src/sgml/plpgsql.sgml
*************** arow RECORD;
*** 328,334 ****
      <para>
       The general syntax of a variable declaration is:
  <synopsis>
! <replaceable>name</replaceable> <optional> CONSTANT </optional> <replaceable>type</replaceable> <optional> COLLATE <replaceable>collation_name</replaceable> </optional> <optional> NOT NULL </optional> <optional> { DEFAULT | := } <replaceable>expression</replaceable> </optional>;
  </synopsis>
        The <literal>DEFAULT</> clause, if given, specifies the initial value assigned
        to the variable when the block is entered.  If the <literal>DEFAULT</> clause
--- 328,334 ----
      <para>
       The general syntax of a variable declaration is:
  <synopsis>
! <replaceable>name</replaceable> <optional> CONSTANT </optional> <replaceable>type</replaceable> <optional> COLLATE <replaceable>collation_name</replaceable> </optional> <optional> NOT NULL </optional> <optional> { DEFAULT | := | = } <replaceable>expression</replaceable> </optional>;
  </synopsis>
        The <literal>DEFAULT</> clause, if given, specifies the initial value assigned
        to the variable when the block is entered.  If the <literal>DEFAULT</> clause

--bg08WKrSYDhXBjb5
Content-Type: text/plain
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0


-- 
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

--bg08WKrSYDhXBjb5--