From bd2ef63aa827066476ec6ab3d7dcd0a3b5fe0671 Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Mon, 5 Nov 2007 16:45:52 +0000
Subject: [PATCH] Move txid snapshot field description table from datatype to
 functions section.

---
 doc/src/sgml/datatype.sgml | 73 +-------------------------------------
 doc/src/sgml/func.sgml     | 65 +++++++++++++++++++++++++++++----
 2 files changed, 60 insertions(+), 78 deletions(-)

diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml
index e1e157ab37..5f173c907a 100644
--- a/doc/src/sgml/datatype.sgml
+++ b/doc/src/sgml/datatype.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/datatype.sgml,v 1.213 2007/11/05 14:51:08 momjian Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/datatype.sgml,v 1.214 2007/11/05 16:45:52 momjian Exp $ -->
 
  <chapter id="datatype">
   <title id="datatype-title">Data Types</title>
@@ -3437,77 +3437,6 @@ SELECT to_tsquery('Fat:ab & Cats');
 
   </sect1>
 
-  <sect1 id="datatype-txid-snapshot">
-   <title>Transaction Snapshot Type</title>
-
-   <indexterm zone="datatype-txid-snapshot">
-    <primary>txid_snapshot</primary>
-   </indexterm>
-
-   <para>
-    The data type <type>txid_snapshot</type> stores info about transaction ID
-    visibility at a particular moment in time. The components are
-    described in <xref linkend="datatype-txid-snapshot-parts">.
-   </para>
-
-   <table id="datatype-txid-snapshot-parts">
-    <title>Snapshot components</title>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>Name</entry>
-       <entry>Query Function</entry>
-       <entry>Description</entry>
-      </row>
-     </thead>
-
-     <tbody>
-
-      <row>
-       <entry><type>xmin</type></entry>
-       <entry>txid_snapshot_xmin()</entry>
-       <entry>
-         Earliest transaction ID that is still active.  All earlier
-         transactions will either be committed and visible, or rolled
-         back and dead.
-       </entry>
-      </row>
-
-      <row>
-       <entry><type>xmax</type></entry>
-       <entry>txid_snapshot_xmax()</entry>
-       <entry>
-        Next unassigned txid.  All txids later than this one are
-        unassigned, and thus invisible.
-       </entry>
-      </row>
-
-      <row>
-       <entry><type>xip_list</type></entry>
-       <entry>txid_snapshot_xip()</entry>
-       <entry>
-        Active txids at the time of snapshot.  All of them are between
-        xmin and xmax.  A txid that is <literal>xmin &lt;= txid &lt;
-        xmax</literal> and not in this list is visible.
-       </entry>
-      </row>
-
-     </tbody>
-    </tgroup>
-   </table>
-
-   <para>
-    Snapshot's textual representation is <literal>[xmin]:[xmax]:[xip_list]</literal>
-    for example <literal>10:20:10,14,15</literal> means
-    <literal>xmin=10 xmax=20 xip_list=10,14,15</literal>.
-   </para>
-
-   <para>
-    Functions for getting and querying transaction ids and snapshots are
-    described in <xref linkend="functions-txid">.
-   </para>
-  </sect1>
-
   <sect1 id="datatype-uuid">
    <title><acronym>UUID</acronym> Type</title>
 
diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index ad91d6d6af..78ab02a0ec 100644
--- 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.407 2007/11/05 14:51:08 momjian Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.408 2007/11/05 16:45:52 momjian Exp $ -->
 
  <chapter id="functions">
   <title>Functions and Operators</title>
@@ -11519,11 +11519,6 @@ SELECT pg_type_is_visible('myschema.widget'::regtype);
     <primary>txid_visible_in_snapshot</primary>
    </indexterm>
 
-   <para>
-    The functions shown in <xref linkend="functions-txid-snapshot">
-    export server internal transaction info to user level.
-   </para>
-
    <table id="functions-txid-snapshot">
     <title>Transaction IDs and snapshots</title>
     <tgroup cols="3">
@@ -11575,6 +11570,64 @@ SELECT pg_type_is_visible('myschema.widget'::regtype);
     which transactions were committed between two snapshots.
    </para>
 
+   <para>
+    The data type <type>txid_snapshot</type> stores info about transaction ID
+    visibility at a particular moment in time. The components are
+    described in <xref linkend="datatype-txid-snapshot-parts">.
+   </para>
+
+   <table id="datatype-txid-snapshot-parts">
+    <title>Snapshot components</title>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>Name</entry>
+       <entry>Query Function</entry>
+       <entry>Description</entry>
+      </row>
+     </thead>
+
+     <tbody>
+
+      <row>
+       <entry><type>xmin</type></entry>
+       <entry>txid_snapshot_xmin()</entry>
+       <entry>
+         Earliest transaction ID that is still active.  All earlier
+         transactions will either be committed and visible, or rolled
+         back and dead.
+       </entry>
+      </row>
+
+      <row>
+       <entry><type>xmax</type></entry>
+       <entry>txid_snapshot_xmax()</entry>
+       <entry>
+        Next unassigned txid.  All txids later than this one are
+        unassigned, and thus invisible.
+       </entry>
+      </row>
+
+      <row>
+       <entry><type>xip_list</type></entry>
+       <entry>txid_snapshot_xip()</entry>
+       <entry>
+        Active txids at the time of snapshot.  All of them are between
+        xmin and xmax.  A txid that is <literal>xmin &lt;= txid &lt;
+        xmax</literal> and not in this list is visible.
+       </entry>
+      </row>
+
+     </tbody>
+    </tgroup>
+   </table>
+
+   <para>
+    Snapshot's textual representation is <literal>[xmin]:[xmax]:[xip_list]</literal>
+    for example <literal>10:20:10,14,15</literal> means
+    <literal>xmin=10 xmax=20 xip_list=10,14,15</literal>.
+   </para>
+
   </sect1>
 
   <sect1 id="functions-admin">