API Documentation Fixups

Document all public methods. Reflect newer changes in API

Change-Id: Iecadf4360a73150643a13962098f4f436b5d044c
Reviewed-on: http://review.couchbase.org/28620
Reviewed-by: Brett Lawson <brett19@gmail.com>
Reviewed-by: Mark Nunberg <mnunberg@haskalah.org>
Tested-by: Mark Nunberg <mnunberg@haskalah.org>