Received: from malur.postgresql.org ([217.196.149.56])
 by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from
 <pgsql-docs-owner+M7874=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1W24Op-0000QZ-1t
 for pgsql-docs@arkaria.postgresql.org; Sat, 11 Jan 2014 19:39:15 +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+M7874=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1W24Oo-0001OG-Gp
 for pgsql-docs@arkaria.postgresql.org; Sat, 11 Jan 2014 19:39:14 +0000
Received: from makus.postgresql.org ([2001:4800:7903:4::125])
 by malur.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <bruce@momjian.us>) id 1W24Om-0001MV-Ub
 for pgsql-docs@postgresql.org; Sat, 11 Jan 2014 19:39:13 +0000
Received: from momjian.us ([72.94.173.45])
 by makus.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <bruce@momjian.us>) id 1W24Oj-0001t4-9v
 for pgsql-docs@postgresql.org; Sat, 11 Jan 2014 19:39:12 +0000
Received: from bruce by momjian.us with local (Exim 4.72)
 (envelope-from <bruce@momjian.us>)
 id 1W24Oh-0005Gm-Uw; Sat, 11 Jan 2014 14:39:07 -0500
Date: Sat, 11 Jan 2014 14:39:07 -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: <20140111193907.GL28089@momjian.us>
References: 
 <CAFj8pRDHJqRwZd-GO1t3WnLnS--E943xPrEUSOT_nL8xr9mE2g@mail.gmail.com>
 <20140111184106.GF28089@momjian.us>
 <24220.1389466350@sss.pgh.pa.us>
 <20140111190246.GG28089@momjian.us>
 <24577.1389467569@sss.pgh.pa.us>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="RASg3xLB4tUQ4RcS"
Content-Disposition: inline
In-Reply-To: <24577.1389467569@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


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

On Sat, Jan 11, 2014 at 02:12:49PM -0500, Tom Lane wrote:
> Bruce Momjian <bruce@momjian.us> writes:
> > Oh, I think you are right.  I have reverted the patch.  Attached is
> > proposed documentation for '='.
> 
> Meh.  Variable initialization is only one of multiple cases (assignment,
> GET DIAGNOSTICS; maybe others, I've not examined the grammar).  Also,
> if we do it like this, we're implying that both := and = are equally
> preferred, which might not be the impression we want to leave.
> 
> I'd be a bit inclined to just stick a NOTE somewhere saying that "="
> can be used in place of ":=" for assignment.

OK, here is an updated doc patch that does that.  The next question is
whether we want examples using '=' instead of ':='?  Right now we have
them, and Pavel's patch removed them.

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

  + Everyone has their own god. +

--RASg3xLB4tUQ4RcS
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..4cf9be9
*** a/doc/src/sgml/plpgsql.sgml
--- b/doc/src/sgml/plpgsql.sgml
*************** arow RECORD;
*** 343,348 ****
--- 343,349 ----
        is specified, an assignment of a null value results in a run-time
        error. All variables declared as <literal>NOT NULL</>
        must have a nonnull default value specified.
+       Equals (<literal>=</>) can be used instead of <literal>:=</>.
       </para>
  
       <para>

--RASg3xLB4tUQ4RcS
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

--RASg3xLB4tUQ4RcS--