Merge "Clean up spacing of doc comments"
authorjenkins-bot <jenkins-bot@gerrit.wikimedia.org>
Mon, 5 Aug 2019 22:51:10 +0000 (22:51 +0000)
committerGerrit Code Review <gerrit@wikimedia.org>
Mon, 5 Aug 2019 22:51:10 +0000 (22:51 +0000)
51 files changed:
includes/CategoryFinder.php
includes/DefaultSettings.php
includes/Defines.php
includes/FormOptions.php
includes/MagicWord.php
includes/MagicWordFactory.php
includes/OutputPage.php
includes/Revision/RevisionRecord.php
includes/Revision/RevisionStoreCacheRecord.php
includes/Title.php
includes/api/ApiBase.php
includes/api/ApiQueryBase.php
includes/api/ApiQueryRevisionsBase.php
includes/api/ApiResult.php
includes/auth/AuthManager.php
includes/auth/AuthenticationRequest.php
includes/block/BlockManager.php
includes/changes/ChangesList.php
includes/changes/FeedItem.php
includes/deferred/SearchUpdate.php
includes/diff/DifferenceEngine.php
includes/filerepo/FileRepo.php
includes/libs/CSSMin.php
includes/libs/MWMessagePack.php
includes/libs/ParamValidator/ParamValidator.php
includes/libs/filebackend/fileop/DeleteFileOp.php
includes/libs/mime/defines.php
includes/libs/rdbms/defines.php
includes/logging/LogPage.php
includes/media/Exif.php
includes/page/Article.php
includes/page/WikiPage.php
includes/resourceloader/ResourceLoaderFilePath.php
includes/session/Session.php
includes/session/SessionManager.php
includes/session/Token.php
includes/specialpage/AuthManagerSpecialPage.php
includes/specialpage/LoginSignupSpecialPage.php
includes/specialpage/SpecialPageFactory.php
includes/specials/SpecialBlock.php
includes/specials/SpecialUpload.php
includes/specials/formfields/Licenses.php
languages/messages/MessagesInh.php
tests/phpunit/includes/api/query/ApiQueryBasicTest.php
tests/phpunit/includes/api/query/ApiQueryContinue2Test.php
tests/phpunit/includes/api/query/ApiQueryContinueTest.php
tests/phpunit/includes/libs/CSSMinTest.php
tests/phpunit/includes/libs/XhprofTest.php
tests/phpunit/languages/classes/LanguageSrTest.php
tests/phpunit/languages/classes/LanguageUzTest.php
tests/phpunit/maintenance/categoryChangesAsRdfTest.php

