Document `add herd` and `add sync`.

Quite a few questions about some of the parameters to `add sync`, demarcated by `XXX`s.

While at it, add a brief intro discussing options and parameters.

Update docs on adding tables and seuences.

Start filling out gaps in the docs.

And correcting apparent inaccuracies and modernizing the Pod a bit. This
commit Updates docs through `add db`. Notable changes:

* Remove the bit in the `start` docs about how it restarts Bucardo. The code
  does not appear to support that, and the `restart` command seems to have it
  covered.
* Remove the "--name" bit from the `start` and `stop` commands. There is no
  `--name` option, so I just found it confusing.
* Itemize the types supported by `list` in a Pod list.
* Itemize all the objects supported by `add`.
* Itemize all of the options to `add db`.

Proof-reading for inaccuracie would be greatly appreciated.

Stub missing commands in docs.

The verb is now split from the noun at line 219.

Change default reason_file name to end in .txt.

Because it is not a log file, only the most reason reason is written
to it.

But also modify the rason log file to replace the extension from the reason
file with `.log`. So it should no longer be named
`bucardo.restart.reason.log.log` by default.

In other words, the names are:

Reason File: `bucardo.restart.reason.txt`
Rason Log:   `bucardo.restart.reason.log`.

Closes GitHub issue #9.

Move the reason file to the debug directory.

Which is `.` by default, so in the default case, it will be the same as the
current behavior. Ref: GitHub Issue #9.

Skip the .init and .spec files.

They are not Perl. Maybe distribution-related stuff should go into another directory? `dist` perhaps?

Add --exit-on-nosync option.

And change the default so that, if there are no active syncs, by default
bucardo will *not* exit. Pass this option to make it exit anyway. Per
discussion; Closes #8

Move all but two blocker to-dos to GitHub issues.

They are still here, but now with links to GitHub. Could not find the post reporting the bug that checks the wrong tables, so I did not add that one. The other one I did not add was answering all mail list messages.

Add a Linux init script and RPM spec file.

The latter is forked from Devrim's pgrpms spec file.

Add chkconfig support to the start script.

Clean up TODO, add some links.

Workarounds for empty primary key join/split problem found by Bill on mailing list.

Remove debug detritus.

Change PGIN to IN; consolidate flat and flatpg modes for now.

and another.

oops.  missed a spot.

consolidating IN and PGIN blocks in delete_rows

Prevent empty trailing items from being ignored when doing a split, especially for the list of primary keys. This should fix a problem reported on the mailing list giving the error "arguments of row IN must all be row expressions"

Quick TODO additions

Since we use MAX(), and the table may have no rows, we need to handle getting back a null, which means that $epoch may be undefined.

Fix some syntax and other problems; simple tests now show 8.1 works as a valid target database.

Force time zone to uppercase GMT for old servers.

Check for cases in which the sync column of bucardo_delta_targets does not exist when doing validate_sync.

Add a single apostrophe to text values for additional quoting checks.

Report proper test failure context.

Added a few of these lines to BucardoTesting.pm:

    local $Test::Builder::Level = $Test::Builder::Level + 1;

Because otherwise, Test::Builder reports the failure from the function or
method call in BucardoTesting.pm, rather than the calling `*.t` file. This
will make it easier to find the file and line of the actual test failure.

Add databas now works with the same parameters.

Greg says, via IRC, "We now allow that, for cool in-place table trimming." So
it seems as though the tests for it should be updated. And so they now are.

The pg_stat_activity PID column name has changed on 9.2.

So detect if we're on 9.2 or higher, and use the new name, `pid`. Still use
the old name, `procpid`, for older versions of PostgreSQL.

Turn list of prereqs into a Pod list and add boolean.

Report reason for compile failure.

Tests for same-database

Allow databases to have the same dsn, as we are moving towards in-database replication.

Testing tweaks

Note recent bug

New siganture for 4.99.5

Update MANIFEST

Bump to version 4.99.5: get ready for next beta

Minor sprintf fix to bucardo

We have column names with underscores, thank you very much.

Make the summary usage message more consistent with the man page.
Items are listed in similar order on both pages. Additionally,
customname, customcols and customcode are mentioned in the usage
message. Finally the usage information for customname, customcols
and customcode are added to the man page.

Testing tweaks.

Switch back to Redis, as Redis::Client does not die smoothly on connection errors.

Make sure we remove the tschema test schema in our tests.

Allow spaces in customnames

Tentative support for multi-column primary keys in MongoDB

Changes file cleanups

Do not map NULL values to Mongo but simply drop them, as MongoDB is schemaless.

Quick inline notes on how to handle common data mismatch problem.

Chunk up the MongoDB deletes so as not to overwhelm the server on large tables.
May still require changing statement_chunk_size

Should be setting, not value

Better lookup for old bucardo_sequence tables.
Per mailing list question from Ed Snajder

Credit last change.

Add 'bucardo list all' to list everything at once.

Add "one logfile per sync" idea from the ML.

Fix up table names now that we are capping test3

Try again for a unique var name

Don't use variable names when a column name already exists - some versions of plpgsql will get confused.

Show full name of relation when giving deadlock details. Fix missing comma.

Spellcheck tweaks

Finish up the Redis work, including a new test.
Also switch from the Redis Perl driver the Redis::Client, as the latter has hash support.

Minor typos.

Minor TODO updates.

Add support for MariaDB

Testing tweaks for SQLite

No backticks!

Typo help.

Update testing suite for MySQL.

Adjust for case-sensitive table names in testing.

Various small tweaks.

Cleanup of conflict code

Lower default sleeps; making testing too painful. :)

Expand test coverage.

Remove unused sub. Better debug output during testing.

Sleep a bit after we fork the VAC daemon, to decrease the chances of things blowing up if the MCP dies before we call inactivedestroy on the forked handles.

Better checking of "identical" default column expressions.

There are some other related issues, but might as well fix this up in a commit.

Allow timestamp columns to not match on startup.

Fix up quoting of tablenames.
Redo the truncate support.
Test with mixed-case tablenames.

Test counting tweaks.

Sequence testing.

Fixes for sequences

Add tests for sequences.

Do not show "old" sequence information if this is a fullcopy, as we are simply blowing it away.

Make it easier to add sequences to a herd

Testing infra: detect sequence diffs.

More support for my horrible typing skills.

Remove debug message.

Testing cleanups.

Better summary output.

More support for non-standard table names.h

Add table with a space to the tests, small adjustments so such tables work.

Cleanup the fullcopy test, and refactor things into BucardoTesting.pm

More fullcopy/onetimecopy changes.

Messages cleaning

More cleanup of the fullcopy/onetimecopy system.

Still on the fence about repeatable read vs serializable, but let's aim for less deadlocks with some slight overhead for the true serializability. See my blog post for more :)

Show if a sync is fullcopy or not

Only run the VAC daemon if we have eligible databases.

Fix typo regarding piddir