Fix various typos and documentation issues

Change-Id: I2cd4b647c01d84cfe0e1b4d55e155ced8c918b17

includes/Permissions/PermissionManager.php

@@ -665,7 +665,7 @@ class PermissionManager {
 			$allowed = true;
 		} elseif ( is_array( $whiteListRead ) && count( $whiteListRead ) ) {
 			// Time to check the whitelist
-			// Only do these checks is there's something to check against
+			// Only do these checks if there's something to check against
 			$name = $title->getPrefixedText();
 			$dbName = $title->getPrefixedDBkey();
 

includes/libs/rdbms/loadbalancer/LoadBalancer.php

@@ -1991,7 +1991,7 @@ class LoadBalancer implements ILoadBalancerForOwner {
 
 	/**
 	 * @param IDatabase $conn
-	 * @return string Desciption of a connection handle for log messages
+	 * @return string Description of a connection handle for log messages
 	 * @throws InvalidArgumentException
 	 */
 	private function stringifyConn( IDatabase $conn ) {

includes/page/RedirectStore.php

@@ -24,7 +24,7 @@ namespace MediaWiki\Page;
 use MediaWiki\Linker\LinkTarget;
 
 /**
- * Service for storing and retreiving page redirect information.
+ * Service for storing and retrieving page redirect information.
  *
  * @note This is not yet ready. https://phabricator.wikimedia.org/T290639
  * To manage redirects today, use WikiPage via WikiPageFactory instead.

includes/parser/CoreMagicVariables.php

@@ -322,7 +322,7 @@ class CoreMagicVariables {
 	 *
 	 * @param Parser $parser
 	 * @param ConvertibleTimestamp $ts Current timestamp with the display timezone
-	 * @param string $unit The unit the timestamp is expressed in; one of ("D", "H", "I")
+	 * @param string $unit The unit the timestamp is expressed in; one of ("Y", "M", "D", "H")
 	 */
 	private static function applyUnitTimestampDeadline(
 		Parser $parser,

includes/session/PHPSessionHandler.php

@@ -138,7 +138,7 @@ class PHPSessionHandler implements \SessionHandlerInterface {
 			ini_set( 'session.use_trans_sid', 0 );
 
 			// T124510: Disable automatic PHP session related cache headers.
-			// MediaWiki adds it's own headers and the default PHP behavior may
+			// MediaWiki adds its own headers and the default PHP behavior may
 			// set headers such as 'Pragma: no-cache' that cause problems with
 			// some user agents.
 			session_cache_limiter( '' );

includes/site/SiteLookup.php

@@ -19,7 +19,7 @@
  */
 
 /**
- * Interface to retreive Site objects, for implementation by service classes.
+ * Interface to retrieve Site objects, for implementation by service classes.
  *
  * Default implementation is DBSiteStore.
  *

includes/site/SiteStore.php

@@ -19,7 +19,7 @@
  */
 
 /**
- * Interface for storing and retreiving Site objects.
+ * Interface for storing and retrieving Site objects.
  *
  * Default implementation is DBSiteStore.
  *

includes/skins/components/SkinComponentTempUserBanner.php

@@ -12,7 +12,7 @@ use User;
  * NOTE: This class is currently *not registered* via the SkinComponentRegistry
  * and cannot be called via Skin::getComponent.
  * Because of it's unsuitability for rendering via mustache templates
- * (it renders it's own HTML and returns no data),
+ * (it renders its own HTML and returns no data),
  * it is appended directly to skin data in Skin::getTemplateData.
  * @unstable
  */

includes/specialpage/Hook/ChangesListSpecialPageStructuredFiltersHook.php

@@ -14,7 +14,7 @@ use ChangesListSpecialPage;
 interface ChangesListSpecialPageStructuredFiltersHook {
 	/**
 	 * Use this hook to register filters for pages inheriting from ChangesListSpecialPage
-	 * (in core: RecentChanges,vRecentChangesLinked, and Watchlist). Generally, you will
+	 * (in core: RecentChanges, RecentChangesLinked, and Watchlist). Generally, you will
 	 * want to construct new ChangesListBooleanFilter or ChangesListStringOptionsFilter objects.
 	 * When constructing them, you specify which group they belong to. You can reuse
 	 * existing groups (accessed through $special->getFilterGroup), or create your own

includes/specials/pagers/PagerTools.php

@@ -17,7 +17,7 @@ class PagerTools {
 
 	/**
 	 * Generate a set of tools for a revision.
-	 * Will performs permission checks where necessary.
+	 * Will perform permission checks where necessary.
 	 * @param RevisionRecord $revRecord The revision to generate tools for.
 	 * @param RevisionRecord|null $previousRevRecord The previous revision (if any). Optional.
 	 *   Used to produce undo links.

includes/user/UserGroupManager.php

@@ -49,7 +49,7 @@ use Wikimedia\Rdbms\ReadOnlyMode;
 use Wikimedia\Rdbms\SelectQueryBuilder;
 
 /**
- * Managers user groups.
+ * Manages user groups.
  * @since 1.35
  */
 class UserGroupManager implements IDBAccessObject {

maintenance/refreshLinks.php

@@ -43,7 +43,7 @@ class RefreshLinks extends Maintenance {
 		$this->addOption( 'new-only', 'Only affect articles with just a single edit' );
 		$this->addOption( 'redirects-only', 'Only fix redirects, not all links' );
 		$this->addOption( 'old-redirects-only', 'Only fix redirects with no redirect table entry' );
-		$this->addOption( 'touched-only', 'Only fix pages that has been touched after last update' );
+		$this->addOption( 'touched-only', 'Only fix pages that have been touched after last update' );
 		$this->addOption( 'e', 'Last page id to refresh', false, true );
 		$this->addOption( 'dfn-chunk-size', 'Maximum number of existent IDs to check per ' .
 			'query, default 100000', false, true );

tests/phpunit/includes/specials/ContribsPagerTest.php

@@ -324,7 +324,7 @@ class ContribsPagerTest extends MediaWikiIntegrationTestCase {
 
 	/**
 	 * Flow uses ContribsPager::reallyDoQuery hook to provide something other then
-	 * stdClass as a row, and then manually formats it's own row in ContributionsLineEnding.
+	 * stdClass as a row, and then manually formats its own row in ContributionsLineEnding.
 	 * Emulate this behaviour and check that it works.
 	 *
 	 * @covers ContribsPager::formatRow

tests/phpunit/includes/specials/DeletedContribsPagerTest.php

@@ -57,7 +57,7 @@ class DeletedContribsPagerTest extends MediaWikiIntegrationTestCase {
 
 	/**
 	 * Flow uses DeletedContribsPager::reallyDoQuery hook to provide something other then
-	 * stdClass as a row, and then manually formats it's own row in ContributionsLineEnding.
+	 * stdClass as a row, and then manually formats its own row in ContributionsLineEnding.
 	 * Emulate this behaviour and check that it works.
 	 *
 	 * @covers DeletedContribsPager::formatRow