diff options
| author | Tom Lane <tgl@sss.pgh.pa.us> | 2011-03-05 01:08:38 -0500 |
|---|---|---|
| committer | Tom Lane <tgl@sss.pgh.pa.us> | 2011-03-05 01:08:38 -0500 |
| commit | c2903fb3d2aeb0a7206945478ad28bc47bd6c6e8 (patch) | |
| tree | a4e5275cb673648df888773809bcfae01d352166 /doc/src/sgml/ref/create_language.sgml | |
| parent | 63b656b7bf39beb5b6095ab2b5e1e4e9d8c6a965 (diff) | |
Update documentation to reflect that standard PLs are now extensions.
Recommend use of CREATE EXTENSION rather than plain CREATE LANGUAGE
where relevant. Encourage PL authors to provide extension wrappers
for their PLs.
Diffstat (limited to 'doc/src/sgml/ref/create_language.sgml')
| -rw-r--r-- | doc/src/sgml/ref/create_language.sgml | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/src/sgml/ref/create_language.sgml b/doc/src/sgml/ref/create_language.sgml index c9cb95cae59..13c3baf993c 100644 --- a/doc/src/sgml/ref/create_language.sgml +++ b/doc/src/sgml/ref/create_language.sgml @@ -37,6 +37,21 @@ CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE <replaceable class="pa defined in this new language. </para> + <note> + <para> + As of <productname>PostgreSQL</productname> 9.1, most procedural + languages have been made into <quote>extensions</>, and should + therefore be installed with <xref linkend="sql-createextension"> + not <command>CREATE LANGUAGE</command>. Direct use of + <command>CREATE LANGUAGE</command> should now be confined to + extension installation scripts. If you have a <quote>bare</> + language in your database, perhaps as a result of an upgrade, + you can convert it to an extension using + <literal>CREATE EXTENSION <replaceable>langname</> FROM + unpackaged</literal>. + </para> + </note> + <para> <command>CREATE LANGUAGE</command> effectively associates the language name with handler function(s) that are responsible for executing |