index 720abc3..01427a2 100644 (file)
@@ -58,7 +58,7 @@ class CategoryFinder {
        /** @var array Array of article/category IDs */
        protected $next = [];
 
-       /** @var int Max layer depth **/
+       /** @var int Max layer depth */
        protected $maxdepth = -1;
 
        /** @var array Array of DBKEY category names */
index a3772b9..7d3802c 100644 (file)
@@ -158,7 +158,7 @@ $wgUsePathInfo = ( strpos( PHP_SAPI, 'cgi' ) === false ) &&
        ( strpos( PHP_SAPI, 'apache2filter' ) === false ) &&
        ( strpos( PHP_SAPI, 'isapi' ) === false );
 
-/**@}*/
+/** @} */
 
 /************************************************************************//**
  * @name   URLs and file paths
@@ -377,7 +377,7 @@ $wgUploadStashScalerBaseUrl = false;
  */
 $wgActionPaths = [];
 
-/**@}*/
+/** @} */
 
 /************************************************************************//**
  * @name   Files and file uploads
@@ -1563,7 +1563,7 @@ $wgUseTinyRGBForJPGThumbnails = false;
  *   - captionLength:  Length to truncate filename to in caption when using "showfilename".
  *                     A value of 'true' will truncate the filename to one line using CSS
  *                     and will be the behaviour after deprecation.
- *                     @deprecated since 1.28
+ * @deprecated since 1.28
  *   - showBytes:      Show the filesize in bytes in categories
  *   - showDimensions: Show the dimensions (width x height) in categories
  *   - mode:           Gallery mode
@@ -2169,7 +2169,7 @@ $wgSlaveLagCritical = 30;
  */
 $wgDBWindowsAuthentication = false;
 
-/**@}*/ # End of DB settings }
+/** @} */ # End of DB settings }
 
 /************************************************************************//**
  * @name   Text storage
@@ -8941,7 +8941,7 @@ $wgExperiencedUserMemberSince = 30; # days
  * @code
  * $wgInterwikiPrefixDisplayTypes = [
  *     'iwprefix' => 'definition'
- *];
+ * ];
  * @endcode
  */
 $wgInterwikiPrefixDisplayTypes = [];
index d818226..0269ab6 100644 (file)
@@ -31,7 +31,7 @@ use Wikimedia\Rdbms\IDatabase;
 
 # Obsolete aliases
 
-/**@{
+/** @{
  * Obsolete IDatabase::makeList() constants
  * These are also available as Database class constants
  */
@@ -40,16 +40,16 @@ define( 'LIST_AND', IDatabase::LIST_AND );
 define( 'LIST_SET', IDatabase::LIST_SET );
 define( 'LIST_NAMES', IDatabase::LIST_NAMES );
 define( 'LIST_OR', IDatabase::LIST_OR );
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * Virtual namespaces; don't appear in the page database
  */
 define( 'NS_MEDIA', -2 );
 define( 'NS_SPECIAL', -1 );
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * Real namespaces
  *
  * Number 100 and beyond are reserved for custom namespaces;
@@ -73,9 +73,9 @@ define( 'NS_HELP', 12 );
 define( 'NS_HELP_TALK', 13 );
 define( 'NS_CATEGORY', 14 );
 define( 'NS_CATEGORY_TALK', 15 );
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * Cache type
  */
 define( 'CACHE_ANYTHING', -1 );  // Use anything, as long as it works
@@ -83,18 +83,18 @@ define( 'CACHE_NONE', 0 );       // Do not cache
 define( 'CACHE_DB', 1 );         // Store cache objects in the DB
 define( 'CACHE_MEMCACHED', 2 );  // MemCached, must specify servers in $wgMemCacheServers
 define( 'CACHE_ACCEL', 3 );      // APC or WinCache
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * Antivirus result codes, for use in $wgAntivirusSetup.
  */
 define( 'AV_NO_VIRUS', 0 );  # scan ok, no virus found
 define( 'AV_VIRUS_FOUND', 1 );  # virus found!
 define( 'AV_SCAN_ABORTED', -1 );  # scan aborted, the file is probably immune
 define( 'AV_SCAN_FAILED', false );  # scan failed (scanner not found or error in scanner)
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * Anti-lock flags
  * Was used by $wgAntiLockFlags, which was removed with 1.25
  * Constants kept to not have warnings when used in LocalSettings
@@ -103,9 +103,9 @@ define( 'ALF_PRELOAD_LINKS', 1 ); // unused
 define( 'ALF_PRELOAD_EXISTENCE', 2 ); // unused
 define( 'ALF_NO_LINK_LOCK', 4 ); // unused
 define( 'ALF_NO_BLOCK_LOCK', 8 ); // unused
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * Date format selectors; used in user preference storage and by
  * Language::date() and co.
  */
@@ -114,9 +114,9 @@ define( 'MW_DATE_MDY', 'mdy' );
 define( 'MW_DATE_DMY', 'dmy' );
 define( 'MW_DATE_YMD', 'ymd' );
 define( 'MW_DATE_ISO', 'ISO 8601' );
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * RecentChange type identifiers
  */
 define( 'RC_EDIT', 0 );
@@ -124,9 +124,9 @@ define( 'RC_NEW', 1 );
 define( 'RC_LOG', 3 );
 define( 'RC_EXTERNAL', 5 );
 define( 'RC_CATEGORIZE', 6 );
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * Article edit flags
  */
 define( 'EDIT_NEW', 1 );
@@ -137,21 +137,21 @@ define( 'EDIT_FORCE_BOT', 16 );
 define( 'EDIT_DEFER_UPDATES', 32 ); // Unused since 1.27
 define( 'EDIT_AUTOSUMMARY', 64 );
 define( 'EDIT_INTERNAL', 128 );
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * Hook support constants
  */
 define( 'MW_SUPPORTS_PARSERFIRSTCALLINIT', 1 );
 define( 'MW_SUPPORTS_LOCALISATIONCACHE', 1 );
 define( 'MW_SUPPORTS_CONTENTHANDLER', 1 );
 define( 'MW_EDITFILTERMERGED_SUPPORTS_API', 1 );
-/**@}*/
+/** @} */
 
 /** Support for $wgResourceModules */
 define( 'MW_SUPPORTS_RESOURCE_MODULES', 1 );
 
-/**@{
+/** @{
  * Allowed values for Parser::$mOutputType
  * Parameter to Parser::startExternalParse().
  * Use of Parser consts is preferred:
@@ -166,9 +166,9 @@ define( 'OT_WIKI', 2 );
 define( 'OT_PREPROCESS', 3 );
 define( 'OT_MSG', 3 );  // b/c alias for OT_PREPROCESS
 define( 'OT_PLAIN', 4 );
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * Flags for Parser::setFunctionHook
  * Use of Parser consts is preferred:
  * - Parser::SFH_NO_HASH
@@ -176,9 +176,9 @@ define( 'OT_PLAIN', 4 );
  */
 define( 'SFH_NO_HASH', 1 );
 define( 'SFH_OBJECT_ARGS', 2 );
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * Autopromote conditions (must be here and not in Autopromote.php, so that
  * they're loaded for DefaultSettings.php before AutoLoader.php)
  */
@@ -191,7 +191,7 @@ define( 'APCOND_IPINRANGE', 6 );
 define( 'APCOND_AGE_FROM_EDIT', 7 );
 define( 'APCOND_BLOCKED', 8 );
 define( 'APCOND_ISBOT', 9 );
-/**@}*/
+/** @} */
 
 /** @{
  * Protocol constants for wfExpandUrl()
@@ -202,9 +202,9 @@ define( 'PROTO_RELATIVE', '//' );
 define( 'PROTO_CURRENT', null );
 define( 'PROTO_CANONICAL', 1 );
 define( 'PROTO_INTERNAL', 2 );
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * Content model ids, used by Content and ContentHandler.
  * These IDs will be exposed in the API and XML dumps.
  *
@@ -217,9 +217,9 @@ define( 'CONTENT_MODEL_JAVASCRIPT', 'javascript' );
 define( 'CONTENT_MODEL_CSS', 'css' );
 define( 'CONTENT_MODEL_TEXT', 'text' );
 define( 'CONTENT_MODEL_JSON', 'json' );
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * Content formats, used by Content and ContentHandler.
  * These should be MIME types, and will be exposed in the API and XML dumps.
  *
@@ -242,15 +242,15 @@ define( 'CONTENT_FORMAT_SERIALIZED', 'application/vnd.php.serialized' );
 define( 'CONTENT_FORMAT_JSON', 'application/json' );
 // for future use with the api, and for use by extensions
 define( 'CONTENT_FORMAT_XML', 'application/xml' );
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * Max string length for shell invocations; based on binfmts.h
  */
 define( 'SHELL_MAX_ARG_STRLEN', '100000' );
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * Schema compatibility flags.
  *
  * Used as flags in a bit field that indicates whether the old or new schema (or both)
@@ -269,9 +269,9 @@ define( 'SCHEMA_COMPAT_WRITE_BOTH', SCHEMA_COMPAT_WRITE_OLD | SCHEMA_COMPAT_WRIT
 define( 'SCHEMA_COMPAT_READ_BOTH', SCHEMA_COMPAT_READ_OLD | SCHEMA_COMPAT_READ_NEW );
 define( 'SCHEMA_COMPAT_OLD', SCHEMA_COMPAT_WRITE_OLD | SCHEMA_COMPAT_READ_OLD );
 define( 'SCHEMA_COMPAT_NEW', SCHEMA_COMPAT_WRITE_NEW | SCHEMA_COMPAT_READ_NEW );
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * Schema change migration flags.
  *
  * Used as values of a feature flag for an orderly transition from an old
@@ -296,9 +296,9 @@ define( 'MIGRATION_OLD', 0x00000000 | SCHEMA_COMPAT_OLD );
 define( 'MIGRATION_WRITE_BOTH', 0x10000000 | SCHEMA_COMPAT_READ_BOTH | SCHEMA_COMPAT_WRITE_BOTH );
 define( 'MIGRATION_WRITE_NEW', 0x20000000 | SCHEMA_COMPAT_READ_BOTH | SCHEMA_COMPAT_WRITE_NEW );
 define( 'MIGRATION_NEW', 0x30000000 | SCHEMA_COMPAT_NEW );
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * XML dump schema versions, for use with XmlDumpWriter.
  * See also the corresponding export-nnnn.xsd files in the docs directory,
  * which are also listed at <https://www.mediawiki.org/xml/>.
@@ -307,4 +307,4 @@ define( 'MIGRATION_NEW', 0x30000000 | SCHEMA_COMPAT_NEW );
  */
 define( 'XML_DUMP_SCHEMA_VERSION_10', '0.10' );
 define( 'XML_DUMP_SCHEMA_VERSION_11', '0.11' );
-/**@}*/
+/** @} */
index 0131855..f0a48d2 100644 (file)
@@ -44,7 +44,8 @@ class FormOptions implements ArrayAccess {
        /** Integer type, maps guessType() to WebRequest::getInt() */
        const INT = 1;
        /** Float type, maps guessType() to WebRequest::getFloat()
-        * @since 1.23 */
+        * @since 1.23
+        */
        const FLOAT = 4;
        /** Boolean type, maps guessType() to WebRequest::getBool() */
        const BOOL = 2;
@@ -53,7 +54,8 @@ class FormOptions implements ArrayAccess {
         */
        const INTNULL = 3;
        /** Array type, maps guessType() to WebRequest::getArray()
-        * @since 1.29 */
+        * @since 1.29
+        */
        const ARR = 5;
        /* @} */
 
index 0984786..cb58e62 100644 (file)
@@ -55,7 +55,7 @@ use MediaWiki\MediaWikiServices;
  * @ingroup Parser
  */
 class MagicWord {
-       /**#@-*/
+       /** #@- */
 
        /** @var string */
        public $mId;
@@ -93,7 +93,7 @@ class MagicWord {
        /** @var Language */
        private $contLang;
 
-       /**#@-*/
+       /** #@- */
 
        /**
         * Create a new MagicWord object
index 4e9bfaf..4c66854 100644 (file)
@@ -32,7 +32,7 @@
  * @ingroup Parser
  */
 class MagicWordFactory {
-       /**#@-*/
+       /** #@- */
 
        /** @var bool */
        private $mVariableIDsInitialised = false;
@@ -196,7 +196,7 @@ class MagicWordFactory {
        /** @var Language */
        private $contLang;
 
-       /**#@-*/
+       /** #@- */
 
        /**
         * @param Language $contLang Content language
index 2c7292c..b7341e3 100644 (file)
@@ -54,7 +54,8 @@ class OutputPage extends ContextSource {
        protected $mCanonicalUrl = false;
 
        /**
-        * @var string The contents of <h1> */
+        * @var string The contents of <h1>
+        */
        private $mPageTitle = '';
 
        /**
index 0dcc35c..ff9ac57 100644 (file)
@@ -82,7 +82,7 @@ abstract class RevisionRecord {
        /** @var CommentStoreComment|null */
        protected $mComment;
 
-       /**  @var Title */
+       /** @var Title */
        protected $mTitle; // TODO: we only need the title for permission checks!
 
        /** @var RevisionSlots */
index 0420d34..1258f15 100644 (file)
@@ -97,7 +97,7 @@ class RevisionStoreCacheRecord extends RevisionStoreRecord {
 
        /**
         * Load a fresh row from the database to ensure we return updated information
-
+        *
         * @throws RevisionAccessException if the row could not be loaded
         */
        private function loadFreshRow() {
index 12d6641..281f75b 100644 (file)
@@ -182,7 +182,8 @@ class Title implements LinkTarget, IDBAccessObject {
        private $mPageLanguage = false;
 
        /** @var string|bool|null The page language code from the database, null if not saved in
-        * the database or false if not loaded, yet. */
+        * the database or false if not loaded, yet.
+        */
        private $mDbPageLanguage = false;
 
        /** @var TitleValue|null A corresponding TitleValue object */
index 63d8b18..a7b872c 100644 (file)
@@ -251,7 +251,7 @@ abstract class ApiBase extends ContextSource {
         */
        const PARAM_TEMPLATE_VARS = 25;
 
-       /**@}*/
+       /** @} */
 
        const ALL_DEFAULT_STRING = '*';
 
@@ -506,7 +506,7 @@ abstract class ApiBase extends ContextSource {
                return null;
        }
 
-       /**@}*/
+       /** @} */
 
        /************************************************************************//**
         * @name   Data access methods
@@ -711,7 +711,7 @@ abstract class ApiBase extends ContextSource {
                return MediaWikiServices::getInstance()->getPermissionManager();
        }
 
-       /**@}*/
+       /** @} */
 
        /************************************************************************//**
         * @name   Parameter handling
@@ -1729,7 +1729,7 @@ abstract class ApiBase extends ContextSource {
                );
        }
 
-       /**@}*/
+       /** @} */
 
        /************************************************************************//**
         * @name   Utility methods
@@ -1904,7 +1904,7 @@ abstract class ApiBase extends ContextSource {
                } );
        }
 
-       /**@}*/
+       /** @} */
 
        /************************************************************************//**
         * @name   Warning and error reporting
@@ -2249,7 +2249,7 @@ abstract class ApiBase extends ContextSource {
                wfDebugLog( 'api-feature-usage', $s, 'private', $ctx );
        }
 
-       /**@}*/
+       /** @} */
 
        /************************************************************************//**
         * @name   Help message generation
@@ -2629,7 +2629,7 @@ abstract class ApiBase extends ContextSource {
        public function modifyHelp( array &$help, array $options, array &$tocData ) {
        }
 
-       /**@}*/
+       /** @} */
 }
 
 /**
index ec432d8..50ca99a 100644 (file)
@@ -78,7 +78,7 @@ abstract class ApiQueryBase extends ApiBase {
        public function requestExtraData( $pageSet ) {
        }
 
-       /**@}*/
+       /** @} */
 
        /************************************************************************//**
         * @name   Data access
@@ -131,7 +131,7 @@ abstract class ApiQueryBase extends ApiBase {
                return $this->getQuery()->getPageSet();
        }
 
-       /**@}*/
+       /** @} */
 
        /************************************************************************//**
         * @name   Querying
@@ -465,7 +465,7 @@ abstract class ApiQueryBase extends ApiBase {
                }
        }
 
-       /**@}*/
+       /** @} */
 
        /************************************************************************//**
         * @name   Utility methods
@@ -608,5 +608,5 @@ abstract class ApiQueryBase extends ApiBase {
                );
        }
 
-       /**@}*/
+       /** @} */
 }
index d0b152e..0d284c0 100644 (file)
@@ -43,7 +43,7 @@ abstract class ApiQueryRevisionsBase extends ApiQueryGeneratorBase {
        const IS_DELETED = 1; // Whether the field is revision-deleted
        const CANNOT_VIEW = 2; // Whether the user cannot view the field due to revdel
 
-       /**@}*/
+       /** @} */
 
        protected $limit, $diffto, $difftotext, $difftotextpst, $expandTemplates, $generateXML,
                $section, $parseContent, $fetchContent, $contentFormat, $setParsedLimit = true,
index c27b10e..7224f07 100644 (file)
@@ -514,7 +514,7 @@ class ApiResult implements ApiSerializable {
                        self::OVERRIDE | self::NO_SIZE_CHECK );
        }
 
-       /**@}*/
+       /** @} */
 
        /************************************************************************//**
         * @name   Metadata
@@ -777,7 +777,7 @@ class ApiResult implements ApiSerializable {
                self::setArrayTypeRecursive( $arr, $tag, $kvpKeyName );
        }
 
-       /**@}*/
+       /** @} */
 
        /************************************************************************//**
         * @name   Utility
@@ -1217,7 +1217,7 @@ class ApiResult implements ApiSerializable {
                }
        }
 
-       /**@}*/
+       /** @} */
 
 }
 
index e03c590..c871ce1 100644 (file)
@@ -86,17 +86,20 @@ class AuthManager implements LoggerAwareInterface {
        /** Log in with an existing (not necessarily local) user */
        const ACTION_LOGIN = 'login';
        /** Continue a login process that was interrupted by the need for user input or communication
-        * with an external provider */
+        * with an external provider
+        */
        const ACTION_LOGIN_CONTINUE = 'login-continue';
        /** Create a new user */
        const ACTION_CREATE = 'create';
        /** Continue a user creation process that was interrupted by the need for user input or
-        * communication with an external provider */
+        * communication with an external provider
+        */
        const ACTION_CREATE_CONTINUE = 'create-continue';
        /** Link an existing user to a third-party account */
        const ACTION_LINK = 'link';
        /** Continue a user linking process that was interrupted by the need for user input or
-        * communication with an external provider */
+        * communication with an external provider
+        */
        const ACTION_LINK_CONTINUE = 'link-continue';
        /** Change a user's credentials */
        const ACTION_CHANGE = 'change';
@@ -827,7 +830,7 @@ class AuthManager implements LoggerAwareInterface {
                return array_keys( $ret );
        }
 
-       /**@}*/
+       /** @} */
 
        /**
         * @name Authentication data changing
@@ -908,7 +911,7 @@ class AuthManager implements LoggerAwareInterface {
                }
        }
 
-       /**@}*/
+       /** @} */
 
        /**
         * @name Account creation
@@ -1777,7 +1780,7 @@ class AuthManager implements LoggerAwareInterface {
                return Status::newGood();
        }
 
-       /**@}*/
+       /** @} */
 
        /**
         * @name Account linking
@@ -2002,7 +2005,7 @@ class AuthManager implements LoggerAwareInterface {
                }
        }
 
-       /**@}*/
+       /** @} */
 
        /**
         * @name Information methods
@@ -2235,7 +2238,7 @@ class AuthManager implements LoggerAwareInterface {
                return null;
        }
 
-       /**@}*/
+       /** @} */
 
        /**
         * @name Internal methods
@@ -2463,7 +2466,7 @@ class AuthManager implements LoggerAwareInterface {
                self::$instance = null;
        }
 
-       /**@}*/
+       /** @} */
 
 }
 
index 4744c4d..4200341 100644 (file)
@@ -47,7 +47,8 @@ abstract class AuthenticationRequest {
 
        /** Indicates that the request is required by a primary authentication
         * provider. Since the user can choose which primary to authenticate with,
-        * the request might or might not end up being actually required. */
+        * the request might or might not end up being actually required.
+        */
        const PRIMARY_REQUIRED = 2;
 
        /** @var string|null The AuthManager::ACTION_* constant this request was
@@ -57,14 +58,16 @@ abstract class AuthenticationRequest {
        public $action = null;
 
        /** @var int For login, continue, and link actions, one of self::OPTIONAL,
-        * self::REQUIRED, or self::PRIMARY_REQUIRED */
+        * self::REQUIRED, or self::PRIMARY_REQUIRED
+        */
        public $required = self::REQUIRED;
 
        /** @var string|null Return-to URL, in case of redirect */
        public $returnToUrl = null;
 
        /** @var string|null Username. See AuthenticationProvider::getAuthenticationRequests()
-        * for details of what this means and how it behaves. */
+        * for details of what this means and how it behaves.
+        */
        public $username = null;
 
        /**
index c82ed1c..b67703c 100644 (file)
@@ -50,7 +50,7 @@ class BlockManager {
         *
         * @var array
         * @since 1.34
-        * */
+        */
        public static $constructorOptions = [
                'ApplyIpBlocksToXff',
                'CookieSetOnAutoblock',
index 5ced294..e2b35a8 100644 (file)
@@ -707,7 +707,8 @@ class ChangesList extends ContextSource {
                ) {
                        $title = $rc->getTitle();
                        /** Check for rollback permissions, disallow special pages, and only
-                        * show a link on the top-most revision */
+                        * show a link on the top-most revision
+                        */
                        if ( $title->quickUserCan( 'rollback', $this->getUser() ) ) {
                                $rev = new Revision( [
                                        'title' => $title,
index a6a2615..5f4bada 100644 (file)
@@ -218,5 +218,5 @@ class FeedItem {
        public static function stripComment( $text ) {
                return preg_replace( '/\[\[([^]]*\|)?([^]]+)\]\]/', '\2', $text );
        }
-       /**#@-*/
+       /** #@- */
 }
index 611469c..a508746 100644 (file)
@@ -40,7 +40,7 @@ class SearchUpdate implements DeferrableUpdate {
        /** @var Content|null Content of the page (not text) */
        private $content;
 
-       /** @var WikiPage **/
+       /** @var WikiPage */
        private $page;
 
        /**
index 37ec39a..841daea 100644 (file)
@@ -198,7 +198,7 @@ class DifferenceEngine extends ContextSource {
         */
        protected $isSlotDiffRenderer = false;
 
-       /**#@-*/
+       /** #@- */
 
        /**
         * @param IContextSource|null $context Context to use, anything else will be ignored
index cbbffe4..60f1607 100644 (file)
@@ -45,7 +45,8 @@ class FileRepo {
        const NAME_AND_TIME_ONLY = 1;
 
        /** @var bool Whether to fetch commons image description pages and display
-        *    them on the local wiki */
+        *    them on the local wiki
+        */
        public $fetchDescription;
 
        /** @var int */
@@ -67,7 +68,8 @@ class FileRepo {
        protected $thumbScriptUrl;
 
        /** @var bool Whether to skip media file transformation on parse and rely
-        *    on a 404 handler instead. */
+        *    on a 404 handler instead.
+        */
        protected $transformVia404;
 
        /** @var string URL of image description pages, e.g.
index 7a90082..d3a02f7 100644 (file)
@@ -29,7 +29,7 @@
  */
 class CSSMin {
 
-       /** @var string Strip marker for comments. **/
+       /** @var string Strip marker for comments. */
        const PLACEHOLDER = "\x7fPLACEHOLDER\x7f";
 
        /**
index 84b7b3e..107672e 100644 (file)
@@ -34,7 +34,7 @@
  * @deprecated since 1.34, no longer used
  */
 class MWMessagePack {
-       /** @var bool|null Whether current system is bigendian. **/
+       /** @var bool|null Whether current system is bigendian. */
        public static $bigendian = null;
 
        /**
index 1085375..02746ec 100644 (file)
@@ -166,7 +166,7 @@ class ParamValidator {
         */
        const PARAM_IGNORE_INVALID_VALUES = 'param-ignore-invalid-values';
 
-       /**@}*/
+       /** @} */
 
        /** Magic "all values" value when PARAM_ALL is true. */
        const ALL_DEFAULT_STRING = '*';
index 01f7df4..1047a98 100644 (file)
@@ -1,25 +1,25 @@
 <?php
 /**
-* Helper class for representing operations with transaction support.
-*
-* This program is free software; you can redistribute it and/or modify
-* it under the terms of the GNU General Public License as published by
-* the Free Software Foundation; either version 2 of the License, or
-* (at your option) any later version.
-*
-* This program is distributed in the hope that it will be useful,
-* but WITHOUT ANY WARRANTY; without even the implied warranty of
-* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-* GNU General Public License for more details.
-*
-* You should have received a copy of the GNU General Public License along
-* with this program; if not, write to the Free Software Foundation, Inc.,
-* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
-* http://www.gnu.org/copyleft/gpl.html
-*
-* @file
-* @ingroup FileBackend
-*/
+ * Helper class for representing operations with transaction support.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ * http://www.gnu.org/copyleft/gpl.html
+ *
+ * @file
+ * @ingroup FileBackend
+ */
 
 /**
  * Delete a file at the given storage path from the backend.
index 9f753fe..185765d 100644 (file)
@@ -18,7 +18,7 @@
  * @file
  */
 
-/**@{
+/** @{
  * Media types.
  * This defines constants for the value returned by File::getMediaType()
  */
@@ -45,4 +45,4 @@ define( 'MEDIATYPE_EXECUTABLE', 'EXECUTABLE' );
 define( 'MEDIATYPE_ARCHIVE', 'ARCHIVE' );
 // 3D file types (stl)
 define( 'MEDIATYPE_3D', '3D' );
-/**@}*/
+/** @} */
index cbc8ca3..72fbbf4 100644 (file)
@@ -3,7 +3,7 @@
 use Wikimedia\Rdbms\ILoadBalancer;
 use Wikimedia\Rdbms\IDatabase;
 
-/**@{
+/** @{
  * Database related constants
  */
 define( 'DBO_DEBUG', IDatabase::DBO_DEBUG );
@@ -16,12 +16,12 @@ define( 'DBO_SYSDBA', IDatabase::DBO_SYSDBA );
 define( 'DBO_DDLMODE', IDatabase::DBO_DDLMODE );
 define( 'DBO_SSL', IDatabase::DBO_SSL );
 define( 'DBO_COMPRESS', IDatabase::DBO_COMPRESS );
-/**@}*/
+/** @} */
 
-/**@{
+/** @{
  * Valid database indexes
  * Operation-based indexes
  */
 define( 'DB_REPLICA', ILoadBalancer::DB_REPLICA );
 define( 'DB_MASTER', ILoadBalancer::DB_MASTER );
-/**@}*/
+/** @} */
index fe9e26f..981aeb0 100644 (file)
@@ -58,7 +58,8 @@ class LogPage {
        private $type;
 
        /** @var string One of '', 'block', 'protect', 'rights', 'delete',
-        *   'upload', 'move', 'move_redir' */
+        *   'upload', 'move', 'move_redir'
+        */
        private $action;
 
        /** @var string Comment associated with action */
index 6dfa8d3..3416dbe 100644 (file)
@@ -543,9 +543,9 @@ class Exif {
                }
        }
 
-       /**#@-*/
+       /** #@- */
 
-       /**#@+
+       /** #@+
         * @return array
         */
 
@@ -565,7 +565,7 @@ class Exif {
                return $this->mFilteredExifData;
        }
 
-       /**#@-*/
+       /** #@- */
 
        /**
         * The version of the output format
@@ -721,7 +721,7 @@ class Exif {
                }
        }
 
-       /**#@-*/
+       /** #@- */
 
        /**
         * Validates if a tag has a legal value according to the Exif spec
index f158e4d..fcfb83d 100644 (file)
@@ -2168,7 +2168,7 @@ class Article implements Page {
                return $cacheable;
        }
 
-       /**#@-*/
+       /** #@- */
 
        /**
         * Lightweight method to get the parser output for a page, checking the parser cache
index 173fdc6..3bc9f7c 100644 (file)
@@ -3503,7 +3503,7 @@ class WikiPage implements Page, IDBAccessObject {
                self::purgeInterwikiCheckKey( $title );
        }
 
-       /**#@-*/
+       /** #@- */
 
        /**
         * Purge the check key for cross-wiki cache entries referencing this page
index c01e507..dff9a39 100644 (file)
@@ -34,7 +34,8 @@ class ResourceLoaderFilePath {
        protected $remoteBasePath;
 
        /**
-        * @var string Path to the file */
+        * @var string Path to the file
+        */
        protected $path;
 
        /**
index 328958c..681d6cf 100644 (file)
@@ -694,6 +694,6 @@ final class Session implements \Countable, \Iterator, \ArrayAccess {
                $this->remove( $offset );
        }
 
-       /**@}*/
+       /** @} */
 
 }
index 3810565..c635b97 100644 (file)
@@ -939,6 +939,6 @@ final class SessionManager implements SessionManagerInterface {
                self::$globalSessionRequest = null;
        }
 
-       /**@}*/
+       /** @} */
 
 }
index 5165506..782ac16 100644 (file)
@@ -31,7 +31,8 @@ namespace MediaWiki\Session;
  */
 class Token {
        /** CSRF token suffix. Plus and terminal backslash are included to stop
-        * editing from certain broken proxies. */
+        * editing from certain broken proxies.
+        */
        const SUFFIX = '+\\';
 
        /** @var string */
index 65cd2d2..ba7785c 100644 (file)
@@ -13,7 +13,8 @@ use MediaWiki\Session\Token;
  */
 abstract class AuthManagerSpecialPage extends SpecialPage {
        /** @var string[] The list of actions this special page deals with. Subclasses should override
-        * this. */
+        * this.
+        */
        protected static $allowedActions = [
                AuthManager::ACTION_LOGIN, AuthManager::ACTION_LOGIN_CONTINUE,
                AuthManager::ACTION_CREATE, AuthManager::ACTION_CREATE_CONTINUE,
index 743a5a5..d609d22 100644 (file)
@@ -54,7 +54,8 @@ abstract class LoginSignupSpecialPage extends AuthManagerSpecialPage {
        protected $securityLevel;
 
        /** @var bool True if the user if creating an account for someone else. Flag used for internal
-        * communication, only set at the very end. */
+        * communication, only set at the very end.
+        */
        protected $proxyAccountCreation;
        /** @var User FIXME another flag for passing data. */
        protected $targetUser;
index 40172ab..84d2f3e 100644 (file)
@@ -225,7 +225,7 @@ class SpecialPageFactory {
         *
         * @var array
         * @since 1.33
-        * */
+        */
        public static $constructorOptions = [
                'ContentHandlerUseDB',
                'DisableInternalSearch',
index b2161db..f653454 100644 (file)
@@ -34,7 +34,8 @@ use MediaWiki\MediaWikiServices;
  */
 class SpecialBlock extends FormSpecialPage {
        /** @var User|string|null User to be blocked, as passed either by parameter (url?wpTarget=Foo)
-        * or as subpage (Special:Block/Foo) */
+        * or as subpage (Special:Block/Foo)
+        */
        protected $target;
 
        /** @var int DatabaseBlock::TYPE_ constant */
index 68fda49..81c9d56 100644 (file)
@@ -43,7 +43,7 @@ class SpecialUpload extends SpecialPage {
                return true;
        }
 
-       /** Misc variables **/
+       /** Misc variables */
 
        /** @var WebRequest|FauxRequest The request this form is supposed to handle */
        public $mRequest;
@@ -56,21 +56,21 @@ class SpecialUpload extends SpecialPage {
        public $mLocalFile;
        public $mUploadClicked;
 
-       /** User input variables from the "description" section **/
+       /** User input variables from the "description" section */
 
        /** @var string The requested target file name */
        public $mDesiredDestName;
        public $mComment;
        public $mLicense;
 
-       /** User input variables from the root section **/
+       /** User input variables from the root section */
 
        public $mIgnoreWarning;
        public $mWatchthis;
        public $mCopyrightStatus;
        public $mCopyrightSource;
 
-       /** Hidden variables **/
+       /** Hidden variables */
 
        public $mDestWarningAck;
 
@@ -84,7 +84,7 @@ class SpecialUpload extends SpecialPage {
        /** @var bool Subclasses can use this to determine whether a file was uploaded */
        public $mUploadSuccessful = false;
 
-       /** Text injection points for hooks not using HTMLForm **/
+       /** Text injection points for hooks not using HTMLForm */
        public $uploadFormTextTop;
        public $uploadFormTextAfterSummary;
 
@@ -690,7 +690,7 @@ class SpecialUpload extends SpecialPage {
         */
        protected function processVerificationError( $details ) {
                switch ( $details['status'] ) {
-                       /** Statuses that only require name changing **/
+                       /** Statuses that only require name changing */
                        case UploadBase::MIN_LENGTH_PARTNAME:
                                $this->showRecoverableUploadError( $this->msg( 'minlength1' )->escaped() );
                                break;
@@ -708,7 +708,7 @@ class SpecialUpload extends SpecialPage {
                                $this->showRecoverableUploadError( $this->msg( 'windows-nonascii-filename' )->parse() );
                                break;
 
-                       /** Statuses that require reuploading **/
+                       /** Statuses that require reuploading */
                        case UploadBase::EMPTY_FILE:
                                $this->showUploadError( $this->msg( 'emptyfile' )->escaped() );
                                break;
@@ -781,7 +781,7 @@ class SpecialUpload extends SpecialPage {
                }
        }
 
-       /*** Functions for formatting warnings ***/
+       /** Functions for formatting warnings */
 
        /**
         * Formats a result of UploadBase::getExistsWarning as HTML
index 204b033..c78913c 100644 (file)
@@ -40,7 +40,7 @@ class Licenses extends HTMLFormField {
 
        /** @var string|null */
        protected $selected;
-       /**#@-*/
+       /** #@- */
 
        /**
         * @param array $params
@@ -191,7 +191,7 @@ class Licenses extends HTMLFormField {
                return str_repeat( "\t", $depth ) . Xml::element( 'option', $attribs, $val ) . "\n";
        }
 
-       /**#@-*/
+       /** #@- */
 
        /**
         * Accessor for $this->lines
index a40241c..c3a2a7d 100644 (file)
@@ -1,12 +1,12 @@
 <?php
 /** Ingush (ГӀалгӀай)
-*
-* To improve a translation please visit https://translatewiki.net
-*
-* @ingroup Language
-* @file
-*
-*/
+ *
+ * To improve a translation please visit https://translatewiki.net
+ *
+ * @ingroup Language
+ * @file
+ *
+ */
 
 $fallback = 'ru';
 
index e49e1d8..c935c2d 100644 (file)
@@ -34,7 +34,7 @@ class ApiQueryBasicTest extends ApiQueryTestBase {
        /**
         * Create a set of pages. These must not change, otherwise the tests might give wrong results.
         *
-*@see MediaWikiTestCase::addDBDataOnce()
+        * @see MediaWikiTestCase::addDBDataOnce()
         */
        function addDBDataOnce() {
                try {
index 334fd5d..a1aeb66 100644 (file)
@@ -30,7 +30,7 @@ class ApiQueryContinue2Test extends ApiQueryContinueTestBase {
        /**
         * Create a set of pages. These must not change, otherwise the tests might give wrong results.
         *
-*@see MediaWikiTestCase::addDBDataOnce()
+        * @see MediaWikiTestCase::addDBDataOnce()
         */
        function addDBDataOnce() {
                try {
index 7259bb8..a12d9b0 100644 (file)
@@ -34,7 +34,7 @@ class ApiQueryContinueTest extends ApiQueryContinueTestBase {
        /**
         * Create a set of pages. These must not change, otherwise the tests might give wrong results.
         *
-*@see MediaWikiTestCase::addDBDataOnce()
+        * @see MediaWikiTestCase::addDBDataOnce()
         */
        function addDBDataOnce() {
                try {
index 4c93789..34837c7 100644 (file)
@@ -333,7 +333,7 @@ class CSSMinTest extends MediaWikiTestCase {
         * Cases with empty url() for CSSMin::remap.
         *
         * Regression test for T191237.
-   *
+        *
         * @dataProvider provideRemapEmptyUrl
         * @covers CSSMin
         */
index ccad4a4..25b4291 100644 (file)
@@ -55,7 +55,7 @@ class XhprofTest extends PHPUnit\Framework\TestCase {
 
        /**
         * Data provider for testCallAny().
-       */
+        */
        public function provideCallAny() {
                return [
                        [
index 8da7602..d0aeb8e 100644 (file)
@@ -240,7 +240,7 @@ class LanguageSrTest extends LanguageClassesTestCase {
        # #### HELPERS #####################################################
 
        /**
-        *Wrapper to verify text stay the same after applying conversion
+        * Wrapper to verify text stay the same after applying conversion
         * @param string $text Text to convert
         * @param string $variant Language variant 'sr-ec' or 'sr-el'
         * @param string $msg Optional message
@@ -291,7 +291,7 @@ class LanguageSrTest extends LanguageClassesTestCase {
                $this->assertConverted( $text, 'sr-ec', $msg );
        }
 
-       /** Wrapper for converter::convertTo() method*/
+       /** Wrapper for converter::convertTo() method */
        protected function convertTo( $text, $variant ) {
                return $this->getLang()
                        ->mConverter
index abc63ee..09054da 100644 (file)
@@ -113,7 +113,7 @@ class LanguageUzTest extends LanguageClassesTestCase {
                $this->assertConverted( $text, 'uz-cyrl', $msg );
        }
 
-       /** Wrapper for converter::convertTo() method*/
+       /** Wrapper for converter::convertTo() method */
        protected function convertTo( $text, $variant ) {
                return $this->getLang()->mConverter->convertTo( $text, $variant );
        }
index 521705e..8925b1f 100644 (file)
@@ -4,7 +4,7 @@ use Wikimedia\Rdbms\IDatabase;
 
 /**
  * Tests for CategoryChangesAsRdf recent changes exporter.
- *  @covers CategoryChangesAsRdf
+ * @covers CategoryChangesAsRdf
  */
 class CategoryChangesAsRdfTest extends MediaWikiLangTestCase {