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
   7 == MediaWiki 1.5 alpha 1 ==
   8
   9 May 3, 2005
  10
  11 This is a testing preview release, being put out mainly to aid testers in
  12 finding installation bugs and other major problems. It is strongly recommended
  13 NOT to run a live production web site on this alpha release.
  14
  15 **  WARNING: USE OF THIS ALPHA RELEASE MAY INFEST YOUR HOUSE WITH  **
  16 **  TERMITES, ROT YOUR TEETH,  GROW HAIR ON YOUR PALMS, AND PASTE  **
  17 **  INNUENDO  INTO  YOUR  C.V.  RIGHT  BEFORE  A  JOB  INTERVIEW!  **
  18 **  DON'T SAY WE DIDN'T WARN YOU, MAN. WE TOTALLY DID RIGHT HERE.  **
  19
  20
  21 === Big changes ===
  22
  23 Schema:
  24   The core table schema has changed significantly. This should make better
  25   use of the database's cache and disk I/O, and make significantly speed up
  26   rename and delete operations on pages with very long edit histories.
  27
  28   Unfortunately this does mean upgrading a wiki of size from 1.4 will require
  29   some downtime for the schema restructuring, but future storage backend
  30   changes should be able to integrate into the new system more easily.
  31
  32 Permalinks:
  33   The current revision of a page now has a permanent 'oldid' number assigned
  34   immediately, and the id numbers are now preserved across deletion/undeletion.
  35   A permanent reference to the current revision of a page is now just a matter
  36   of going to the 'history' tab and copying the first link in the list.
  37
  38 Page move log:
  39   Renames of pages are now recorded in Special:Log and the page history.
  40   A handy revert link is available from the log for sysops.
  41
  42 Editing diff:
  43   Ever lost track of what you'd done so far during an edit? A 'Show diff'
  44   button on the edit page now makes it easy to remember.
  45
  46 Uploads:
  47   It's now possible to specify the final filename of an upload distinct
  48   from the original filename on your disk.
  49
  50   An image link for a missing file will now take you straight to the upload page.
  51
  52   More metadata is pre-extracted from uploaded images, which will ease pressure
  53   on disk or NFS volumes used to store images. EXIF metadata is displayed on
  54   the image description page if PHP is configured with the necessary module.
  55
  56 User accounts:
  57   There are some changes to the user permissions system, with assignable
  58   groups. This is still somewhat in flux; do not rely on the present system
  59   that you see in this alpha to still be there.
  60
  61 E-mail:
  62   User-to-user e-mail can now be restricted to require a mail-back confirmation
  63   first to reduce potential for abuse with false addresses.
  64
  65   Updates to user talk pages and watchlist entries can optionally send e-mail
  66   notifications.
  67
  68 External hooks:
  69   A somewhat experimental interface for hooking in an external editor
  70   application is included. This may not be on by default in final release,
  71   depending on support.
  72
  73 And...
  74   A bunch of stuff we forgot to mention.
  75
  76
  77 === What's gone? ===
  78
  79 Latin-1:
  80   Wikis must now be encoded in Unicode UTF-8; this has been the default for
  81   some time, but some languages could optionally be installed in Latin-1 mode.
  82   This is no longer supported.
  83
  84 MySQL 3.x:
  85   Some optimization hacks for MySQL 3.x have been removed as part of the schema
  86   clean-up (specifically, the inverse_timestamp fields). MediaWiki 1.5 should
  87   still run, but wikis of significant size should very seriously consider
  88   upgrading to a more modern release. MySQL 3.x support will probably be
  89   entirely dropped in the next major release later this year.
  90
  91 Special:Maintenance
  92   These tools were, ironically enough, not really maintained. This special
  93   page has been removed; insofar as some of its pieces were useful and haven't
  94   already been supplanted by other special pages they should be rewritten in
  95   an efficient and safe manner in the future.
  96
  97
  98 === What's still waiting? ===
  99
 100 These things should be fixed by the time 1.5.0 final is released:
 101
 102 Upgrade:
 103   Wikis in Latin-1 encoding are no longer supported; only Unicode UTF-8.
 104   A new option $wgLegacyEncoding is provided to allow on-the-fly recoding of
 105   old page text entries, but other metadata fields (titles, comments etc) need
 106   to be pre-converted. The upgrade process does not yet fully automate this.
 107
 108   In general the upgrade from 1.4 to 1.5 schema has not been tested for all
 109   cases, and there may be problems.
 110
 111 Backups:
 112   The text entries of deleted pages are no longer removed from the main
 113   text table on deletion. If you provide public backup dumps of your databases,
 114   you will probably want to use the new XML-format dump generator... but
 115   this hasn't been finished yet.
 116
 117 PostgreSQL:
 118   The table definitions for PostgreSQL install are out of date, and patches
 119   to support PostgreSQL from the main installer are still pending.
 120
 121 MySQL 4.1+:
 122   Proper charset encoding / collation configuration for installs on MySQL 4.1
 123   and higher still needs to be fiddled with. Some bits may fail on the UTF-8
 124   setting due to some long field keys.
 125
 126 Authentication plugin fixes:
 127   The AuthPlugin interface needs some improvements to work better with LDAP,
 128   HTTP basic auth, and other such environments. Some patches are pending.
 129
 130
 131 === Smaller changes ===
 132
 133 Various bugfixes, small features, and a few experimental things:
 134
 135 * 'live preview' reduces preview reload burden on supported browsers
 136 * Schema reworking: http://meta.wikimedia.org/wiki/Proposed_Database_Schema_Changes/October_2004
 137 * New WikiSyntax: -- turns into &mdash; or &ndash; depending on context
 138 * (bug 15) Allow editors to view diff of their change before actually submitting an edit
 139 * (bug 190) Hide your own edits on the watchlist
 140 * (bug 510): Special:Randompage now works for other namespaces than NS_MAIN.
 141 * (bug 1015) support for the full wikisyntax in <gallery> captions.
 142 * (bug 1105) A "Destination filename" (save as) added to Special:Upload Upload.
 143 * (bug 1352) Images on description pages now get thumbnailed regardless of whether the thumbnail is larger than the original.
 144 * (bug 1662) A new magicword, {{CURRENTMONTHABBREV}} returns the abbreviation of the current month
 145 * (bug 1668) 'Date format' supported for other languages than English, see:
 146   http://mail.wikipedia.org/pipermail/wikitech-l/2005-March/028364.html
 147 * (bug 1739) A new magicword, {{REVISIONID}} give you the article or diff database
 148   revision id, useful for proper citation.
 149 * (bug 1998) Updated the Russian translation.
 150 * (bug 2064) Configurable JavaScript mimetype with $wgJsMimeType
 151 * (bug 2084) Fixed a regular expression in includes/Title.php that was accepting invalid syntax like #REDIRECT [[foo] in redirects
 152 * It's now possible to invert the namespace selection at Special:Allpages and Special:Contributions
 153 * No longer using sorbs.net to check for open proxies by default.
 154 * What was $wgDisableUploads is now $wgEnableUploads, and should be set to true if one wishes to enable uploads.
 155 * Supplying a reason for a block is no longer mandatory
 156 * Language conversion support for category pages
 157 * $wgStyleSheetDirectory is no longer an alias for $wgStyleDirectory;
 158 * Special:Movepage can now take paramaters like Special:Movepage/Page_to_move
 159   (used to just be able to take paramaters via a GET request like index.php?title=Special:Movepage&target=Page_to_move)
 160 * ...and more!
 161
 162
 163 === Changes since 1.5alpha1 ===
 164
 165 * ...various...
 166 * (bug 2067) Fixed crash on empty quoted HTML attribute
 167 * (bug 2079) Removed links to Special:Maintenance from movepagetext messages
 168 * Fix for reading incorrectly re-gzipped HistoryBlob entries
 169 * (bug 1906) Generalize project namespace for Latin localization, update namespaces
 170 * (bug 2075) Corrected namespace definitions in Tamil localization
 171 * Add $wgLegacySchemaConversion update-time option to reduce amount of
 172   copying during the schema upgrade: creates HistoryBlobCurStub reference
 173   records in text instead of copying all the cur_text fields. Requires
 174   that the cur table be left in place until/unless such fields are migrated
 175   into the main text store.
 176 * (bug 1692) Fix margin on unwatch tab
 177 * HistoryBlobStub: the last-used HistoryBlob is kept open to speed up
 178   multiple-revision pulls
 179 * Special:Export now includes page, revision, and user id numbers by
 180   default (previously this was disabled for no particular reason)
 181 * dumpBackup.php can dump the full database to Export XML, with current
 182   revisions only or complete histories.
 183
 184
 185 === Caveats ===
 186
 187 Some output, particularly involving user-supplied inline HTML, may not
 188 produce 100% valid or well-formed XHTML output. Testers are welcome to
 189 set $wgMimeType = "application/xhtml+xml"; to test for remaining problem
 190 cases, but this is not recommended on live sites. (This must be set for
 191 MathML to display properly in Mozilla.)
 192
 193
 194 For notes on 1.4.x and older releases, see HISTORY.
 195
 196
 197 === Online documentation ===
 198
 199 Documentation for both end-users and site administrators is currently being
 200 built up on Meta-Wikipedia, and is covered under the GNU Free Documentation
 201 License:
 202
 203   http://meta.wikipedia.org/wiki/Help:Contents
 204
 205
 206 === Mailing list ===
 207
 208 A MediaWiki-l mailing list has been set up distinct from the Wikipedia
 209 wikitech-l list:
 210
 211   http://mail.wikipedia.org/mailman/listinfo/mediawiki-l
 212
 213 A low-traffic announcements-only list is also available:
 214   http://mail.wikipedia.org/mailman/listinfo/mediawiki-announce
 215
 216 It's highly recommended that you sign up for one of these lists if you're
 217 going to run a public MediaWiki, so you can be notified of security fixes.
 218
 219
 220 === IRC help ===
 221
 222 There's usually someone online in #mediawiki on irc.freenode.net