From 90e74042b44e9305ae3e03548b5509a11c0c5c45 Mon Sep 17 00:00:00 2001
From: Sam Reed <reedy@users.mediawiki.org>
Date: Tue, 11 Oct 2011 18:30:50 +0000
Subject: [PATCH] Fix comment blocks that start /* to /**

---
 includes/DefaultSettings.php                                 | 4 ++--
 includes/Exception.php                                       | 5 ++++-
 includes/installer/DatabaseUpdater.php                       | 2 +-
 languages/messages/MessagesLv.php                            | 2 +-
 languages/messages/MessagesRu.php                            | 2 +-
 languages/messages/MessagesUk.php                            | 2 +-
 maintenance/fuzz-tester.php                                  | 4 ++--
 maintenance/populateParentId.php                             | 2 +-
 maintenance/populateRevisionLength.php                       | 2 +-
 tests/phpunit/includes/GlobalFunctions/wfExpandUrlTest.php   | 2 +-
 tests/phpunit/includes/IPTest.php                            | 2 +-
 tests/phpunit/includes/api/RandomImageGenerator.php          | 2 +-
 tests/phpunit/includes/media/JpegMetadataExtractorTest.php   | 2 +-
 .../installer/MediaWikiButtonsAvailabilityTestCase.php       | 2 +-
 .../installer/MediaWikiDifferentDatabaseAccountTestCase.php  | 2 +-
 .../installer/MediaWikiDifferntDatabasePrefixTestCase.php    | 2 +-
 .../MediaWikiErrorsConnectToDatabasePageTestCase.php         | 2 +-
 tests/selenium/installer/MediaWikiErrorsNamepageTestCase.php | 2 +-
 tests/selenium/installer/MediaWikiHelpFieldHintTestCase.php  | 2 +-
 tests/selenium/installer/MediaWikiInstallationConfig.php     | 4 ++--
 tests/selenium/installer/MediaWikiMySQLDataBaseTestCase.php  | 2 +-
 .../selenium/installer/MediaWikiMySQLiteDataBaseTestCase.php | 2 +-
 .../installer/MediaWikiOnAlreadyInstalledTestCase.php        | 2 +-
 .../installer/MediaWikiRestartInstallationTestCase.php       | 2 +-
 .../installer/MediaWikiRightFrameworkLinksTestCase.php       | 2 +-
 .../installer/MediaWikiUpgradeExistingDatabaseTestCase.php   | 2 +-
 tests/selenium/installer/MediaWikiUserInterfaceTestCase.php  | 2 +-
 tests/selenium/suites/MediawikiCoreSmokeTestSuite.php        | 2 +-
 tests/selenium/suites/SimpleSeleniumTestSuite.php            | 2 +-
 29 files changed, 35 insertions(+), 32 deletions(-)

diff --git a/includes/DefaultSettings.php b/includes/DefaultSettings.php
index 35ae738373..daeb88b568 100644
--- a/includes/DefaultSettings.php
+++ b/includes/DefaultSettings.php
@@ -2488,7 +2488,7 @@ $wgResourceModules = array();
  */
 $wgResourceLoaderSources = array();
 
-/*
+/**
  * Default 'remoteBasePath' value for resource loader modules.
  * If not set, then $wgScriptPath will be used as a fallback.
  */
@@ -3635,7 +3635,7 @@ $wgAutopromoteOnce = array(
 	'onView' => array()
 );
 
-/*
+/**
  * Put user rights log entries for autopromotion in recent changes?
  * @since 1.18
  */
diff --git a/includes/Exception.php b/includes/Exception.php
index 432b768af2..f771af0680 100644
--- a/includes/Exception.php
+++ b/includes/Exception.php
@@ -131,7 +131,10 @@ class MWException extends Exception {
 		}
 	}
 
