wiki.techinc.nl/RELEASE-NOTES

= MediaWiki release notes =

Security reminder: MediaWiki does not require PHP's register_globals
setting since version 1.2.0. If you have it on, turn it *off* if you can.

== MediaWiki 1.9 ==

THIS IS NOT A RELEASE YET.

MediaWiki is now using a "continuous integration" development model with
quarterly snapshot releases. The latest development code is always kept
"ready to run", and in fact runs our own sites on Wikipedia.

Release branches will continue to receive security updates for about a year
from first release, but nonessential bugfixes and feature development happen
will be made on the development trunk and appear in the next quarterly release.

Those wishing to use the latest code instead of a branch release can obtain
it from source control: http://www.mediawiki.org/wiki/Download_from_SVN

== Configuration changes ==


== Major new features ==


== Changes since 1.8 ==

* (bug 6835) Removing the includes/Parser.php::getTemplateArgs() function, 
  because it seems to be unused.
* (bug 7139) Increasing the visual width of the edit summary field on larger
  screen sizes, for the default monobook skin.
* Fix PHP notice and estimates for dumpBackup.php and friends
* Improved register_globals paranoia checks
* (bug 7545) Fix PHP version check on install
* Disable PHP exception backtrace printing unless $wgShowExceptionDetails
  is set. Backtraces may contain sensitive information in function call
  parameters.
* (bug 6164) Avoid smashing Cite state if message transformation triggers
  during bad image list check, by skipping message transformation.
  This isn't a good permanent fix.
  

== Languages updated ==

* Occitan (oc)


== Compatibility ==

MediaWiki 1.9 requires PHP 5 (5.1 recommended). PHP 4 is no longer supported.

MySQL 3.23.x is no longer supported; some older hosts may need to upgrade.
At this time we still recommend 4.0, but 4.1/5.0 will work fine in most cases.


== Upgrading ==

Some minor database changes have been made since 1.7:
* new fields and indexes on ipblocks
* index change on recentchanges

Several changes from 1.5 and 1.6 do require updates to be run on upgrade.
To ensure that these tables are filled with data, run refreshLinks.php after
the upgrade.

If you are upgrading from MediaWiki 1.4.x or earlier, some major database
changes are made, and there is a slightly higher chance that things could
break. Don't forget to always back up your database before upgrading!

See the file UPGRADE for more detailed upgrade instructions.


=== Caveats ===

Some output, particularly involving user-supplied inline HTML, may not
produce 100% valid or well-formed XHTML output. Testers are welcome to
set $wgMimeType = "application/xhtml+xml"; to test for remaining problem
cases, but this is not recommended on live sites. (This must be set for
MathML to display properly in Mozilla.)


For notes on 1.5.x and older releases, see HISTORY.


=== Online documentation ===

Documentation for both end-users and site administrators is currently being
built up on Meta-Wikipedia, and is covered under the GNU Free Documentation
License:

  http://www.mediawiki.org/wiki/Documentation


=== Mailing list ===

A MediaWiki-l mailing list has been set up distinct from the Wikipedia
wikitech-l list:

  http://mail.wikimedia.org/mailman/listinfo/mediawiki-l

A low-traffic announcements-only list is also available:

  http://mail.wikimedia.org/mailman/listinfo/mediawiki-announce

It's highly recommended that you sign up for one of these lists if you're
going to run a public MediaWiki, so you can be notified of security fixes.


=== IRC help ===

There's usually someone online in #mediawiki on irc.freenode.net
Import release notes from stable 2003-12-08 07:10:21 +00:00			`= MediaWiki release notes =`

Copy release notes & history from 1.3. 2004-08-14 20:18:23 +00:00			`Security reminder: MediaWiki does not require PHP's register_globals`
			`setting since version 1.2.0. If you have it on, turn it off if you can.`
