RELEASE-NOTES

   1 = MediaWiki release notes =
   2
   3 Security reminder: MediaWiki does not require PHP's register_globals
   4 setting since version 1.2.0. If you have it on, turn it *off* if you can.
   5
   6 == MediaWiki 1.11 ==
   7
   8 THIS IS NOT A RELEASE YET.
   9
  10 MediaWiki is now using a "continuous integration" development model with
  11 quarterly snapshot releases. The latest development code is always kept
  12 "ready to run", and in fact runs our own sites on Wikipedia.
  13
  14 Release branches will continue to receive security updates for about a year
  15 from first release, but nonessential bugfixes and feature developments
  16 will be made on the development trunk and appear in the next quarterly release.
  17
  18 Those wishing to use the latest code instead of a branch release can obtain
  19 it from source control: http://www.mediawiki.org/wiki/Download_from_SVN
  20
  21 == Configuration changes since 1.10 ==
  22
  23 * $wgThumbUpright - Adjust width of upright images when parameter 'upright' is
  24   used
  25 * $wgAddGroups, $wgRemoveGroups - Finer control over who can assign which
  26   usergroups
  27 * $wgEnotifImpersonal, $wgEnotifUseJobQ - Bulk mail options for large sites
  28
  29 == New features since 1.10 ==
  30
  31 * (bug 8868) Separate "blocked" message for autoblocks
  32 * Adding expiry of block to block messages
  33 * Links to redirect pages in categories are wrapped in
  34   <span class="redirect-in-category"></span>
  35 * Introduced 'ImageOpenShowImageInlineBefore' hook; see docs/hooks.txt for
  36   more information
  37 * (bug 9628) Show warnings about slave lag on Special:Contributions,
  38   Special:Watchlist
  39 * (bug 8818) Expose "wpDestFile" as parameter $1 to "uploaddisabledtext"
  40 * Introducing new image keyword 'upright' and corresponding variable
  41   $wgThumbUpright. This allows better proportional view of upright images
  42   related to landscape images on a page without nailing the width of upright
  43   images to a fix value which makes views for anon unproportional and user
  44   preferences useless
  45 * (bug 6072) Introducing 'border' keyword to the [[Image:]] syntax
  46 * Introducing 'frameless' keyword to [[Image:]] syntax which respects the
  47   user preferences for image width like 'thumb' but without a frame.
  48 * (bug 7960) Link to "what links here" for each "what links here" entry
  49 * Added support for configuration of an arbitrary number of commons-style
  50   file repositories.
  51 * Added a Content-Disposition header to thumb.php output
  52 * Improved thumb.php error handling
  53 * Display file history on local image description pages of shared images
  54 * Added $wgArticleRobotPolicies
  55 * (bug 10076) Additional parameter $7 added to MediaWiki:Blockedtext
  56   containing, the ip, ip range, or username whose block is affecting the
  57 * (bug 7691) Show relevant lines from the deletion log when re-creating a
  58   previously deleted article
  59 * Added variables 'wgRestrictionEdit' and 'wgRestrictionMove' for JS to header
  60 * (bug 9898) Allow viewing all namespaces in Special:Newpages
  61 * (bug 10139) Introduce 'EditSectionLink' and 'EditSectionLinkForOther' hooks;
  62   see docs/hooks.txt for details
  63 * (bug 9769) Provide "watch this page" toggle on protection form
  64 * (bug 9886) Provide clear example "stub link" in Special:Preferences
  65 * (bug 10055) Populate email address and real name properties of User objects
  66   passed to the 'AbortNewAccount' hook
  67 * Show result of Special:Booksources in wiki content language always, it's
  68   normally better maintained than the generic list from the standard message
  69   files
  70 * (bug 7997) Allow users to be blocked from using Special:Emailuser
  71 * (bug 8989) Blacklist 'mhtml' and 'mht' files from upload
  72 * (bug 8760) Allow wiki links in "protectexpiry" message
  73 * (bug 5908) Add "DEFAULTSORTKEY" and "DEFAULTCATEGORYSORT" aliases for
  74   "DEFAULTSORT" magic word
  75 * (bug 10181) Support the XCache object caching mechanism
  76 * (bug 9058) Introduce '--aconf' option for all maintenance scripts, to provide
  77   a path to the AdminSettings.php file
  78 * (bug 8781) Remind users to check file permissions for LocalSettings.php
  79   post-installation
  80 * Use shared.css for all skins and oldshared.css in place of common.css for
  81   pre-Monobook skins.  As always, modifications should go in-wiki to MediaWiki:
  82   Common.css and MediaWiki:Monobook.css.
  83 * (bug 8869) Introduce Special:Uncategorizedtemplates
  84 * (bug 8734) Different log message when article protection level is changed
  85 * (bug 8458, 10338) Limit custom signature length to $wgMaxSigChars Unicode
  86   characters
  87 * (bug 10096) Added an ability to query interwiki map table
  88 * On reupload, add a null revision to the image description page
  89 * Group log output by date
  90 * Kurdish interface latin/arabic writing system with transliteration
  91 * Support wiki text in all query page headers
  92 * Add 'Orphanedpages' as an alias to Special:Lonelypages
  93 * (bug 9328) Use "revision-info-current" message in place of "revision-info"
  94   when viewing the current revision of a page, if available
  95 * (bug 8890) Enable wiki text for "license" message
  96 * Throw a showstopper exception when a hook function fails to return a value.
  97   Forgetting to give a 'true' return value is a very common error which tends
  98   to cause hard-to-track-down interactions between extensions.
  99 * Use $wgJobClasses to determine the correct Job to instantiate for a particular
 100   queued task; allows extensions to introduce custom jobs
 101 * (bug 10326) AJAX-based page watching and unwatching has been cleaned up and
 102   enabled by default.
 103 * Added option to install to MyISAM
 104 * (bug 9250) Remove hardcoded minimum image name length of three characters
 105 * Fixed DISPLAYTITLE behaviour to reject titles which don't normalise to the
 106   same title as the current page, and enabled per default
 107 * Wrap site CSS and JavaScript in a <pre> tag, like user JS/CSS
 108 * (bug 10196) Add classes and dir="ltr" to the <pre>s on CSS and JS pages (new
 109   classes: mw-code, mw-css, mw-js)
 110 * (bug 6711) Add $wgAddGroups and $wgRemoveGroups to allow finer control over
 111   usergroup assignment.
 112 * Introduce 'UserEffectiveGroups' hook; see docs/hooks.txt for more information
 113 * (bug 10387) Detect and handle '.php5' extension environments at install time
 114   Patch by Edward Z. Yang.
 115 * Introduce 'ShowRawCssJs' hook; see docs/hooks.txt for more information
 116 * (bug 10404) Show rights log for the selected user in Special:Userrights
 117 * New javascript for upload page that will show a warning if a file with the
 118   "destination filename" already exists.
 119 * Add 'editsection-brackets' message to allow localization (or removal) of the
 120   brackets in the "[edit]" link for sections
 121 * (bug 10437) Move texvc styling to shared.css
 122 * (bug 10438) HTML TeX formulas should not wrap
 123 * Introduce "raw editing" mode for the watchlist, to allow bulk additions,
 124   removals, and convenient exporting of watchlist contents
 125 * Put an (undo) button on the page history page, for people with rollback
 126   permission only.
 127
 128 == Bugfixes since 1.10 ==
 129
 130 * (bug 9712) Use Arabic comma in date/time formats for Arabic and Farsi
 131 * (bug 9670) Follow redirects when render edit section links to transcluded
 132   templates.
 133 * (bug 6204) Fix incorrect unindentation with $wgMaxTocLevel
 134 * (bug 3431) Suppress "next page" link in Special:Search at end of results
 135 * Don't show unblock form if the user doesn't have permission to use it
 136   (cosmetic change, no vulnerabilities existed)
 137 * Subtitle success message when unblocking a block ID instead of a pseudo link
 138   like [[User:#123|#123]]
 139 * Use the standard HTTP fetch functions when retrieving remote wiki pages
 140   through transwiki, so we can take advantage of cURL goodies if available
 141 * Disable user JavaScript on Special:Userlogin, Special:Resetpass and
 142   Special:Preferences, to avoid a compromised script sniffing passwords, etc.
 143 * (bug 9854, 3770) Clip overflow text in gallery boxes for visual cleanliness
 144   instead of letting it flow outside the box or trigger ugly scroll bars.
 145 * Tooltips for print version and permalink
 146 * Links to the MediaWiki namespace for system messages having their default
 147   values are no longer shown as nonexistent (e.g., in red)
 148 * Special:Ipblocklist differentiates between empty list and no search results.
 149 * (bug 5375) profiling does not respect read-only mode.
 150 * (bug 7070) monobook/user.gif has antialias artifacts
 151 * (bug 9123) Safer way when applying $wgLocalTZoffset
 152 * (bug 9896) Documentation for $wgSquidServers and X-FORWARDED-FOR
 153 * (bug 9417) Uploading new versions of images when using Postgres no longer
 154   throws warnings.
 155 * (bug 9908) Using tsearch2 with Postgres 8.1 no longer gives an error.
 156 * (bug 1438) Fix for diff table layout on very wide lines.
 157   Diff style rules have been broken out to common/diff.css,
 158   and the dupes removed from the default skin files.
 159   Skins can still override the default rules.
 160 * (bug 1229) Balance columns in diff display evenly
 161 * Right-align diff line numbers in RTL language display
 162 * (bug 9332) Fix instructions in tests/README
 163 * (bug 9813) Reject usernames containing '#' to avoid silent truncation
 164   of fragments during the normalisation process
 165 * (bug 7989) RSS feeds content now use black text when using white background.
 166 * (bug 9971) Typo in a french language message.
 167 * (bug 9973) Changed size was shown in advanced recentchanges collapsible items
 168   with $wgRCShowChangedSized = false.
 169 * Fix PHP strict standards warning in enhanced recent changes.
 170 * (bug 5850) Added hexadecimal html entities comments for $digitTransformTable
 171   entries.
 172 * (bug 7432) Change language name for Aromanian (roa-rup)
 173 * (bug 908) Unexistent special pages now generate a red link.
 174 * (bug 7899) Added \hline and \vline to the list of allowed TeX commands
 175 * (bug 7993) support mathematical symbol classes
 176 * (bug 10007) Allow Block IP to work with Postgrs again.
 177 * Add Google Wireless Transcoder to the Unicode editing blacklist
 178 * (bug 10083) Fix for Special:Version breakage on PHP 5.2 with some hooks
 179 * (bug 3624) TeX: \ker, \hom, \arg, \dim treated like \sin & \cos
 180 * (bug 10132, 10134) Restore back-compatibility Image::imageUrl() function
 181 * (bug 10113) Fix double-click for view source on protected pages
 182 * (bug 10117) Special:Wantedpages doesn't handle invalid titles in result
 183   set [now prints out a warning]
 184 * (bug 10118) Introduced Special:Mostlinkedtemplates, report which lists
 185   templates with a high number of inclusion links
 186 * (bug 10104) Fixed Database::getLag() for PostgreSQL and Oracle
 187 * (bug 9820) session.save_path check no longer halts installation, but
 188   warns of possible bad values
 189 * (bug 9978) Fixed session.save_path validation when using extended
 190   configuration format, e.g. "5;/tmp"
 191 * Don't generate a diff link in the patrol log if the page doesn't exist
 192 * (bug 10067) Translations for former skins removed from message files
 193 * (bug 9993) Force $wgShowExceptionDetails on during installation
 194 * (bug 9980) Validate administrator username and password during
 195   installation
 196 * (bug 9383) Don't set a default value for BLOB column in rc-deleted
 197   database patch
 198 * (bug 10149) Don't show full template list on section-0 edit
 199 * (bug 9909) Ensure access to binary fields in the math table use encodeBlob()
 200   and decodeBlob()
 201 * (bug 6743) Don't link broken image links to the upload form when uploads
 202   are disabled
 203 * (bug 9679) Improve documentation for $wgSiteNotice
 204 * (bug 10215) Show custom editing introduction when editing existing pages
 205 * (bug 10223) Fix edit link in noarticletext localizations for fr, oc
 206 * (bug 10247) Fix IP address regex to avoid false positive IPv6 matches
 207 * (bug 9948) Workaround for diff regression with old Mozilla versions
 208 * (bug 10265) Fix regression in category image gallery paging
 209 * (bug 8577) Fix some weird misapplications of time zones.
 210   {{CURRENT*}} functions now consistently use UTC as intended, while
 211   {{LOCAL*}} functions return local time per server config or $wgLocaltimezone.
 212   Signature dates for Japanese and other languages including weekday now show
 213   the correct day to match the rest of the time in local time.
 214 * Escape the output of magic variables that return page name or part of it
 215 * (bug 10309) Initialise parser state properly in extractSections(), fixes
 216   some cases where section edits broke because tags were improperly stripped
 217 * Avoid PHP notice errors when doing HTTP proxy purges for an empty list
 218 * As intended, *skip* the HTTP proxy purges when doing HTCP purges
 219 * (bug 9696) Fix handling of brace transformations in "pagemovedtext"
 220 * (bug 10325) Fix regression in form action on Special:Listusers
 221 * Fixed installation on MyISAM or old InnoDB with charset=utf8, was giving
 222   overlong key errors.
 223 * Fixed zero-padding issues with MySQL 5 binary schema
 224 * (bug 10344) Don't follow a redirect after changing its protection level
 225 * (bug 10333) Correct date format in Slovenian
 226 * (bug 10160) Show error message for unknown namespace on Special:Allpages and
 227   Special:Prefixindex; making forms prettier for RTL wikis.
 228 * (bug 10334) Replace normal spaces before percent (%) signs with non-breaking
 229   spaces
 230 * (bug 10372) namespaceDupes.php no longer ignores namespace aliases
 231 * (bug 10198) namespaceDupes.php no longer ignores interwiki prefixes
 232 * namespaceDupes.php should work better for initial-lowercase wikis
 233 * (bug 10377) "Permanent links" to revisions still work if the page is moved
 234   and the redirect deleted
 235 * (bug 7071) Properly handle an 'oldid' passed to view or edit that doesn't
 236   match the given title. Fixes inconsistencies with talk, history, edit links.
 237 * (bug 10397) Fix AJAX watch error fallback when we receive a bogus result
 238 * (bug 10396) Fix AJAX error when $wgScriptPath/index.php is not valid;
 239   using $wgScript now included in JS info
 240 * Use native XMLHttpRequest class in preference to ActiveX on IE 7; this
 241   avoids the "ActiveX "Do you want to allow ActiveX?" prompt when something
 242   security settings are cranked this way and AJAX-y gets used.
 243 * Delay AJAX watch initialization until click so IE 6 with ugly security
 244   settings doesn't prompt you until you use the link.
 245 * (bug 10401) Provide non-redirecting link to original title in Special:Movepage
 246 * Fix broken handling of log views for page titles consisting of one
 247   or more zeros, e.g. "0", "00" etc.
 248 * Fix read permission check for special pages with subpage parameters, e.g.
 249   Special:Confirmemail
 250 * Fix read permission check for unreadable page titles which are numerically
 251   equivalent to a whitelisted title
 252 * '?>' closing tag removed from all files to help avoid problems with extraneous
 253   whitespace (broken XML feeds, etc.)
 254 * Don't use garbled parser cache output when viewing custom CSS or JavaScript
 255   pages
 256 * (bug 10406) Fix Special:Listusers filter form for non-ASCII localizations
 257 * Fix empty message checks for message names containing &
 258   This corrects some odd behavior with sidebar items and custom namespaces
 259   containing ampersands.
 260 * (bug 10375) Change thousands separator character to &nbsp; for Latin (la)
 261
 262
 263 == API changes since 1.10 ==
 264
 265 (For ongoing development discussion, see http://www.mediawiki.org/wiki/API)
 266
 267 * New properties: links, templates, images, langlinks, categories, external
 268   links
 269 * Breaking Change: imagelinks renamed into imageusage (il->iu)
 270 * Bug fix: incorrect generator behavior in some cases
 271 * JSON format allows an optional callback function to wrap the result.
 272 * Login module disabled until a more secure solution can be implemented
 273 * (bug 9938) Querying by revision identifier returns the most recent revision
 274   for the corresponding page, rather than the requested revision
 275 * (bug 8772) Filter page revision queries by user
 276 * (bug 9927) User contributions queries do not accept IP addresses
 277 * Watchlist feed now reports a proper feed item when the user is not logged in
 278 * Watchlist feed date bug fixed - automatically shows one last day
 279 * Watchlist feed now allows to specify number of hours to monitor
 280 * list=allpages now returns a list instead of a map in JSON format
 281 * Breaking Change: in json, revisions are now returned as a list, not as a map.
 282 * Add: prop=info can show page is new flag, current page length, and visit
 283   counter.
 284 * Change: Query watchlist now shows flags only when explicitly requested with
 285   wlparam=flags
 286 * rc_this_oldid (textid) is no longer accessible from query watchlist
 287 * action=usercontribs: additional filtering by ucshow=; selection of needed
 288   fields with ucprop=; the textid (rev_text_id) is no longer being exposed
 289 * (bug 9970) Breaking Change: backlinks, embeddedin and imageusage now return
 290   lists in JSON instead of a map, and do not return anything when titles do
 291   not exist
 292 * (bug 9121) Introduced indexpageids query parameter to list the page_id
 293   values of all returned page items
 294 * (bug 10147) Now interwiki titles are not processed but added to a separate
 295   "interwiki" section of the output.
 296 * Added categorymembers list to query for pages in a category.
 297 * (bug 10260) Show page protection status
 298 * (bug 10392) Include MediaWiki version details in version output
 299 * (bug 10411) Site language in meta=siteinfo
 300 * (bug 10391) action=help doesn't return help if format is fancy markup
 301 * (bug 10297) include previous revision ID in prop=revisions
 302 * backlinks, embeddedin and imageusage lists should use (bl|ei|iu)title parameter
 303   instead of titles. Titles for these lists is obsolete and might stop working soon.
 304
 305 == Maintenance script changes since 1.10 ==
 306
 307 * Add support for wgMaxTocLevel option in parserTests
 308 * (bug 6823) Disable article view counter in maintenance/dumpHTML.php
 309 * Fix maintenance/importImages.php so it doesn't barf PHP errors when no
 310   suitable files are found, and make the list of extensions an option (defaults
 311   to $wgFileExtensions)
 312
 313 == Languages updated since 1.10 ==
 314
 315 * Arabic (ar)
 316 * Bulgarian (bg)
 317 * Catalan (ca)
 318 * Danish (da)
 319 * German (de)
 320 * Greek (el)
 321 * Spanish (es)
 322 * Farsi (fa)
 323 * Finnish (fi)
 324 * Võro (fiu-vro)
 325 * French (fr)
 326 * Galician (gl)
 327 * Hakka (hak)
 328 * Hebrew (he)
 329 * Indonesian (id)
 330 * Italian (it)
 331 * Japanese (ja)
 332 * Georgian (ka)
 333 * Kabyle (kab)
 334 * Kazakh (kk)
 335 * Kurdish (ku)
 336 * Latin (la)
 337 * Lithuanian (lt)
 338 * Malayalam (ml)
 339 * Burmese (my)
 340 * Norwegian (no)
 341 * Polish (pl)
 342 * Portuguese (pt)
 343 * Romanian (ro)
 344 * Russian (ru)
 345 * Slovak (sk)
 346 * Slovenian (sl)
 347 * Shona (sn)
 348 * Somali (so)
 349 * Albanian (sq)
 350 * Sundanese (su)
 351 * Swedish (sv)
 352 * Tigrinya (ti)
 353 * Volapük (vo)
 354 * Old Chinese / Late Middle Chinese (zh-classical)
 355 * Chinese (PRC) (zh-cn)
 356 * Chinese (Taiwan) (zh-tw)
 357 * Cantonese (zh-yue)
 358
 359 == Compatibility ==
 360
 361 MediaWiki 1.11 requires PHP 5 (5.1 recommended). PHP 4 is no longer supported.
 362
 363 PHP 5.0.x fails on 64-bit systems due to serious bugs with array processing:
 364 http://bugs.php.net/bug.php?id=34879
 365 Upgrade affected systems to PHP 5.1 or higher.
 366
 367 MySQL 3.23.x is no longer supported; some older hosts may need to upgrade.
 368 At this time we still recommend 4.0, but 4.1/5.0 will work fine in most cases.
 369
 370
 371 == Upgrading ==
 372
 373 1.11 has several database changes since 1.10, and will not work without schema
 374 updates.
 375
 376 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
 377 new database fields are filled with data.
 378
 379 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
 380 changes are made, and there is a slightly higher chance that things could
 381 break. Don't forget to always back up your database before upgrading!
 382
 383 See the file UPGRADE for more detailed upgrade instructions.
 384
 385 === Caveats ===
 386
 387 Some output, particularly involving user-supplied inline HTML, may not
 388 produce 100% valid or well-formed XHTML output. Testers are welcome to
 389 set $wgMimeType = "application/xhtml+xml"; to test for remaining problem
 390 cases, but this is not recommended on live sites. (This must be set for
 391 MathML to display properly in Mozilla.)
 392
 393
 394 For notes on 1.10.x and older releases, see HISTORY.
 395
 396
 397 === Online documentation ===
 398
 399 Documentation for both end-users and site administrators is currently being
 400 built up on MediaWiki.org, and is covered under the GNU Free Documentation
 401 License (except for pages that explicitly state that their contents are in
 402 the public domain) :
 403
 404   http://www.mediawiki.org/wiki/Documentation
 405
 406
 407 === Mailing list ===
 408
 409 A MediaWiki-l mailing list has been set up distinct from the Wikipedia
 410 wikitech-l list:
 411
 412   http://lists.wikimedia.org/mailman/listinfo/mediawiki-l
 413
 414 A low-traffic announcements-only list is also available:
 415
 416   http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
 417
 418 It's highly recommended that you sign up for one of these lists if you're
 419 going to run a public MediaWiki, so you can be notified of security fixes.
 420
 421
 422 === IRC help ===
 423
 424 There's usually someone online in #mediawiki on irc.freenode.net