Some Javadocs for replication stuff [dc]