From 7e245c982a2b4d42b862d98d13c84f577f7373e9 Mon Sep 17 00:00:00 2001 From: Alex Pott <alex.a.pott@googlemail.com> Date: Sun, 25 Oct 2015 20:37:36 -0700 Subject: [PATCH] Issue #2594845 by er.manojsharma, tarekdj, snehi, dpopdan, anil280988, jhodgdon, cilefen: Many database driver classes have no class doc blocks --- core/lib/Drupal/Core/Database/Driver/mysql/Connection.php | 3 +++ core/lib/Drupal/Core/Database/Driver/mysql/Delete.php | 3 +++ core/lib/Drupal/Core/Database/Driver/mysql/Insert.php | 3 +++ core/lib/Drupal/Core/Database/Driver/mysql/Merge.php | 3 +++ core/lib/Drupal/Core/Database/Driver/mysql/Schema.php | 3 +++ core/lib/Drupal/Core/Database/Driver/mysql/Select.php | 3 +++ core/lib/Drupal/Core/Database/Driver/mysql/Transaction.php | 3 +++ core/lib/Drupal/Core/Database/Driver/mysql/Truncate.php | 3 +++ core/lib/Drupal/Core/Database/Driver/mysql/Update.php | 3 +++ core/lib/Drupal/Core/Database/Driver/mysql/Upsert.php | 2 +- core/lib/Drupal/Core/Database/Driver/pgsql/Connection.php | 3 +++ core/lib/Drupal/Core/Database/Driver/pgsql/Delete.php | 3 +++ core/lib/Drupal/Core/Database/Driver/pgsql/Insert.php | 3 +++ core/lib/Drupal/Core/Database/Driver/pgsql/Merge.php | 3 +++ core/lib/Drupal/Core/Database/Driver/pgsql/NativeUpsert.php | 2 +- core/lib/Drupal/Core/Database/Driver/pgsql/Schema.php | 3 +++ core/lib/Drupal/Core/Database/Driver/pgsql/Select.php | 3 +++ core/lib/Drupal/Core/Database/Driver/pgsql/Transaction.php | 3 +++ core/lib/Drupal/Core/Database/Driver/pgsql/Truncate.php | 3 +++ core/lib/Drupal/Core/Database/Driver/pgsql/Update.php | 3 +++ core/lib/Drupal/Core/Database/Driver/pgsql/Upsert.php | 2 +- core/lib/Drupal/Core/Database/Driver/sqlite/Connection.php | 2 +- core/lib/Drupal/Core/Database/Driver/sqlite/Delete.php | 2 +- core/lib/Drupal/Core/Database/Driver/sqlite/Insert.php | 2 +- core/lib/Drupal/Core/Database/Driver/sqlite/Merge.php | 3 +++ core/lib/Drupal/Core/Database/Driver/sqlite/Schema.php | 3 +++ core/lib/Drupal/Core/Database/Driver/sqlite/Select.php | 3 +++ core/lib/Drupal/Core/Database/Driver/sqlite/Statement.php | 2 +- core/lib/Drupal/Core/Database/Driver/sqlite/Transaction.php | 3 +++ core/lib/Drupal/Core/Database/Driver/sqlite/Truncate.php | 2 +- core/lib/Drupal/Core/Database/Driver/sqlite/Update.php | 3 +++ core/lib/Drupal/Core/Database/Driver/sqlite/Upsert.php | 2 +- 32 files changed, 78 insertions(+), 9 deletions(-) diff --git a/core/lib/Drupal/Core/Database/Driver/mysql/Connection.php b/core/lib/Drupal/Core/Database/Driver/mysql/Connection.php index 2bfc330acd9b..dd8c299e48d9 100644 --- a/core/lib/Drupal/Core/Database/Driver/mysql/Connection.php +++ b/core/lib/Drupal/Core/Database/Driver/mysql/Connection.php @@ -21,6 +21,9 @@ * @{ */ +/** + * MySQL implementation of \Drupal\Core\Database\Connection. + */ class Connection extends DatabaseConnection { /** diff --git a/core/lib/Drupal/Core/Database/Driver/mysql/Delete.php b/core/lib/Drupal/Core/Database/Driver/mysql/Delete.php index 4e594da3e5fb..296a1298d56d 100644 --- a/core/lib/Drupal/Core/Database/Driver/mysql/Delete.php +++ b/core/lib/Drupal/Core/Database/Driver/mysql/Delete.php @@ -9,4 +9,7 @@ use Drupal\Core\Database\Query\Delete as QueryDelete; +/** + * MySQL implementation of \Drupal\Core\Database\Query\Delete. + */ class Delete extends QueryDelete { } diff --git a/core/lib/Drupal/Core/Database/Driver/mysql/Insert.php b/core/lib/Drupal/Core/Database/Driver/mysql/Insert.php index b458d3647123..731cab1be7ac 100644 --- a/core/lib/Drupal/Core/Database/Driver/mysql/Insert.php +++ b/core/lib/Drupal/Core/Database/Driver/mysql/Insert.php @@ -9,6 +9,9 @@ use Drupal\Core\Database\Query\Insert as QueryInsert; +/** + * MySQL implementation of \Drupal\Core\Database\Query\Insert. + */ class Insert extends QueryInsert { public function execute() { diff --git a/core/lib/Drupal/Core/Database/Driver/mysql/Merge.php b/core/lib/Drupal/Core/Database/Driver/mysql/Merge.php index b98d8688801e..b517c52b9f24 100644 --- a/core/lib/Drupal/Core/Database/Driver/mysql/Merge.php +++ b/core/lib/Drupal/Core/Database/Driver/mysql/Merge.php @@ -9,4 +9,7 @@ use Drupal\Core\Database\Query\Merge as QueryMerge; +/** + * MySQL implementation of \Drupal\Core\Database\Query\Merge. + */ class Merge extends QueryMerge { } diff --git a/core/lib/Drupal/Core/Database/Driver/mysql/Schema.php b/core/lib/Drupal/Core/Database/Driver/mysql/Schema.php index a20e58d672f1..c1fe4074b869 100644 --- a/core/lib/Drupal/Core/Database/Driver/mysql/Schema.php +++ b/core/lib/Drupal/Core/Database/Driver/mysql/Schema.php @@ -19,6 +19,9 @@ * @{ */ +/** + * MySQL implementation of \Drupal\Core\Database\Schema. + */ class Schema extends DatabaseSchema { /** diff --git a/core/lib/Drupal/Core/Database/Driver/mysql/Select.php b/core/lib/Drupal/Core/Database/Driver/mysql/Select.php index caa2dbf06eaf..125f9443ffc9 100644 --- a/core/lib/Drupal/Core/Database/Driver/mysql/Select.php +++ b/core/lib/Drupal/Core/Database/Driver/mysql/Select.php @@ -9,4 +9,7 @@ use Drupal\Core\Database\Query\Select as QuerySelect; +/** + * MySQL implementation of \Drupal\Core\Database\Query\Select. + */ class Select extends QuerySelect { } diff --git a/core/lib/Drupal/Core/Database/Driver/mysql/Transaction.php b/core/lib/Drupal/Core/Database/Driver/mysql/Transaction.php index a04d7a03a08e..f52b59251a9c 100644 --- a/core/lib/Drupal/Core/Database/Driver/mysql/Transaction.php +++ b/core/lib/Drupal/Core/Database/Driver/mysql/Transaction.php @@ -9,4 +9,7 @@ use Drupal\Core\Database\Transaction as DatabaseTransaction; +/** + * MySQL implementation of \Drupal\Core\Database\Transaction. + */ class Transaction extends DatabaseTransaction { } diff --git a/core/lib/Drupal/Core/Database/Driver/mysql/Truncate.php b/core/lib/Drupal/Core/Database/Driver/mysql/Truncate.php index 00cf10c5f859..3f87481a58dc 100644 --- a/core/lib/Drupal/Core/Database/Driver/mysql/Truncate.php +++ b/core/lib/Drupal/Core/Database/Driver/mysql/Truncate.php @@ -9,4 +9,7 @@ use Drupal\Core\Database\Query\Truncate as QueryTruncate; +/** + * MySQL implementation of \Drupal\Core\Database\Query\Truncate. + */ class Truncate extends QueryTruncate { } diff --git a/core/lib/Drupal/Core/Database/Driver/mysql/Update.php b/core/lib/Drupal/Core/Database/Driver/mysql/Update.php index 7d96e5577e51..333eeb697634 100644 --- a/core/lib/Drupal/Core/Database/Driver/mysql/Update.php +++ b/core/lib/Drupal/Core/Database/Driver/mysql/Update.php @@ -9,4 +9,7 @@ use Drupal\Core\Database\Query\Update as QueryUpdate; +/** + * MySQL implementation of \Drupal\Core\Database\Query\Update. + */ class Update extends QueryUpdate { } diff --git a/core/lib/Drupal/Core/Database/Driver/mysql/Upsert.php b/core/lib/Drupal/Core/Database/Driver/mysql/Upsert.php index 6d5025157af2..ad8f28f00838 100644 --- a/core/lib/Drupal/Core/Database/Driver/mysql/Upsert.php +++ b/core/lib/Drupal/Core/Database/Driver/mysql/Upsert.php @@ -10,7 +10,7 @@ use Drupal\Core\Database\Query\Upsert as QueryUpsert; /** - * Implements the Upsert query for the MySQL database driver. + * MySQL implementation of \Drupal\Core\Database\Query\Upsert. */ class Upsert extends QueryUpsert { diff --git a/core/lib/Drupal/Core/Database/Driver/pgsql/Connection.php b/core/lib/Drupal/Core/Database/Driver/pgsql/Connection.php index b5ef45d18e70..81aeabc0efbf 100644 --- a/core/lib/Drupal/Core/Database/Driver/pgsql/Connection.php +++ b/core/lib/Drupal/Core/Database/Driver/pgsql/Connection.php @@ -16,6 +16,9 @@ * @{ */ +/** + * PostgreSQL implementation of \Drupal\Core\Database\Connection. + */ class Connection extends DatabaseConnection { /** diff --git a/core/lib/Drupal/Core/Database/Driver/pgsql/Delete.php b/core/lib/Drupal/Core/Database/Driver/pgsql/Delete.php index f8940adc0f53..72687cec7301 100644 --- a/core/lib/Drupal/Core/Database/Driver/pgsql/Delete.php +++ b/core/lib/Drupal/Core/Database/Driver/pgsql/Delete.php @@ -9,6 +9,9 @@ use Drupal\Core\Database\Query\Delete as QueryDelete; +/** + * PostgreSQL implementation of \Drupal\Core\Database\Query\Delete. + */ class Delete extends QueryDelete { /** diff --git a/core/lib/Drupal/Core/Database/Driver/pgsql/Insert.php b/core/lib/Drupal/Core/Database/Driver/pgsql/Insert.php index f36f509de66e..084856ae446a 100644 --- a/core/lib/Drupal/Core/Database/Driver/pgsql/Insert.php +++ b/core/lib/Drupal/Core/Database/Driver/pgsql/Insert.php @@ -15,6 +15,9 @@ * @{ */ +/** + * PostgreSQL implementation of \Drupal\Core\Database\Query\Insert. + */ class Insert extends QueryInsert { public function execute() { diff --git a/core/lib/Drupal/Core/Database/Driver/pgsql/Merge.php b/core/lib/Drupal/Core/Database/Driver/pgsql/Merge.php index ad74c13a69cd..445c5c873676 100644 --- a/core/lib/Drupal/Core/Database/Driver/pgsql/Merge.php +++ b/core/lib/Drupal/Core/Database/Driver/pgsql/Merge.php @@ -9,4 +9,7 @@ use Drupal\Core\Database\Query\Merge as QueryMerge; +/** + * PostgreSQL implementation of \Drupal\Core\Database\Query\Merge. + */ class Merge extends QueryMerge { } diff --git a/core/lib/Drupal/Core/Database/Driver/pgsql/NativeUpsert.php b/core/lib/Drupal/Core/Database/Driver/pgsql/NativeUpsert.php index d1c6d11200ea..1f1c94bd5060 100644 --- a/core/lib/Drupal/Core/Database/Driver/pgsql/NativeUpsert.php +++ b/core/lib/Drupal/Core/Database/Driver/pgsql/NativeUpsert.php @@ -10,7 +10,7 @@ use Drupal\Core\Database\Query\Upsert as QueryUpsert; /** - * Implements the native Upsert query for the PostgreSQL database driver. + * PostgreSQL implementation of native \Drupal\Core\Database\Query\Upsert. * * @see http://www.postgresql.org/docs/9.5/static/sql-insert.html#SQL-ON-CONFLICT */ diff --git a/core/lib/Drupal/Core/Database/Driver/pgsql/Schema.php b/core/lib/Drupal/Core/Database/Driver/pgsql/Schema.php index cd22b94e344a..c59e2e43ea59 100644 --- a/core/lib/Drupal/Core/Database/Driver/pgsql/Schema.php +++ b/core/lib/Drupal/Core/Database/Driver/pgsql/Schema.php @@ -17,6 +17,9 @@ * @{ */ +/** + * PostgreSQL implementation of \Drupal\Core\Database\Schema. + */ class Schema extends DatabaseSchema { /** diff --git a/core/lib/Drupal/Core/Database/Driver/pgsql/Select.php b/core/lib/Drupal/Core/Database/Driver/pgsql/Select.php index 0b58c677980c..ff73a96a0397 100644 --- a/core/lib/Drupal/Core/Database/Driver/pgsql/Select.php +++ b/core/lib/Drupal/Core/Database/Driver/pgsql/Select.php @@ -14,6 +14,9 @@ * @{ */ +/** + * PostgreSQL implementation of \Drupal\Core\Database\Query\Select. + */ class Select extends QuerySelect { public function orderRandom() { diff --git a/core/lib/Drupal/Core/Database/Driver/pgsql/Transaction.php b/core/lib/Drupal/Core/Database/Driver/pgsql/Transaction.php index 682c53c08807..8a4d9852bcb7 100644 --- a/core/lib/Drupal/Core/Database/Driver/pgsql/Transaction.php +++ b/core/lib/Drupal/Core/Database/Driver/pgsql/Transaction.php @@ -9,4 +9,7 @@ use Drupal\Core\Database\Transaction as DatabaseTransaction; +/** + * PostgreSQL implementation of \Drupal\Core\Database\Transaction. + */ class Transaction extends DatabaseTransaction { } diff --git a/core/lib/Drupal/Core/Database/Driver/pgsql/Truncate.php b/core/lib/Drupal/Core/Database/Driver/pgsql/Truncate.php index c0ad989462e7..6ffd8953d394 100644 --- a/core/lib/Drupal/Core/Database/Driver/pgsql/Truncate.php +++ b/core/lib/Drupal/Core/Database/Driver/pgsql/Truncate.php @@ -9,6 +9,9 @@ use Drupal\Core\Database\Query\Truncate as QueryTruncate; +/** + * PostgreSQL implementation of \Drupal\Core\Database\Query\Truncate. + */ class Truncate extends QueryTruncate { /** diff --git a/core/lib/Drupal/Core/Database/Driver/pgsql/Update.php b/core/lib/Drupal/Core/Database/Driver/pgsql/Update.php index 5d4171dd5d02..ac9bf0c2f582 100644 --- a/core/lib/Drupal/Core/Database/Driver/pgsql/Update.php +++ b/core/lib/Drupal/Core/Database/Driver/pgsql/Update.php @@ -11,6 +11,9 @@ use Drupal\Core\Database\Query\Update as QueryUpdate; use Drupal\Core\Database\Query\SelectInterface; +/** + * PostgreSQL implementation of \Drupal\Core\Database\Query\Update. + */ class Update extends QueryUpdate { public function execute() { diff --git a/core/lib/Drupal/Core/Database/Driver/pgsql/Upsert.php b/core/lib/Drupal/Core/Database/Driver/pgsql/Upsert.php index e23092d875b8..b8b5a88b5708 100644 --- a/core/lib/Drupal/Core/Database/Driver/pgsql/Upsert.php +++ b/core/lib/Drupal/Core/Database/Driver/pgsql/Upsert.php @@ -10,7 +10,7 @@ use Drupal\Core\Database\Query\Upsert as QueryUpsert; /** - * Implements the Upsert query for the PostgreSQL database driver. + * PostgreSQL implementation of \Drupal\Core\Database\Query\Upsert. */ class Upsert extends QueryUpsert { diff --git a/core/lib/Drupal/Core/Database/Driver/sqlite/Connection.php b/core/lib/Drupal/Core/Database/Driver/sqlite/Connection.php index e1eb45957381..b94ae9f61418 100644 --- a/core/lib/Drupal/Core/Database/Driver/sqlite/Connection.php +++ b/core/lib/Drupal/Core/Database/Driver/sqlite/Connection.php @@ -12,7 +12,7 @@ use Drupal\Core\Database\Connection as DatabaseConnection; /** - * Specific SQLite implementation of DatabaseConnection. + * SQLite implementation of \Drupal\Core\Database\Connection. */ class Connection extends DatabaseConnection { diff --git a/core/lib/Drupal/Core/Database/Driver/sqlite/Delete.php b/core/lib/Drupal/Core/Database/Driver/sqlite/Delete.php index a6a07ce5b5b6..b9563e5d4dad 100644 --- a/core/lib/Drupal/Core/Database/Driver/sqlite/Delete.php +++ b/core/lib/Drupal/Core/Database/Driver/sqlite/Delete.php @@ -10,6 +10,6 @@ use Drupal\Core\Database\Query\Delete as QueryDelete; /** - * SQLite specific implementation of \Drupal\Core\Database\Query\Delete. + * SQLite implementation of \Drupal\Core\Database\Query\Delete. */ class Delete extends QueryDelete { } diff --git a/core/lib/Drupal/Core/Database/Driver/sqlite/Insert.php b/core/lib/Drupal/Core/Database/Driver/sqlite/Insert.php index 0e940e7e89b7..5482c4b6e636 100644 --- a/core/lib/Drupal/Core/Database/Driver/sqlite/Insert.php +++ b/core/lib/Drupal/Core/Database/Driver/sqlite/Insert.php @@ -10,7 +10,7 @@ use Drupal\Core\Database\Query\Insert as QueryInsert; /** - * SQLite specific implementation of InsertQuery. + * SQLite implementation of \Drupal\Core\Database\Query\Insert. * * We ignore all the default fields and use the clever SQLite syntax: * INSERT INTO table DEFAULT VALUES diff --git a/core/lib/Drupal/Core/Database/Driver/sqlite/Merge.php b/core/lib/Drupal/Core/Database/Driver/sqlite/Merge.php index 2acea077f0f2..2e745604dd14 100644 --- a/core/lib/Drupal/Core/Database/Driver/sqlite/Merge.php +++ b/core/lib/Drupal/Core/Database/Driver/sqlite/Merge.php @@ -9,4 +9,7 @@ use Drupal\Core\Database\Query\Merge as QueryMerge; +/** + * SQLite implementation of \Drupal\Core\Database\Query\Merge. + */ class Merge extends QueryMerge { } diff --git a/core/lib/Drupal/Core/Database/Driver/sqlite/Schema.php b/core/lib/Drupal/Core/Database/Driver/sqlite/Schema.php index 6799dcb14de3..1fb1f16f6f10 100644 --- a/core/lib/Drupal/Core/Database/Driver/sqlite/Schema.php +++ b/core/lib/Drupal/Core/Database/Driver/sqlite/Schema.php @@ -17,6 +17,9 @@ * @{ */ +/** + * SQLite implementation of \Drupal\Core\Database\Schema. + */ class Schema extends DatabaseSchema { /** diff --git a/core/lib/Drupal/Core/Database/Driver/sqlite/Select.php b/core/lib/Drupal/Core/Database/Driver/sqlite/Select.php index 8f2fdb749e65..366fb21df82f 100644 --- a/core/lib/Drupal/Core/Database/Driver/sqlite/Select.php +++ b/core/lib/Drupal/Core/Database/Driver/sqlite/Select.php @@ -9,6 +9,9 @@ use Drupal\Core\Database\Query\Select as QuerySelect; +/** + * SQLite implementation of \Drupal\Core\Database\Query\Select. + */ class Select extends QuerySelect { public function forUpdate($set = TRUE) { // SQLite does not support FOR UPDATE so nothing to do. diff --git a/core/lib/Drupal/Core/Database/Driver/sqlite/Statement.php b/core/lib/Drupal/Core/Database/Driver/sqlite/Statement.php index bfa494f73f6e..e2b98218ad20 100644 --- a/core/lib/Drupal/Core/Database/Driver/sqlite/Statement.php +++ b/core/lib/Drupal/Core/Database/Driver/sqlite/Statement.php @@ -11,7 +11,7 @@ use Drupal\Core\Database\StatementInterface; /** - * Specific SQLite implementation of DatabaseConnection. + * SQLite implementation of \Drupal\Core\Database\Statement. * * The PDO SQLite driver only closes SELECT statements when the PDOStatement * destructor is called and SQLite does not allow data change (INSERT, diff --git a/core/lib/Drupal/Core/Database/Driver/sqlite/Transaction.php b/core/lib/Drupal/Core/Database/Driver/sqlite/Transaction.php index 736dbccf39da..b09330045771 100644 --- a/core/lib/Drupal/Core/Database/Driver/sqlite/Transaction.php +++ b/core/lib/Drupal/Core/Database/Driver/sqlite/Transaction.php @@ -9,4 +9,7 @@ use Drupal\Core\Database\Transaction as DatabaseTransaction; +/** + * SQLite implementation of \Drupal\Core\Database\Transaction. + */ class Transaction extends DatabaseTransaction { } diff --git a/core/lib/Drupal/Core/Database/Driver/sqlite/Truncate.php b/core/lib/Drupal/Core/Database/Driver/sqlite/Truncate.php index a0171c4cc188..ae16bc2dbf18 100644 --- a/core/lib/Drupal/Core/Database/Driver/sqlite/Truncate.php +++ b/core/lib/Drupal/Core/Database/Driver/sqlite/Truncate.php @@ -10,7 +10,7 @@ use Drupal\Core\Database\Query\Truncate as QueryTruncate; /** - * SQLite specific implementation of TruncateQuery. + * SQLite implementation of \Drupal\Core\Database\Query\Truncate. * * SQLite doesn't support TRUNCATE, but a DELETE query with no condition has * exactly the effect (it is implemented by DROPing the table). diff --git a/core/lib/Drupal/Core/Database/Driver/sqlite/Update.php b/core/lib/Drupal/Core/Database/Driver/sqlite/Update.php index aca3c95198c2..da56c4e2227a 100644 --- a/core/lib/Drupal/Core/Database/Driver/sqlite/Update.php +++ b/core/lib/Drupal/Core/Database/Driver/sqlite/Update.php @@ -9,4 +9,7 @@ use Drupal\Core\Database\Query\Update as QueryUpdate; +/** + * SQLite implementation of \Drupal\Core\Database\Query\Update. + */ class Update extends QueryUpdate { } diff --git a/core/lib/Drupal/Core/Database/Driver/sqlite/Upsert.php b/core/lib/Drupal/Core/Database/Driver/sqlite/Upsert.php index d382b18237a3..360f35226d5e 100644 --- a/core/lib/Drupal/Core/Database/Driver/sqlite/Upsert.php +++ b/core/lib/Drupal/Core/Database/Driver/sqlite/Upsert.php @@ -10,7 +10,7 @@ use Drupal\Core\Database\Query\Upsert as QueryUpsert; /** - * Implements the Upsert query for the SQLite database driver. + * SQLite implementation of \Drupal\Core\Database\Query\Upsert. */ class Upsert extends QueryUpsert { -- GitLab