1 files changed, 17 insertions, 7 deletions
diff --git a/doc/src/sgml/ref/createlang.sgml b/doc/src/sgml/ref/createlang.sgml
index 36bd318e1de..0bc1976c15e 100644
--- a/doc/src/sgml/ref/createlang.sgml
+++ b/doc/src/sgml/ref/createlang.sgml
@@ -12,7 +12,7 @@ PostgreSQL documentation
 
  <refnamediv>
   <refname>createlang</refname>
-  <refpurpose>define a new <productname>PostgreSQL</productname> procedural language</refpurpose>
+  <refpurpose>install a <productname>PostgreSQL</productname> procedural language</refpurpose>
  </refnamediv>
 
  <indexterm zone="app-createlang">
@@ -40,12 +40,22 @@ PostgreSQL documentation
   <title>Description</title>
 
   <para>
-   <application>createlang</application> is a utility for adding a new
-   programming language to a <productname>PostgreSQL</productname> database.
+   <application>createlang</application> is a utility for adding a
+   procedural language to a <productname>PostgreSQL</productname> database.
+  </para>
+
+  <para>
    <application>createlang</application> is just a wrapper around the
-   <xref linkend="sql-createlanguage">
-   command.
+   <xref linkend="sql-createextension"> SQL command.
   </para>
+
+  <caution>
+   <para>
+    <application>createlang</application> is deprecated and may be removed
+    in a future <productname>PostgreSQL</productname> release.  Direct use
+    of the <command>CREATE EXTENSION</> command is recommended instead.
+   </para>
+  </caution>
  </refsect1>
 
 
@@ -60,8 +70,7 @@ PostgreSQL documentation
       <term><replaceable class="parameter">langname</replaceable></term>
       <listitem>
        <para>
-        Specifies the name of the procedural programming language to be
-        defined.
+        Specifies the name of the procedural language to be installed.
        </para>
       </listitem>
      </varlistentry>
@@ -273,6 +282,7 @@ PostgreSQL documentation
 
   <simplelist type="inline">
    <member><xref linkend="app-droplang"></member>
+   <member><xref linkend="sql-createextension"></member>
    <member><xref linkend="sql-createlanguage"></member>
   </simplelist>
  </refsect1>