Update of /home/cvsd/slony1/slony1-engine/doc/adminguide
In directory main:/tmp/cvs-serv26115

Modified Files:
	adminscripts.sgml 
Log Message:
Several improvements to documentation, per patches from Mark Stosberg.


Index: adminscripts.sgml
===================================================================
RCS file: /home/cvsd/slony1/slony1-engine/doc/adminguide/adminscripts.sgml,v
retrieving revision 1.47
retrieving revision 1.48
diff -C2 -d -r1.47 -r1.48
*** adminscripts.sgml	30 Jan 2007 19:57:11 -0000	1.47
--- adminscripts.sgml	1 Feb 2007 19:09:08 -0000	1.48
***************
*** 22,29 ****
  </command></para>
  
! <para>This will produce a number of scripts with the prefix <command>slonik_</command>.
! They eliminate tedium by always referring to a central configuration file
! for the details of your site configuration. Most also include some command 
! line help with the "-h" option, making them easier to learn and use.
  </para>
  
--- 22,32 ----
  </command></para>
  
! <para>This will produce a number of scripts with the prefix
! <command>slonik_</command>.  They eliminate tedium by always referring
! to a central configuration file for the details of your site
! configuration. A documented sample of this file is provided in
! <filename>altperl/slon_tools.conf-sample</filename>. Most also include
! some command line help with the "--help" option, making them easier to
! learn and use.
  </para>
  
***************
*** 35,44 ****
  <emphasis>before</emphasis> piping it to <xref linkend="slonik">.</para>
  
! <sect3><title>Node/Cluster Configuration - cluster.nodes</title>
! <indexterm><primary>cluster.nodes - node/cluster configuration for Perl tools</primary></indexterm>
  
  <para>The UNIX environment variable <envar>SLONYNODES</envar> is used
  to determine what Perl configuration file will be used to control the
! shape of the nodes in a &slony1; cluster.</para>
  
  <para>What variables are set up.
--- 38,49 ----
  <emphasis>before</emphasis> piping it to <xref linkend="slonik">.</para>
  
! <sect3><title>Support for Multiple Clusters</title>
! <indexterm><primary>Multiple Cluster support for the altperl tools</primary></indexterm>
  
  <para>The UNIX environment variable <envar>SLONYNODES</envar> is used
  to determine what Perl configuration file will be used to control the
! shape of the nodes in a &slony1; cluster. If it is not provided, a
! default <filename>slon_tools.conf</filename> location will be
! referenced. </para>
  
  <para>What variables are set up.
***************
*** 88,91 ****
--- 93,97 ----
  </programlisting>
  </sect3>
+ 
  <sect3><title>Set configuration - cluster.set1, cluster.set2</title>
  <indexterm><primary>cluster.set1 - replication set configuration for Perl tools</primary></indexterm>
***************
*** 101,133 ****
  control what tables will be in a particular replication set.</para>
  
- <para>What variables are set up.</para>
- <itemizedlist>
- <listitem><para>$TABLE_ID = 44;</para>
- <para> Each table must be identified by a unique number; this variable controls where numbering starts</para>
- </listitem>
- <listitem><para>$SEQUENCE_ID = 17;</para>
- <para> Each sequence must be identified by a unique number; this variable controls where numbering starts</para>
- </listitem>
- <listitem><para>@PKEYEDTABLES</para>
- 
- <para> An array of names of tables to be replicated that have a
- defined primary key so that &slony1; can automatically select its key</para>
- </listitem>
- <listitem><para>%KEYEDTABLES</para>
- <para> A hash table of tables to be replicated, where the hash index
- is the table name, and the hash value is the name of a unique not null
- index suitable as a "candidate primary key."</para>
- </listitem>
- <listitem><para>@SERIALTABLES</para>
- 
- <para> An array of names of tables to be replicated that have no
- candidate for primary key.  &slony1; will add a key field based on a
- sequence that &slony1; generates</para>
- </listitem>
- <listitem><para>@SEQUENCES</para>
- 
- <para> An array of names of sequences that are to be replicated</para>
- </listitem>
- </itemizedlist>
  </sect3>
  <sect3><title>slonik_build_env</title>
--- 107,110 ----