CVS User Account cvsuser
Thu Sep 23 15:50:29 PDT 2004
Log Message:
-----------
Changes to table documentation.  As per contribution from "Ed L"
@bluepolka.net, this drops column comments from the 'table', and 
instead attaches it to the individual columns.

Updated the "schemadoc.html" file based on this; note that this
puts the column docs into the HTML table created for each table,
which is a really nice improvement.

And fixed a misspelling of "funciton" in the Slony-I functions file...

Modified Files:
--------------
    slony1-engine/doc/howto:
        schemadoc.html (r1.4 -> r1.5)
    slony1-engine/src/backend:
        slony1_base.sql (r1.16 -> r1.17)
        slony1_funcs.sql (r1.25 -> r1.26)

-------------- next part --------------
Index: schemadoc.html
===================================================================
RCS file: /usr/local/cvsroot/slony1/slony1-engine/doc/howto/schemadoc.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -Ldoc/howto/schemadoc.html -Ldoc/howto/schemadoc.html -u -w -r1.4 -r1.5
--- doc/howto/schemadoc.html
+++ doc/howto/schemadoc.html
@@ -111,13 +111,13 @@
   <body>
 
     <!-- Primary Index -->
-	<p><br><br>Dumped on 2004-08-05</p>
+	<p><br><br>Dumped on 2004-09-23</p>
 <h1><a name="index">Index of database - schemadoc</a></h1>
 <ul>
     
     <li><a name="schemadoc.schema">schemadoc</a></li><ul>
     	<li><a href="#schemadoc.table.sl-config-lock">sl_config_lock</a></li><li><a href="#schemadoc.table.sl-confirm">sl_confirm</a></li><li><a href="#schemadoc.table.sl-event">sl_event</a></li><li><a href="#schemadoc.table.sl-listen">sl_listen</a></li><li><a href="#schemadoc.table.sl-log-1">sl_log_1</a></li><li><a href="#schemadoc.table.sl-log-2">sl_log_2</a></li><li><a href="#schemadoc.table.sl-node">sl_node</a></li><li><a href="#schemadoc.table.sl-path">sl_path</a></li><li><a href="#schemadoc.view.sl-seqlastvalue">sl_seqlastvalue</a></li><li><a href="#schemadoc.table.sl-seqlog">sl_seqlog</a></li><li><a href="#schemadoc.table.sl-sequence">sl_sequence</a></li><li><a href="#schemadoc.table.sl-set">sl_set</a></li><li><a href="#schemadoc.table.sl-setsync">sl_setsync</a></li><li><a href="#schemadoc.table.sl-subscribe">sl_subscribe</a></li><li><a href="#schemadoc.table.sl-table">sl_table</a></li><li><a href="#schemadoc.table.sl-trigger">sl_trigger</a></li>
-  	<li><a href="#schemadoc.function.altertableforreplication-integer">altertableforreplication( integer )</a></li><li><a href="#schemadoc.function.altertablerestore-integer">altertablerestore( integer )</a></li><li><a href="#schemadoc.function.cleanupevent">cleanupevent(  )</a></li><li><a href="#schemadoc.function.ddlscript-integer-text">ddlscript( integer, text )</a></li><li><a href="#schemadoc.function.ddlscript-int-integer-text">ddlscript_int( integer, text )</a></li><li><a href="#schemadoc.function.determineattkindserial-text">determineattkindserial( text )</a></li><li><a href="#schemadoc.function.determineattkindunique-text-name">determineattkindunique( text, name )</a></li><li><a href="#schemadoc.function.determineidxnameserial-text">determineidxnameserial( text )</a></li><li><a href="#schemadoc.function.determineidxnameunique-text-name">determineidxnameunique( text, name )</a></li><li><a href="#schemadoc.function.disablenode-integer">disablenode( integer )</a></li><li><a href="#schemadoc.function.disablenode-int-integer">disablenode_int( integer )</a></li><li><a href="#schemadoc.function.droplisten-integer-integer-integer">droplisten( integer, integer, integer )</a></li><li><a href="#schemadoc.function.droplisten-int-integer-integer-integer">droplisten_int( integer, integer, integer )</a></li><li><a href="#schemadoc.function.dropnode-integer">dropnode( integer )</a></li><li><a href="#schemadoc.function.dropnode-int-integer">dropnode_int( integer )</a></li><li><a href="#schemadoc.function.droppath-integer-integer">droppath( integer, integer )</a></li><li><a href="#schemadoc.function.droppath-int-integer-integer">droppath_int( integer, integer )</a></li><li><a href="#schemadoc.function.dropset-integer">dropset( integer )</a></li><li><a href="#schemadoc.function.dropset-int-integer">dropset_int( integer )</a></li><li><a href="#schemadoc.function.droptrigger-integer-name">droptrigger( integer, name )</a></li><li><a href="#schemadoc.function.droptrigger-int-integer-name">droptrigger_int( integer, name )</a></li><li><a href="#schemadoc.function.enablenode-integer">enablenode( integer )</a></li><li><a href="#schemadoc.function.enablenode-int-integer">enablenode_int( integer )</a></li><li><a href="#schemadoc.function.enablesubscription-integer-integer-integer">enablesubscription( integer, integer, integer )</a></li><li><a href="#schemadoc.function.enablesubscription-int-integer-integer-integer">enablesubscription_int( integer, integer, integer )</a></li><li><a href="#schemadoc.function.failednode-integer-integer">failednode( integer, integer )</a></li><li><a href="#schemadoc.function.failednode2-integer-integer-integer-bigint-bigint">failednode2( integer, integer, integer, bigint, bigint )</a></li><li><a href="#schemadoc.function.failoverset-int-integer-integer-integer">failoverset_int( integer, integer, integer )</a></li><li><a href="#schemadoc.function.forwardconfirm-integer-integer-bigint-timestamp-without-time-zone">forwardconfirm( integer, integer, bigint, timestamp without time zone )</a></li><li><a href="#schemadoc.function.initializelocalnode-integer-text">initializelocalnode( integer, text )</a></li><li><a href="#schemadoc.function.lockset-integer">lockset( integer )</a></li><li><a href="#schemadoc.function.mergeset-integer-integer">mergeset( integer, integer )</a></li><li><a href="#schemadoc.function.mergeset-int-integer-integer">mergeset_int( integer, integer )</a></li><li><a href="#schemadoc.function.moveset-integer-integer">moveset( integer, integer )</a></li><li><a href="#schemadoc.function.moveset-int-integer-integer-integer">moveset_int( integer, integer, integer )</a></li><li><a href="#schemadoc.function.sequencelastvalue-text">sequencelastvalue( text )</a></li><li><a href="#schemadoc.function.sequencesetvalue-integer-integer-bigint-bigint">sequencesetvalue( integer, integer, bigint, bigint )</a></li><li><a href="#schemadoc.function.setaddsequence-integer-integer-text-text">setaddsequence( integer, integer, text, text )</a></li><li><a href="#schemadoc.function.setaddsequence-int-integer-integer-text-text">setaddsequence_int( integer, integer, text, text )</a></li><li><a href="#schemadoc.function.setaddtable-integer-integer-text-name-text">setaddtable( integer, integer, text, name, text )</a></li><li><a href="#schemadoc.function.setaddtable-int-integer-integer-text-name-text">setaddtable_int( integer, integer, text, name, text )</a></li><li><a href="#schemadoc.function.storelisten-integer-integer-integer">storelisten( integer, integer, integer )</a></li><li><a href="#schemadoc.function.storelisten-int-integer-integer-integer">storelisten_int( integer, integer, integer )</a></li><li><a href="#schemadoc.function.storenode-integer-text">storenode( integer, text )</a></li><li><a href="#schemadoc.function.storenode-int-integer-text">storenode_int( integer, text )</a></li><li><a href="#schemadoc.function.storepath-integer-integer-text-integer">storepath( integer, integer, text, integer )</a></li><li><a href="#schemadoc.function.storepath-int-integer-integer-text-integer">storepath_int( integer, integer, text, integer )</a></li><li><a href="#schemadoc.function.storeset-integer-text">storeset( integer, text )</a></li><li><a href="#schemadoc.function.storeset-int-integer-integer-text">storeset_int( integer, integer, text )</a></li><li><a href="#schemadoc.function.storetrigger-integer-name">storetrigger( integer, name )</a></li><li><a href="#schemadoc.function.storetrigger-int-integer-name">storetrigger_int( integer, name )</a></li><li><a href="#schemadoc.function.subscribeset-integer-integer-integer-boolean">subscribeset( integer, integer, integer, boolean )</a></li><li><a href="#schemadoc.function.subscribeset-int-integer-integer-integer-boolean">subscribeset_int( integer, integer, integer, boolean )</a></li><li><a href="#schemadoc.function.tableaddkey-text">tableaddkey( text )</a></li><li><a href="#schemadoc.function.tabledropkey-integer">tabledropkey( integer )</a></li><li><a href="#schemadoc.function.tablehasserialkey-text">tablehasserialkey( text )</a></li><li><a href="#schemadoc.function.uninstallnode">uninstallnode(  )</a></li><li><a href="#schemadoc.function.unlockset-integer">unlockset( integer )</a></li><li><a href="#schemadoc.function.unsubscribeset-integer-integer">unsubscribeset( integer, integer )</a></li><li><a href="#schemadoc.function.unsubscribeset-int-integer-integer">unsubscribeset_int( integer, integer )</a></li>
+  	<li><a href="#schemadoc.function.altertableforreplication-integer">altertableforreplication( integer )</a></li><li><a href="#schemadoc.function.altertablerestore-integer">altertablerestore( integer )</a></li><li><a href="#schemadoc.function.cleanupevent">cleanupevent(  )</a></li><li><a href="#schemadoc.function.ddlscript-integer-text-integer">ddlscript( integer, text, integer )</a></li><li><a href="#schemadoc.function.ddlscript-int-integer-text-integer">ddlscript_int( integer, text, integer )</a></li><li><a href="#schemadoc.function.determineattkindserial-text">determineattkindserial( text )</a></li><li><a href="#schemadoc.function.determineattkindunique-text-name">determineattkindunique( text, name )</a></li><li><a href="#schemadoc.function.determineidxnameserial-text">determineidxnameserial( text )</a></li><li><a href="#schemadoc.function.determineidxnameunique-text-name">determineidxnameunique( text, name )</a></li><li><a href="#schemadoc.function.disablenode-integer">disablenode( integer )</a></li><li><a href="#schemadoc.function.disablenode-int-integer">disablenode_int( integer )</a></li><li><a href="#schemadoc.function.droplisten-integer-integer-integer">droplisten( integer, integer, integer )</a></li><li><a href="#schemadoc.function.droplisten-int-integer-integer-integer">droplisten_int( integer, integer, integer )</a></li><li><a href="#schemadoc.function.dropnode-integer">dropnode( integer )</a></li><li><a href="#schemadoc.function.dropnode-int-integer">dropnode_int( integer )</a></li><li><a href="#schemadoc.function.droppath-integer-integer">droppath( integer, integer )</a></li><li><a href="#schemadoc.function.droppath-int-integer-integer">droppath_int( integer, integer )</a></li><li><a href="#schemadoc.function.dropset-integer">dropset( integer )</a></li><li><a href="#schemadoc.function.dropset-int-integer">dropset_int( integer )</a></li><li><a href="#schemadoc.function.droptrigger-integer-name">droptrigger( integer, name )</a></li><li><a href="#schemadoc.function.droptrigger-int-integer-name">droptrigger_int( integer, name )</a></li><li><a href="#schemadoc.function.enablenode-integer">enablenode( integer )</a></li><li><a href="#schemadoc.function.enablenode-int-integer">enablenode_int( integer )</a></li><li><a href="#schemadoc.function.enablesubscription-integer-integer-integer">enablesubscription( integer, integer, integer )</a></li><li><a href="#schemadoc.function.enablesubscription-int-integer-integer-integer">enablesubscription_int( integer, integer, integer )</a></li><li><a href="#schemadoc.function.failednode-integer-integer">failednode( integer, integer )</a></li><li><a href="#schemadoc.function.failednode2-integer-integer-integer-bigint-bigint">failednode2( integer, integer, integer, bigint, bigint )</a></li><li><a href="#schemadoc.function.failoverset-int-integer-integer-integer">failoverset_int( integer, integer, integer )</a></li><li><a href="#schemadoc.function.forwardconfirm-integer-integer-bigint-timestamp-without-time-zone">forwardconfirm( integer, integer, bigint, timestamp without time zone )</a></li><li><a href="#schemadoc.function.initializelocalnode-integer-text">initializelocalnode( integer, text )</a></li><li><a href="#schemadoc.function.lockset-integer">lockset( integer )</a></li><li><a href="#schemadoc.function.mergeset-integer-integer">mergeset( integer, integer )</a></li><li><a href="#schemadoc.function.mergeset-int-integer-integer">mergeset_int( integer, integer )</a></li><li><a href="#schemadoc.function.moveset-integer-integer">moveset( integer, integer )</a></li><li><a href="#schemadoc.function.moveset-int-integer-integer-integer">moveset_int( integer, integer, integer )</a></li><li><a href="#schemadoc.function.sequencelastvalue-text">sequencelastvalue( text )</a></li><li><a href="#schemadoc.function.sequencesetvalue-integer-integer-bigint-bigint">sequencesetvalue( integer, integer, bigint, bigint )</a></li><li><a href="#schemadoc.function.setaddsequence-integer-integer-text-text">setaddsequence( integer, integer, text, text )</a></li><li><a href="#schemadoc.function.setaddsequence-int-integer-integer-text-text">setaddsequence_int( integer, integer, text, text )</a></li><li><a href="#schemadoc.function.setaddtable-integer-integer-text-name-text">setaddtable( integer, integer, text, name, text )</a></li><li><a href="#schemadoc.function.setaddtable-int-integer-integer-text-name-text">setaddtable_int( integer, integer, text, name, text )</a></li><li><a href="#schemadoc.function.slonyversion">slonyversion(  )</a></li><li><a href="#schemadoc.function.slonyversionmajor">slonyversionmajor(  )</a></li><li><a href="#schemadoc.function.slonyversionminor">slonyversionminor(  )</a></li><li><a href="#schemadoc.function.slonyversionpatchlevel">slonyversionpatchlevel(  )</a></li><li><a href="#schemadoc.function.storelisten-integer-integer-integer">storelisten( integer, integer, integer )</a></li><li><a href="#schemadoc.function.storelisten-int-integer-integer-integer">storelisten_int( integer, integer, integer )</a></li><li><a href="#schemadoc.function.storenode-integer-text">storenode( integer, text )</a></li><li><a href="#schemadoc.function.storenode-int-integer-text">storenode_int( integer, text )</a></li><li><a href="#schemadoc.function.storepath-integer-integer-text-integer">storepath( integer, integer, text, integer )</a></li><li><a href="#schemadoc.function.storepath-int-integer-integer-text-integer">storepath_int( integer, integer, text, integer )</a></li><li><a href="#schemadoc.function.storeset-integer-text">storeset( integer, text )</a></li><li><a href="#schemadoc.function.storeset-int-integer-integer-text">storeset_int( integer, integer, text )</a></li><li><a href="#schemadoc.function.storetrigger-integer-name">storetrigger( integer, name )</a></li><li><a href="#schemadoc.function.storetrigger-int-integer-name">storetrigger_int( integer, name )</a></li><li><a href="#schemadoc.function.subscribeset-integer-integer-integer-boolean">subscribeset( integer, integer, integer, boolean )</a></li><li><a href="#schemadoc.function.subscribeset-int-integer-integer-integer-boolean">subscribeset_int( integer, integer, integer, boolean )</a></li><li><a href="#schemadoc.function.tableaddkey-text">tableaddkey( text )</a></li><li><a href="#schemadoc.function.tabledropkey-integer">tabledropkey( integer )</a></li><li><a href="#schemadoc.function.tablehasserialkey-text">tablehasserialkey( text )</a></li><li><a href="#schemadoc.function.uninstallnode">uninstallnode(  )</a></li><li><a href="#schemadoc.function.unlockset-integer">unlockset( integer )</a></li><li><a href="#schemadoc.function.unsubscribeset-integer-integer">unsubscribeset( integer, integer )</a></li><li><a href="#schemadoc.function.unsubscribeset-int-integer-integer">unsubscribeset_int( integer, integer )</a></li>
     </ul>
     
 </ul>
