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.13 ==
   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 in 1.13 ===
  22
  23 * New option $wgFeed can be set false to turn off syndication feeds
  24 * (bug 5745) Special:Whatlinkshere now shows up to $wgMaxRedirectLinksRetrieved
  25   links through each redirect instead of hardcoded 500
  26 * Set $wgUploadSizeWarning to false by default
  27 * Added $wgLBFactoryConf, for generic configuration of multi-master wiki farms
  28 * Removed $wgAlternateMaster, use $wgLBFactoryConf
  29 * (bug 13562) Misspelled option $wgUserNotifedOnAllChanges changed to
  30   $wgUserNotifiedOnAllChanges
  31
  32 === New features in 1.13 ===
  33
  34 * __HIDDENCAT__ on a category page causes the category to be hidden on the
  35   article page.
  36 * Don't show edit permissions errors on a red link click, just redirect to the
  37   article. This is so that readers who don't know what a red link is aren't
  38   confused when they are told they are range-blocked.
  39 * Add a new hook ImageBeforeProduceHTML to allow extensions to modify wikitext
  40   image syntax output.
  41 * (bug 13100) Added 'preloadtitle' parameter to action=edit&section=new that
  42   pre-fills the section title field.
  43 * (bug 13112) Added Special:RelatedChanges alias to Special:Recentchangeslinked
  44 * (bug 13130) Moved edit token and autosummary fields above edit tools to
  45   reduce broken form submissions
  46 * Add --old-redirects-only option to maintenance/refreshLinks.php, to add old
  47   redirects to the redirect table
  48 * Add links to page and file deletion forms to edit predefined delete reasons
  49 * (bug 13269) Added MediaWiki:Uploadfooter to the bottom of Special:Upload
  50 * (bug 2815) Search results for media now use thumb instead of text extract
  51 * When a page doesn't exist, the tab should say "create", not "edit"
  52 * (bug 12882) Added a span with class "patrollink" arround "Mark as patrolled"
  53   link on diffs
  54 * Magic word formatnum can now take raw suffix to undo formatting
  55 * Add updatelog table to reliably permit updates that don't change the schema
  56 * Add category table to allow better tracking of category membership counts
  57 ** (bug 1212) Give correct membership counts on the pages of large categories
  58 ** Use category table for more efficient display of Special:Categories
  59 * (bug 1459) Search for duplicate files by hash: Special:FileDuplicateSearch
  60 * (bug 9447) Added hooks for search result headings
  61 * Image redirects are now enabled
  62 * (bug 13450) Email confirmation can now be canceled before the expiration
  63 * (bug 13490) Show upload/file size limit on upload form
  64 * Redesign of Special:Userrights
  65 * Make rev_deleted log entries more intelligible.
  66 * (bug 6943) Added PAGESINCATEGORY: magic word
  67 * (bug 13604) Added Special:ListGroupRights
  68 * Added message 'mainpage-description' as duplicate of 'mainpage' and added it
  69   to message 'sidebar'
  70 ** (bug 6332) Lacking entry Mainpage-url
  71 ** (bug 8617) Separate main page url and name
  72 * Automatically add old redirects to the redirect table when needed
  73 * (bug 6934) Allow separated inclusions, links, redirects on whatlinkshere
  74 * Add a footer (emailuser-footer) to the bottom of messages sent with
  75   Special:EmailUser
  76 * Cache image redirects
  77
  78 === Bug fixes in 1.13 ===
  79
  80 * (bug 10677) Add link to the file description page on the shared repository
  81 * (bug 13084) Increase size of source/destination filename fields in upload form
  82 * (bug 13115) rebuildrecentchanges should print the current value of $wgRCMaxAge
  83 * (bug 13140) Show parent categories in category namespace
  84 * (bug 13149) Correctly format 'fileexists' message on Upload page
  85 * Make the default filepageexists message accurate
  86 * (bug 12988) $wgMinimalPasswordLength no longer breaks create user by email
  87 * (bug 13022) Fix upload from URL on PHP 5.0.x
  88 * (bug 13132) Unable to unprotect pages protected with earlier versions of MediaWiki
  89 * (bug 12723) OpenSearch description name now uses more compact language code
  90   to avoid passing the length limit as often, is customizable per site via
  91   'opensearch-desc' message.
  92 * (bug 13135) Special:Userrights now passes IDs through form submission
  93   to allow functionality on not-quite-right usernames
  94 * (bug 12575) Prevent duplicate patrol log entries from being created
  95 * (bug 13174) __HIDDENCAT__ now applies only to category pages
  96 * (bug 13031) Add links to user pages in e-mail form
  97 * (bug 13147) Description for categoriespagetext (used in Special:Categories) reworded
  98 * (bug 11561) Fix fatal error when calling action=revert to non-image page
  99 * (bug 12430) Fix call to private method LinkFilter::makeRegex fatal error in
 100   maintenance/cleanupSpam.php
 101 * All skins should have the "mediawiki" class on the body element
 102 * (bug 13019) Message cache for some extensions not loaded at time of editing
 103 * (bug 13247) Prettified ISBN links
 104 * maintenance/refreshLinks.php did not fix page_id 1 with the --new-only option
 105 * (bug 13110) Don't show "Permission error" page if the edit is already rolled
 106   back when using rollback
 107 * (bug 13012) Use content messages for block options when generating the
 108   recentchanges entry
 109 * (bug 13274) Change links for messages to ucfirst
 110 * (bug 13273) Un-hardcode some punctuation (add new messages colon-separator,
 111   autocomment-prefix)
 112 * Parse MediaWiki message translations with a correct language setting on preview
 113 * (bug 13281) Treat X-Forwarded-For, Client-ip and User-Agent headers as
 114   case-insensitive names.
 115 * Adding the fix for lists in RTL wikis to more skins, and fixing the image toc
 116 * (bug 8157) Remove redirects from Special:Unusedtemplates. Patch by WebBoy.
 117 * (bug 10721) Duplicate section anchors with differing case now disambiguated
 118   for Internet Explorer's sake and standards compliance
 119 * (bug 13298) Tighter limits on Special:Newpages limits when embedding
 120 * Email subject in content language instead of sending user's UI language
 121 * (bug 13251) Allow maintenance rebuild scripts to work with Postgres
 122 * (bug 2084) Fixed incorrect regex to match redirects
 123 * (bug 3131) Manually-specified upload destination filename is no longer
 124   overwritten by browsing for a file after you wrote it.
 125 * (bug 7251) Sidebars generated by MediaWiki:Sidebar now have the class
 126   'generated-sidebar'.
 127 * (bug 13265) Media handler is missing 'image/x-bmp'
 128 * (bug 13407) MediaWiki:Powersearch is used in two places
 129 * (bug 13403) Fix cache invalidation of history pages when old revisions change
 130 * (bug 11563) Deprecated SearchMySQL4 class; merged code to SearchMySQL
 131 * (bug 12801) Fix link in subtitle message in AJAX search
 132 * (bug 13428) Fix regression in protection form layout HTML validity
 133 * (bug 9403) Sanitize newlines from search term input
 134 * (bug 13429) Separate date and time in message sp-newimages-showfrom
 135 * (bug 13137) Allow setting 'editprotected' right separately from 'protect',
 136   so groups may optionally edit protected pages without having 'protect' perms
 137 * Disallow deletion of big pages by means of moving a page to its title and
 138   using the "delete and move" option.
 139 * (bug 13466) White space differences not shown in diffs
 140 * (bug 1953) Search form now honors namespace selections more reliably
 141 * (bug 12294) Namespace class renamed to MWNamespace for PHP 5.3 compatibility
 142 * PHP 5.3 compatibility fix for wfRunHooks() called with no parameters
 143 * (bug 6447) Trackbacks now work with transactional tables, if enabled
 144 * (bug 6892, 7147) Trackback error handling, optional fields more robust
 145 * (bug 6813) Don't break HTML validator when using trackbacks
 146 * Fix for size checks on SVG images with global 'stroke-width' attribute
 147 * (bug 11874) Inline CSS with !important no longer borken
 148 * (bug 1600) Strip extra == section markup == in new-comment field
 149 * (bug 11325) Wrapped page titles in MonoBook skin spaced more nicely
 150 * (bug 12077) Fix HTML nesting for TOC
 151 * (bug 344) Purge cache for talk/article pages when deleting the other tab
 152 * (bug 13436) Treat image captions correctly when they include option keywords
 153   (like ending with "px" or starting with "upright")
 154 * Trackback display formatting fixed
 155 * Don't die when single-element arrays are passed to SQL query constructors
 156   that have an array index other than 0
 157 * (bug 13522) Fix fatal error in Parser::extractTagsAndParams
 158 * (bug 13532) Use proper timestamp call when reverting images
 159 * (bug 13543) Updated FAQ link in the installer sidebar
 160 * (bug 13540) Date format in confirmation e-mail now matches message language
 161 * (bug 13554) PHP Notice in old pre-processor when list item is empty.
 162 * (bug 13556) Don't show a blank form if no image is attached in Special:Upload
 163 * (bug 13576) maintenance/rebuildrecentchanges.php fails
 164 * (bug 13441) Allow Special:Recentchanges to show bots only
 165 * (bug 13431) Show true message source in Special:Allmessages&ot=php / xml
 166 * (bug 13463) Login successful page doesn't use user's preferred interface language
 167 * (bug 13630) Fixed warnings for pass by reference at call time in
 168   Special:Revisiondelete when generating the log entry.
 169 * (bug 12064) BeforePageDisplay hook is now called for all skins
 170 * (bug 13624) Fix regression with manual thumb= parameter on images
 171 * (bug 11039) Add missing labels on protection form
 172 * (bug 13458) Preview/edit toolbar spacing now works consistently
 173 * (bug 13433) Fix action=render on Image: pages
 174 * (bug 13678) Fix CSS validation for Monobook
 175 * (bug 13684) Links in Special:ListGroupRights should be in content language
 176 * (bug 13690) Fix PHP notice on accessing some URLs
 177 * Hide (undo) link if user isn't able to edit page
 178 * Invalidate cache of pages that includes images via redirects on upload
 179 * (bug 13705) Don't show rollback link in page history if called with dir=prev
 180 * (bug 13708) Don't set "Search results" title when loading Special:Search
 181   without query
 182 * (bug 13736) Don't show MediaWiki:Anontalkpagetext on non-existant IP addresses
 183 * (bug 13728) Don't trim initial whitespace during section edits
 184
 185
 186 === API changes in 1.13 ===
 187
 188 * Fixing main page display in meta=siteinfo
 189 * (bug 13128) Added patrolled flag to list=recentchanges
 190 * Implemented {bl,ei,iu}redirect (lists links through redirects as well)
 191 * (bug 13154) Introduced subpages flag to meta=siteinfo&siprop=namespaces
 192 * (bug 13157) Added ucuserprefix parameter to list=usercontibs
 193 * (bug 12394) Added rctitles parameter to list=recentchanges, making rcid
 194   retrieval easier
 195 * (bug 13218) Fix inclusion of " character in hyperlinks
 196 * Added watch and unwatch parameters to action=delete and action=move
 197 * Added action=edit
 198 * (bug 11401) Added xmldoublequote to xml formatter
 199 * Added rvsection parameter to prop=revisions to allow fetching the content of
 200   a certain section only
 201 * Introduced list=allimages
 202 * (bug 13371) Build page set from image hashes
 203 * Mark non-existent messages in meta=allmessages as missing
 204 * (bug 13390) One invalid title no longer kills an entire API query
 205 * (bug 13419) Fix gblredirect so it actually works
 206 * (bug 13418) Disable eiredirect because it's useless
 207 * (bug 13395) list=allcategories should use category table
 208 * (bug 13442) Missing pages in prop=langlinks and prop=extlinks are now
 209   handled properly.
 210 * (bug 13444) Add description to list=watchlist
 211 * (bug 13482) Disabled search types handled properly
 212 * Added inprop=talkid,subjectid to prop=info
 213 * Added help text message that specifies whether a module is POST-only
 214 * Added createonly parameter to action=edit
 215 * Replaced $wgAPIUCUserPrefixMinLength by the more generic $wgAPIMaxDBRows
 216 * (bug 11719) Remove trailing blanks in YAML output.
 217 * (bug 13541) Added siprop=specialpagealiases to meta=siteinfo
 218 * Added fallback8bitEncoding field to meta=siteinfo&siprop=general output
 219 * (bug 13544) Added prop=revid to action=parse
 220 * (bug 13603) Added siprop=usergroups to meta=siteinfo
 221 * Cleaned up redirect resolution
 222 * Added possibility to obtain all external links through list=exturlusage
 223 * (bug 13606) Added archivename to iiprop
 224 * (bug 11633) Explicitly convert redirect titles to strings due to PHP's
 225   very weak typing on array keys.
 226 * (bug 12136) Extend allowed characters in JSON callback to ][.'"_A-Za-z0-9
 227 * (bug 11673) Return error 'unknown_action' in specified format
 228 * (bug 13618) Added rcprop=redirect and rcshow=redirect to list=recentchanges
 229 * (bug 13544) Added oldid parameter to action=parse to allow for parsing of old revisions
 230 * (bug 13718) Return the proper continue parameter for cmsort=timestamp
 231 * action=login now returns the correct waiting time in the details property
 232
 233 === Languages updated in 1.13 ===
 234
 235 * Afrikaans (af)
 236 * Gheg Albanian (aln)
 237 * Amharic (am)
 238 * Aragonese (an)
 239 * Old English (ang)
 240 * Arabic (ar)
 241 * Aramaic (arc)
 242 * Araucanian (arn)
 243 * Egyptian Spoken Arabic (arz) (new)
 244 * Asturian (ast)
 245 * Kotava (avk)
 246 * Samogitian (bat-smg)
 247 * Bikol Central (bcl)
 248 * Belarusian (be)
 249 * Bulgarian (bg)
 250 * Bihari (bh)
 251 * Bengali (bn)
 252 * Breton (br)
 253 * Bosnian (bs)
 254 * Buginese (bug)
 255 * Catalan (ca)
 256 * Min Dong Chinese (cdo)
 257 * Corsican (co)
 258 * Crimean Turkish (Cyrillic) (crh-cyrl)
 259 * Crimean Turkish (Latin) (crh-latn)
 260 * Czech (cs)
 261 * Kashubian (csb)
 262 * Church Slavic (cu)
 263 * Welsh (cy)
 264 * Danish (da)
 265 * Zazaki (diq)
 266 * Dalecarlian (dlc)
 267 * Lower Sorbian (dsb)
 268 * Middle Dutch (dum) (removed)
 269 * Divehi (dv)
 270 * Dzongkha (dz)
 271 * Greek (el)
 272 * English (en)
 273 * British English (en-gb) (new)
 274 * Esperanto (eo)
 275 * Spanish (es)
 276 * Estonian (et)
 277 * Basque (eu)
 278 * Extremaduran (ext)
 279 * Finnish (fi)
 280 * Võro (fiu-vro)
 281 * Faroese (fo)
 282 * French (fr)
 283 * Cajun French (frc)
 284 * Franco-Provençal (frp)
 285 * Friulian (fur)
 286 * Western Frisian (fy)
 287 * Irish (ga)
 288 * Gagauz (gag)
 289 * Gan (gan)
 290 * Galician (gl)
 291 * Swiss German (gsw)
 292 * Gujarati (gu)
 293 * Hakka (hak)
 294 * Hawaiian (haw)
 295 * Hindi (hi)
 296 * Fiji Hindi (Latin) (hif-latn) (new)
 297 * Croatian (hr)
 298 * Upper Sorbian (hsb)
 299 * Haitian (ht)
 300 * Hungarian (hu)
 301 * Armenian (hy)
 302 * Interlingua (ia)
 303 * Indonesian (id)
 304 * Eastern Canadian (Unified Canadian Aboriginal Syllabics) (ike-cans)
 305 * Eastern Canadian (Latin) (ike-latn)
 306 * Iloko (ilo)
 307 * Ido (io)
 308 * Icelandic (is)
 309 * Italian (it)
 310 * Japanese (ja)
 311 * Jutish (jut)
 312 * Javanese (jv)
 313 * Georgian (ka)
 314 * Kara-Kalpak (kaa)
 315 * Kabyle (kab)
 316 * Kazakh (Arabic script) (kk-arab)
 317 * Kazakh (Cyrillic script) (kk-cyrl)
 318 * Kazakh (Latin script) (kk-latn)
 319 * Kalaallisut (kl)
 320 * Khmer (km)
 321 * Kannada (kn)
 322 * Korean (ko)
 323 * Kinaray-a (krj)
 324 * Karelian (krl)
 325 * Kurdish (Latin)‬ (ku-latn)
 326 * Latin (la)
 327 * Luxembourgish (lb)
 328 * Lezghian (lez)
 329 * Lingua Franca Nova (lfn)
 330 * Ganda (lg)
 331 * Limburgish (li)
 332 * Líguru (lij)
 333 * Lumbaart (lmo)
 334 * Lao (lo)
 335 * Lozi (loz)
 336 * Lithuanian (lt)
 337 * Latvian (lv)
 338 * Maithili (mai)
 339 * Moksha (mdf)
 340 * Malagasy (mg)
 341 * Macedonian (mk)
 342 * Malayalam (ml)
 343 * Mongolian (mn)
 344 * Moldavian (mo)
 345 * Marathi (mr)
 346 * Malay (ms)
 347 * Mirandese (mwl)
 348 * Burmese (my)
 349 * Erzya (myv)
 350 * Nahuatl (nah)
 351 * Low German (nds)
 352 * Nedersaksisch (nds-nl)
 353 * Nepali (ne)
 354 * Newari (new)
 355 * Dutch (nl)
 356 * Norwegian Nynorsk (nn)
 357 * Norwegian (bokmål)‬ (no)
 358 * Old Norse (non) (removed)
 359 * Northern Sotho (nso)
 360 * Classical Newari (nwc)
 361 * Occitan (oc)
 362 * Oriya (or)
 363 * Pampanga (pam)
 364 * Pali (pi)
 365 * Polish (pl)
 366 * Piemontèis (pms)
 367 * Pontic (pnt)
 368 * Pashto (ps)
 369 * Portuguese (pt)
 370 * Brazilian Portuguese (pt-br)
 371 * Quechua (qu)
 372 * Romani (rmy)
 373 * Romanian (ro)
 374 * Russian (ru)
 375 * Yakut (sah)
 376 * Sicilian (scn)
 377 * Scots (sco)
 378 * Sassaresu (sdc)
 379 * Northern Sami (se)
 380 * Cmique Itom (sei)
 381 * Sinhalese (si)
 382 * Slovak (sk)
 383 * Slovenian (sl)
 384 * Southern Sami (sma)
 385 * Somali (so)
 386 * Albanian (sq)
 387 * Serbian Cyrillic ekavian (sr-ec)
 388 * latinica (sr-el)
 389 * Sranan Tongo (srn)
 390 * Swati (ss)
 391 * Southern Sotho (st)
 392 * Seeltersk (stq)
 393 * Sundanese (su)
 394 * Swedish (sv)
 395 * Swahili (sw)
 396 * Silesian (szl) (new)
 397 * Tamil (ta)
 398 * Telugu (te)
 399 * Tetum (tet)
 400 * Tajik (tg-cyrl)
 401 * Thai (th)
 402 * Tigrinya (ti)
 403 * Tagalog (tl)
 404 * Tonga (to)
 405 * Toki Pona (tokipona)
 406 * Tok Pisin (tpi)
 407 * Turkish (tr)
 408 * Tatar (Cyrillic) (tt-cyrl)
 409 * Tatar (Latin) (tt-latn)
 410 * Tuvinian (tyv)
 411 * Ukrainian (uk)
 412 * Venda (ve)
 413 * Venetian (vec)
 414 * Vietnamese (vi)
 415 * Volapük (vo)
 416 * Walloon (wa)
 417 * Waray (war)
 418 * Wolof (wo)
 419 * Mingrelian (xmf)
 420 * Yiddish (yi)
 421 * Yoruba (yo)
 422 * Cantonese (yue)
 423 * Zeeuws (zea)
 424 * Old Chinese / Late Time Chinese (zh-classical)
 425 * Simplified Chinese (zh-hans)
 426 * Traditional Chinese (zh-hant)
 427 * ‪Chinese (Taiwan) (zh-tw)
 428
 429 == Compatibility ==
 430
 431 MediaWiki 1.13 requires PHP 5 (5.1 recommended). PHP 4 is no longer supported.
 432
 433 PHP 5.0.x fails on 64-bit systems due to serious bugs with array processing:
 434 http://bugs.php.net/bug.php?id=34879
 435 Upgrade affected systems to PHP 5.1 or higher.
 436
 437 MySQL 3.23.x is no longer supported; some older hosts may need to upgrade.
 438 At this time we still recommend 4.0, but 4.1/5.0 will work fine in most cases.
 439
 440
 441 == Upgrading ==
 442
 443 1.13 has several database changes since 1.12, and will not work without schema
 444 updates.
 445
 446 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
 447 new database fields are filled with data.
 448
 449 If upgrading from before 1.11, and you are using a wiki as a commons repository,
 450 make sure that it is updated as well. Otherwise, errors may arise due to
 451 database schema changes.
 452
 453 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
 454 changes are made, and there is a slightly higher chance that things could
 455 break. Don't forget to always back up your database before upgrading!
 456
 457 See the file UPGRADE for more detailed upgrade instructions.
 458
 459
 460 === Caveats ===
 461
 462 Some output, particularly involving user-supplied inline HTML, may not
 463 produce 100% valid or well-formed XHTML output. Testers are welcome to
 464 set $wgMimeType = "application/xhtml+xml"; to test for remaining problem
 465 cases, but this is not recommended on live sites. (This must be set for
 466 MathML to display properly in Mozilla.)
 467
 468 For notes on 1.12.x and older releases, see HISTORY.
 469
 470
 471 === Online documentation ===
 472
 473 Documentation for both end-users and site administrators is currently being
 474 built up on MediaWiki.org, and is covered under the GNU Free Documentation
 475 License (except for pages that explicitly state that their contents are in
 476 the public domain) :
 477
 478   http://www.mediawiki.org/wiki/Documentation
 479
 480
 481 === Mailing list ===
 482
 483 A MediaWiki-l mailing list has been set up distinct from the Wikipedia
 484 wikitech-l list:
 485
 486   http://lists.wikimedia.org/mailman/listinfo/mediawiki-l
 487
 488 A low-traffic announcements-only list is also available:
 489
 490   http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
 491
 492 It's highly recommended that you sign up for one of these lists if you're
 493 going to run a public MediaWiki, so you can be notified of security fixes.
 494
 495
 496 === IRC help ===
 497
 498 There's usually someone online in #mediawiki on irc.freenode.net