public inbox for [email protected]  
help / color / mirror / Atom feed
From: Bruce Momjian <[email protected]>
To: Marc Mamin <[email protected]>
Cc: Peter Eisentraut <[email protected]>
Cc: '[email protected]' <[email protected]>
Subject: Re: misleading lang_name case in CREATE FUNCTION doc.
Date: Thu, 13 Feb 2014 17:07:30 -0500
Message-ID: <[email protected]> (raw)
In-Reply-To: <B6F6FD62F2624C4C9916AC0175D56D880CE4B2A8@jenmbs01.ad.intershop.net>
References: <B6F6FD62F2624C4C9916AC0175D56D880CE2A93C@jenmbs01.ad.intershop.net>
	<[email protected]>
	<B6F6FD62F2624C4C9916AC0175D56D880CE4740C@jenmbs01.ad.intershop.net>
	<[email protected]>
	<B6F6FD62F2624C4C9916AC0175D56D880CE4B2A8@jenmbs01.ad.intershop.net>
List-Unsubscribe: <mailto:[email protected]?body=unsub%20pgsql-docs>

On Tue, Nov 26, 2013 at 07:28:17PM +0000, Marc Mamin wrote:
> 
> >Von: Peter Eisentraut [[email protected]]
> 
> >>On 11/13/13, 9:02 AM, Marc Mamin wrote:
> >> something like :?
> >>
> >> The name of the language that the function is implemented in.
> >> Can be 'sql', 'c', 'internal', or the name of a user-defined procedural language.
> >> Single quotes are optional, they required correct case when used.
> 
> >That would make the deprecated syntax more prominent than the
> >non-deprecated one.  We want to get rid of the single quotes.
> 
> Ok, next try :)
> 
> The name of the language that the function is implemented in.
> Can be sql, c, internal, or the name of a user-defined procedural language.
> Single quotes are deprecated. They require  correct case when used.

I have applied the attached patch to improve the wording.  Thanks for
the report.

-- 
  Bruce Momjian  <[email protected]>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

  + Everyone has their own god. +


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


Attachments:

  [text/x-diff] lang.diff (1.1K, 2-lang.diff)
  download | inline diff:
diff --git a/doc/src/sgml/ref/create_function.sgml b/doc/src/sgml/ref/create_function.sgml
new file mode 100644
index 81278bb..b61b978
*** a/doc/src/sgml/ref/create_function.sgml
--- b/doc/src/sgml/ref/create_function.sgml
*************** CREATE [ OR REPLACE ] FUNCTION
*** 252,261 ****
       <listitem>
        <para>
         The name of the language that the function is implemented in.
!        Can be <literal>SQL</literal>, <literal>C</literal>,
         <literal>internal</literal>, or the name of a user-defined
!        procedural language.  For backward compatibility,
!        the name can be enclosed by single quotes.
        </para>
       </listitem>
      </varlistentry>
--- 252,261 ----
       <listitem>
        <para>
         The name of the language that the function is implemented in.
!        It can be <literal>sql</literal>, <literal>c</literal>,
         <literal>internal</literal>, or the name of a user-defined
!        procedural language, e.g. <literal>plpgsql</literal>.  Enclosing the
!        name in single quotes is deprecated and requires matching case.
        </para>
       </listitem>
      </varlistentry>


view thread (6+ messages)

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected]
  Subject: Re: misleading lang_name case in CREATE FUNCTION doc.
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox