Document encode(bytea, 'escape')'s behavior correctly.

I changed this in commit fd15dba543247eb1ce879d22632b9fdb4c230831, but
missed the fact that the SGML documentation of the function specified
exactly what it did.  Well, one of the two places where it's specified
documented that --- probably I looked at the other place and thought
nothing needed to be done.  Sync the two places where encode() and
decode() are described.

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 7779b52339deff69eb41fdf6d568a28dc74c97fd..29576d7ca3210fc4e615fcaf9cda678a6f53a94f 100644 (file)
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -1447,7 +1447,8 @@
        
         Encode binary data into a textual representation.  Supported
         formats are: base64, hex, escape.
-        escape merely outputs null bytes as \000 and
+        escape converts zero bytes and high-bit-set bytes to
+        octal sequences (\nnn) and
         doubles backslashes.
        
        encode(E'123\\000\\001', 'base64')
@@ -2753,12 +2754,12 @@
      
       
        decode(string text,
-              type text)
+       format text)
       
       bytea
       
-       Decode binary string from string previously
-       encoded with encode.  Parameter type is same as in encode.
+       Decode binary data from textual representation in string.
+       Options for format are same as in encode.
       
       decode(E'123\\000456', 'escape')
       123\000456
@@ -2766,13 +2767,16 @@
 
      
       
-       encode(string bytea,
-              type text)
+       encode(data bytea,
+       format text)
       
       text
       
-       Encode binary string to ASCII-only representation.  Supported
-       types are: base64, hex, escape.
+       Encode binary data into a textual representation.  Supported
+       formats are: base64, hex, escape.
+       escape converts zero bytes and high-bit-set bytes to
+       octal sequences (\nnn) and
+       doubles backslashes.
       
       encode(E'123\\000456'::bytea, 'escape')
       123\000456