@@ -190,15 +190,7 @@
 			<a name="schemadoc.table.sl-confirm">sl_confirm</a>
 		</h2>
         
-         <p>Holds confirmation of replication events.
-
-After a period of time, Slony removes old confirmed events from both this table and the sl_event table.
-
-con_origin		:	Integer.  The ID # (from sl_node.no_id) of the source node for this event  
-con_received	:	Integer.
-con_seqno		:	Integer.  The ID # for the event
-con_timestamp	:	Timestamp.  When this event was confirmed
-</p>
+         <p>Holds confirmation of replication events.  After a period of time, Slony removes old confirmed events from both this table and the sl_event table.</p>
         
 
 
@@ -223,7 +215,7 @@
 				
 				
 				</i>
-				
+				<br><br>The ID # (from sl_node.no_id) of the source node for this event
 				</td>
 			 </tr>
             
@@ -255,7 +247,7 @@
 				
 				
 				</i>
-				
+				<br><br>The ID # for the event
 				</td>
 			 </tr>
             
@@ -271,7 +263,7 @@
 				
 				DEFAULT (timeofday())::timestamp without time zone
 				</i>
-				
+				<br><br>When this event was confirmed
 				</td>
 			 </tr>
             
@@ -303,41 +295,7 @@
 			<a name="schemadoc.table.sl-event">sl_event</a>
 		</h2>
         
-         <p>Holds information about replication events.
-
-After a period of time, Slony removes old confirmed events from both this table and the sl_confirm table.
-
-ev_origin		:	Integer.  The ID # (from sl_node.no_id) of the source node for this event
-ev_seqno		:	Integer.  The ID # for the event
-ev_timestamp	:	Timestamp.  When this event record was created
-ev_minxid		:
-ev_maxxid		:
-ev_xip			:	String.
-ev_type			:	String.  The type of event this record is for.
-
-				SYNC				= Synchronise
-				STORE_NODE			=
-				ENABLE_NODE			=
-				DROP_NODE			=
-				STORE_PATH			=
-				DROP_PATH			=
-				STORE_LISTEN		=
-				DROP_LISTEN			=
-				STORE_SET			=
-				DROP_SET			=
-				MERGE_SET			=
-				SET_ADD_TABLE		=
-				SET_ADD_SEQUENCE	=
-				STORE_TRIGGER		=
-				DROP_TRIGGER		=
-				MOVE_SET			=
-				FAILOVER_SET		=
-				SUBSCRIBE_SET		=
-				ENABLE_SUBSCRIPTION	=
-				UNSUBSCRIBE_SET		=
-				DDL_SCRIPT			=
-				ADJUST_SEQ			=
-</p>
+         <p>Holds information about replication events.  After a period of time, Slony removes old confirmed events from both this table and the sl_confirm table.</p>
         
 
 
@@ -369,7 +327,7 @@
 				
 				
 				</i>
-				
+				<br><br>The ID # (from sl_node.no_id) of the source node for this event
 				</td>
 			 </tr>
             
@@ -392,7 +350,7 @@
 				
 				
 				</i>
-				
+				<br><br>The ID # for the event
 				</td>
 			 </tr>
             
@@ -408,7 +366,7 @@
 				
 				
 				</i>
-				
+				<br><br>When this event record was created
 				</td>
 			 </tr>
             
@@ -424,7 +382,7 @@
 				
 				
 				</i>
-				
+				<br><br>Earliest XID on provider node for this event
 				</td>
 			 </tr>
             
@@ -440,7 +398,7 @@
 				
 				
 				</i>
-				
+				<br><br>Latest XID on provider node for this event
 				</td>
 			 </tr>
             
@@ -456,7 +414,7 @@
 				
 				
 				</i>
-				
+				<br><br>TBD
 				</td>
 			 </tr>
             
@@ -472,6 +430,29 @@
 				
 				
 				</i>
+				<br><br>The type of event this record is for.  
+				SYNC				= Synchronise
+				STORE_NODE			=
+				ENABLE_NODE			=
+				DROP_NODE			=
+				STORE_PATH			=
+				DROP_PATH			=
+				STORE_LISTEN		=
+				DROP_LISTEN			=
+				STORE_SET			=
+				DROP_SET			=
+				MERGE_SET			=
+				SET_ADD_TABLE		=
+				SET_ADD_SEQUENCE	=
+				STORE_TRIGGER		=
+				DROP_TRIGGER		=
+				MOVE_SET			=
+				FAILOVER_SET		=
+				SUBSCRIBE_SET		=
+				ENABLE_SUBSCRIPTION	=
+				UNSUBSCRIBE_SET		=
+				DDL_SCRIPT			=
+				ADJUST_SEQ			=
 				
 				</td>
 			 </tr>
@@ -488,7 +469,7 @@
 				
 				
 				</i>
-				
+				<br><br>Data field containing an argument needed to process the event
 				</td>
 			 </tr>
             
@@ -504,7 +485,7 @@
 				
 				
 				</i>
-				
+				<br><br>Data field containing an argument needed to process the event
 				</td>
 			 </tr>
             
@@ -520,7 +501,7 @@
 				
 				
 				</i>
-				
+				<br><br>Data field containing an argument needed to process the event
 				</td>
 			 </tr>
             
@@ -536,7 +517,7 @@
 				
 				
 				</i>
-				
+				<br><br>Data field containing an argument needed to process the event
 				</td>
 			 </tr>
             
@@ -552,7 +533,7 @@
 				
 				
 				</i>
-				
+				<br><br>Data field containing an argument needed to process the event
 				</td>
 			 </tr>
             
@@ -568,7 +549,7 @@
 				
 				
 				</i>
-				
+				<br><br>Data field containing an argument needed to process the event
 				</td>
 			 </tr>
             
@@ -584,7 +565,7 @@
 				
 				
 				</i>
-				
+				<br><br>Data field containing an argument needed to process the event
 				</td>
 			 </tr>
             
@@ -600,7 +581,7 @@
 				
 				
 				</i>
-				
+				<br><br>Data field containing an argument needed to process the event
 				</td>
 			 </tr>
             
