Document some parameters

libraries/error_report.lib.php

@@ -160,16 +160,15 @@ function PMA_sendErrorReport($report) {
  *
  * uses the $LINE_COUNT global array of file names and line numbers
  *
- * @param Array $filenames list of files in order of concatenation
+ * @param Array   $filenames         list of files in order of concatenation
  * @param Integer $cumulative_number the cumulative line number in the
- *    concatenated files
+ *                                   concatenated files
  *
- * returns two variables in an array:
+ * @return Array the filename and linenumber
+ * Returns two variables in an array:
  * - A String $filename the filename where the requested cumulative number
  *   exists
  * - Integer $linenumber the translated line number in the returned file
- *
- * @return Array the filename and linenumber
  */
 function PMA_getLineNumber($filenames, $cumulative_number) {
   global $LINE_COUNT;

libraries/import.lib.php

@@ -77,7 +77,7 @@ function PMA_detectCompression($filepath)
  * @param string $sql         query to run
  * @param string $full        query to display, this might be commented
  * @param bool   $controluser whether to use control user for queries
- * @param array  &$sql_data
+ * @param array  &$sql_data   SQL parse data storage
  *
  * @return void
  * @access public

user_password.php

@@ -120,8 +120,8 @@ function PMA_setChangePasswordMsg()
 /**
  * Change the password
  *
- * @param string $password
- * @param string $message
+ * @param string $password                New password
+ * @param string $message                 Message
  * @param array  $change_password_message Message to show
  *
  * @return void