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