Enable "PhanUndeclaredVariable" phan check
[lhc/web/wiklou.git] / RELEASE-NOTES-1.32
index 8e5022c..c06ba91 100644 (file)
@@ -6,14 +6,21 @@ MediaWiki 1.32 is an alpha-quality branch and is not recommended for use in
 production.
 
 === Configuration changes in 1.32 ===
-* (T115414) The $wgEnableAPI and $wgEnableWriteAPI settings, deprecated in 1.31, have been removed.
+* (T115414) The $wgEnableAPI and $wgEnableWriteAPI settings, deprecated in 1.31,
+  have been removed.
 * The $wgUseAjax setting, deprecated in 1.31, is now ignored.
 * The $wgSiteSupportPage setting, unused since 1.5, was removed.
-* $wgJpegQuality was added to allow configuring the quality of JPEG thumbnails (default 80).
-* The default quality of JPEG thumbnails generated by GD was reduced from 95 to 80.
-* $wgExperimentalHtmlIds, deprecated since 1.30, has been removed. The 'html5-legacy' value for
-  $wgFragmentMode is no longer accepted.
-* …
+* The default quality of JPEG thumbnails generated by GD was reduced from 95 to
+  80. The quality of JPEG thumbnails is now configurable through the new setting
+  $wgJpegQuality (default 80). This aligns the quality to what ImageMagick uses.
+* $wgExperimentalHtmlIds, deprecated since 1.30, has been removed. The
+  'html5-legacy' value for $wgFragmentMode is no longer accepted.
+* The experimental Html5Internal and Html5Depurate tidy drivers were removed.
+  RemexHtml, which is the default, should be used instead.
+* (T135963) You can now define a Content Security Policy for your wiki. This
+  adds a defense-in-depth feature to stop an attacker who has found a bug in
+  the parser allowing them to insert malicious attributes. Disabled by default,
+  you can configure this via $wgCSPHeader and $wgCSPReportOnlyHeader.
 
 === New features in 1.32 ===
 * (T112474) Generalized the ResourceLoader mechanism for overriding modules
@@ -36,53 +43,80 @@ production.
 * …
 
 === Action API changes in 1.32 ===
-* …
+* Added templated parameters.
+  * A module can define a templated parameter like "{fruit}-quantity", where
+    the actual parameters recognized correspond to the values of a multi-valued
+    parameter. Then clients can make requests like
+    "fruits=apples|bananas&apples-quantity=1&bananas-quantity=5".
+  * action=paraminfo will return templated parameter definitions separately
+    from normal parameters. All parameter definitions now include an "index"
+    key to allow clients to maintain parameter ordering when merging normal and
+    templated parameters.
 
 === Action API internal changes in 1.32 ===
 * Added 'ApiParseMakeOutputPage' hook.
+* Parameter names may no longer contain '{' or '}', as these are now used for
+  templated parameters.
 
 === Languages updated in 1.32 ===
-MediaWiki supports over 350 languages. Many localisations are updated
-regularly. Below only new and removed languages are listed, as well as
-changes to languages because of Phabricator reports.
+MediaWiki supports over 350 languages. Many localisations are updated regularly.
+Below only new and removed languages are listed, as well as changes to languages
+because of Phabricator reports.
 
-* 
+* (T193566) Added language support for Ambonese Malay (abs).
 
 === Breaking changes in 1.32 ===
