Deprecating something means to say something nasty about it, or to draw its character into question. For example, "this function is lazy and good for nothing". Deprecatory remarks by a developer are generally taken as a warning that violence will soon be done against the function in question. Other developers are thus warned to avoid associating with the deprecated function. However, since wfDeprecated() was introduced, it has become obvious that the targets of deprecation are not limited to functions. Developers can deprecate literally anything: a parameter, a return value, a file format, Mondays, the concept of being, etc. wfDeprecated() requires every deprecatory statement to begin with "use of", leading to some awkward sentences. For example, one might say: "Use of your mouth to cough without it being covered by your arm is deprecated since 2020." So, introduce wfDeprecatedMsg(), which allows deprecation messages to be specified in plain text, with the caller description being optionally appended. Migrate incorrect or gramatically awkward uses of wfDeprecated() to wfDeprecatedMsg(). Change-Id: Ib3dd2fe37677d98425d0f3692db5c9e988943ae8 |
||
|---|---|---|
| .. | ||
| composer | ||
| eventrelayer | ||
| filebackend | ||
| http | ||
| iterators | ||
| lockmanager | ||
| Message | ||
| mime | ||
| objectcache | ||
| ParamValidator | ||
| rdbms | ||
| redis | ||
| services | ||
| stats | ||
| uuid | ||
| virtualrest | ||
| APACHE-LICENSE-2.0.txt | ||
| ArrayUtils.php | ||
| Cookie.php | ||
| CookieJar.php | ||
| CryptHKDF.php | ||
| CSSMin.php | ||
| DeferredStringifier.php | ||
| Deflate.php | ||
| DnsSrvDiscoverer.php | ||
| ExplodeIterator.php | ||
| GenericArrayObject.php | ||
| HashRing.php | ||
| HtmlArmor.php | ||
| HttpStatus.php | ||
| JavaScriptMinifier.php | ||
| jsminplus.php | ||
| MapCacheLRU.php | ||
| MappedIterator.php | ||
| MemoizedCallable.php | ||
| MessageSpecifier.php | ||
| MWCryptHash.php | ||
| ProcessCacheLRU.php | ||
| README | ||
| ReplacementArray.php | ||
| ReverseArrayIterator.php | ||
| RiffExtractor.php | ||
| StaticArrayWriter.php | ||
| StatusValue.php | ||
| StringUtils.php | ||
| Timing.php | ||
| UDPTransport.php | ||
| Xhprof.php | ||
| XhprofData.php | ||
The classes in this directory ./includes/libs are considered standalone from the remainder of the MediaWiki codebase. They do not call on any other portions of MediaWiki code, and can be used in other projects without dependency issues.