Automatic Wait For.

This is a merge of the auto_wait_for feature branch.

This change modifies slonik so that it will (in normal circumstances)
automatically wait for events to be confirmed before proceeding in
cases where it detects that this is required.

See the documentation changes included in this patch for more details.

Branch
------
master

Details
-------
http://git.postgresql.org/gitweb?p=slony1-engine.git;a=commitdiff;h=29a509489ed665d18ad66c441a6aea4378507e65

Modified Files
--------------
clustertest/disorder/tests/BasicTest.js       |   10 +-
clustertest/disorder/tests/ExecuteScript.js   |    7 +-
clustertest/disorder/tests/FailNodeTest.js    |   70 +--
clustertest/disorder/tests/Failover.js        |   93 ++--
clustertest/disorder/tests/HeavyLoadTest.js   |    2 +
clustertest/disorder/tests/LogShipping.js     |    2 +-
clustertest/disorder/tests/LongTransaction.js |    7 +-
clustertest/disorder/tests/MergeSet.js        |   75 ++
clustertest/disorder/tests/MultipleOrigins.js |    4 +-
clustertest/disorder/tests/OmitCopy.js        |    1 -
clustertest/disorder/tests/RecreateSet.js     |    3 +-
clustertest/disorder/tests/RenameTests.js     |    5 +-
clustertest/disorder/tests/Unsubscribe.js     |    4 +-
clustertest/disorder/tests/disorder_tests.js  |    6 +-
doc/adminguide/addthings.sgml                 |   15 +-
doc/adminguide/events.sgml                    |  130 +++-
doc/adminguide/slonik.sgml                    |   21 +-
doc/adminguide/slonik_ref.sgml                |  233 ++++++-
src/backend/slony1_funcs.c                    |    7 +
src/backend/slony1_funcs.sql                  |   54 ++-
src/slonik/slonik.c                           |  927 ++++++++++++++++++++++---
21 files changed, 1405 insertions(+), 271 deletions(-)