Added method descriptions for BucketManager.

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