Various doc blocks improvements

libraries/dbi/drizzle-wrappers.lib.php

@@ -70,12 +70,12 @@ class PMA_Drizzle extends Drizzle
     /**
      * Creates a new database conection using TCP
      *
-     * @param $host
-     * @param $port
-     * @param $user
-     * @param $password
-     * @param $db
-     * @param $options
+     * @param string  $host     Drizzle host
+     * @param integer $port     Drizzle port
+     * @param string  $user     username
+     * @param string  $password password
+     * @param string  $db       database name
+     * @param integer $options  connection options
      *
      * @return PMA_DrizzleCon
      */
@@ -90,11 +90,11 @@ class PMA_Drizzle extends Drizzle
     /**
      * Creates a new connection using unix domain socket
      *
-     * @param $uds
-     * @param $user
-     * @param $password
-     * @param $db
-     * @param $options
+     * @param string  $uds      socket
+     * @param string  $user     username
+     * @param string  $password password
+     * @param string  $db       database name
+     * @param integer $options  connection options
      *
      * @return PMA_DrizzleCon
      */
@@ -132,7 +132,7 @@ class PMA_DrizzleCon
     /**
      * Constructor
      *
-     * @param DrizzleCon $dcon
+     * @param DrizzleCon $dcon connection handle
      *
      * @return void
      */
@@ -144,7 +144,7 @@ class PMA_DrizzleCon
     /**
      * Executes given query. Opens database connection if not already done.
      *
-     * @param string $query
+     * @param string $query       query to execute
      * @param int    $bufferMode  PMA_Drizzle::BUFFER_RESULT,PMA_Drizzle::BUFFER_ROW
      * @param int    $fetchMode   PMA_Drizzle::FETCH_ASSOC, PMA_Drizzle::FETCH_NUM
      *                            or PMA_Drizzle::FETCH_BOTH

libraries/dbi/drizzle.dbi.lib.php

@@ -31,14 +31,14 @@ if (!defined('PMA_MYSQL_CLIENT_API')) {
 /**
  * Helper function for connecting to the database server
  *
- * @param PMA_Drizzle $drizzle
- * @param string      $host
- * @param int         $port
- * @param string      $uds
- * @param string      $user
- * @param string      $password
- * @param string      $db
- * @param int         $options
+ * @param PMA_Drizzle $drizzle  connection handle
+ * @param string      $host     Drizzle host
+ * @param integer     $port     Drizzle port
+ * @param string      $uds      server socket
+ * @param string      $user     username
+ * @param string      $password password
+ * @param string      $db       database name
+ * @param integer     $options  connection options
  *
  * @return PMA_DrizzleCon
  */
@@ -235,7 +235,7 @@ function PMA_DBI_fetch_row($result)
  * Adjusts the result pointer to an arbitrary row in the result
  *
  * @param PMA_DrizzleResult $result Drizzle result object
- * @param int               $offset
+ * @param int               $offset offset to seek
  *
  * @return boolean true on success, false on failure
  */