Added descriptions to the various classes which were lacking one.

Change-Id: I88c1e1e93709917352beac88a065d84bfe574c2c
Reviewed-on: http://review.couchbase.org/29265
Tested-by: Brett Lawson <brett19@gmail.com>
Reviewed-by: Trond Norbye <trond.norbye@gmail.com>

Author: brett19

example/couchbase-api.php

@@ -178,9 +178,13 @@
  */
 const COUCHBASE_REPLICA_SELECT = LCB_REPLICA_SELECT;
 
+/**
+ * A class representing a connection to a Couchbase bucket.
+ */
 class Couchbase {
 
     /**
+     * Constructs a new instance of a Couchbase object.
      *
      * @param array $hosts An array of hostnames[:port] where the
      *                     Couchbase cluster is running. The port number is
@@ -974,6 +978,12 @@ function listDesignDocs() {
 
 }
 
+/**
+ * A class to wrap the management of a Couchbase cluster.
+ *
+ * Provides APIs for managing a Couchbase cluster, including the creation,
+ * deletion and modification of buckets.
+ */
 class CouchbaseClusterManager {
 
     /**
@@ -1099,46 +1109,84 @@ function flushBucket($name) {
 //                                                    //
 ////////////////////////////////////////////////////////
 
+/**
+ * The base Couchbase Exception class which all Couchbase Exceptions
+ * inherit from.
+ */
 class CouchbaseException extends Exception {
 
 }
 
+/**
+ * Exception thrown when an invalid key is passed
+ */
 class CouchbaseIllegalKeyException extends CouchbaseException {
 
 }
 
+/**
+ * Exception thrown when the server determines the requested key does not
+ * exist.
+ */
 class CouchbaseNoSuchKeyException extends CouchbaseException {
 
 }
 
+/**
+ * Exception thrown when authentication with the server fails.
+ */
 class CouchbaseAuthenticationException extends CouchbaseException {
 
 }
 
+/**
+ * Exception thrown on internal libcouchbase errors.
+ */
 class CouchbaseLibcouchbaseException extends CouchbaseException {
 
 }
 
+/**
+ * Exception thrown when the server encounters an error.
+ */
 class CouchbaseServerException extends CouchbaseException {
 
 }
 
+/**
+ * Exception thrown when the CAS value you passed does not match the servers
+ * current value.
+ */
 class CouchbaseKeyMutatedException extends CouchbaseException {
 
 }
 
+/**
+ * Exception thrown when an operation times out.
+ */
 class CouchbaseTimeoutException extends CouchbaseException {
 
 }
 
+/**
+ * Exception thrown when there are not enough nodes online to preform a
+ * particular operation.  Generally occurs due to invalid durability
+ * requirements
+ */
 class CouchbaseNotEnoughNodesException extends CouchbaseException {
 
 }
 
+/**
+ * Exception thrown when an illegal option is passed to a method.
+ */
 class CouchbaseIllegalOptionException extends CouchbaseException {
 
 }
 
+/**
+ * Exception thrown when an illegal value is passed to a method.
+ */
 class CouchbaseIllegalValueException extends CouchbaseException {
 
 }