@@ -632,12 +613,7 @@
 			<a name="schemadoc.table.sl-listen">sl_listen</a>
 		</h2>
         
-         <p>Indicates how nodes listen to events from other nodes in the Slony-I network.
-
-li_origin		:	Integer.  The ID # (from sl_node.no_id) of the node this listener is operating on
-li_provider		:	Integer.  The ID # (from sl_node.no_id) of the source node for this listening event
-li_receiver		:	Integer.  The ID # (from sl_node.no_id) of the target node for this listening event
-</p>
+         <p>Indicates how nodes listen to events from other nodes in the Slony-I network.</p>
         
 
 
@@ -677,7 +653,7 @@
 				
 				
 				</i>
-				
+				<br><br>The ID # (from sl_node.no_id) of the node this listener is operating on
 				</td>
 			 </tr>
             
@@ -708,7 +684,7 @@
 				
 				
 				</i>
-				
+				<br><br>The ID # (from sl_node.no_id) of the source node for this listening event
 				</td>
 			 </tr>
             
@@ -739,7 +715,7 @@
 				
 				
 				</i>
-				
+				<br><br>The ID # (from sl_node.no_id) of the target node for this listening event
 				</td>
 			 </tr>
             
@@ -771,13 +747,7 @@
 			<a name="schemadoc.table.sl-log-1">sl_log_1</a>
 		</h2>
         
-         <p>Stores each change to be propagated to subscriber nodes
-
-log_origin - origin node from which the change came
-log_xid - transaction ID on the origin node
-log_table_id - the table ID (from sl_table.tab_id) that this log entry is to affect
-log_cmdtype - replication action to take. U = Update, I = Insert, D = DELETE
-log_cmddata - the data needed to perform the log action</p>
+         <p>Stores each change to be propagated to subscriber nodes</p>
         
 
 
@@ -802,7 +772,7 @@
 				
 				
 				</i>
-				
+				<br><br>Origin node from which the change came
 				</td>
 			 </tr>
             
@@ -818,7 +788,7 @@
 				
 				
 				</i>
-				
+				<br><br>Transaction ID on the origin node
 				</td>
 			 </tr>
             
@@ -834,7 +804,7 @@
 				
 				
 				</i>
-				
+				<br><br>The table ID (from sl_table.tab_id) that this log entry is to affect
 				</td>
 			 </tr>
             
@@ -866,7 +836,7 @@
 				
 				
 				</i>
-				
+				<br><br>Replication action to take. U = Update, I = Insert, D = DELETE
 				</td>
 			 </tr>
             
@@ -882,7 +852,7 @@
 				
 				
 				</i>
-				
+				<br><br>The data needed to perform the log action
 				</td>
 			 </tr>
             
@@ -914,13 +884,7 @@
 			<a name="schemadoc.table.sl-log-2">sl_log_2</a>
 		</h2>
         
-         <p>Stores each change to be propagated to subscriber nodes
-
-log_origin - origin node from which the change came
-log_xid - transaction ID on the origin node
-log_table_id - the table ID (from sl_table.tab_id) that this log entry is to affect
-log_cmdtype - replication action to take. U = Update, I = Insert, D = DELETE
-log_cmddata - the data needed to perform the log action</p>
+         <p>Stores each change to be propagated to subscriber nodes</p>
         
 
 
@@ -945,7 +909,7 @@
 				
 				
 				</i>
-				
+				<br><br>Origin node from which the change came
 				</td>
 			 </tr>
             
@@ -961,7 +925,7 @@
 				
 				
 				</i>
-				
+				<br><br>Transaction ID on the origin node
 				</td>
 			 </tr>
             
@@ -977,7 +941,7 @@
 				
 				
 				</i>
-				
+				<br><br>The table ID (from sl_table.tab_id) that this log entry is to affect
 				</td>
 			 </tr>
             
@@ -1009,7 +973,7 @@
 				
 				
 				</i>
-				
+				<br><br>Replication action to take. U = Update, I = Insert, D = DELETE
 				</td>
 			 </tr>
             
@@ -1025,7 +989,7 @@
 				
 				
 				</i>
-				
+				<br><br>The data needed to perform the log action
 				</td>
 			 </tr>
             
@@ -1057,7 +1021,7 @@
 			<a name="schemadoc.table.sl-node">sl_node</a>
 		</h2>
         
-         <p>Holds the list of nodes associated with this namespace.  no_id is the unique ID number for the node; no_comment is a human-oriented description of the node</p>
+         <p>Holds the list of nodes associated with this namespace.</p>
         
 
 
@@ -1089,7 +1053,7 @@
 				
 				
 				</i>
-				
+				<br><br>The unique ID number for the node
 				</td>
 			 </tr>
             
@@ -1121,7 +1085,7 @@
 				
 				
 				</i>
-				
+				<br><br>A human-oriented description of the node
 				</td>
 			 </tr>
             
@@ -1172,13 +1136,7 @@
 			<a name="schemadoc.table.sl-path">sl_path</a>
 		</h2>
         
-         <p>Holds connection information for the paths between nodes, and the synchronisation delay
-
-pa_server - The Node ID # (from sl_node.no_id) of the data source
-pa_client - The Node ID # (from sl_node.no_id) of the data target
-pa_conninfo - The PostgreSQL connection string used to connect to the source node.
-pa_connretry - The synchronisation delay, in seconds
-</p>
+         <p>Holds connection information for the paths between nodes, and the synchronisation delay</p>
         
 
 
@@ -1218,7 +1176,7 @@
 				
 				
 				</i>
-				
+				<br><br>The Node ID # (from sl_node.no_id) of the data source
 				</td>
 			 </tr>
             
@@ -1249,7 +1207,7 @@
 				
 				
 				</i>
-				
+				<br><br>The Node ID # (from sl_node.no_id) of the data target
 				</td>
 			 </tr>
             
@@ -1265,7 +1223,7 @@
 				NOT NULL
 				
 				</i>
-				
+				<br><br>The PostgreSQL connection string used to connect to the source node.
 				</td>
 			 </tr>
             
@@ -1281,7 +1239,7 @@
 				
 				
 				</i>
-				
+				<br><br>The synchronisation delay, in seconds
 				</td>
 			 </tr>
             
@@ -1471,7 +1429,7 @@
 			<a name="schemadoc.table.sl-seqlog">sl_seqlog</a>
 		</h2>
         
-         <p>Not documented yet</p>
+         <p>Log of Sequence updates</p>
         
 
 
@@ -1496,7 +1454,7 @@
 				
 				
 				</i>
-				
+				<br><br>Sequence ID
 				</td>
 			 </tr>
             
@@ -1512,7 +1470,7 @@
 				
 				
 				</i>
-				
+				<br><br>Publisher node at which the sequence originates
 				</td>
 			 </tr>
             
@@ -1528,7 +1486,7 @@
 				
 				
 				</i>
-				
+				<br><br>TBD
 				</td>
 			 </tr>
             
@@ -1544,7 +1502,7 @@
 				
 				
 				</i>
-				
+				<br><br>Last value published for this sequence
 				</td>
 			 </tr>
             
@@ -1576,11 +1534,7 @@
 			<a name="schemadoc.table.sl-sequence">sl_sequence</a>
 		</h2>
         
-         <p>Similar to sl_table, each entry identifies a sequence being replicated.
-seq_id is an internally-used ID for Slony-I to use in its sequencing of updates
-seq_reloid is the OID of the sequence object
-seq_set indicates which replication set the object is in
-seq_comment is a human-oriented comment</p>
+         <p>Similar to sl_table, each entry identifies a sequence being replicated.</p>
         
 
 
