aboutsummaryrefslogtreecommitdiff
path: root/doc/src/sgml/ref/createlang.sgml
diff options
context:
space:
mode:
authorTom Lane <tgl@sss.pgh.pa.us>2011-03-05 14:03:06 -0500
committerTom Lane <tgl@sss.pgh.pa.us>2011-03-05 14:03:06 -0500
commitba0c93a0f46ca70cae47a8817067c1e98482979f (patch)
tree98686028d05eb9ca1d81a00bde94b057dbe7d6f3 /doc/src/sgml/ref/createlang.sgml
parentc0f2b2e256a3e98c2a066cee8623b7ab156b7f9c (diff)
downloadpostgresql-ba0c93a0f46ca70cae47a8817067c1e98482979f.tar.gz
postgresql-ba0c93a0f46ca70cae47a8817067c1e98482979f.zip
Convert createlang/droplang to use CREATE/DROP EXTENSION.
In createlang this is a one-line change. In droplang there's a whole lot of cruft that can be discarded since the extension mechanism now manages removal of the language's support functions. Also, add deprecation notices to these two programs' reference pages, since per discussion we may toss them overboard altogether in a release or two.
Diffstat (limited to 'doc/src/sgml/ref/createlang.sgml')
-rw-r--r--doc/src/sgml/ref/createlang.sgml24
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>