diff --git a/core/lib/Drupal/Core/Database/Connection.php b/core/lib/Drupal/Core/Database/Connection.php
index 067cf2f..cac6e11 100644
--- a/core/lib/Drupal/Core/Database/Connection.php
+++ b/core/lib/Drupal/Core/Database/Connection.php
@@ -45,7 +45,7 @@
   /**
    * The current database logging object for this connection.
    *
-   * @var \Drupal\Core\Database\Log logger
+   * @var \Drupal\Core\Database\Log
    */
   protected $logger = NULL;
 
@@ -316,7 +316,7 @@ public function prefixTables($sql) {
    * is not used in prefixTables due to performance reasons.
    *
    * @param string $table
-   *   (optional) The table to be searched.
+   *   (optional) The table to find the prefix for.
    */
   public function tablePrefix($table = 'default') {
     if (isset($this->prefixes[$table])) {
@@ -516,7 +516,7 @@ protected function filterComment($comment = '') {
    *   An associative array of options to control how the query is run. See
    *   the documentation for DatabaseConnection::defaultOptions() for details.
    *
-   * @return \Drupal\Core\Database\StatementInterface|NULL
+   * @return \Drupal\Core\Database\StatementInterface|null
    *   This method will return one of: the executed statement, the number of
    *   rows affected by the query (not the number matched), or the generated
    *   insert ID of the last query, depending on the value of
@@ -703,7 +703,7 @@ public function insert($table, array $options = array()) {
    * Prepares and returns a MERGE query object.
    *
    * @param string $table
-   *   The name of the table associated with the query.
+   *  The name of the table to query.
    * @param $options
    *   (optional) An array of options on the query.
    *
@@ -722,7 +722,7 @@ public function merge($table, array $options = array()) {
    * Prepares and returns an UPDATE query object.
    *
    * @param string $table
-   *   The name of the table associated with the query.
+   *  The name of the table to query.
    * @param array $options
    *   (optional) An array of options on the query.
    *
@@ -740,7 +740,7 @@ public function update($table, array $options = array()) {
    * Prepares and returns a DELETE query object.
    *
    * @param string $table
-   *   The name of the table associated with the query.
+   *  The name of the table to query.
    * @param array $options
    *   (optional) An array of options on the query.
    *
@@ -758,7 +758,7 @@ public function delete($table, array $options = array()) {
    * Prepares and returns a TRUNCATE query object.
    *
    * @param string $table
-   *   The name of the table associated with the query.
+   *  The name of the table to query.
    * @param $options
    *   (optional) An array of options on the query.
    *
@@ -797,6 +797,7 @@ public function schema() {
    *
    * @param string $database
    *   The unescaped database name.
+   *
    * @return string
    *   The sanitized database name string.
    */
@@ -813,6 +814,7 @@ public function escapeDatabase($database) {
    *
    * @param string $table
    *   The unescaped table name.
+   *
    * @return string
    *   The sanitized table name string.
    */
@@ -829,6 +831,7 @@ public function escapeTable($table) {
    *
    * @param string $field
    *   The unescaped field name.
+   *
    * @return string
    *   The sanitized field name string.
    */
@@ -846,6 +849,7 @@ public function escapeField($field) {
    *
    * @param string $field
    *   The unescpaed alias name string.
+   *
    * @return string
    *   The sanitized field name string.
    */