@@ -1612,7 +1566,7 @@
 				
 				
 				</i>
-				
+				<br><br>An internally-used ID for Slony-I to use in its sequencing of updates
 				</td>
 			 </tr>
             
@@ -1636,7 +1590,7 @@
 				NOT NULL
 				
 				</i>
-				
+				<br><br>The OID of the sequence object
 				</td>
 			 </tr>
             
@@ -1660,7 +1614,7 @@
 				
 				
 				</i>
-				
+				<br><br>Indicates which replication set the object is in
 				</td>
 			 </tr>
             
@@ -1676,7 +1630,7 @@
 				
 				
 				</i>
-				
+				<br><br>A human-oriented comment
 				</td>
 			 </tr>
             
@@ -1708,13 +1662,7 @@
 			<a name="schemadoc.table.sl-set">sl_set</a>
 		</h2>
         
-         <p>Holds definitions of replication sets.  
-
-set_id is a unique ID number for the set.
-set_origin is the ID number of the source node for the replication set.
-set_locked indicates whether or not the set is locked.
-set_comment is a human-oriented description of the set.
-</p>
+         <p>Holds definitions of replication sets.</p>
         
 
 
@@ -1746,7 +1694,7 @@
 				
 				
 				</i>
-				
+				<br><br>A unique ID number for the set.
 				</td>
 			 </tr>
             
@@ -1770,7 +1718,7 @@
 				
 				
 				</i>
-				
+				<br><br>The ID number of the source node for the replication set.
 				</td>
 			 </tr>
             
@@ -1786,7 +1734,7 @@
 				
 				
 				</i>
-				
+				<br><br>Indicates whether or not the set is locked.
 				</td>
 			 </tr>
             
@@ -1802,7 +1750,7 @@
 				
 				
 				</i>
-				
+				<br><br>A human-oriented description of the set.
 				</td>
 			 </tr>
             
@@ -1893,7 +1841,7 @@
 				
 				
 				</i>
-				
+				<br><br>ID number of the replication set
 				</td>
 			 </tr>
             
@@ -1917,7 +1865,7 @@
 				
 				
 				</i>
-				
+				<br><br>ID number of the node
 				</td>
 			 </tr>
             
@@ -1933,7 +1881,7 @@
 				
 				
 				</i>
-				
+				<br><br>Slony-I sequence number
 				</td>
 			 </tr>
             
@@ -1949,7 +1897,7 @@
 				
 				
 				</i>
-				
+				<br><br>Earliest XID in provider system affected by SYNC
 				</td>
 			 </tr>
             
@@ -1965,7 +1913,7 @@
 				
 				
 				</i>
-				
+				<br><br>Latest XID in provider system affected by SYNC
 				</td>
 			 </tr>
             
@@ -1981,7 +1929,7 @@
 				
 				
 				</i>
-				
+				<br><br>TBD
 				</td>
 			 </tr>
             
@@ -1997,7 +1945,7 @@
 				
 				
 				</i>
-				
+				<br><br>TBD
 				</td>
 			 </tr>
             
@@ -2029,7 +1977,7 @@
 			<a name="schemadoc.table.sl-subscribe">sl_subscribe</a>
 		</h2>
         
-         <p>Not documented yet</p>
+         <p>Holds a list of subscriptions on sets</p>
         
 
 
@@ -2069,7 +2017,7 @@
 				
 				
 				</i>
-				
+				<br><br>ID # (from sl_set) of the set being subscribed to
 				</td>
 			 </tr>
             
@@ -2093,7 +2041,7 @@
 				
 				
 				</i>
-				
+				<br><br>ID# (from sl_node) of the node providing data
 				</td>
 			 </tr>
             
@@ -2124,7 +2072,7 @@
 				
 				
 				</i>
-				
+				<br><br>ID# (from sl_node) of the node receiving data from the provider
 				</td>
 			 </tr>
             
@@ -2140,7 +2088,7 @@
 				
 				
 				</i>
-				
+				<br><br>Does this provider keep data in sl_log_1/sl_log_2 to allow it to be a provider for other nodes?
 				</td>
 			 </tr>
             
@@ -2156,7 +2104,7 @@
 				
 				
 				</i>
-				
+				<br><br>Has this subscription been activated?  This is not set until the subscriber has received COPY data from the provider
 				</td>
 			 </tr>
             
@@ -2188,12 +2136,7 @@
 			<a name="schemadoc.table.sl-table">sl_table</a>
 		</h2>
         
-         <p>Holds information about the tables being replicated.
-
-tab_id - unique key for Slony-I to use to identify the table
-tab_reloid - the OID of the table in pg_catalog.pg_class.oid
-tab_idxname - the name of the primary index of the table
-tab_comment - Human-oriented description of the table</p>
+         <p>Holds information about the tables being replicated.</p>
         
 
 
@@ -2225,7 +2168,7 @@
 				
 				
 				</i>
-				
+				<br><br>Unique key for Slony-I to use to identify the table
 				</td>
 			 </tr>
             
@@ -2249,7 +2192,7 @@
 				NOT NULL
 				
 				</i>
-				
+				<br><br>The OID of the table in pg_catalog.pg_class.oid
 				</td>
 			 </tr>
             
@@ -2289,7 +2232,7 @@
 				NOT NULL
 				
 				</i>
-				
+				<br><br>The name of the primary index of the table
 				</td>
 			 </tr>
             
@@ -2321,7 +2264,7 @@
 				
 				
 				</i>
-				
+				<br><br>Human-oriented description of the table
 				</td>
 			 </tr>
             
@@ -2360,7 +2303,7 @@
 			<a name="schemadoc.table.sl-trigger">sl_trigger</a>
 		</h2>
         
-         <p>Indicates the name of a trigger [for what purpose?]</p>
+         <p>Holds information about triggers on tables managed using Slony-I</p>
         
 
 
@@ -2400,7 +2343,7 @@
 				
 				
 				</i>
-				
+				<br><br>Slony-I ID number of table the trigger is on
 				</td>
 			 </tr>
             
@@ -2423,7 +2366,7 @@
 				
 				
 				</i>
-				
+				<br><br>Indicates the name of a trigger
 				</td>
 			 </tr>
             
@@ -2764,11 +2707,11 @@
 	
 		<hr>
 		<h2>Function: 
-			<a href="#schemadoc.schema"><a name="schemadoc.function.ddlscript-integer-text">ddlscript( integer, text )</a>
+			<a href="#schemadoc.schema"><a name="schemadoc.function.ddlscript-integer-text-integer">ddlscript( integer, text, integer )</a>
 		</h2>
 <h3>Returns: bigint</h3>
 <h3>Language: PLPGSQL</h3>
-        <p>ddlScript(set_id, script)
+        <p>ddlScript(set_id, script, only_on_node)
 
 Generates a SYNC event, runs the script on the origin, and then
 generates a DDL_SCRIPT event to request it to be run on replicated
@@ -2777,6 +2720,7 @@
 declare
 	p_set_id			alias for $1;
 	p_script			alias for $2;
+	p_only_on_node		alias for $3;
 	v_set_origin		int4;
 begin
 	-- ----
@@ -2803,19 +2747,19 @@
 	-- Create a SYNC event, run the script and generate the DDL_SCRIPT event
 	-- ----
 	perform schemadoc.createEvent(&#39;_schemadoc&#39;, &#39;SYNC&#39;, NULL);
-	perform schemadoc.ddlScript_int(p_set_id, p_script);
+	perform schemadoc.ddlScript_int(p_set_id, p_script, p_only_on_node);
 	return  schemadoc.createEvent(&#39;_schemadoc&#39;, &#39;DDL_SCRIPT&#39;, 
-			p_set_id, p_script);
+			p_set_id, p_script, p_only_on_node);
 end;
 </pre>
 	
 		<hr>
 		<h2>Function: 
