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.10 ==
   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 development happen
  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 ==
  22
  23 === $wgCommandLineDarkBg ==
  24
  25 A new switch used by maintenance scripts (parserTests.php). It lets you specify
  26 if your terminal use a dark background, the colorized output will be made
  27 lighter making things easier to read.
  28
  29 == Major new features ==
  30
  31 $wgAjaxShowEditors will let your users see who else is editing the page
  32 they are currently editing.
  33
  34 == Changes since 1.9 ==
  35
  36 * (bug 7292) Fix site statistics when moving pages in/out of content namespaces
  37 * (bug 6937) Introduce "statistics-footer" message, appended to Special:Statistics
  38 * (bug 8531) Correct local name of Lingála (patch by Raymond)
  39 * (bug 6638) List block flags in block log entries
  40 * New script maintenance/language/checkExtensioni18n.php used to check i18n
  41   progress in the extension repository.
  42 * Running maintenance/parserTests.php with '--record' option, will now
  43   automatically attempt to create the required tables
  44 * Made the PLURAL: parser function return singular on -1 per default
  45 * Fixed up the AjaxSearch
  46 * (bugs 5051, 5376) Tooltips and accesskeys no longer require JavaScript
  47 * Added SkinTemplateOutputPageBeforeExec hook before SkinTemplate::outputPage()
  48   starts page output (http://lists.wikimedia.org/pipermail/wikitech-l/2007-January/028554.html)
  49 * Fix SpecialVersion->formatCredits input. Version and Url parameters should be
  50   null to be treated properly with isset.
  51 * Page restrictions moved into a new, dedicated table
  52 * Introduce "cascading protection" -- implicit protection on pages transcluded
  53   into a page protected with this option enabled
  54 * The minimum permissions needed to edit a page in each namespace can now be
  55   customized via the $wgNamespaceProtection array. By default, editing pages in
  56   the MediaWiki namespace requires "editinterface" permission, as before.
  57 * (bug 8567) Added hook RawPageViewBeforeOutput just before the text is blown
  58   out in action=raw, so extensions might influence the output.
  59 * Correct tooltip accesskey hint for Opera on the Macintosh
  60   (uses Shift-Esc-, not Ctrl-).
  61 * (bug 3446) Add user preference to hide page content below diffs, can be
  62   overridden by adding diffonly=1 or diffonly=0 to the URL of the diff page
  63 * (bug 8002) Math should render left-to-right even in right-to-left wikis
  64 * Pass e-mail and real name fields to AuthPlugin::addUser, as additional
  65   optional fields, which may be considered useful at registration time.
  66 * PostgreSQL upgrade scripts fixed and updated
  67 * (bug 8613) Fix error when viewing "Recent Changes" and using Postgres.
  68 * Initialise site_stats table at upgrade time if data was missing
  69 * (bug 7250) Updated Unicode normalization tables to Unicode 5.0
  70 * Add 'purge' privilege to replace the hardcoded check for login state in
  71   determining whether action=purge can be done via GET. Switching the
  72   permission on for anons can be helpful for benchmarking.
  73 * Unmaintained Oracle support files have been removed.
  74 * Made Linker::userToolLinks() show the contribs link red when the user has
  75   zero edits
  76 * Use browser default for printing size, don't force to 11pt
  77 * (bug 8632) Fix regression in page protection null edit update
  78 * (bug 7842) Link back to deleted revision list from deleted revision preview
  79 * (bug 8619) Add user-aware "unblock" link to Special:Blockip
  80 * (bug 8407) Disallow indexing of "printable" versions
  81 * (bug 8522) Provide a "delete" link on Special:Brokenredirects for users with
  82   the appropriate permission
  83 * (bug 8628) Add user-aware block list link to Special:Blockip
  84 * (bug 8643) Correctly escape the page-specific CSS class for non-Monobook skins
  85 * (bug 8629) Document $wgFilterCallback
  86 * (bug 1000) Clarify warning about memory_limit in installer
  87 * Suppress PHP warning about set_time_limit in installer when safe mode is on
  88 * (bug 3000) Fall back to SCRIPT_NAME plus QUERY_STRING when REQUEST_URI is
  89   not available, as on IIS with PHP-CGI
  90 * (bug 8621) Log revisions marked as patrolled
  91 * Introduce "BookInformation" hook; see docs/hooks.txt for more details
  92 * Missing interwiki row for English Wikipedia restored (as "wikipedia:")
  93 * use configured cache servers for mctest.php
  94 * bucket details in mcc.php
  95 * fix input validation and remove debugging code in compressOld
  96 * full ID range for moveToExternal
  97 * fix resolveStubs.php for compatibility with older serialized data
  98 * maximum line length for bar graphs in getLagTimes.php
  99 * recognize specieswiki in rebuildInterwiki.inc
 100 * --purge option to do additional parser-cache purging for purgeList.php
 101 * profile unicode cleanup in Xml
 102 * log slow parses in Article.php
 103 * profile wfMsgReal
 104 * log mkdir failures
 105 * profile AutoLoader
 106 * rebuild empty DjVu metadata containing ''
 107 * security fix for DjVu metadata retrieval
 108 * Add title prefix search for Special:Undelete
 109 * Remove full-archive list from Special:Undelete
 110 * Undelete page list can use plural marker
 111 * (bug 8638) Fix update from 1.4 and earlier
 112 * Allow restriction of autoconfirmed permission by edit count. New global setting
 113   $wgAutoConfirmCount (defaulting to zero, naturally).
 114 * (bug 8641) Fix order of updates to ipblocks table
 115 * (bug 8678) Fix detection of self-links for numeric titles in Parser
 116 * (bug 6171) Magically close tags in tables when not using Tidy.
 117 * Fix hardcoded background color in parserTests.php
 118 * parserTests.php : removed the 'light' option for --color argument, replacing
 119   it with a new global switch : $wgCommandLineDarkBg
 120 * Sanitizer now correctly escapes lonely '>' occurring before the first wikitag.
 121 * Ignore self closing on closing tags ( '</div />' now gives '</div>')
 122 * (bug 8673) Minor fix for web service API content-type header
 123 * Fix API revision list on PHP 5.2.1; bad reference assignment
 124 * (bug 8136) Introduce 'ArticleUndelete' hook; see docs/hooks.txt for more info
 125 * (bug 8688) Handle underscores/spaces in Special:Blockip and Special:Ipblocklist
 126   in a consistent manner
 127 * (bug 8701) Check database lock status when blocking/unblocking users
 128 * ParserOptions and ParserOutput classes are now in their own files
 129 * (bug 8708) Namespace translations for Zealandic language
 130 * Renamed constructor methods to PHP 5 __construct reserved name
 131 * (bug 8715) Warn users when editing an interface message whether or not the message page exists
 132 * ar: fix the 'create a new page' on search page when no exact match found
 133 * (bug 8703) Corrected Talk namespace name for Limburgish (li)
 134 * (bug 8712) Expose user groups as a JavaScript global
 135 * Introduce 'CustomEditor' hook; see docs/hooks.txt for more information
 136 * (bug 8671) Expose "wpDestFile" as a parameter to "uploadtext"
 137 * (bug 8403) Respect bad image list exceptions in galleries on wiki pages
 138
 139 == Languages updated ==
 140
 141 * Arabic (ar)
 142 * Belarusian (be)
 143 * Breton (br)
 144 * Finnish (fi)
 145 * French (fr)
 146 * German (de)
 147 * Hebrew (he)
 148 * Indonesian (id)
 149 * Japanese (ja)
 150 * Korean (ko)
 151 * Limburgish (li)
 152 * Ripuarian (ksh)
 153 * Limburgish (li)
 154 * Lithuanian (lt)
 155 * Polish (pl)
 156 * Sicilian (scn)
 157 * Swedish (sv)
 158 * Zealandic (zea)
 159
 160 == Compatibility ==
 161
 162 MediaWiki 1.10 requires PHP 5 (5.1 recommended). PHP 4 is no longer supported.
 163
 164 PHP 5.0.x fails on 64-bit systems due to serious bugs with array processing:
 165 http://bugs.php.net/bug.php?id=34879
 166 Upgrade affected systems to PHP 5.1 or higher.
 167
 168 MySQL 3.23.x is no longer supported; some older hosts may need to upgrade.
 169 At this time we still recommend 4.0, but 4.1/5.0 will work fine in most cases.
 170
 171
 172 == Upgrading ==
 173
 174 Some minor database changes have been made since 1.7:
 175 * new fields and indexes on ipblocks
 176 * index change on recentchanges
 177
 178 Several changes from 1.5 and 1.6 do require updates to be run on upgrade.
 179 To ensure that these tables are filled with data, run refreshLinks.php after
 180 the upgrade.
 181
 182 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
 183 changes are made, and there is a slightly higher chance that things could
 184 break. Don't forget to always back up your database before upgrading!
 185
 186 See the file UPGRADE for more detailed upgrade instructions.
 187
 188
 189
 190 === Caveats ===
 191
 192 Some output, particularly involving user-supplied inline HTML, may not
 193 produce 100% valid or well-formed XHTML output. Testers are welcome to
 194 set $wgMimeType = "application/xhtml+xml"; to test for remaining problem
 195 cases, but this is not recommended on live sites. (This must be set for
 196 MathML to display properly in Mozilla.)
 197
 198
 199 For notes on 1.9.x and older releases, see HISTORY.
 200
 201
 202 === Online documentation ===
 203
 204 Documentation for both end-users and site administrators is currently being
 205 built up on Meta-Wikipedia, and is covered under the GNU Free Documentation
 206 License:
 207
 208   http://www.mediawiki.org/wiki/Documentation
 209
 210
 211 === Mailing list ===
 212
 213 A MediaWiki-l mailing list has been set up distinct from the Wikipedia
 214 wikitech-l list:
 215
 216   http://lists.wikimedia.org/mailman/listinfo/mediawiki-l
 217
 218 A low-traffic announcements-only list is also available:
 219
 220   http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
 221
 222 It's highly recommended that you sign up for one of these lists if you're
 223 going to run a public MediaWiki, so you can be notified of security fixes.
 224
 225
 226 === IRC help ===
 227
 228 There's usually someone online in #mediawiki on irc.freenode.net