X-Git-Url: https://git.heureux-cyclage.org/?a=blobdiff_plain;f=tests%2FtestHelpers.inc;h=62dccbf0b36ac4dd934bb0c1ff76d5ab00f80041;hb=25b3aa9ca2652afe05b42f65759d428c1c1afa8c;hp=2f5fa9ea3f7cdbe90c45bb48b414e3a1fc785d2a;hpb=92e31275a4f7117a4465b8886dfeca6dcb37351e;p=lhc%2Fweb%2Fwiklou.git

diff --git a/tests/testHelpers.inc b/tests/testHelpers.inc
index 2f5fa9ea3f..62dccbf0b3 100644
--- a/tests/testHelpers.inc
+++ b/tests/testHelpers.inc
@@ -36,16 +36,26 @@
  */
 interface ITestRecorder {
 
-	/** Called at beginning of the parser test run */
+	/**
+	 * Called at beginning of the parser test run
+	 */
 	public function start();
 
-	/** Called after each test */
+	/**
+	 * Called after each test
+	 * @param string $test
+	 * @param bool $result
+	 */
 	public function record( $test, $result );
 
-	/** Called before finishing the test run */
+	/**
+	 * Called before finishing the test run
+	 */
 	public function report();
 
-	/** Called at the end of the parser test run */
+	/**
+	 * Called at the end of the parser test run
+	 */
 	public function end();
 
 }
@@ -107,6 +117,7 @@ class DbTestPreviewer extends TestRecorder {
 
 	/**
 	 * This should be called before the table prefix is changed
+	 * @param TestRecorder $parent
 	 */
 	function __construct( $parent ) {
 		parent::__construct( $parent );
@@ -220,6 +231,9 @@ class DbTestPreviewer extends TestRecorder {
 	 * Returns a string giving information about when a test last had a status change.
 	 * Could help to track down when regressions were introduced, as distinct from tests
 	 * which have never passed (which are more change requests than regressions).
+	 * @param string $testname
+	 * @param string $after
+	 * @return string
 	 */
 	private function getTestStatusInfo( $testname, $after ) {
 		// If we're looking at a test that has just been removed, then say when it first appeared.
@@ -423,7 +437,7 @@ class TestFileIterator implements Iterator {
 		$input = $this->checkSection( array( 'wikitext', 'input' ), false );
 		$result = $this->checkSection( array( 'html/php', 'html/*', 'html', 'result' ), false );
 		// some tests have "with tidy" and "without tidy" variants
-		$tidy = $this->checkSection( array( 'html/php+tidy', 'html+tidy'), false );
+		$tidy = $this->checkSection( array( 'html/php+tidy', 'html+tidy' ), false );
 		if ( $tidy != false ) {
 			if ( $this->nextSubTest == 0 ) {
 				if ( $result != false ) {
@@ -475,9 +489,11 @@ class TestFileIterator implements Iterator {
 
 	function readNextTest() {
 		# Run additional subtests of previous test
-		while ( $this->nextSubTest > 0 )
-			if ( $this->setupCurrentTest() )
+		while ( $this->nextSubTest > 0 ) {
+			if ( $this->setupCurrentTest() ) {
 				return true;
+			}
+		}
 
 		$this->clearSection();
 		# Reset hooks for the delayed test object
@@ -554,8 +570,9 @@ class TestFileIterator implements Iterator {
 				if ( $this->section == 'end' ) {
 					$this->checkSection( 'test' );
 					do {
-						if ( $this->setupCurrentTest() )
+						if ( $this->setupCurrentTest() ) {
 							return true;
+						}
 					} while ( $this->nextSubTest > 0 );
 					# go on to next test (since this was disabled)
 					$this->clearSection();
@@ -600,6 +617,7 @@ class TestFileIterator implements Iterator {
 	 * mentioned before closing this section
 	 * @param bool $fatal True iff an exception should be thrown if
 	 * the section is not found.
+	 * @return bool|string
 	 */
 	private function checkSection( $tokens, $fatal = true ) {
 		if ( is_null( $this->section ) ) {
@@ -672,6 +690,7 @@ class DelayedParserTest {
 	 * Called whenever we actually want to run the hook.
 	 * Should be the case if we found the parserTest is not disabled
 	 * @param ParserTest|NewParserTest $parserTest
+	 * @return bool
 	 */
 	public function unleash( &$parserTest ) {
 		if ( !( $parserTest instanceof ParserTest || $parserTest instanceof NewParserTest )	) {