From: Timo Tijhof Date: Wed, 15 May 2013 00:53:49 +0000 (+0200) Subject: docs: Consistently use "since" phrasing in @deprecated X-Git-Tag: 1.31.0-rc.0~19676 X-Git-Url: http://git.cyclocoop.org/fichier?a=commitdiff_plain;h=176c5354bb691dedd66006c1b5838515a3865e95;p=lhc%2Fweb%2Fwiklou.git docs: Consistently use "since" phrasing in @deprecated Most have it already: https://doc.wikimedia.org/mediawiki-core/master/php/html/deprecated.html Ran a find/replace on "@deprecated \d" to fix the odd ones. Change-Id: I5217aaf75264a0036b5426cd8536116b4bb8f535 --- diff --git a/includes/Action.php b/includes/Action.php index dff3803348..e9961042a1 100644 --- a/includes/Action.php +++ b/includes/Action.php @@ -213,7 +213,7 @@ abstract class Action { /** * Shortcut to get the user Language being used for this instance * - * @deprecated 1.19 Use getLanguage instead + * @deprecated since 1.19 Use getLanguage instead * @return Language */ final public function getLang() { diff --git a/includes/DefaultSettings.php b/includes/DefaultSettings.php index bcc4ae4525..4e19642dff 100644 --- a/includes/DefaultSettings.php +++ b/includes/DefaultSettings.php @@ -5804,7 +5804,7 @@ $wgDisableQueryPageUpdate = false; * List of special pages, followed by what subtitle they should go under * at Special:SpecialPages * - * @deprecated 1.21 Override SpecialPage::getGroupName instead + * @deprecated since 1.21 Override SpecialPage::getGroupName instead */ $wgSpecialPageGroups = array(); diff --git a/includes/SpecialPage.php b/includes/SpecialPage.php index f619c79010..38448cd32b 100644 --- a/includes/SpecialPage.php +++ b/includes/SpecialPage.php @@ -797,7 +797,7 @@ class SpecialPage { /** * Shortcut to get user's language * - * @deprecated 1.19 Use getLanguage instead + * @deprecated since 1.19 Use getLanguage instead * @return Language * @since 1.18 */ diff --git a/includes/SpecialPageFactory.php b/includes/SpecialPageFactory.php index 3c4e61d00b..4d635536a7 100644 --- a/includes/SpecialPageFactory.php +++ b/includes/SpecialPageFactory.php @@ -287,7 +287,7 @@ class SpecialPageFactory { * * @param $page Mixed: SpecialPage or string * @param $group String - * @deprecated 1.21 Override SpecialPage::getGroupName + * @deprecated since 1.21 Override SpecialPage::getGroupName */ public static function setGroup( $page, $group ) { wfDeprecated( __METHOD__, '1.21' ); @@ -302,7 +302,7 @@ class SpecialPageFactory { * * @param $page SpecialPage * @return String - * @deprecated 1.21 Use SpecialPage::getFinalGroupName + * @deprecated since 1.21 Use SpecialPage::getFinalGroupName */ public static function getGroup( &$page ) { wfDeprecated( __METHOD__, '1.21' ); diff --git a/includes/api/ApiPageSet.php b/includes/api/ApiPageSet.php index 3caf81f0ed..fbe597342f 100644 --- a/includes/api/ApiPageSet.php +++ b/includes/api/ApiPageSet.php @@ -604,7 +604,7 @@ class ApiPageSet extends ApiBase { /** * Do not use, does nothing, will be removed - * @deprecated 1.21 + * @deprecated since 1.21 */ public function finishPageSetGeneration() { wfDeprecated( __METHOD__, '1.21' ); diff --git a/includes/context/ContextSource.php b/includes/context/ContextSource.php index 33f51cb972..e13cfa88ce 100644 --- a/includes/context/ContextSource.php +++ b/includes/context/ContextSource.php @@ -125,7 +125,7 @@ abstract class ContextSource implements IContextSource { /** * Get the Language object * - * @deprecated 1.19 Use getLanguage instead + * @deprecated since 1.19 Use getLanguage instead * @return Language */ public function getLang() { diff --git a/includes/context/DerivativeContext.php b/includes/context/DerivativeContext.php index b9a7006865..eda56a7d55 100644 --- a/includes/context/DerivativeContext.php +++ b/includes/context/DerivativeContext.php @@ -209,7 +209,7 @@ class DerivativeContext extends ContextSource { /** * Set the Language object * - * @deprecated 1.19 Use setLanguage instead + * @deprecated since 1.19 Use setLanguage instead * @param Language|string $l Language instance or language code */ public function setLang( $l ) { @@ -237,7 +237,7 @@ class DerivativeContext extends ContextSource { } /** - * @deprecated 1.19 Use getLanguage instead + * @deprecated since 1.19 Use getLanguage instead * @return Language */ public function getLang() { diff --git a/includes/context/IContextSource.php b/includes/context/IContextSource.php index c7b221b9b0..35d5aed6b5 100644 --- a/includes/context/IContextSource.php +++ b/includes/context/IContextSource.php @@ -79,7 +79,7 @@ interface IContextSource { /** * Get the Language object * - * @deprecated 1.19 Use getLanguage instead + * @deprecated since 1.19 Use getLanguage instead * @return Language */ public function getLang(); diff --git a/includes/context/RequestContext.php b/includes/context/RequestContext.php index fd99caf2ae..cb26dcf7a0 100644 --- a/includes/context/RequestContext.php +++ b/includes/context/RequestContext.php @@ -233,7 +233,7 @@ class RequestContext implements IContextSource { /** * Set the Language object * - * @deprecated 1.19 Use setLanguage instead + * @deprecated since 1.19 Use setLanguage instead * @param Language|string $l Language instance or language code */ public function setLang( $l ) { @@ -261,7 +261,7 @@ class RequestContext implements IContextSource { } /** - * @deprecated 1.19 Use getLanguage instead + * @deprecated since 1.19 Use getLanguage instead * @return Language */ public function getLang() { diff --git a/includes/db/LoadBalancer.php b/includes/db/LoadBalancer.php index f702047885..12e493a48c 100644 --- a/includes/db/LoadBalancer.php +++ b/includes/db/LoadBalancer.php @@ -117,7 +117,7 @@ class LoadBalancer { * Given an array of non-normalised probabilities, this function will select * an element and return the appropriate key * - * @deprecated 1.21, use ArrayUtils::pickRandom() + * @deprecated since 1.21, use ArrayUtils::pickRandom() * * @param $weights array * diff --git a/includes/job/Job.php b/includes/job/Job.php index bb6fb0479f..ab7df5d2ed 100644 --- a/includes/job/Job.php +++ b/includes/job/Job.php @@ -84,7 +84,7 @@ abstract class Job { * * @param array $jobs of Job objects * @return bool - * @deprecated 1.21 + * @deprecated since 1.21 */ public static function batchInsert( $jobs ) { return JobQueueGroup::singleton()->push( $jobs ); @@ -99,7 +99,7 @@ abstract class Job { * * @param array $jobs of Job objects * @return bool - * @deprecated 1.21 + * @deprecated since 1.21 */ public static function safeBatchInsert( $jobs ) { return JobQueueGroup::singleton()->push( $jobs, JobQueue::QOS_ATOMIC ); @@ -112,7 +112,7 @@ abstract class Job { * * @param $type string * @return Job|bool Returns false if there are no jobs - * @deprecated 1.21 + * @deprecated since 1.21 */ public static function pop_type( $type ) { return JobQueueGroup::singleton()->get( $type )->pop(); @@ -123,7 +123,7 @@ abstract class Job { * This is subject to $wgJobTypesExcludedFromDefaultQueue. * * @return Job or false if there's no jobs - * @deprecated 1.21 + * @deprecated since 1.21 */ public static function pop() { return JobQueueGroup::singleton()->pop(); @@ -150,7 +150,7 @@ abstract class Job { /** * @return integer May be 0 for jobs stored outside the DB - * @deprecated 1.22 + * @deprecated since 1.22 */ public function getId() { return $this->id; @@ -270,7 +270,7 @@ abstract class Job { /** * Insert a single job into the queue. * @return bool true on success - * @deprecated 1.21 + * @deprecated since 1.21 */ public function insert() { return JobQueueGroup::singleton()->push( $this );