From 9b775726629fe804af71a72c914933025ee21f75 Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Tue, 4 Sep 2001 03:17:54 +0000
Subject: [PATCH] Add mention of bytea data type and escaping rules.

---
 doc/src/sgml/datatype.sgml | 27 +++++++++++++++++++++++++--
 1 file changed, 25 insertions(+), 2 deletions(-)

diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml
index ce9fffa0c2..7efc0a7589 100644
--- a/doc/src/sgml/datatype.sgml
+++ b/doc/src/sgml/datatype.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/datatype.sgml,v 1.60 2001/08/31 01:55:25 ishii Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/datatype.sgml,v 1.61 2001/09/04 03:17:54 momjian Exp $
 -->
 
  <chapter id="datatype">
@@ -83,6 +83,12 @@ $Header: /cvsroot/pgsql/doc/src/sgml/datatype.sgml,v 1.60 2001/08/31 01:55:25 is
        <entry>rectangular box in 2D plane</entry>
       </row>
 
+      <row>
+       <entry><type>bytea</type></entry>
+       <entry></entry>
+       <entry>binary data</entry>
+      </row>
+
       <row>
        <entry><type>character(<replaceable>n</replaceable>)</type></entry>
        <entry><type>char(<replaceable>n</replaceable>)</type></entry>
@@ -782,7 +788,11 @@ CREATE TABLE <replaceable class="parameter">tablename</replaceable> (<replaceabl
 	<entry>text</entry>
 	<entry>Variable unlimited length</entry>
        </row>
-      </tbody>
+        <row>
+	<entry>bytea</entry>
+	<entry>binary data</entry>
+       </row>
+     </tbody>
      </tgroup>
     </table>
 
@@ -829,6 +839,19 @@ CREATE TABLE <replaceable class="parameter">tablename</replaceable> (<replaceabl
     standard, many other RDBMS packages have it as well.
    </para>
 
+   <para>
+    The <type>bytea</type> data type allows storage of binary data,
+    specifically allowing storage of NULLs which are entered as
+    <literal>'\\000'</>. The first backslash is interpreted by the
+    single quotes, and the second is recognized by <type>bytea</> and
+    preceeds a three digit octal value. For a similar reason, a
+    backslash must be entered into a field as <literal>'\\\\'</> or
+    <literal>'\\134'</>. You may also have to escape line feeds and
+    carriage return if your interface automatically translates these. It
+    can store values of any length. <type>Bytea</> is a non-standard
+    data type.
+   </para>
+
    <para>
     The storage requirement for data of these types is 4 bytes plus
     the actual string, and in case of <type>character</type> plus the