Fix attachments missing from DocumentRevision

Retrieving a document via getAllDocuments returns document with their
attachments missing.
Fix document retrieval for getAllDocuments and getAllDocumentsWithIds
Add tests for attachments on objects retrieved from getAllDocuments and
getAllDocumentsWithIds
Merge pull request #50 from cloudant/33603_fix_missing_attachments

Fix attachments missing from DocumentRevision
Changes the CDTReplicator -start signature.

-(void)start becomes -(BOOL)start:NSError**

Errors created by TDReplicator objects are propaged from
TDReplicatorManager. They are reported to the Log (via Warn),
but new CDT-level errors are reported to developers using the
CDT API.
Addresses comments in the PR.

Adds synchornization to -startWithError for thread safety.

Adds synchronization to -stop for thread safety.

Mmakes -start a __deprecated method.

Updates tests in ReplicationAcceptance to use the new
-startWithError method.

This commit will be squashed.
Adds tests to ensure that the correct type of TDReplicator is created
by a TDReplicationManager when using the NSDictionary object produced
by the CDT*Replication objects.