-			<a href="#schemadoc.schema"><a name="schemadoc.function.ddlscript-int-integer-text">ddlscript_int( integer, text )</a>
+			<a href="#schemadoc.schema"><a name="schemadoc.function.ddlscript-int-integer-text-integer">ddlscript_int( integer, text, integer )</a>
 		</h2>
 <h3>Returns: integer</h3>
 <h3>Language: PLPGSQL</h3>
-        <p>ddlScript_int(set_id, script)
+        <p>ddlScript_int(set_id, script, only_on_node)
 
 Processes the DDL_SCRIPT event.  On slave nodes, this restores
 original triggers/rules, runs the script, and then puts tables back
@@ -2824,6 +2768,7 @@
 declare
 	p_set_id			alias for $1;
 	p_script			alias for $2;
+	p_only_on_node		alias for $3;
 	v_set_origin		int4;
 	v_no_id				int4;
 	v_row				record;
@@ -2854,6 +2799,14 @@
 	end if;
 
 	-- ----
+	-- If execution on only one node is requested, check that
+	-- we are that node.
+	-- ----
+	if p_only_on_node &gt; 0 and p_only_on_node &lt;&gt; v_no_id then
+		return 0;
+	end if;
+
+	-- ----
 	-- Restore all original triggers and rules
 	-- ----
 	for v_row in select * from schemadoc.sl_table
@@ -3667,7 +3620,7 @@
 <h3>Language: PLPGSQL</h3>
         <p>no_id - Node ID #
 
-Internal funciton to process the ENABLE_NODE event for node no_id</p>
+Internal function to process the ENABLE_NODE event for node no_id</p>
         <pre>
 declare
 	p_no_id			alias for $1;
@@ -5073,6 +5026,60 @@
 	
 		<hr>
 		<h2>Function: 
+			<a href="#schemadoc.schema"><a name="schemadoc.function.slonyversion">slonyversion(  )</a>
+		</h2>
+<h3>Returns: text</h3>
+<h3>Language: PLPGSQL</h3>
+        <p>Returns the version number of the slony schema</p>
+        <pre>
+begin
+	return &#39;&#39;	|| schemadoc.slonyVersionMajor() || &#39;.&#39;
+				|| schemadoc.slonyVersionMinor() || &#39;.&#39;
+				|| schemadoc.slonyVersionPatchlevel();
+end;
+</pre>
+	
+		<hr>
+		<h2>Function: 
+			<a href="#schemadoc.schema"><a name="schemadoc.function.slonyversionmajor">slonyversionmajor(  )</a>
+		</h2>
+<h3>Returns: integer</h3>
+<h3>Language: PLPGSQL</h3>
+        <p>Returns the major version number of the slony schema</p>
+        <pre>
+begin
+	return 1;
+end;
+</pre>
+	
+		<hr>
+		<h2>Function: 
+			<a href="#schemadoc.schema"><a name="schemadoc.function.slonyversionminor">slonyversionminor(  )</a>
+		</h2>
+<h3>Returns: integer</h3>
+<h3>Language: PLPGSQL</h3>
+        <p>Returns the minor version number of the slony schema</p>
+        <pre>
+begin
+	return 1;
+end;
+</pre>
+	
+		<hr>
+		<h2>Function: 
+			<a href="#schemadoc.schema"><a name="schemadoc.function.slonyversionpatchlevel">slonyversionpatchlevel(  )</a>
+		</h2>
+<h3>Returns: integer</h3>
+<h3>Language: PLPGSQL</h3>
+        <p>Returns the version patch level of the slony schema</p>
+        <pre>
+begin
+	return 0;
+end;
+</pre>
+	
+		<hr>
+		<h2>Function: 
 			<a href="#schemadoc.schema"><a name="schemadoc.function.storelisten-integer-integer-integer">storelisten( integer, integer, integer )</a>
 		</h2>
 <h3>Returns: bigint</h3>
Index: slony1_base.sql
===================================================================
RCS file: /usr/local/cvsroot/slony1/slony1-engine/src/backend/slony1_base.sql,v
retrieving revision 1.16
retrieving revision 1.17
diff -Lsrc/backend/slony1_base.sql -Lsrc/backend/slony1_base.sql -u -w -r1.16 -r1.17
--- src/backend/slony1_base.sql
+++ src/backend/slony1_base.sql
@@ -26,7 +26,10 @@
 	CONSTRAINT "sl_node-pkey"
 		PRIMARY KEY (no_id)
 );
-comment on table @NAMESPACE at .sl_node is 'Holds the list of nodes associated with this namespace.  no_id is the unique ID number for the node; no_comment is a human-oriented description of the node';
+comment on table @NAMESPACE at .sl_node is 'Holds the list of nodes associated with this namespace.';
+comment on column @NAMESPACE at .sl_node.no_id is 'The unique ID number for the node';  
+comment on column @NAMESPACE at .sl_node.no_comment is 'A human-oriented description of the node';
+
 
 -- ----------------------------------------------------------------------
 -- TABLE sl_set
@@ -43,13 +46,11 @@
 		FOREIGN KEY (set_origin)
 		REFERENCES @NAMESPACE at .sl_node (no_id)
 );
-comment on table @NAMESPACE at .sl_set is 'Holds definitions of replication sets.  
-
-set_id is a unique ID number for the set.
-set_origin is the ID number of the source node for the replication set.
-set_locked indicates whether or not the set is locked.
-set_comment is a human-oriented description of the set.
-';
+comment on table @NAMESPACE at .sl_set is 'Holds definitions of replication sets.';
+comment on column @NAMESPACE at .sl_set.set_id is 'A unique ID number for the set.';
+comment on column @NAMESPACE at .sl_set.set_origin is 'The ID number of the source node for the replication set.';
+comment on column @NAMESPACE at .sl_set.set_locked is 'Indicates whether or not the set is locked.';
+comment on column @NAMESPACE at .sl_set.set_comment is 'A human-oriented description of the set.';
 
 
 -- ----------------------------------------------------------------------
@@ -75,6 +76,14 @@
 );
 comment on table @NAMESPACE at .sl_setsync is 'Not documented yet';
 
+comment on column @NAMESPACE at .sl_setsync.ssy_setid is 'ID number of the replication set';
+comment on column @NAMESPACE at .sl_setsync.ssy_origin is 'ID number of the node';
+comment on column @NAMESPACE at .sl_setsync.ssy_seqno is 'Slony-I sequence number';
+comment on column @NAMESPACE at .sl_setsync.ssy_minxid is 'Earliest XID in provider system affected by SYNC';
+comment on column @NAMESPACE at .sl_setsync.ssy_maxxid is 'Latest XID in provider system affected by SYNC';
+comment on column @NAMESPACE at .sl_setsync.ssy_xip is 'TBD';
+comment on column @NAMESPACE at .sl_setsync.ssy_action_list is 'TBD';
+
 
 -- ----------------------------------------------------------------------
 -- TABLE sl_table
@@ -93,12 +102,11 @@
 		FOREIGN KEY (tab_set)
 		REFERENCES @NAMESPACE at .sl_set (set_id)
 );