Update version and docs to 1.3.0beta1 2004-05-21 19:04:52 +00:00
1.9 bump 2006-10-10 22:05:24 +00:00			`== MediaWiki 1.9 ==`
Bump to beta4; disable compressOld as it's known to break. 2005-07-30 20:57:15 +00:00
* Added skinname and style path parameters to CBT version of MonoBook 2006-04-06 23:03:14 +00:00			`THIS IS NOT A RELEASE YET.`
Add date to the release notice 2006-04-05 10:00:14 +00:00
Move huge set of bits over to HISTORY. Add some legible RELEASE-NOTES 2006-04-05 01:38:50 +00:00			`MediaWiki is now using a "continuous integration" development model with`
			`quarterly snapshot releases. The latest development code is always kept`
			`"ready to run", and in fact runs our own sites on Wikipedia.`
Bump to beta4; disable compressOld as it's known to break. 2005-07-30 20:57:15 +00:00
Move huge set of bits over to HISTORY. Add some legible RELEASE-NOTES 2006-04-05 01:38:50 +00:00			`Release branches will continue to receive security updates for about a year`
			`from first release, but nonessential bugfixes and feature development happen`
			`will be made on the development trunk and appear in the next quarterly release.`

			`Those wishing to use the latest code instead of a branch release can obtain`
			`it from source control: http://www.mediawiki.org/wiki/Download_from_SVN`

* Disable $wgAllowExternalImages by default. 2006-06-13 05:11:23 +00:00			`== Configuration changes ==`


(bug 2099) Deleted files can now be archived and undeleted, if you set up an appropriate non-web-accessible directory. Set $wgSaveDeletedFiles on and an appropriate directory path in $wgFileStore['deleted']['directory'] 2006-06-16 01:16:45 +00:00			`== Major new features ==`


(bug 6835): Removing the includes/Parser.php::getTemplateArgs() function, because it seems to be unused: * Nobody on #mediawiki seems to definitively know of anything that uses it. * A "grep -inr getTemplateArgs" shows that there seem to be no calls to it in MediaWiki or the extensions in SVN. * A google codesearch ( http://www.google.com/codesearch?q=getTemplateArgs&btnG=Search+Code ) seems to show no out-of-tree usage. * A straight google showed nothing obvious. * An "svn blame includes/Parser.php" shows that it was added in r4452 (2 years 2 months ago) and has hardly been touched since. * A "php parserTests.php --quiet --quick --color=no" shows no new regressions when it's removed. * Using a code coverage tool I simply could not get this function to be invoked. * Nobody requested this be kept when removing it was first suggested on wikitech-l three months ago (http://mail.wikipedia.org/pipermail/wikitech-l/2006-July/036969.html ). * A PHPXref output for MW 1.6.3 ( http://mediawiki.openapp.org/mediawiki/nav.html?_functions/index.html ) showed zero references to this function. In short, it looks like dead code, and seeing as this is the very start of the 1.9 cycle, now is probably the ideal time to remove it, so as to give a maximum window of opportunity for complaints in case it turns out someone somewhere is actually using this. Also purging the RELEASE-NOTES of stuff from the 1.8 series, since the RELEASE-NOTES need to be updated anyway for this. 2006-10-11 05:45:16 +00:00			`== Changes since 1.8 ==`
* Disable $wgAllowExternalImages by default. 2006-06-13 05:11:23 +00:00
(bug 6835): Removing the includes/Parser.php::getTemplateArgs() function, because it seems to be unused: * Nobody on #mediawiki seems to definitively know of anything that uses it. * A "grep -inr getTemplateArgs" shows that there seem to be no calls to it in MediaWiki or the extensions in SVN. * A google codesearch ( http://www.google.com/codesearch?q=getTemplateArgs&btnG=Search+Code ) seems to show no out-of-tree usage. * A straight google showed nothing obvious. * An "svn blame includes/Parser.php" shows that it was added in r4452 (2 years 2 months ago) and has hardly been touched since. * A "php parserTests.php --quiet --quick --color=no" shows no new regressions when it's removed. * Using a code coverage tool I simply could not get this function to be invoked. * Nobody requested this be kept when removing it was first suggested on wikitech-l three months ago (http://mail.wikipedia.org/pipermail/wikitech-l/2006-July/036969.html ). * A PHPXref output for MW 1.6.3 ( http://mediawiki.openapp.org/mediawiki/nav.html?_functions/index.html ) showed zero references to this function. In short, it looks like dead code, and seeing as this is the very start of the 1.9 cycle, now is probably the ideal time to remove it, so as to give a maximum window of opportunity for complaints in case it turns out someone somewhere is actually using this. Also purging the RELEASE-NOTES of stuff from the 1.8 series, since the RELEASE-NOTES need to be updated anyway for this. 2006-10-11 05:45:16 +00:00			`* (bug 6835) Removing the includes/Parser.php::getTemplateArgs() function,`
			`because it seems to be unused.`