-* $wgRequestTime was removed (deprecated in 1.25).
-  Use $_SERVER['REQUEST_TIME_FLOAT'] or WebRequest::getElapsedTime() instead.
-* The MediaWikiI18N class was removed (deprecated in 1.31).
-* QuickTemplate::setTranslator() was removed (deprecated in 1.31).
-  Use Skin::msg() instead.
-* wfInitShellLocale() was removed (deprecated in 1.30).
-* wfShellExecDisabled() was removed (deprecated in 1.30).
-* The type string for the parameter $lang of DateFormatter::getInstance is
-  removed (deprecated in 1.31).
-* The EDIT_TOKEN_SUFFIX constant was removed (deprecated in 1.27).
-  Use MediaWiki\Session\Token::SUFFIX instead.
-* EditPage::isOouiEnabled() was removed (deprecated in 1.30).
-* mw.util.wikiGetlink() was removed (deprecated in 1.23).
-  Use mw.util.getUrl() instead.
-* (T61113) The following methods and constants from the Revision class were deprecated in
-  1.25 and have now been removed.
+* $wgRequestTime, deprecated in 1.25, was removed. Use
+  $_SERVER['REQUEST_TIME_FLOAT'] or WebRequest::getElapsedTime() instead.
+* The MediaWikiI18N class, deprecated in 1.31, was removed.
+* QuickTemplate::setTranslator(), deprecated in 1.31, was removed. Use
+  Skin::msg() instead.
+* wfInitShellLocale(), deprecated in 1.30, was removed.
+* wfShellExecDisabled(), deprecated in 1.30, was removed.
+* The type string for the parameter $lang of DateFormatter::getInstance,
+  deprecated in 1.31, was removed.
+* The EDIT_TOKEN_SUFFIX constant deprecated in 1.27, was removed. Use
+  MediaWiki\Session\Token::SUFFIX instead.
+* EditPage::isOouiEnabled() deprecated in 1.30, was removed.
+* mw.util.wikiGetlink(), deprecated in 1.23, was removed. Use mw.util.getUrl()
+  instead.
+* (T61113) The following methods and constants from the Revision class, which
+  were deprecated in 1.25, have now been removed:
   * Revision::getRawUser()
   * Revision::getRawUserText()
   * Revision::getRawComment()
-* window.gM() from mediawiki.jqueryMsg was removed (deprecated in 1.23).
-  Use mw.msg() or mw.message() instead.
+* window.gM() from mediawiki.jqueryMsg, deprecated in 1.23, was removed. Use
+  mw.msg() or mw.message() instead.
+* mw.util.escapeId(), deprecated in 1.30, was removed. Use
+  mw.util.escapeIdForAttribute or mw.util.escapeIdForLink instead.
+* mw.util.updateTooltipAccessKeys(), deprecated in 1.24, was removed. Use
+  jquery.accessKeyLabel instead.
+* The SqlDataUpdate class, deprecated in 1.28, has been removed.
+* The Html5Internal and Html5Depurate tidy driver classes were removed, along with the
+  Balancer tidy implementation. Both implementations were experimental, and were replaced
+  by RemexHtml.
 
 === Deprecations in 1.32 ===
 * Use of a StartProfiler.php file is deprecated in favour of placing
   configuration in LocalSettings.php.
 * HTMLForm::setSubmitProgressive() is deprecated. No need to call it. Submit
   button is already marked as progressive.
+* Skin::setupSkinUserCss() is deprecated. Adding of modules to load
+  has been centralised to Skin::getDefaultModules(), which is now capable
+  of queueing style modules as well.
+* OutputPage::addModuleScripts() and ParserOutput::addModuleScripts are
+  deprecated. Use addModules() instead.
+* Overriding SearchEngine::{searchText,searchTitle,searchArchiveTitle}
+  in extending classes is deprecated.  Extend related doSearch* methods
+  instead.
 
 === Other changes in 1.32 ===
 * …
 
 == Compatibility ==
-MediaWiki 1.32 requires PHP 5.5.9 or later. Although HHVM 3.18.5 or later is supported,
-it is generally advised to use PHP 5.5.9 or later for long term support.
+MediaWiki 1.32 requires PHP 5.5.9 or later. Although HHVM 3.18.5 or later is
+supported, it is generally advised to use PHP 5.5.9 or later for long term
+support.
 
 MySQL/MariaDB is the recommended DBMS. PostgreSQL or SQLite can also be used,
 but support for them is somewhat less mature. There is experimental support for