Merge 'trunk' into 'replication_dedux'

r13508@dev (orig r4441):  castaway | 2008-05-30 17:41:03 -0500
Update docs for best practices and correctness.

r13509@dev (orig r4448):  castaway | 2008-05-31 15:14:05 -0500
Fix broken pod test (missing newline!)

r13510@dev (orig r4451):  ash | 2008-06-01 05:28:14 -0500
Prepare for new dev release