(bug 7139) Increasing the visual width of the edit summary field on larger screen sizes, for the default monobook skin. Using 80% via CSS, so should fall back to the current hard-coded 60 character width for older web clients that don't support CSS. 2006-10-11 06:58:36 +00:00			`* (bug 7139) Increasing the visual width of the edit summary field on larger`
			`screen sizes, for the default monobook skin.`
* Fix PHP notice and estimates for dumpBackup.php and friends 2006-10-11 17:58:42 +00:00			`* Fix PHP notice and estimates for dumpBackup.php and friends`
* Improved register_globals paranoia checks 2006-10-11 18:14:27 +00:00			`* Improved register_globals paranoia checks`
* (bug 7545) Fix PHP version check on install 2006-10-11 18:22:45 +00:00			`* (bug 7545) Fix PHP version check on install`
* Disable PHP exception backtrace printing unless $wgShowExceptionDetails is set. Backtraces may contain sensitive information in function call parameters. 2006-10-11 18:57:49 +00:00			`* Disable PHP exception backtrace printing unless $wgShowExceptionDetails`
			`is set. Backtraces may contain sensitive information in function call`
			`parameters.`
* (bug 6164) Avoid smashing Cite state if message transformation triggers during bad image list check, by skipping message transformation. This isn't a good permanent fix. 2006-10-12 01:07:01 +00:00			`* (bug 6164) Avoid smashing Cite state if message transformation triggers`
			`during bad image list check, by skipping message transformation.`
			`This isn't a good permanent fix.`

table prefixes 2006-10-04 09:14:31 +00:00
* (bug 6587) Remove redundant "allnonarticles" message * Refactor release notes with suggestion; list all updated languages in the release once, to avoid duplicate lines per update and general confusion, etc. 2006-07-08 13:10:21 +00:00			`== Languages updated ==`

(bug 7548) Date format for Occitan localisation (occ) 2006-10-11 21:50:57 +00:00			`* Occitan (oc)`

Move huge set of bits over to HISTORY. Add some legible RELEASE-NOTES 2006-04-05 01:38:50 +00:00
			`== Compatibility ==`

1.9 bump 2006-10-10 22:05:24 +00:00			`MediaWiki 1.9 requires PHP 5 (5.1 recommended). PHP 4 is no longer supported.`
Move huge set of bits over to HISTORY. Add some legible RELEASE-NOTES 2006-04-05 01:38:50 +00:00
Forport from REL1_6: Fix" #5796: we require MySQL 4.0.14 2006-05-02 19:09:51 +00:00			`MySQL 3.23.x is no longer supported; some older hosts may need to upgrade.`
Move huge set of bits over to HISTORY. Add some legible RELEASE-NOTES 2006-04-05 01:38:50 +00:00			`At this time we still recommend 4.0, but 4.1/5.0 will work fine in most cases.`
Drop MySQL 3.23.x support; 4.0 or greater required. 2005-08-26 23:02:54 +00:00
a little info; needs more work 2006-04-04 07:50:19 +00:00
			`== Upgrading ==`