-comment on table @NAMESPACE at .sl_table is 'Holds information about the tables being replicated.
-
-tab_id - unique key for Slony-I to use to identify the table
-tab_reloid - the OID of the table in pg_catalog.pg_class.oid
-tab_idxname - the name of the primary index of the table
-tab_comment - Human-oriented description of the table';
+comment on table @NAMESPACE at .sl_table is 'Holds information about the tables being replicated.';
+comment on column @NAMESPACE at .sl_table.tab_id is 'Unique key for Slony-I to use to identify the table';
+comment on column @NAMESPACE at .sl_table.tab_reloid is 'The OID of the table in pg_catalog.pg_class.oid';
+comment on column @NAMESPACE at .sl_table.tab_idxname is 'The name of the primary index of the table';
+comment on column @NAMESPACE at .sl_table.tab_comment is 'Human-oriented description of the table';
 
 
 -- ----------------------------------------------------------------------
@@ -115,7 +123,9 @@
 		REFERENCES @NAMESPACE at .sl_table (tab_id)
 		ON DELETE CASCADE
 );
-comment on table @NAMESPACE at .sl_trigger is 'Indicates the name of a trigger [for what purpose?]';
+comment on table @NAMESPACE at .sl_trigger is 'Holds information about triggers on tables managed using Slony-I';
+comment on column @NAMESPACE at .sl_trigger.trig_tabid is 'Slony-I ID number of table the trigger is on';
+comment on column @NAMESPACE at .sl_trigger.trig_tgname is 'Indicates the name of a trigger';
 
 
 -- ----------------------------------------------------------------------
@@ -133,11 +143,11 @@
 		FOREIGN KEY (seq_set)
 		REFERENCES @NAMESPACE at .sl_set (set_id)
 );
-comment on table @NAMESPACE at .sl_sequence is 'Similar to sl_table, each entry identifies a sequence being replicated.
-seq_id is an internally-used ID for Slony-I to use in its sequencing of updates
-seq_reloid is the OID of the sequence object
-seq_set indicates which replication set the object is in
-seq_comment is a human-oriented comment';
+comment on table @NAMESPACE at .sl_sequence is 'Similar to sl_table, each entry identifies a sequence being replicated.';
+comment on column @NAMESPACE at .sl_sequence.seq_id is 'An internally-used ID for Slony-I to use in its sequencing of updates';
+comment on column @NAMESPACE at .sl_sequence.seq_reloid is 'The OID of the sequence object';
+comment on column @NAMESPACE at .sl_sequence.seq_set is 'Indicates which replication set the object is in';
+comment on column @NAMESPACE at .sl_sequence.seq_comment is 'A human-oriented comment';
 
 
 -- ----------------------------------------------------------------------
@@ -158,13 +168,11 @@
 		FOREIGN KEY (pa_client)
 		REFERENCES @NAMESPACE at .sl_node (no_id)
 );
-comment on table @NAMESPACE at .sl_path is 'Holds connection information for the paths between nodes, and the synchronisation delay
-
-pa_server - The Node ID # (from sl_node.no_id) of the data source
-pa_client - The Node ID # (from sl_node.no_id) of the data target
-pa_conninfo - The PostgreSQL connection string used to connect to the source node.
-pa_connretry - The synchronisation delay, in seconds
-';
+comment on table @NAMESPACE at .sl_path is 'Holds connection information for the paths between nodes, and the synchronisation delay';
+comment on column @NAMESPACE at .sl_path.pa_server is 'The Node ID # (from sl_node.no_id) of the data source';
+comment on column @NAMESPACE at .sl_path.pa_client is 'The Node ID # (from sl_node.no_id) of the data target';
+comment on column @NAMESPACE at .sl_path.pa_conninfo is 'The PostgreSQL connection string used to connect to the source node.';
+comment on column @NAMESPACE at .sl_path.pa_connretry is 'The synchronisation delay, in seconds';
 
 
 -- ----------------------------------------------------------------------
@@ -184,12 +192,10 @@
 		FOREIGN KEY (li_provider, li_receiver)
 		REFERENCES @NAMESPACE at .sl_path (pa_server, pa_client)
 );
-comment on table @NAMESPACE at .sl_listen is 'Indicates how nodes listen to events from other nodes in the Slony-I network.
-
-li_origin		:	Integer.  The ID # (from sl_node.no_id) of the node this listener is operating on
-li_provider		:	Integer.  The ID # (from sl_node.no_id) of the source node for this listening event
-li_receiver		:	Integer.  The ID # (from sl_node.no_id) of the target node for this listening event
-';
+comment on table @NAMESPACE at .sl_listen is 'Indicates how nodes listen to events from other nodes in the Slony-I network.';
+comment on column @NAMESPACE at .sl_listen.li_origin is 'The ID # (from sl_node.no_id) of the node this listener is operating on';
+comment on column @NAMESPACE at .sl_listen.li_provider is 'The ID # (from sl_node.no_id) of the source node for this listening event';
+comment on column @NAMESPACE at .sl_listen.li_receiver is 'The ID # (from sl_node.no_id) of the target node for this listening event';
 
 
 -- ----------------------------------------------------------------------
@@ -211,7 +217,12 @@
 		FOREIGN KEY (sub_set)
 		REFERENCES @NAMESPACE at .sl_set (set_id)
 );
-comment on table @NAMESPACE at .sl_subscribe is 'Not documented yet';
+comment on table @NAMESPACE at .sl_subscribe is 'Holds a list of subscriptions on sets';
+comment on column @NAMESPACE at .sl_subscribe.sub_set is 'ID # (from sl_set) of the set being subscribed to';
+comment on column @NAMESPACE at .sl_subscribe.sub_provider is 'ID# (from sl_node) of the node providing data';
+comment on column @NAMESPACE at .sl_subscribe.sub_receiver is 'ID# (from sl_node) of the node receiving data from the provider';
+comment on column @NAMESPACE at .sl_subscribe.sub_forward is 'Does this provider keep data in sl_log_1/sl_log_2 to allow it to be a provider for other nodes?';
+comment on column @NAMESPACE at .sl_subscribe.sub_active is 'Has this subscription been activated?  This is not set until the subscriber has received COPY data from the provider';
 
 
 -- ----------------------------------------------------------------------
@@ -237,18 +248,15 @@
 	CONSTRAINT "sl_event-pkey"
 		PRIMARY KEY (ev_origin, ev_seqno)
 );
-comment on table @NAMESPACE at .sl_event is 'Holds information about replication events.
-
-After a period of time, Slony removes old confirmed events from both this table and the sl_confirm table.
-
-ev_origin		:	Integer.  The ID # (from sl_node.no_id) of the source node for this event
-ev_seqno		:	Integer.  The ID # for the event
-ev_timestamp	:	Timestamp.  When this event record was created
-ev_minxid		:
-ev_maxxid		:
-ev_xip			:	String.
-ev_type			:	String.  The type of event this record is for.
-
+comment on table @NAMESPACE at .sl_event is 'Holds information about replication events.  After a period of time, Slony removes old confirmed events from both this table and the sl_confirm table.';
+comment on column @NAMESPACE at .sl_event.ev_origin is 'The ID # (from sl_node.no_id) of the source node for this event';
+comment on column @NAMESPACE at .sl_event.ev_seqno is 'The ID # for the event';
+comment on column @NAMESPACE at .sl_event.ev_timestamp is 'When this event record was created';
+comment on column @NAMESPACE at .sl_event.ev_minxid is 'Earliest XID on provider node for this event';
+comment on column @NAMESPACE at .sl_event.ev_maxxid is 'Latest XID on provider node for this event';
+comment on column @NAMESPACE at .sl_event.ev_seqno is 'The ID # for the event';
+comment on column @NAMESPACE at .sl_event.ev_xip is 'TBD';
+comment on column @NAMESPACE at .sl_event.ev_type is 'The type of event this record is for.  
 				SYNC				= Synchronise
 				STORE_NODE			=
 				ENABLE_NODE			=
