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.6.0 ==
   7
   8 MediaWiki is now using a "continuous integration" development model with
   9 quarterly snapshot releases. The latest development code is always kept
  10 "ready to run", and in fact runs our own sites on Wikipedia.
  11
  12 Release branches will continue to receive security updates for about a year
  13 from first release, but nonessential bugfixes and feature development happen
  14 will be made on the development trunk and appear in the next quarterly release.
  15
  16 Those wishing to use the latest code instead of a branch release can obtain
  17 it from source control: http://www.mediawiki.org/wiki/Download_from_SVN
  18
  19
  20 === What's new in 1.6 ===
  21
  22 User interface:
  23 * The account creation form has been separated from the user login form.
  24 * Page protection/unprotection uses a new, expanded form
  25
  26 Templates:
  27 * Categories and "what links here" now update as expected when adding or
  28   removing links in a template.
  29 * Template parameters can now have default values, as {{{name|default value}}}
  30
  31 Uploads:
  32 * Optional support for rasterizing SVG images to PNG for inline dislay
  33
  34 Feeds:
  35 * Feed generation upgraded to Atom 1.0
  36 * Diffs in RSS and Atom feeds are now colored for improved readability.
  37
  38 Database:
  39 * MySQL 3.23.x support dropped; 4.0 or later required
  40 * Experimental support for Unicode mode of MySQL 4.1/5.0 (moderately tested)
  41 * Experimental Oracle support (not well tested!)
  42
  43 Anti-spam extension support:
  44 * Spam blacklist extension now has support for automated cleanup:
  45   http://meta.wikimedia.org/wiki/SpamBlacklist_extension
  46 * Support for a captcha extension to restrict automated spam edits:
  47   http://meta.wikimedia.org/wiki/ConfirmEdit_extension
  48
  49 Numerous bug fixes and other behind-the-scenes changes have been made;
  50 see the file HISTORY for a complete change list.
  51
  52
  53 == Compatibility ==
  54
  55 Older PHP 4.2 and 4.1 releases are no longer supported; PHP 4 users must
  56 upgrade to 4.3 or later.
  57
  58 MediaWiki 1.6 is the last major version to support PHP 4; future versions
  59 will require PHP 5.
  60
  61 MySQL 3.23.x is longer supported; some older hosts may need to upgrade.
  62 At this time we still recommend 4.0, but 4.1/5.0 will work fine in most cases.
  63
  64
  65 == Upgrading ==
  66
  67 Several changes to the database have been made from 1.5; these are relatively
  68 minor but do require that the update process be run before the new code will
  69 work properly:
  70
  71 * A new "templatelinks" table tracks template inclusions.
  72 * A new "externallinks" table tracks URL links; this can be used by a
  73   mass spam-cleanup tool in the SpamBlacklist extension.
  74 * A new "jobs" table stores a queue of pages to update in the background; this
  75   is used to update links in including pages when templates are edited.
  76
  77 To ensure that these tables are filled with data, run refreshLinks.php after
  78 the upgrade.
  79
  80
  81 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
  82 changes are made, and there is a slightly higher chance that things could
  83 break. Don't forget to always back up your database before upgrading!
  84
  85 See the file UPGRADE for more detailed upgrade instructions.
  86
  87
  88
  89 === Caveats ===
  90
  91 Some output, particularly involving user-supplied inline HTML, may not
  92 produce 100% valid or well-formed XHTML output. Testers are welcome to
  93 set $wgMimeType = "application/xhtml+xml"; to test for remaining problem
  94 cases, but this is not recommended on live sites. (This must be set for
  95 MathML to display properly in Mozilla.)
  96
  97
  98 For notes on 1.5.x and older releases, see HISTORY.
  99
 100
 101 === Online documentation ===
 102
 103 Documentation for both end-users and site administrators is currently being
 104 built up on Meta-Wikipedia, and is covered under the GNU Free Documentation
 105 License:
 106
 107   http://www.mediawiki.org/wiki/Documentation
 108
 109
 110 === Mailing list ===
 111
 112 A MediaWiki-l mailing list has been set up distinct from the Wikipedia
 113 wikitech-l list:
 114
 115   http://mail.wikimedia.org/mailman/listinfo/mediawiki-l
 116
 117 A low-traffic announcements-only list is also available:
 118
 119   http://mail.wikimedia.org/mailman/listinfo/mediawiki-announce
 120
 121 It's highly recommended that you sign up for one of these lists if you're
 122 going to run a public MediaWiki, so you can be notified of security fixes.
 123
 124
 125 === IRC help ===
 126
 127 There's usually someone online in #mediawiki on irc.freenode.net