[ticket/13801] Updated comments for clarity

PHPBB3-13801

phpBB/includes/message_parser.php

@@ -1256,6 +1256,7 @@ class parse_message extends bbcode_firstpass
 		{
 			foreach ($errors as $i => $args)
 			{
+				// Translate each error with $user->lang()
 				$errors[$i] = call_user_func_array(array($user, 'lang'), $args);
 			}
 			$this->warn_msg = array_merge($this->warn_msg, $errors);

phpBB/phpbb/textformatter/parser_interface.php

@@ -82,7 +82,8 @@ interface parser_interface
 	/**
 	* Get the list of errors that were generated during last parsing
 	*
-	* @return array
+	* @return array[] Array of arrays. Each array contains a lang string at index 0 plus any number
+	*                 of optional parameters
 	*/
 	public function get_errors();
 

phpBB/phpbb/textformatter/s9e/parser.php

@@ -186,7 +186,7 @@ class parser implements \phpbb\textformatter\parser_interface
 	/**
 	* {@inheritdoc}
 	*
-	* This will translate the log entries found in s9e\TextFormatter's logger into phpBB error
+	* This will convert the log entries found in s9e\TextFormatter's logger into phpBB error
 	* messages
 	*/
 	public function get_errors()