@@ -272,6 +280,14 @@
 				DDL_SCRIPT			=
 				ADJUST_SEQ			=
 ';
+comment on column @NAMESPACE at .sl_event.ev_data1 is 'Data field containing an argument needed to process the event';
+comment on column @NAMESPACE at .sl_event.ev_data2 is 'Data field containing an argument needed to process the event';
+comment on column @NAMESPACE at .sl_event.ev_data3 is 'Data field containing an argument needed to process the event';
+comment on column @NAMESPACE at .sl_event.ev_data4 is 'Data field containing an argument needed to process the event';
+comment on column @NAMESPACE at .sl_event.ev_data5 is 'Data field containing an argument needed to process the event';
+comment on column @NAMESPACE at .sl_event.ev_data6 is 'Data field containing an argument needed to process the event';
+comment on column @NAMESPACE at .sl_event.ev_data7 is 'Data field containing an argument needed to process the event';
+comment on column @NAMESPACE at .sl_event.ev_data8 is 'Data field containing an argument needed to process the event';
 
 
 -- ----------------------------------------------------------------------
@@ -283,15 +299,12 @@
 	con_seqno			int8,
 	con_timestamp		timestamp DEFAULT timeofday()::timestamp
 );
-comment on table @NAMESPACE at .sl_confirm is 'Holds confirmation of replication events.
+comment on table @NAMESPACE at .sl_confirm is 'Holds confirmation of replication events.  After a period of time, Slony removes old confirmed events from both this table and the sl_event table.';
 
-After a period of time, Slony removes old confirmed events from both this table and the sl_event table.
+comment on column @NAMESPACE at .sl_confirm.con_origin is 'The ID # (from sl_node.no_id) of the source node for this event';
+comment on column @NAMESPACE at .sl_confirm.con_seqno is 'The ID # for the event';
+comment on column @NAMESPACE at .sl_confirm.con_timestamp is 'When this event was confirmed';
 
-con_origin		:	Integer.  The ID # (from sl_node.no_id) of the source node for this event  
-con_received	:	Integer.
-con_seqno		:	Integer.  The ID # for the event
-con_timestamp	:	Timestamp.  When this event was confirmed
-';
 create index sl_confirm_idx1 on @NAMESPACE at .sl_confirm
 	(con_origin, con_received, con_seqno);
 create index sl_confirm_idx2 on @NAMESPACE at .sl_confirm
@@ -306,7 +319,13 @@
 	seql_ev_seqno		int8,
 	seql_last_value		int8
 );
-comment on table @NAMESPACE at .sl_seqlog is 'Not documented yet';
+comment on table @NAMESPACE at .sl_seqlog is 'Log of Sequence updates';
+
+comment on column @NAMESPACE at .sl_seqlog.seql_seqid is 'Sequence ID';
+comment on column @NAMESPACE at .sl_seqlog.seql_origin is 'Publisher node at which the sequence originates';
+comment on column @NAMESPACE at .sl_seqlog.seql_ev_seqno is 'TBD';
+comment on column @NAMESPACE at .sl_seqlog.seql_last_value is 'Last value published for this sequence';
+
 create index sl_seqlog_idx on @NAMESPACE at .sl_seqlog
 	(seql_origin, seql_ev_seqno, seql_seqid);
 
@@ -361,13 +380,12 @@
 create index sl_log_1_idx1 on @NAMESPACE at .sl_log_1
 	(log_origin, log_xid @NAMESPACE at .xxid_ops, log_actionseq);
 
-comment on table @NAMESPACE at .sl_log_1 is 'Stores each change to be propagated to subscriber nodes
-
-log_origin - origin node from which the change came
-log_xid - transaction ID on the origin node
-log_table_id - the table ID (from sl_table.tab_id) that this log entry is to affect
-log_cmdtype - replication action to take. U = Update, I = Insert, D = DELETE
-log_cmddata - the data needed to perform the log action';
+comment on table @NAMESPACE at .sl_log_1 is 'Stores each change to be propagated to subscriber nodes';
+comment on column @NAMESPACE at .sl_log_1.log_origin is 'Origin node from which the change came';
+comment on column @NAMESPACE at .sl_log_1.log_xid is 'Transaction ID on the origin node';
+comment on column @NAMESPACE at .sl_log_1.log_tableid is 'The table ID (from sl_table.tab_id) that this log entry is to affect';
+comment on column @NAMESPACE at .sl_log_1.log_cmdtype is 'Replication action to take. U = Update, I = Insert, D = DELETE';
+comment on column @NAMESPACE at .sl_log_1.log_cmddata is 'The data needed to perform the log action';
 
 -- ----------------------------------------------------------------------
 -- TABLE sl_log_2
@@ -380,13 +398,12 @@
 	log_cmdtype			char,
 	log_cmddata			text
 );
-comment on table @NAMESPACE at .sl_log_2 is 'Stores each change to be propagated to subscriber nodes
-
-log_origin - origin node from which the change came
-log_xid - transaction ID on the origin node
-log_table_id - the table ID (from sl_table.tab_id) that this log entry is to affect
-log_cmdtype - replication action to take. U = Update, I = Insert, D = DELETE
-log_cmddata - the data needed to perform the log action';
+comment on table @NAMESPACE at .sl_log_2 is 'Stores each change to be propagated to subscriber nodes';
+comment on column @NAMESPACE at .sl_log_2.log_origin is 'Origin node from which the change came';
+comment on column @NAMESPACE at .sl_log_2.log_xid is 'Transaction ID on the origin node';
+comment on column @NAMESPACE at .sl_log_2.log_tableid is 'The table ID (from sl_table.tab_id) that this log entry is to affect';
+comment on column @NAMESPACE at .sl_log_2.log_cmdtype is 'Replication action to take. U = Update, I = Insert, D = DELETE';
+comment on column @NAMESPACE at .sl_log_2.log_cmddata is 'The data needed to perform the log action';
 create index sl_log_2_idx1 on @NAMESPACE at .sl_log_2
 	(log_origin, log_xid @NAMESPACE at .xxid_ops, log_actionseq);
 
@@ -487,7 +504,6 @@
 comment on table @NAMESPACE at .sl_config_lock is 'This table exists solely to prevent overlapping execution of configuration change procedures and the resulting possible deadlocks.
 ';
 
-
 -- ----------------------------------------------------------------------
 -- Last but not least grant USAGE to the replication schema objects.
 -- ----------------------------------------------------------------------
Index: slony1_funcs.sql
===================================================================
RCS file: /usr/local/cvsroot/slony1/slony1-engine/src/backend/slony1_funcs.sql,v
retrieving revision 1.25
retrieving revision 1.26
diff -Lsrc/backend/slony1_funcs.sql -Lsrc/backend/slony1_funcs.sql -u -w -r1.25 -r1.26
--- src/backend/slony1_funcs.sql
+++ src/backend/slony1_funcs.sql
@@ -529,7 +529,7 @@
 comment on function @NAMESPACE at .enableNode_int(int4) is
 'no_id - Node ID #
 
-Internal funciton to process the ENABLE_NODE event for node no_id';
+Internal function to process the ENABLE_NODE event for node no_id';
 
 -- ----------------------------------------------------------------------
 -- FUNCTION disableNode (no_id)


More information about the Slony1-commit mailing list