summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDries Buytaert2011-10-13 20:19:31 -0400
committerDries Buytaert2011-10-13 20:19:31 -0400
commitf93f9235107d43285a93e392a974accac5b5bab0 (patch)
tree73f58aeb274f7ec0f2260a00321403401980ff7a
parent336fef3d434ed48163f53dbf494075f0b9278f7a (diff)
- Patch #341038 by jhodgdon, kathyh, sdboyer: Docblock for DatabaseStatementInterface is a bit off.
-rw-r--r--includes/database/database.inc12
1 files changed, 5 insertions, 7 deletions
diff --git a/includes/database/database.inc b/includes/database/database.inc
index 70c4406..bdd65cc 100644
--- a/includes/database/database.inc
+++ b/includes/database/database.inc
@@ -1896,21 +1896,19 @@ class DatabaseTransaction {
}
/**
- * A prepared statement.
+ * Represents a prepared statement.
*
- * Some methods in that class are purposely commented out. Due to a change in
+ * Some methods in that class are purposefully commented out. Due to a change in
* how PHP defines PDOStatement, we can't define a signature for those methods
* that will work the same way between versions older than 5.2.6 and later
- * versions.
- *
- * Please refer to http://bugs.php.net/bug.php?id=42452 for more details.
+ * versions. See http://bugs.php.net/bug.php?id=42452 for more details.
*
* Child implementations should either extend PDOStatement:
* @code
* class DatabaseStatement_oracle extends PDOStatement implements DatabaseStatementInterface {}
* @endcode
- * or implement their own class, but in that case they will also have to
- * implement the Iterator or IteratorArray interfaces before
+ * or define their own class. If defining their own class, they will also have
+ * to implement either the Iterator or IteratorAggregate interface before
* DatabaseStatementInterface:
* @code
* class DatabaseStatement_oracle implements Iterator, DatabaseStatementInterface {}