diff options
| author | Tom Lane | 2005-05-03 19:18:31 +0000 |
|---|---|---|
| committer | Tom Lane | 2005-05-03 19:18:31 +0000 |
| commit | cff25fa049f42c9091e7ba0a4e8f080d2519a1f8 (patch) | |
| tree | 0824048e251fd0cf3cee63c2408a7951aea74d0a /doc/src | |
| parent | 308f01c304dd5225b9eebc10a34a00d755f92de9 (diff) | |
Alter the signature for encoding conversion functions to declare the
output area as INTERNAL not CSTRING. This is to prevent people from
calling the functions by hand. This is a permanent solution for the
back branches but I hope it is just a stopgap for HEAD.
Diffstat (limited to 'doc/src')
| -rw-r--r-- | doc/src/sgml/ref/create_conversion.sgml | 14 |
1 files changed, 8 insertions, 6 deletions
diff --git a/doc/src/sgml/ref/create_conversion.sgml b/doc/src/sgml/ref/create_conversion.sgml index cea5a2fa9e1..0bb8cbf4015 100644 --- a/doc/src/sgml/ref/create_conversion.sgml +++ b/doc/src/sgml/ref/create_conversion.sgml @@ -1,4 +1,4 @@ -<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_conversion.sgml,v 1.13 2003/09/22 00:16:57 petere Exp $ --> +<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_conversion.sgml,v 1.13.2.1 2005/05/03 19:18:31 tgl Exp $ --> <refentry id="SQL-CREATECONVERSION"> <refmeta> @@ -8,7 +8,7 @@ <refnamediv> <refname>CREATE CONVERSION</refname> - <refpurpose>define a new conversion</refpurpose> + <refpurpose>define a new encoding conversion</refpurpose> </refnamediv> <indexterm zone="sql-createconversion"> @@ -26,10 +26,12 @@ CREATE [DEFAULT] CONVERSION <replaceable>name</replaceable> <title>Description</title> <para> - <command>CREATE CONVERSION</command> defines a new encoding - conversion. Conversion names may be used in the <function>convert</function> function + <command>CREATE CONVERSION</command> defines a new conversion between + character set encodings. Conversion names may be used in the + <function>convert</function> function to specify a particular encoding conversion. Also, conversions that - are marked <literal>DEFAULT</> can be used for automatic encoding conversion between + are marked <literal>DEFAULT</> can be used for automatic encoding + conversion between client and server. For this purpose, two conversions, from encoding A to B <emphasis>and</emphasis> from encoding B to A, must be defined. </para> @@ -109,7 +111,7 @@ conv_proc( integer, -- source encoding ID integer, -- destination encoding ID cstring, -- source string (null terminated C string) - cstring, -- destination string (null terminated C string) + internal, -- destination (fill with a null terminated C string) integer -- source string length ) RETURNS void; </programlisting> |