]> granicus.if.org Git - postgresql/commitdiff
Adjust hints and docs to suggest CREATE EXTENSION not CREATE LANGUAGE.
authorTom Lane <tgl@sss.pgh.pa.us>
Fri, 27 Apr 2018 17:42:03 +0000 (13:42 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Fri, 27 Apr 2018 17:42:03 +0000 (13:42 -0400)
The core PLs have been extension-ified for seven years now, and we can
reasonably hope that all out-of-core PLs have been too.  So adjust a few
places that were still recommending CREATE LANGUAGE as the user-level
way to install a PL.

Discussion: https://postgr.es/m/CA+TgmoaJTUDMSuSCg4k08Dv8vhbrJq9nP3ZfPbmysVz_616qxw@mail.gmail.com

doc/src/sgml/ref/create_transform.sgml
doc/src/sgml/ref/do.sgml
src/backend/commands/functioncmds.c

index 17cb1932cfe5a0b39e73235efdab76d3c98cbb10..4bce36b41a74cdf21adc9ae68c9176e513fa3942 100644 (file)
@@ -157,7 +157,7 @@ CREATE [ OR REPLACE ] TRANSFORM FOR <replaceable>type_name</replaceable> LANGUAG
 <programlisting>
 CREATE TYPE hstore ...;
 
-CREATE LANGUAGE plpythonu ...;
+CREATE EXTENSION plpythonu;
 </programlisting>
    Then create the necessary functions:
 <programlisting>
@@ -176,7 +176,7 @@ CREATE TRANSFORM FOR hstore LANGUAGE plpythonu (
     TO SQL WITH FUNCTION plpython_to_hstore(internal)
 );
 </programlisting>
-   In practice, these commands would be wrapped up in extensions.
+   In practice, these commands would be wrapped up in an extension.
   </para>
 
   <para>
index b9a6f9a6fd69bb46f5dc1425b789b38ce717830a..a3a4877e80ffed2f26c4ee4b45ebaabe7b74890a 100644 (file)
@@ -81,7 +81,7 @@ DO [ LANGUAGE <replaceable class="parameter">lang_name</replaceable> ] <replacea
 
   <para>
    The procedural language to be used must already have been installed
-   into the current database by means of <command>CREATE LANGUAGE</command>.
+   into the current database by means of <command>CREATE EXTENSION</command>.
    <literal>plpgsql</literal> is installed by default, but other languages are not.
   </para>
 
index cc229bbecf040475b958eba968cdf6d4a7bb59c7..8864d9ae44676941b2c0c1f6cfe005d918bfabfd 100644 (file)
@@ -934,7 +934,7 @@ CreateFunction(ParseState *pstate, CreateFunctionStmt *stmt)
                                (errcode(ERRCODE_UNDEFINED_OBJECT),
                                 errmsg("language \"%s\" does not exist", language),
                                 (PLTemplateExists(language) ?
-                                 errhint("Use CREATE LANGUAGE to load the language into the database.") : 0)));
+                                 errhint("Use CREATE EXTENSION to load the language into the database.") : 0)));
 
        languageOid = HeapTupleGetOid(languageTuple);
        languageStruct = (Form_pg_language) GETSTRUCT(languageTuple);
@@ -2136,7 +2136,7 @@ ExecuteDoStmt(DoStmt *stmt, bool atomic)
                                (errcode(ERRCODE_UNDEFINED_OBJECT),
                                 errmsg("language \"%s\" does not exist", language),
                                 (PLTemplateExists(language) ?
-                                 errhint("Use CREATE LANGUAGE to load the language into the database.") : 0)));
+                                 errhint("Use CREATE EXTENSION to load the language into the database.") : 0)));
 
        codeblock->langOid = HeapTupleGetOid(languageTuple);
        languageStruct = (Form_pg_language) GETSTRUCT(languageTuple);