Adding more javadocs.

Change-Id: I2620d37e19590001e30dc0606744a3520398f370
Reviewed-on: http://review.couchbase.org/40846
Reviewed-by: Michael Nitschinger <michael.nitschinger@couchbase.com>
Tested-by: Michael Nitschinger <michael.nitschinger@couchbase.com>