Update javadocs to match API spec.  (issue #180)

https://github.com/couchbase/couchbase-lite-android/issues/180
add failing test demonstrating incorrect conflict replication

Replicates couchbase/couchbase-lite-android#174. Conflicting leaf
revisions aren't being sent in push replications.
include all leaf revisions in push replications

Fixes couchbase/couchbase-lite-android#174.
Merge branch 'refs/heads/stable'
Merge branch 'refs/heads/push_leafs'
Rework testAllLeafRevisionsArePushed() so that it has no external sync gw dependencies.

https://github.com/couchbase/couchbase-lite-android/issues/174