diff --git a/includes/Rest/ResponseInterface.php b/includes/Rest/ResponseInterface.php index 05374147fc6..f6b727cfd8a 100644 --- a/includes/Rest/ResponseInterface.php +++ b/includes/Rest/ResponseInterface.php @@ -36,7 +36,7 @@ use Psr\Http\Message\StreamInterface; * An interface similar to PSR-7's ResponseInterface, the primary difference * being that it is mutable. * - * @stable for implementing + * @stable to implement */ interface ResponseInterface { // ResponseInterface diff --git a/includes/actions/EditAction.php b/includes/actions/EditAction.php index bc632a4fa76..e81446b8ac1 100644 --- a/includes/actions/EditAction.php +++ b/includes/actions/EditAction.php @@ -23,7 +23,7 @@ * * This is a wrapper that will call the EditPage class or a custom editor from an extension. * - * @stable for subclasssing + * @stable to extend * @ingroup Actions */ class EditAction extends FormlessAction { diff --git a/includes/language/MessageLocalizer.php b/includes/language/MessageLocalizer.php index ea64f4da644..b90006c58c2 100644 --- a/includes/language/MessageLocalizer.php +++ b/includes/language/MessageLocalizer.php @@ -21,7 +21,7 @@ /** * Interface for localizing messages in MediaWiki * - * @stable for implementing + * @stable to implement * * @since 1.30 * @ingroup Language diff --git a/includes/linker/Hook/LinkerGenerateRollbackLinkHook.php b/includes/linker/Hook/LinkerGenerateRollbackLinkHook.php index aae53db6f14..58abd2b16c7 100644 --- a/includes/linker/Hook/LinkerGenerateRollbackLinkHook.php +++ b/includes/linker/Hook/LinkerGenerateRollbackLinkHook.php @@ -6,7 +6,7 @@ use IContextSource; use MediaWiki\Revision\RevisionRecord; /** - * @stable for implementation + * @stable to implement * @ingroup Hooks */ interface LinkerGenerateRollbackLinkHook { diff --git a/includes/rcfeed/RCFeedFormatter.php b/includes/rcfeed/RCFeedFormatter.php index 9b7410c4d27..c72e21e047f 100644 --- a/includes/rcfeed/RCFeedFormatter.php +++ b/includes/rcfeed/RCFeedFormatter.php @@ -22,7 +22,7 @@ /** * Interface for RC feed formatters * - * @stable for implementing + * @stable to implement * @since 1.22 */ interface RCFeedFormatter { diff --git a/includes/skins/Hook/SkinPageReadyConfigHook.php b/includes/skins/Hook/SkinPageReadyConfigHook.php index cd76d09eeb1..edd7f0f09a5 100644 --- a/includes/skins/Hook/SkinPageReadyConfigHook.php +++ b/includes/skins/Hook/SkinPageReadyConfigHook.php @@ -8,7 +8,7 @@ use ResourceLoaderContext; * This is a hook handler interface, see docs/Hooks.md. * Use the hook name "SkinPageReadyConfig" to register handlers implementing this interface. * - * @stable for implementation + * @stable to implement */ interface SkinPageReadyConfigHook { /** diff --git a/includes/skins/SkinMustache.php b/includes/skins/SkinMustache.php index 2f07fd7d058..cfaa6d44502 100644 --- a/includes/skins/SkinMustache.php +++ b/includes/skins/SkinMustache.php @@ -31,7 +31,7 @@ class SkinMustache extends SkinTemplate { /** * @since 1.36 - * @stable for overriding + * @stable to override * @param string $name of the portal e.g. p-personal the name is personal. * @param array $items that are accepted input to Skin::makeListItem * @return array data that can be passed to a Mustache template that diff --git a/maintenance/includes/Maintenance.php b/maintenance/includes/Maintenance.php index 79dbbdfe356..540d0c8d15e 100644 --- a/maintenance/includes/Maintenance.php +++ b/maintenance/includes/Maintenance.php @@ -51,7 +51,7 @@ use Wikimedia\Rdbms\IMaintainableDatabase; * be careful with the constructor when subclassing. MediaWikiServices instance * is not yet available at this point. * - * @stable for subclassing + * @stable to extend * * @since 1.16 * @ingroup Maintenance @@ -175,7 +175,7 @@ abstract class Maintenance { * Default constructor. Children should call this *first* if implementing * their own constructors * - * @stable for calling + * @stable to call */ public function __construct() { $this->addDefaultParams(); @@ -428,7 +428,7 @@ abstract class Maintenance { /** * Throw some output to the user. Scripts can call this with no fears, * as we handle all --quiet stuff here - * @stable for overriding + * @stable to override * @param string $out The text to show to the user * @param mixed|null $channel Unique identifier for the channel. See function outputChanneled. */ @@ -457,7 +457,7 @@ abstract class Maintenance { /** * Throw an error to the user. Doesn't respect --quiet, so don't use * this for non-error output - * @stable for overriding + * @stable to override * @param string $err The error to display * @param int $die Deprecated since 1.31, use Maintenance::fatalError() instead */ @@ -480,7 +480,7 @@ abstract class Maintenance { /** * Output a message and terminate the current script. * - * @stable for overriding + * @stable to override * @param string $msg Error message * @param int $exitCode PHP exit status. Should be in range 1-254. * @since 1.31 @@ -542,7 +542,7 @@ abstract class Maintenance { * Maintenance::DB_NONE - For no DB access at all * Maintenance::DB_STD - For normal DB access, default * Maintenance::DB_ADMIN - For admin DB access - * @stable for overriding + * @stable to override * @return int */ public function getDbType() { @@ -591,7 +591,7 @@ abstract class Maintenance { /** * @since 1.24 - * @stable for overriding + * @stable to override * @return Config */ public function getConfig() { @@ -747,7 +747,7 @@ abstract class Maintenance { * to allow sysadmins to explicitly set one if they'd prefer to override * defaults (or for people using Suhosin which yells at you for trying * to disable the limits) - * @stable for overriding + * @stable to override * @return string */ public function memoryLimit() { @@ -950,7 +950,7 @@ abstract class Maintenance { /** * Run some validation checks on the params, etc - * @stable for overriding + * @stable to override */ public function validateParamsAndArgs() { $die = false; @@ -983,7 +983,7 @@ abstract class Maintenance { /** * Handle the special variables that are global to all scripts - * @stable for overriding + * @stable to override */ protected function loadSpecialVars() { if ( $this->hasOption( 'dbuser' ) ) { @@ -1123,7 +1123,7 @@ abstract class Maintenance { /** * Handle some last-minute setup here. - * @stable for overriding + * @stable to override */ public function finalSetup() { global $wgCommandLineMode, $wgServer, $wgShowExceptionDetails, $wgShowHostnames; @@ -1209,7 +1209,7 @@ abstract class Maintenance { /** * Execute a callback function at the end of initialisation - * @stable for overriding + * @stable to override */ protected function afterFinalSetup() { if ( defined( 'MW_CMDLINE_CALLBACK' ) ) { @@ -1351,7 +1351,7 @@ abstract class Maintenance { * * This function has the same parameters as LoadBalancer::getConnection(). * - * @stable for overriding + * @stable to override * * @param int $db DB index (DB_REPLICA/DB_PRIMARY) * @param string|string[] $groups default: empty array @@ -1371,7 +1371,7 @@ abstract class Maintenance { /** * Sets database object to be returned by getDB(). - * @stable for overriding + * @stable to override * * @param IMaintainableDatabase $db */ diff --git a/tests/phpunit/MediaWikiIntegrationTestCase.php b/tests/phpunit/MediaWikiIntegrationTestCase.php index 5e11cfd4f98..792ea7fb545 100644 --- a/tests/phpunit/MediaWikiIntegrationTestCase.php +++ b/tests/phpunit/MediaWikiIntegrationTestCase.php @@ -25,7 +25,7 @@ use Wikimedia\Rdbms\IMaintainableDatabase; * Consider using MediaWikiUnitTestCase and mocking dependencies if your code uses dependency * injection and does not access any globals. * - * @stable for subclassing + * @stable to extend */ abstract class MediaWikiIntegrationTestCase extends PHPUnit\Framework\TestCase { use MediaWikiCoversValidator; @@ -154,7 +154,7 @@ abstract class MediaWikiIntegrationTestCase extends PHPUnit\Framework\TestCase { ]; /** - * @stable for calling + * @stable to call * @param string|null $name * @param array $data * @param string $dataName @@ -1360,7 +1360,7 @@ abstract class MediaWikiIntegrationTestCase extends PHPUnit\Framework\TestCase { * @see resetDB() * * @since 1.27 - * @stable for overriding + * @stable to override */ public function addDBDataOnce() { } @@ -1373,7 +1373,7 @@ abstract class MediaWikiIntegrationTestCase extends PHPUnit\Framework\TestCase { * @see resetDB() * * @since 1.18 - * @stable for overriding + * @stable to override */ public function addDBData() { } @@ -1639,7 +1639,7 @@ abstract class MediaWikiIntegrationTestCase extends PHPUnit\Framework\TestCase { * by the 'scripts', even if the test is only interested in a subset of them, otherwise * the overrides may not be fully cleaned up, leading to errors later. * - * @stable for overriding + * @stable to override * @param IMaintainableDatabase $db The DB connection to use for the mock schema. * May be used to check the current state of the schema, to determine what * overrides are needed. diff --git a/tests/phpunit/MediaWikiUnitTestCase.php b/tests/phpunit/MediaWikiUnitTestCase.php index edfdb8a6e8e..eea22d2b6e2 100644 --- a/tests/phpunit/MediaWikiUnitTestCase.php +++ b/tests/phpunit/MediaWikiUnitTestCase.php @@ -30,7 +30,7 @@ use Wikimedia\ObjectFactory; * Extend this class if you are testing classes which use dependency injection and do not access * global functions, variables, services or a storage backend. * - * @stable for subclassing + * @stable to extend * @since 1.34 */ abstract class MediaWikiUnitTestCase extends TestCase {