1 files changed, 11 insertions, 3 deletions
diff --git a/includes/database/schema.inc b/includes/database/schema.inc
index d575114eb..75e7aab6b 100644
--- a/includes/database/schema.inc
+++ b/includes/database/schema.inc
@@ -274,7 +274,7 @@ abstract class DatabaseSchema implements QueryPlaceholderInterface {
    * @throws DatabaseSchemaObjectDoesNotExistException
    *   If the specified table doesn't exist.
    * @throws DatabaseSchemaObjectExistsException
-   *   If the specified table target table already exist.
+   *   If a table with the specified new name already exists.
    */
   abstract public function renameTable($table, $new_name);
 
@@ -576,12 +576,20 @@ abstract class DatabaseSchema implements QueryPlaceholderInterface {
 }
 
 /**
- * Exception thrown if an object already exists on an operation creating a table, field or index.
+ * Exception thrown if an object being created already exists.
+ *
+ * For example, this exception should be thrown whenever there is an attempt to
+ * create a new database table, field, or index that already exists in the
+ * database schema.
  */
 class DatabaseSchemaObjectExistsException extends Exception {}
 
 /**
- * Exception thrown if an object doesn't exists on a modify operation.
+ * Exception thrown if an object being modified doesn't exist yet.
+ *
+ * For example, this exception should be thrown whenever there is an attempt to
+ * modify a database table, field, or index that does not currently exist in
+ * the database schema.
  */
 class DatabaseSchemaObjectDoesNotExistException extends Exception {}