-	/* Return titles of this error page */
+	/**
+	 * Return titles of this error page
+	 * @return String
+	 */
 	function getPageTitle() {
 		global $wgSitename;
 		return $this->msg( 'internalerror', "$wgSitename error" );
diff --git a/includes/installer/DatabaseUpdater.php b/includes/installer/DatabaseUpdater.php
index b8700dbf46..b94fca4351 100644
--- a/includes/installer/DatabaseUpdater.php
+++ b/includes/installer/DatabaseUpdater.php
@@ -8,7 +8,7 @@
 
 require_once( dirname(__FILE__) . '/../../maintenance/Maintenance.php' );
 
-/*
+/**
  * Class for handling database updates. Roughly based off of updaters.inc, with
  * a few improvements :)
  *
diff --git a/languages/messages/MessagesLv.php b/languages/messages/MessagesLv.php
index 0784e73b89..190ed51ef5 100644
--- a/languages/messages/MessagesLv.php
+++ b/languages/messages/MessagesLv.php
@@ -22,7 +22,7 @@
  * @author לערי ריינהארט
  */
 
-/*
+/**
  * @copyright Copyright © 2006, Niklas Laxström
  * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License 2.0 or later
  */
diff --git a/languages/messages/MessagesRu.php b/languages/messages/MessagesRu.php
index 25395425ee..8af96b7d13 100644
--- a/languages/messages/MessagesRu.php
+++ b/languages/messages/MessagesRu.php
@@ -56,7 +56,7 @@
  * @author გიორგიმელა
  */
 
-/*
+/**
  * Изменения сделанные в этом файле будут потеряны при обновлении MediaWiki.
  *
  * Если необходимо внести изменения в перевод отдельных строк интерфейса,
diff --git a/languages/messages/MessagesUk.php b/languages/messages/MessagesUk.php
index 5e3b94a17b..c94e808406 100644
--- a/languages/messages/MessagesUk.php
+++ b/languages/messages/MessagesUk.php
@@ -35,7 +35,7 @@
  * @author Тест
  */
 
-/*
+/**
  * УВАГА! НЕ РЕДАГУЙТЕ ЦЕЙ ФАЙЛ!
  *
  * Якщо необхідно змінити переклад окремих частин інтерфейсу,
diff --git a/maintenance/fuzz-tester.php b/maintenance/fuzz-tester.php
index 89a88e66fc..2348a15f45 100644
--- a/maintenance/fuzz-tester.php
+++ b/maintenance/fuzz-tester.php
@@ -2395,8 +2395,8 @@ function wikiTestOutput( pageTest $test ) {
 
 // ////////////////// HTML VALIDATION /////////////////////////
 
-/*
- ** Asks the validator whether this is valid HTML, or not.
+/**
+ * Asks the validator whether this is valid HTML, or not.
  */
 function validateHTML( $text ) {
 
diff --git a/maintenance/populateParentId.php b/maintenance/populateParentId.php
index 67689b9f6d..14f158c95d 100644
--- a/maintenance/populateParentId.php
+++ b/maintenance/populateParentId.php
@@ -1,5 +1,5 @@
 <?php
-/*
+/**
  * Makes the required database updates for rev_parent_id
  * to be of any use. It can be used for some simple tracking
  * and to find new page edits by users.
diff --git a/maintenance/populateRevisionLength.php b/maintenance/populateRevisionLength.php
index bb42de93b6..f562df472e 100644
--- a/maintenance/populateRevisionLength.php
+++ b/maintenance/populateRevisionLength.php
@@ -1,5 +1,5 @@
 <?php
-/*
+/**
  * Populates the rev_len field for old revisions created before MW 1.10.
  *
  * This program is free software; you can redistribute it and/or modify
diff --git a/tests/phpunit/includes/GlobalFunctions/wfExpandUrlTest.php b/tests/phpunit/includes/GlobalFunctions/wfExpandUrlTest.php
index ab54602606..6c165e75e6 100644
--- a/tests/phpunit/includes/GlobalFunctions/wfExpandUrlTest.php
+++ b/tests/phpunit/includes/GlobalFunctions/wfExpandUrlTest.php
@@ -1,5 +1,5 @@
 <?php
-/*
+/**
  * Unit tests for wfExpandUrl()
  */
 
diff --git a/tests/phpunit/includes/IPTest.php b/tests/phpunit/includes/IPTest.php
index c31e2af4d6..d0d28f6c9d 100644
--- a/tests/phpunit/includes/IPTest.php
+++ b/tests/phpunit/includes/IPTest.php
@@ -1,5 +1,5 @@
 <?php
-/*
+/**
  * Tests for IP validity functions. Ported from /t/inc/IP.t by avar.
  */
 
diff --git a/tests/phpunit/includes/api/RandomImageGenerator.php b/tests/phpunit/includes/api/RandomImageGenerator.php
index 12ffd4550d..866e0fb294 100644
--- a/tests/phpunit/includes/api/RandomImageGenerator.php
+++ b/tests/phpunit/includes/api/RandomImageGenerator.php
@@ -1,6 +1,6 @@
 <?php
 
-/*
+/**
  * RandomImageGenerator -- does what it says on the tin.
  * Requires Imagick, the ImageMagick library for PHP, or the command line equivalent (usually 'convert').
  *
diff --git a/tests/phpunit/includes/media/JpegMetadataExtractorTest.php b/tests/phpunit/includes/media/JpegMetadataExtractorTest.php
index 99c4384bb5..2cfffdbf02 100644
--- a/tests/phpunit/includes/media/JpegMetadataExtractorTest.php
+++ b/tests/phpunit/includes/media/JpegMetadataExtractorTest.php
@@ -1,5 +1,5 @@
 <?php
-/*
+/**
  * @todo Could use a test of extended XMP segments. Hard to find programs that
  * create example files, and creating my own in vim propbably wouldn't
  * serve as a very good "test". (Adobe photoshop probably creates such files
diff --git a/tests/selenium/installer/MediaWikiButtonsAvailabilityTestCase.php b/tests/selenium/installer/MediaWikiButtonsAvailabilityTestCase.php
index 3557f516a0..bf5b379d5e 100644
--- a/tests/selenium/installer/MediaWikiButtonsAvailabilityTestCase.php
+++ b/tests/selenium/installer/MediaWikiButtonsAvailabilityTestCase.php
@@ -30,7 +30,7 @@
 
 require_once (dirname(__FILE__).'/'.'MediaWikiInstallationCommonFunction.php');
 
-/*
+/**
  * Test Case ID   : 30 (http://www.mediawiki.org/wiki/New_installer/Test_plan)
  * Test Case Name :'Back' and 'Continue' button availability
  * Version        : MediaWiki 1.18alpha
diff --git a/tests/selenium/installer/MediaWikiDifferentDatabaseAccountTestCase.php b/tests/selenium/installer/MediaWikiDifferentDatabaseAccountTestCase.php
index 4afcdc0e87..f1b7945970 100644
--- a/tests/selenium/installer/MediaWikiDifferentDatabaseAccountTestCase.php
+++ b/tests/selenium/installer/MediaWikiDifferentDatabaseAccountTestCase.php
@@ -30,7 +30,7 @@
 
 require_once ( dirname( __FILE__ ) . '/MediaWikiInstallationCommonFunction.php' );
 
-/*
+/**
  * Test Case ID   : 04 (http://www.mediawiki.org/wiki/New_installer/Test_plan)
  * Test Case Name : Install MediaWiki with different Database accounts for web access.
  * Version        : MediaWiki 1.18alpha
diff --git a/tests/selenium/installer/MediaWikiDifferntDatabasePrefixTestCase.php b/tests/selenium/installer/MediaWikiDifferntDatabasePrefixTestCase.php
index b6a0fc09a8..2d623afcee 100644
--- a/tests/selenium/installer/MediaWikiDifferntDatabasePrefixTestCase.php
+++ b/tests/selenium/installer/MediaWikiDifferntDatabasePrefixTestCase.php
@@ -29,7 +29,7 @@
 
 require_once ( dirname( __FILE__ ) . '/MediaWikiInstallationCommonFunction.php' );
 
-/*
+/**
  * Test Case ID   : 02 (http://www.mediawiki.org/wiki/New_installer/Test_plan)
  * Test Case Name : Install MediaWiki with the same database and the different
  *                  database prefixes(Share one database between multiple wikis).
diff --git a/tests/selenium/installer/MediaWikiErrorsConnectToDatabasePageTestCase.php b/tests/selenium/installer/MediaWikiErrorsConnectToDatabasePageTestCase.php
index 3642a8efd6..b112bc0e77 100644
--- a/tests/selenium/installer/MediaWikiErrorsConnectToDatabasePageTestCase.php
+++ b/tests/selenium/installer/MediaWikiErrorsConnectToDatabasePageTestCase.php
@@ -30,7 +30,7 @@
 
 require_once ( dirname( __FILE__ ) . '/MediaWikiInstallationCommonFunction.php' );
 
-/*
+/**
  * Test Case ID   : 09 (http://www.mediawiki.org/wiki/New_installer/Test_plan)
  * Test Case Name : Invalid/ blank values for fields in 'Connect to database' page.
  * Version        : MediaWiki 1.18alpha
diff --git a/tests/selenium/installer/MediaWikiErrorsNamepageTestCase.php b/tests/selenium/installer/MediaWikiErrorsNamepageTestCase.php
index d70dcc42cc..024fe5d61c 100644
--- a/tests/selenium/installer/MediaWikiErrorsNamepageTestCase.php
+++ b/tests/selenium/installer/MediaWikiErrorsNamepageTestCase.php
@@ -27,7 +27,7 @@
  *
  */
 
-/*
+/**
  * Test Case ID   : 10 (http://www.mediawiki.org/wiki/New_installer/Test_plan)
  * Test Case Name : Invalid/ blank values for fields in 'Name' page.
  * Version        : MediaWiki 1.18alpha
diff --git a/tests/selenium/installer/MediaWikiHelpFieldHintTestCase.php b/tests/selenium/installer/MediaWikiHelpFieldHintTestCase.php
index 355a285716..806fcfde13 100644
--- a/tests/selenium/installer/MediaWikiHelpFieldHintTestCase.php
+++ b/tests/selenium/installer/MediaWikiHelpFieldHintTestCase.php
@@ -27,7 +27,7 @@
  *
  */
 
-/*
+/**
  * Test Case ID   : 29 (http://www.mediawiki.org/wiki/New_installer/Test_plan)
  * Test Case Name : Help field hint availability for the fields.
  * Version        : MediaWiki 1.18alpha
diff --git a/tests/selenium/installer/MediaWikiInstallationConfig.php b/tests/selenium/installer/MediaWikiInstallationConfig.php
index d3067d698a..d86bcb8532 100644
--- a/tests/selenium/installer/MediaWikiInstallationConfig.php
+++ b/tests/selenium/installer/MediaWikiInstallationConfig.php
@@ -28,7 +28,7 @@
  */
 
 
-/*
+/**
  * MediaWikiInstallerTestSuite.php can be run one time successfully
  * with current value of the 'DB_NAME_PREFIX'.
  * If you wish to run the suite more than one time, you need to change
@@ -39,7 +39,7 @@ define('DIRECTORY_NAME', "mediawiki" );
 define( 'PORT', "8080" );
 define( 'HOST_NAME', "localhost" );
 
-/*
+/**
  *  Use the followings to run the test suite in different browsers.
  *  Firefox : *firefox
  *  IE :  *iexplore
diff --git a/tests/selenium/installer/MediaWikiMySQLDataBaseTestCase.php b/tests/selenium/installer/MediaWikiMySQLDataBaseTestCase.php
index abf9ddf234..399ed4e5d8 100644
--- a/tests/selenium/installer/MediaWikiMySQLDataBaseTestCase.php
+++ b/tests/selenium/installer/MediaWikiMySQLDataBaseTestCase.php
@@ -30,7 +30,7 @@
 
 require_once (dirname(__FILE__).'/'.'MediaWikiInstallationCommonFunction.php');
 
-/*
+/**
  * Test Case ID   : 01 (http://www.mediawiki.org/wiki/New_installer/Test_plan)
  * Test Case Name : Install Mediawiki using 'MySQL' database type successfully
  * Version        : MediaWiki 1.18alpha
diff --git a/tests/selenium/installer/MediaWikiMySQLiteDataBaseTestCase.php b/tests/selenium/installer/MediaWikiMySQLiteDataBaseTestCase.php
index fe704a4285..f57c1a559b 100644
--- a/tests/selenium/installer/MediaWikiMySQLiteDataBaseTestCase.php
+++ b/tests/selenium/installer/MediaWikiMySQLiteDataBaseTestCase.php
@@ -30,7 +30,7 @@
 
 require_once (dirname(__FILE__).'/'.'MediaWikiInstallationCommonFunction.php');
 
-/*
+/**
  * Test Case ID   : 06 (http://www.mediawiki.org/wiki/New_installer/Test_plan)
  * Test Case Name : Install Mediawiki using 'MySQL' database type successfully
  * Version        : MediaWiki 1.18alpha
diff --git a/tests/selenium/installer/MediaWikiOnAlreadyInstalledTestCase.php b/tests/selenium/installer/MediaWikiOnAlreadyInstalledTestCase.php
index e8b8f9b084..4c05266651 100644
--- a/tests/selenium/installer/MediaWikiOnAlreadyInstalledTestCase.php
+++ b/tests/selenium/installer/MediaWikiOnAlreadyInstalledTestCase.php
@@ -31,7 +31,7 @@
 require_once (dirname(__FILE__).'/'.'MediaWikiInstallationCommonFunction.php');
 
 
-/*
+/**
  * Test Case ID   : 03 (http://www.mediawiki.org/wiki/New_installer/Test_plan)
  * Test Case Name : Install mediawiki on a already installed Mediawiki.]
  * Version        : MediaWiki 1.18alpha
diff --git a/tests/selenium/installer/MediaWikiRestartInstallationTestCase.php b/tests/selenium/installer/MediaWikiRestartInstallationTestCase.php
index b0a3800027..b9ca83057f 100644
--- a/tests/selenium/installer/MediaWikiRestartInstallationTestCase.php
+++ b/tests/selenium/installer/MediaWikiRestartInstallationTestCase.php
@@ -31,7 +31,7 @@
 
 require_once (dirname(__FILE__).'/'.'MediaWikiInstallationCommonFunction.php');
 
-/*
+/**
  * Test Case ID   : 11, 12 (http://www.mediawiki.org/wiki/New_installer/Test_plan)
  * Test Case Name : Install mediawiki on a already installed Mediawiki.
  * Version        : MediaWiki 1.18alpha
diff --git a/tests/selenium/installer/MediaWikiRightFrameworkLinksTestCase.php b/tests/selenium/installer/MediaWikiRightFrameworkLinksTestCase.php
index 346f24f8cd..700172c299 100644
--- a/tests/selenium/installer/MediaWikiRightFrameworkLinksTestCase.php
+++ b/tests/selenium/installer/MediaWikiRightFrameworkLinksTestCase.php
@@ -30,7 +30,7 @@
 
 require_once (dirname(__FILE__).'/'.'MediaWikiInstallationCommonFunction.php');
 
-/*
+/**
  * Test Case ID   : 14, 15, 16, 17 (http://www.mediawiki.org/wiki/New_installer/Test_plan)
  * Test Case Name : User selects 'Read me' link.
  *                  User selects 'Release notes' link.
diff --git a/tests/selenium/installer/MediaWikiUpgradeExistingDatabaseTestCase.php b/tests/selenium/installer/MediaWikiUpgradeExistingDatabaseTestCase.php
index 0ab5e65941..eb82071e5c 100644
--- a/tests/selenium/installer/MediaWikiUpgradeExistingDatabaseTestCase.php
+++ b/tests/selenium/installer/MediaWikiUpgradeExistingDatabaseTestCase.php
@@ -30,7 +30,7 @@
 
 require_once (dirname(__FILE__).'/'.'MediaWikiInstallationCommonFunction.php');
 
-/*
+/**
  * Test Case ID   : 05 (http://www.mediawiki.org/wiki/New_installer/Test_plan)
  * Test Case Name : Install Mediawiki by updating the existing database.
  * Version        : MediaWiki 1.18alpha
diff --git a/tests/selenium/installer/MediaWikiUserInterfaceTestCase.php b/tests/selenium/installer/MediaWikiUserInterfaceTestCase.php
index 7be39c04cc..0994892fda 100644
--- a/tests/selenium/installer/MediaWikiUserInterfaceTestCase.php
+++ b/tests/selenium/installer/MediaWikiUserInterfaceTestCase.php
@@ -29,7 +29,7 @@
 
 require_once (dirname(__FILE__).'/'.'MediaWikiInstallationCommonFunction.php');
 
-/*
+/**
  * Test Case ID   : 18 - 27 (http://www.mediawiki.org/wiki/New_installer/Test_plan)
  * Test Case Name : UI of MediaWiki initial/ Language/ Welcome to MediaWiki!/ Connect to database/
  * Database settings/ Name/ Options/ Install/ Complete/ Restart Inslation pages
diff --git a/tests/selenium/suites/MediawikiCoreSmokeTestSuite.php b/tests/selenium/suites/MediawikiCoreSmokeTestSuite.php
index 5d5ef51800..a9a9b4d664 100644
--- a/tests/selenium/suites/MediawikiCoreSmokeTestSuite.php
+++ b/tests/selenium/suites/MediawikiCoreSmokeTestSuite.php
@@ -1,5 +1,5 @@
 <?php
-/*
+/**
  * Stubs for now. We're going to start populating this test.
  */
 class MediawikiCoreSmokeTestSuite extends SeleniumTestSuite
diff --git a/tests/selenium/suites/SimpleSeleniumTestSuite.php b/tests/selenium/suites/SimpleSeleniumTestSuite.php
index 3f5e364554..2e0c4ee251 100644
--- a/tests/selenium/suites/SimpleSeleniumTestSuite.php
+++ b/tests/selenium/suites/SimpleSeleniumTestSuite.php
@@ -1,5 +1,5 @@
 <?php
-/*
+/**
  * Sample test suite. 
  * Two ways to configure MW for these tests
  * 1) If you are running multiple test suites, add the following in LocalSettings.php
-- 
2.20.1