MDL-35479 document unit test debugging() changes

lib/phpunit/classes/database_driver_testcase.php

@@ -136,7 +136,7 @@ abstract class database_driver_testcase extends PHPUnit_Framework_TestCase {
 
     /**
      * Return debugging messages from the current test.
-     * @return array
+     * @return array with instances having 'message', 'level' and 'stacktrace' property.
      */
     public function getDebuggingMessages() {
         return phpunit_util::get_debugging_messages();
@@ -144,10 +144,9 @@ abstract class database_driver_testcase extends PHPUnit_Framework_TestCase {
 
     /**
      * Clear all previous debugging messages in current test.
-     * @return array
      */
     public function resetDebugging() {
-        return phpunit_util::reset_debugging();
+        phpunit_util::reset_debugging();
     }
 
     /**
@@ -188,6 +187,10 @@ abstract class database_driver_testcase extends PHPUnit_Framework_TestCase {
         phpunit_util::reset_debugging();
     }
 
+    /**
+     * Call when no debugging() messages expected.
+     * @param string $message
+     */
     public function assertDebuggingNotCalled($message = '') {
         $debugging = phpunit_util::get_debugging_messages();
         $count = count($debugging);