a little relase notes lovin' 2006-10-10 21:43:16 +00:00			`Some minor database changes have been made since 1.7:`
			`* new fields and indexes on ipblocks`
			`* index change on recentchanges`
a little info; needs more work 2006-04-04 07:50:19 +00:00
a little relase notes lovin' 2006-10-10 21:43:16 +00:00			`Several changes from 1.5 and 1.6 do require updates to be run on upgrade.`
a little info; needs more work 2006-04-04 07:50:19 +00:00			`To ensure that these tables are filled with data, run refreshLinks.php after`
			`the upgrade.`

			`If you are upgrading from MediaWiki 1.4.x or earlier, some major database`
Move huge set of bits over to HISTORY. Add some legible RELEASE-NOTES 2006-04-05 01:38:50 +00:00			`changes are made, and there is a slightly higher chance that things could`
			`break. Don't forget to always back up your database before upgrading!`
a little info; needs more work 2006-04-04 07:50:19 +00:00
			`See the file UPGRADE for more detailed upgrade instructions.`


* Update ipblocks table in MySQL 5 table defs 2005-12-02 00:38:02 +00:00
Update release notes with 1.2.x past stuff and new 1.3.x features 2004-04-23 06:42:11 +00:00			`=== Caveats ===`

			`Some output, particularly involving user-supplied inline HTML, may not`
			`produce 100% valid or well-formed XHTML output. Testers are welcome to`
			`set $wgMimeType = "application/xhtml+xml"; to test for remaining problem`
			`cases, but this is not recommended on live sites. (This must be set for`
			`MathML to display properly in Mozilla.)`

Import release notes from stable 2003-12-08 07:10:21 +00:00
* Rearranged Special:Movepage form to reduce confusion between destination title and reason input boxes 2005-08-11 08:08:36 +00:00			`For notes on 1.5.x and older releases, see HISTORY.`
Import release notes from stable 2003-12-08 07:10:21 +00:00

Update for 1.1.0 2003-12-08 08:40:48 +00:00			`=== Online documentation ===`
Import release notes from stable 2003-12-08 07:10:21 +00:00
			`Documentation for both end-users and site administrators is currently being`
			`built up on Meta-Wikipedia, and is covered under the GNU Free Documentation`
			`License:`

Move huge set of bits over to HISTORY. Add some legible RELEASE-NOTES 2006-04-05 01:38:50 +00:00			`http://www.mediawiki.org/wiki/Documentation`
Import release notes from stable 2003-12-08 07:10:21 +00:00

Update for 1.1.0 2003-12-08 08:40:48 +00:00			`=== Mailing list ===`
Import release notes from stable 2003-12-08 07:10:21 +00:00
			`A MediaWiki-l mailing list has been set up distinct from the Wikipedia`
			`wikitech-l list:`

Move huge set of bits over to HISTORY. Add some legible RELEASE-NOTES 2006-04-05 01:38:50 +00:00			`http://mail.wikimedia.org/mailman/listinfo/mediawiki-l`
Import release notes from stable 2003-12-08 07:10:21 +00:00
Write some preliminary release notes for 1.5 alpha 2005-05-03 12:03:23 +00:00			`A low-traffic announcements-only list is also available:`
Move huge set of bits over to HISTORY. Add some legible RELEASE-NOTES 2006-04-05 01:38:50 +00:00
			`http://mail.wikimedia.org/mailman/listinfo/mediawiki-announce`
Write some preliminary release notes for 1.5 alpha 2005-05-03 12:03:23 +00:00
			`It's highly recommended that you sign up for one of these lists if you're`
			`going to run a public MediaWiki, so you can be notified of security fixes.`

Import release notes from stable 2003-12-08 07:10:21 +00:00
Copy release notes & history from 1.3. 2004-08-14 20:18:23 +00:00			`=== IRC help ===`
Update for 1.1.0 2003-12-08 08:40:48 +00:00
Copy release notes & history from 1.3. 2004-08-14 20:18:23 +00:00			`There's usually someone online in #mediawiki on irc.freenode.net`