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 * Show "undo" links in page histories
 126 * Option to jump to specified time period in user contributions
 127 * Improved feedback on "rollback success" page
 128 * Show distinct 'namespaceprotected' message to users when namespace protection
 129   prevents page editing
 130
 131 == Bugfixes since 1.10 ==
 132
 133 * (bug 9712) Use Arabic comma in date/time formats for Arabic and Farsi
 134 * (bug 9670) Follow redirects when render edit section links to transcluded
 135   templates.
 136 * (bug 6204) Fix incorrect unindentation with $wgMaxTocLevel
 137 * (bug 3431) Suppress "next page" link in Special:Search at end of results
 138 * Don't show unblock form if the user doesn't have permission to use it
 139   (cosmetic change, no vulnerabilities existed)
 140 * Subtitle success message when unblocking a block ID instead of a pseudo link
 141   like [[User:#123|#123]]
 142 * Use the standard HTTP fetch functions when retrieving remote wiki pages
 143   through transwiki, so we can take advantage of cURL goodies if available
 144 * Disable user JavaScript on Special:Userlogin, Special:Resetpass and
 145   Special:Preferences, to avoid a compromised script sniffing passwords, etc.
 146 * (bug 9854, 3770) Clip overflow text in gallery boxes for visual cleanliness
 147   instead of letting it flow outside the box or trigger ugly scroll bars.
 148 * Tooltips for print version and permalink
 149 * Links to the MediaWiki namespace for system messages having their default
 150   values are no longer shown as nonexistent (e.g., in red)
 151 * Special:Ipblocklist differentiates between empty list and no search results.
 152 * (bug 5375) profiling does not respect read-only mode.
 153 * (bug 7070) monobook/user.gif has antialias artifacts
 154 * (bug 9123) Safer way when applying $wgLocalTZoffset
 155 * (bug 9896) Documentation for $wgSquidServers and X-FORWARDED-FOR
 156 * (bug 9417) Uploading new versions of images when using Postgres no longer
 157   throws warnings.
 158 * (bug 9908) Using tsearch2 with Postgres 8.1 no longer gives an error.
 159 * (bug 1438) Fix for diff table layout on very wide lines.
 160   Diff style rules have been broken out to common/diff.css,
 161   and the dupes removed from the default skin files.
 162   Skins can still override the default rules.
 163 * (bug 1229) Balance columns in diff display evenly
 164 * Right-align diff line numbers in RTL language display
 165 * (bug 9332) Fix instructions in tests/README
 166 * (bug 9813) Reject usernames containing '#' to avoid silent truncation
 167   of fragments during the normalisation process
 168 * (bug 7989) RSS feeds content now use black text when using white background.
 169 * (bug 9971) Typo in a french language message.
 170 * (bug 9973) Changed size was shown in advanced recentchanges collapsible items
 171   with $wgRCShowChangedSized = false.
 172 * Fix PHP strict standards warning in enhanced recent changes.
 173 * (bug 5850) Added hexadecimal html entities comments for $digitTransformTable
 174   entries.
 175 * (bug 7432) Change language name for Aromanian (roa-rup)
 176 * (bug 908) Unexistent special pages now generate a red link.
 177 * (bug 7899) Added \hline and \vline to the list of allowed TeX commands
 178 * (bug 7993) support mathematical symbol classes
 179 * (bug 10007) Allow Block IP to work with Postgrs again.
 180 * Add Google Wireless Transcoder to the Unicode editing blacklist
 181 * (bug 10083) Fix for Special:Version breakage on PHP 5.2 with some hooks
 182 * (bug 3624) TeX: \ker, \hom, \arg, \dim treated like \sin & \cos
 183 * (bug 10132, 10134) Restore back-compatibility Image::imageUrl() function
 184 * (bug 10113) Fix double-click for view source on protected pages
 185 * (bug 10117) Special:Wantedpages doesn't handle invalid titles in result
 186   set [now prints out a warning]
 187 * (bug 10118) Introduced Special:Mostlinkedtemplates, report which lists
 188   templates with a high number of inclusion links
 189 * (bug 10104) Fixed Database::getLag() for PostgreSQL and Oracle
 190 * (bug 9820) session.save_path check no longer halts installation, but
 191   warns of possible bad values
 192 * (bug 9978) Fixed session.save_path validation when using extended
 193   configuration format, e.g. "5;/tmp"
 194 * Don't generate a diff link in the patrol log if the page doesn't exist
 195 * (bug 10067) Translations for former skins removed from message files
 196 * (bug 9993) Force $wgShowExceptionDetails on during installation
 197 * (bug 9980) Validate administrator username and password during
 198   installation
 199 * (bug 9383) Don't set a default value for BLOB column in rc-deleted
 200   database patch
 201 * (bug 10149) Don't show full template list on section-0 edit
 202 * (bug 9909) Ensure access to binary fields in the math table use encodeBlob()
 203   and decodeBlob()
 204 * (bug 6743) Don't link broken image links to the upload form when uploads
 205   are disabled
 206 * (bug 9679) Improve documentation for $wgSiteNotice
 207 * (bug 10215) Show custom editing introduction when editing existing pages
 208 * (bug 10223) Fix edit link in noarticletext localizations for fr, oc
 209 * (bug 10247) Fix IP address regex to avoid false positive IPv6 matches
 210 * (bug 9948) Workaround for diff regression with old Mozilla versions
 211 * (bug 10265) Fix regression in category image gallery paging
 212 * (bug 8577) Fix some weird misapplications of time zones.
 213   {{CURRENT*}} functions now consistently use UTC as intended, while
 214   {{LOCAL*}} functions return local time per server config or $wgLocaltimezone.
 215   Signature dates for Japanese and other languages including weekday now show
 216   the correct day to match the rest of the time in local time.
 217 * Escape the output of magic variables that return page name or part of it
 218 * (bug 10309) Initialise parser state properly in extractSections(), fixes
 219   some cases where section edits broke because tags were improperly stripped
 220 * Avoid PHP notice errors when doing HTTP proxy purges for an empty list
 221 * As intended, *skip* the HTTP proxy purges when doing HTCP purges
 222 * (bug 9696) Fix handling of brace transformations in "pagemovedtext"
 223 * (bug 10325) Fix regression in form action on Special:Listusers
 224 * Fixed installation on MyISAM or old InnoDB with charset=utf8, was giving
 225   overlong key errors.
 226 * Fixed zero-padding issues with MySQL 5 binary schema
 227 * (bug 10344) Don't follow a redirect after changing its protection level
 228 * (bug 10333) Correct date format in Slovenian
 229 * (bug 10160) Show error message for unknown namespace on Special:Allpages and
 230   Special:Prefixindex; making forms prettier for RTL wikis.
 231 * (bug 10334) Replace normal spaces before percent (%) signs with non-breaking
 232   spaces
 233 * (bug 10372) namespaceDupes.php no longer ignores namespace aliases
 234 * (bug 10198) namespaceDupes.php no longer ignores interwiki prefixes
 235 * namespaceDupes.php should work better for initial-lowercase wikis
 236 * (bug 10377) "Permanent links" to revisions still work if the page is moved
 237   and the redirect deleted
 238 * (bug 7071) Properly handle an 'oldid' passed to view or edit that doesn't
 239   match the given title. Fixes inconsistencies with talk, history, edit links.
 240 * (bug 10397) Fix AJAX watch error fallback when we receive a bogus result
 241 * (bug 10396) Fix AJAX error when $wgScriptPath/index.php is not valid;
 242   using $wgScript now included in JS info
 243 * Use native XMLHttpRequest class in preference to ActiveX on IE 7; this
 244   avoids the "ActiveX "Do you want to allow ActiveX?" prompt when something
 245   security settings are cranked this way and AJAX-y gets used.
 246 * Delay AJAX watch initialization until click so IE 6 with ugly security
 247   settings doesn't prompt you until you use the link.
 248 * (bug 10401) Provide non-redirecting link to original title in Special:Movepage
 249 * Fix broken handling of log views for page titles consisting of one
 250   or more zeros, e.g. "0", "00" etc.
 251 * Fix read permission check for special pages with subpage parameters, e.g.
 252   Special:Confirmemail
 253 * Fix read permission check for unreadable page titles which are numerically
 254   equivalent to a whitelisted title
 255 * '?>' closing tag removed from all files to help avoid problems with extraneous
 256   whitespace (broken XML feeds, etc.)
 257 * Don't use garbled parser cache output when viewing custom CSS or JavaScript
 258   pages
 259 * (bug 10406) Fix Special:Listusers filter form for non-ASCII localizations
 260 * Fix empty message checks for message names containing &
 261   This corrects some odd behavior with sidebar items and custom namespaces
 262   containing ampersands.
 263 * (bug 10375) Change thousands separator character to &nbsp; for Latin (la)
 264 * (bug 10477) Fix AJAX watch for Farsi on Firefox: JavaScript encoding tweak
 265 * (bug 10496) Fix broken DISTINCT option logic in database backend
 266 * Fix CSS media declaration for "screen, projection"; was causing some
 267   validation issues
 268 * (bug 10495) $wgMemcachedDebug set twice in includes/DefaultSettings.php
 269 * (bug 10316) Prevent inconsistent cached skin settings in gen=js by setting
 270   the intended skin directly in the URL.
 271 * (bug 9903) Don't mark redirects in categories as stubs
 272
 273
 274 == API changes since 1.10 ==
 275
 276 Full API documentation is available at http://www.mediawiki.org/wiki/API
 277
 278 * New properties: links, templates, images, langlinks, categories, external
 279   links
 280 * Breaking Change: imagelinks renamed into imageusage (il->iu)
 281 * Bug fix: incorrect generator behavior in some cases
 282 * JSON format allows an optional callback function to wrap the result.
 283 * Login module disabled until a more secure solution can be implemented
 284 * (bug 9938) Querying by revision identifier returns the most recent revision
 285   for the corresponding page, rather than the requested revision
 286 * (bug 8772) Filter page revision queries by user
 287 * (bug 9927) User contributions queries do not accept IP addresses
 288 * Watchlist feed now reports a proper feed item when the user is not logged in
 289 * Watchlist feed date bug fixed - automatically shows one last day
 290 * Watchlist feed now allows to specify number of hours to monitor
 291 * list=allpages now returns a list instead of a map in JSON format
 292 * Breaking Change: in json, revisions are now returned as a list, not as a map.
 293 * Add: prop=info can show page is new flag, current page length, and visit
 294   counter.
 295 * Change: Query watchlist now shows flags only when explicitly requested with
 296   wlparam=flags
 297 * rc_this_oldid (textid) is no longer accessible from query watchlist
 298 * action=usercontribs: additional filtering by ucshow=; selection of needed
 299   fields with ucprop=; the textid (rev_text_id) is no longer being exposed
 300 * (bug 9970) Breaking Change: backlinks, embeddedin and imageusage now return
 301   lists in JSON instead of a map, and do not return anything when titles do
 302   not exist
 303 * (bug 9121) Introduced indexpageids query parameter to list the page_id
 304   values of all returned page items
 305 * (bug 10147) Now interwiki titles are not processed but added to a separate
 306   "interwiki" section of the output.
 307 * Added categorymembers list to query for pages in a category.
 308 * (bug 10260) Show page protection status
 309 * (bug 10392) Include MediaWiki version details in version output
 310 * (bug 10411) Site language in meta=siteinfo
 311 * (bug 10391) action=help doesn't return help if format is fancy markup
 312 * (bug 10297) include previous revision ID in prop=revisions
 313 * backlinks, embeddedin and imageusage lists should use (bl|ei|iu)title parameter
 314   instead of titles. Titles for these lists is obsolete and might stop working soon.
 315 * Added prop=imageinfo - gets image properties and upload history
 316 * (bug 10211) Added db server replication lag information in meta=siteinfo
 317 * Added external url search within wiki pages (list=exturlusage)
 318 * Added link enumeration (list=alllinks)
 319 * Added registered users enumeration (list=allusers)
 320
 321 == Maintenance script changes since 1.10 ==
 322
 323 * Add support for wgMaxTocLevel option in parserTests
 324 * (bug 6823) Disable article view counter in maintenance/dumpHTML.php
 325 * Fix maintenance/importImages.php so it doesn't barf PHP errors when no
 326   suitable files are found, and make the list of extensions an option (defaults
 327   to $wgFileExtensions)
 328 * Add option to maintenance/createAndPromote.php to give the user bureaucrat
 329   permissions (--bureaucrat)
 330
 331 == Languages updated since 1.10 ==
 332
 333 * Arabic (ar)
 334 * Bulgarian (bg)
 335 * Catalan (ca)
 336 * Danish (da)
 337 * German (de)
 338 * Greek (el)
 339 * Spanish (es)
 340 * Farsi (fa)
 341 * Finnish (fi)
 342 * Võro (fiu-vro)
 343 * French (fr)
 344 * Galician (gl)
 345 * Hakka (hak)
 346 * Hebrew (he)
 347 * Indonesian (id)
 348 * Italian (it)
 349 * Japanese (ja)
 350 * Georgian (ka)
 351 * Kabyle (kab)
 352 * Kazakh (kk)
 353 * Kurdish (ku)
 354 * Latin (la)
 355 * Lithuanian (lt)
 356 * Malayalam (ml)
 357 * Burmese (my)
 358 * Dutch (nl)
 359 * Norwegian (no)
 360 * Polish (pl)
 361 * Piedmontese (pms)
 362 * Portuguese (pt)
 363 * Romanian (ro)
 364 * Aromanian (roa-rup)
 365 * Russian (ru)
 366 * Slovak (sk)
 367 * Slovenian (sl)
 368 * Shona (sn)
 369 * Somali (so)
 370 * Albanian (sq)
 371 * Sundanese (su)
 372 * Swedish (sv)
 373 * Tigrinya (ti)
 374 * Volapük (vo)
 375 * Old Chinese / Late Middle Chinese (zh-classical)
 376 * Chinese (PRC) (zh-cn)
 377 * Chinese (Taiwan) (zh-tw)
 378 * Cantonese (zh-yue)
 379
 380 == Compatibility ==
 381
 382 MediaWiki 1.11 requires PHP 5 (5.1 recommended). PHP 4 is no longer supported.
 383
 384 PHP 5.0.x fails on 64-bit systems due to serious bugs with array processing:
 385 http://bugs.php.net/bug.php?id=34879
 386 Upgrade affected systems to PHP 5.1 or higher.
 387
 388 MySQL 3.23.x is no longer supported; some older hosts may need to upgrade.
 389 At this time we still recommend 4.0, but 4.1/5.0 will work fine in most cases.
 390
 391
 392 == Upgrading ==
 393
 394 1.11 has several database changes since 1.10, and will not work without schema
 395 updates.
 396
 397 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
 398 new database fields are filled with data.
 399
 400 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
 401 changes are made, and there is a slightly higher chance that things could
 402 break. Don't forget to always back up your database before upgrading!
 403
 404 See the file UPGRADE for more detailed upgrade instructions.
 405
 406 === Caveats ===
 407
 408 Some output, particularly involving user-supplied inline HTML, may not
 409 produce 100% valid or well-formed XHTML output. Testers are welcome to
 410 set $wgMimeType = "application/xhtml+xml"; to test for remaining problem
 411 cases, but this is not recommended on live sites. (This must be set for
 412 MathML to display properly in Mozilla.)
 413
 414
 415 For notes on 1.10.x and older releases, see HISTORY.
 416
 417
 418 === Online documentation ===
 419
 420 Documentation for both end-users and site administrators is currently being
 421 built up on MediaWiki.org, and is covered under the GNU Free Documentation
 422 License (except for pages that explicitly state that their contents are in
 423 the public domain) :
 424
 425   http://www.mediawiki.org/wiki/Documentation
 426
 427
 428 === Mailing list ===
 429
 430 A MediaWiki-l mailing list has been set up distinct from the Wikipedia
 431 wikitech-l list:
 432
 433   http://lists.wikimedia.org/mailman/listinfo/mediawiki-l
 434
 435 A low-traffic announcements-only list is also available:
 436
 437   http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
 438
 439 It's highly recommended that you sign up for one of these lists if you're
 440 going to run a public MediaWiki, so you can be notified of security fixes.
 441
 442
 443 === IRC help ===
 444
 445 There's usually someone online in #mediawiki on irc.freenode.net