Update "encode" documentation to mention that 'escape' only changes null

bytes and backslashes, remove "ASCII" mention.  Backpatch to 8.2.X.

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 431e0c10fa8e661979727f333967e215ea44cf98..d7179465033094265991066f6636491f98ebfec1 100644 (file)
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.347.2.5 2007/02/20 14:05:02 momjian Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.347.2.6 2007/02/20 19:59:18 momjian Exp $ -->
 
  <chapter id="functions">
   <title>Functions and Operators</title>
@@ -1326,8 +1326,10 @@
        </entry>
        <entry><type>text</type></entry>
        <entry>
-        Encode binary data to <acronym>ASCII</acronym>-only representation.  Supported
+        Encode binary data to different representation.  Supported
         types are: <literal>base64</>, <literal>hex</>, <literal>escape</>.
+        <literal>Escape</> merely outputs null bytes as <literal>\000</> and
+        doubles backslashes.
        </entry>
        <entry><literal>encode( E'123\\000\\001', 'base64')</literal></entry>
        <entry><literal>MTIzAAE=</literal></entry>