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.17 ==
   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.17 ===
  22 * DatabaseFunctions.php that was needed for compatibility with pre-1.3 extensions
  23   has been removed.
  24
  25 === New features in 1.17 ===
  26 * (bug 10183) Users can now add personal styles and scripts to all skins via
  27   User:<name>/common.css and /common.js (if user css/js is enabled)
  28 * (bug 22748) Add anchors on Special:ListGroupRights
  29 * (bug 21981) Add parameter 'showfilename' to <gallery> to automatically apply
  30   the names of the individual files within the gallery
  31 * (bug 12797) Add $wgGalleryOptions for adjusting of default gallery display
  32   options
  33 * $wgAllowUserCssPrefs option allows disabling CSS-based preferences; which can
  34   improve page loading speed.
  35
  36 === Bug fixes in 1.17 ===
  37 * (bug 17560) Half-broken deletion moved image files to deletion archive without
  38   updating DB
  39 * (bug 22666) Submitting user block form with an invalid user name no longer
  40   throws an error
  41 * (bugs 22665 and 22667) User '0' can now be unblocked and have its block
  42   settings changed
  43 * (bug 22606) The body of e-mail address confirmation message is now different
  44   when the address changed
  45 * (bug 22664) Special:Userrights now accepts '0' as a valid user name
  46 * (bug 5210) preload parser now parses <noinclude>, <includeonly> and redirects
  47 * (bug 22709) IIS7 mishandles redirects generated by OutputPage::output() when
  48   the URL contains a colon.
  49 * (bug 22353) Categorised recent changes now works again
  50 * (bug 22747) "Reveal my e-mail address in notification e-mails" preference is
  51   now only displayed when relevant
  52
  53 == API changes in 1.17 ==
  54 * (bug 22738) Allow filtering by action type on query=logevent
  55 * (bug 22764) uselang parameter for action=parse
  56
  57 === Languages updated in 1.17 ===
  58
  59 == Compatibility ==
  60
  61 MediaWiki 1.17 requires PHP 5.1 (5.2 recommended). PHP 4 is no longer supported.
  62
  63 MySQL 3.23.x is no longer supported; some older hosts may need to upgrade.
  64 At this time we still recommend 4.0, but 4.1/5.0 will work fine in most cases.
  65
  66
  67 == Upgrading ==
  68
  69 1.17 has several database changes since 1.16, and will not work without schema
  70 updates.
  71
  72 If upgrading from before 1.11, and you are using a wiki as a commons reposito-
  73 ry, make sure that it is updated as well. Otherwise, errors may arise due to
  74 database schema changes.
  75
  76 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
  77 new database fields are filled with data.
  78
  79 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
  80 changes are made, and there is a slightly higher chance that things could
  81 break. Don't forget to always back up your database before upgrading!
  82
  83 See the file UPGRADE for more detailed upgrade instructions.
  84
  85
  86 === Caveats ===
  87
  88 Some output, particularly involving user-supplied inline HTML, may not
  89 produce 100% valid or well-formed XHTML output. Testers are welcome to
  90 set $wgMimeType = "application/xhtml+xml"; to test for remaining problem
  91 cases, but this is not recommended on live sites. (This must be set for
  92 MathML to display properly in Mozilla.)
  93
  94 For notes on 1.16.x and older releases, see HISTORY.
  95
  96
  97 === Online documentation ===
  98
  99 Documentation for both end-users and site administrators is currently being
 100 built up on MediaWiki.org, and is covered under the GNU Free Documentation
 101 License (except for pages that explicitly state that their contents are in
 102 the public domain) :
 103
 104   http://www.mediawiki.org/wiki/Documentation
 105
 106
 107 === Mailing list ===
 108
 109 A MediaWiki-l mailing list has been set up distinct from the Wikipedia
 110 wikitech-l list:
 111
 112   http://lists.wikimedia.org/mailman/listinfo/mediawiki-l
 113
 114 A low-traffic announcements-only list is also available:
 115
 116   http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
 117
 118 It's highly recommended that you sign up for one of these lists if you're
 119 going to run a public MediaWiki, so you can be notified of security fixes.
 120
 121
 122 === IRC help ===
 123
 124 There's usually someone online in #mediawiki on irc.freenode.net