[ticket/10678] More formatting and docblocks

PHPBB3-10678

tests/test_framework/phpbb_database_test_case.php

@@ -129,6 +129,14 @@ abstract class phpbb_database_test_case extends PHPUnit_Extensions_Database_Test
 		return new phpbb_database_test_connection_manager($config);
 	}
 
+	/**
+	* Converts a match in the middle of a string to uppercase.
+	* This is necessary for tranforming the fixture information for Firebird tests
+	*
+	* @param $matches The array of matches from a regular expression
+	*
+	* @return string The string with the specified match converted to uppercase
+	*/
 	public static function to_upper($matches)
 	{
 		return $matches[1] . strtoupper($matches[2]) . $matches[3];