Updated API comments

Updates all API comments according to https://github.com/couchbaselabs/couchbase-lite-api
Merge pull request #31 from couchbaselabs/update_api_comments

Updated API comments