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.12 ==
   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.12 ===
  22
  23 === New features in 1.12 ===
  24 * (bug 10735) Add a warning for non-descriptive filenames at Special:Upload
  25 * Add {{filepath:}} parser function to get full path to an uploaded file,
  26   complementing {{fullurl:}} for pages.
  27 * (bug 11136) If using Postgres, search path is explicitly set if wgDBmwschema is
  28   not set to 'mediawiki', allowing multiple mediawiki instances per user.
  29 * (bug 11151) Add descriptive <title> to revision history page
  30 * (bug 5412) Add feed links for the site to all pages
  31 * (bug 11353) Add ability to retrieve raw section content via action=raw
  32 * Show relevant deletion log lines when uploading a previously deleted file
  33 * On SkinTemplate based skins (like MonoBook), omit confusing "edit"/"view source"
  34   tab entirely if the page doesn't exist and the user isn't allowed to create it
  35 * Clarify instructions given when an exception is thrown
  36 * AuthPlugin added strictUserAuth() method to allow per-user override
  37   of the strict() authentication behavior.
  38 * (bug 7872) Deleted revisions can now be viewed as diffs showing changes
  39   against the previous revision, whether currently deleted or live.
  40 * Added tooltips for the "Go" and "Search" buttons
  41 * (bug 11649) Show input form when Special:Whatlinkshere has no parameters
  42
  43 === Bug fixes in 1.12 ===
  44
  45 * Subpages are now indexed for searching properly when using PostgreSQL
  46 * (bug 3846) Suppress warnings from, e.g. open_basedir when scanning for
  47   ImageMagick, diff3 et al. during installation [patch by Jan Reininghaus]
  48 * (bug 7027) Shift handling of deletion permissions-checking to
  49   getUserPermissionsErrors.
  50 * Login and signup forms are now more correct for right-to-left languages.
  51 * (bug 5387) Block log items on RecentChanges don't make use of possible
  52   translations
  53 * (bug 11211) Pass, as a parameter to the protectedpagetext interface
  54   message, the level of protection.
  55 * (bug 9611) Supply the blocker and reason for the cantcreateaccounttext
  56   message.
  57 * (bug 8759) Fixed bug where rollback was allowed on protected pages for wikis
  58   where rollback is given to non-sysops.
  59 * (bug 8834) Split off permission for editing user JavaScript and CSS from
  60   editinterface to a new permission key editusercssjs.
  61 * (bug 11266) Set fallback language for Fulfulde (ff) to French
  62 * (bug 11179) Include image version deletion comment in public log
  63 * Fixed notice when accessing special page without read permission and whitelist
  64   is not defined
  65 * (bug 9252) Fix for tidy funkiness when using editintro mode
  66 * (bug 4021) Fix for MySQL wildcard search
  67 * (bug 10699) Fix for MySQL phrase search
  68 * (bug 11321) Fix width of gallerybox when option "width=xxx" is used
  69 * (bug 7890) Special:BrokenRedirects links deleted redirects to a non-existent page
  70 * Fix initial statistics when installing: add correct values
  71 * (bug 11342) Fix several 'returnto' links in permissions/error pages which
  72   linked to the main page instead of targetted page
  73 * Strike the link to the redirect rather than using an asterisk in Special:Listredirects
  74 * (bug 11355) Fix false positives in Safe Mode and other config detection
  75   when boolean settings are disabled with 'Off' via php_admin_value/php_value
  76 * (bug 11292) Fixed unserialize errors with Postgres by creating special Blob object.
  77 * (bug 11363) Make all metadata fields bytea when using Postgres.
  78 * (bug 11331) Add buildConcat() and use CASE not IF for DB compatibility. Make oldimage
  79   cascade delete via image table for Postgres, change fa_storage_key TEXT.
  80 * (bug 11438) Live Preview chops returned text
  81 * Show the right message on account creation when the user is blocked
  82 * (bug 11450) Fix creation of objectcache table on upgrade
  83 * Fix namespace selection after submit of Special:Newpages
  84 * Make input form of Special:Newpages nicer for RTL wikis
  85 * (bug 11462) Fix typo in LanguageGetSpecialPageAliases hook name
  86 * (bug 11474) Fix unintentional fall-through in math error handling
  87 * (bug 11478) Fix undefined method call in file deletion interface
  88 * (bug 278) Search results no longer highlight incorrect partial word matches
  89 * Compatibility with incorrectly detected old-style DJVU mime types
  90 * (bug 11560) Fix broken HTML output from weird link nesting in edit comments.
  91   Nested links (as in image caption text) still don't work _right_ but they're
  92   less wrong
  93 * (bug 9718) Remove unnecessary css from main.css causing spacing issues on
  94   some browsers.
  95 * (bug 11574) Add an interface message loginstart, which, similarly to loginend,
  96   appears just before the login form. Patch by MinuteElectron.
  97 * Do not cache category pages if using 'from' or 'until'
  98 * Created new hook getUserPermissionsErrors, to go with userCan changes.
  99 * Diff pages did not properly display css/js pages.
 100 * (bug 11620) Add call to User::isValidEmailAddr during accout creation.
 101 * (bug 11629) If $wgEmailConfirmToEdit is true, require people to supply an
 102   email address when registering.
 103 * (bug 11612) Days to show in recent changes cannot be larger than 7
 104 * (bug 11131) Change filearchive width/height columns to int for Postgres
 105 * Support plural in undeleted{revisions,revisions-files,files}
 106 * (bug 11343) If the database is read-only, ensure that undelete fails.
 107 * (bug 11690) Show revert link for page moves in Special:Log to allowed users
 108   only
 109 * Initial-lowercase prefix checks in namespaceDupes.php now actually work.
 110
 111
 112 === API changes in 1.12 ===
 113
 114 Full API documentation is available at http://www.mediawiki.org/wiki/API
 115
 116 * (bug 11275) Enable descending sort in categorymembers
 117 * (bug 11308) Allow the API to output the image metadata
 118 * (bug 11296) Temporary fix for escaping of ampersands inside links in pretty-printed
 119   help document.
 120 * (bug 11405) Expand templates implementation in the API
 121 * (bug 11218) Add option to feedwatchlist to display multiple revisions for each page.
 122 * (bug 11404) Provide name of exception caught in error code field of internal api
 123   error messages.
 124 * (bug 11534) rvendid doesn't work
 125 * Fixed rvlimit of the revisions query to only enforce the lower query limit if
 126   revision content is requested.
 127 * Include svn revision number (if install is checked-out from svn) in siteinfo query.
 128 * (bug 11173) Allow limited wikicode rendering via api.php
 129 * (bug 11572) API should provide interface for expanding templates
 130 * (bug 11569) Login should return the cookie prefix
 131 * (bug 11632) Breaking change: Specify the type of a change in the recentchanges list
 132   as 'edit', 'new', 'log' instead of 0, 1, 2, respectively.
 133 * Compatibility fix for PHP 5.0.x.
 134 * Add rctype parameter to list=recentchanges that filters by type
 135 * Add apprtype and apprlevel parameters to filter list=allpages by protection types and levels
 136 * Add apdir parameter to enable listing all pages from Z to A
 137
 138 === Languages updated in 1.12 ===
 139
 140 * Amharic (am) (new)
 141 * Arabic (ar)
 142 * Mapudungun (arn) (new)
 143 * Asturian (ast)
 144 * Samogitian (bat-smg)
 145 * Bikol Central (bcl)
 146 * Belarusian Taraskievica orthography (be-tarask)
 147 * Bulgarian (bg)
 148 * Bislama (bi) (new)
 149 * Bengali (bn)
 150 * Bishnupriya Manipuri (bpy)
 151 * Breton (br)
 152 * Catalan (ca)
 153 * Czech (cs)
 154 * Cassubian (csb)
 155 * Welsh (cy)
 156 * Danish (da)
 157 * German (de)
 158 * Lower Sorbian (dsb) (new)
 159 * Ewe (ee) (new)
 160 * Greek (el)
 161 * Spanish (es)
 162 * Extremaduran (ext)
 163 * Finnish (fi)
 164 * Persian (fa)
 165 * Võro (fiu-vro)
 166 * Faroese (fo)
 167 * French (fr)
 168 * Cajun French (frc)
 169 * Franco-Provençal (frp)
 170 * Frisian (fy)
 171 * Irish (ga)
 172 * Gön-gnŷ (gan) (new)
 173 * Galician (gl)
 174 * Ancient Greek (grc) (new)
 175 * Hakka (hak)
 176 * Hebrew (he)
 177 * Croatian (hr)
 178 * Upper Sorbian (hsb)
 179 * Armenian (hy)
 180 * Indonesian (id)
 181 * Ingush (inh) (new)
 182 * Icelandic (is)
 183 * Italian (it)
 184 * Japanese (ja)
 185 * Kazakh (kk)
 186 * Korean (ko)
 187 * Latin (la)
 188 * Limbugian (li)
 189 * Lithuanian (lt)
 190 * Malay (ms)
 191 * Nahuatl (nah)
 192 * Min-nan (nan)
 193 * Low Saxon (nds)
 194 * Dutch Low Saxon (nds-nl)
 195 * Dutch (nl)
 196 * Norwegian (no)
 197 * Portugese (pt)
 198 * Romanian (ro)
 199 * Russian (ru)
 200 * Sakha (sah)
 201 * Sicilian (scn)
 202 * Sassarese (sdc) (new)
 203 * Seri (sei) (new)
 204 * Tachelhit (shi)
 205 * Slovak (sk)
 206 * Serbian (Cyrillic) (sr-ec)
 207 * Sundanese (su)
 208 * Swedish (sv)
 209 * Tamil (ta)
 210 * Tetun (tet) (new)
 211 * Tagalog (tl) (new)
 212 * West Flemish (vls)
 213 * Walloon (wa)
 214 * Yiddish (yi)
 215 * Cantonese (yue)
 216 * Zhuang (za)
 217 * Zealandic (zea)
 218 * Old Chinese/Late Time Chinese (zh-classical)
 219 * Chinese (Simplified) (zh-hans)
 220 * Chinese (Traditional) (zh-hant)
 221
 222 == Compatibility ==
 223
 224 MediaWiki 1.12 requires PHP 5 (5.1 recommended). PHP 4 is no longer supported.
 225
 226 PHP 5.0.x fails on 64-bit systems due to serious bugs with array processing:
 227 http://bugs.php.net/bug.php?id=34879
 228 Upgrade affected systems to PHP 5.1 or higher.
 229
 230 MySQL 3.23.x is no longer supported; some older hosts may need to upgrade.
 231 At this time we still recommend 4.0, but 4.1/5.0 will work fine in most cases.
 232
 233
 234 == Upgrading ==
 235
 236 1.12 has several database changes since 1.11, and will not work without schema
 237 updates.
 238
 239 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
 240 new database fields are filled with data.
 241
 242 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
 243 changes are made, and there is a slightly higher chance that things could
 244 break. Don't forget to always back up your database before upgrading!
 245
 246 See the file UPGRADE for more detailed upgrade instructions.
 247
 248
 249 === Caveats ===
 250
 251 Some output, particularly involving user-supplied inline HTML, may not
 252 produce 100% valid or well-formed XHTML output. Testers are welcome to
 253 set $wgMimeType = "application/xhtml+xml"; to test for remaining problem
 254 cases, but this is not recommended on live sites. (This must be set for
 255 MathML to display properly in Mozilla.)
 256
 257 For notes on 1.11.x and older releases, see HISTORY.
 258
 259
 260 === Online documentation ===
 261
 262 Documentation for both end-users and site administrators is currently being
 263 built up on MediaWiki.org, and is covered under the GNU Free Documentation
 264 License (except for pages that explicitly state that their contents are in
 265 the public domain) :
 266
 267   http://www.mediawiki.org/wiki/Documentation
 268
 269
 270 === Mailing list ===
 271
 272 A MediaWiki-l mailing list has been set up distinct from the Wikipedia
 273 wikitech-l list:
 274
 275   http://lists.wikimedia.org/mailman/listinfo/mediawiki-l
 276
 277 A low-traffic announcements-only list is also available:
 278
 279   http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
 280
 281 It's highly recommended that you sign up for one of these lists if you're
 282 going to run a public MediaWiki, so you can be notified of security fixes.
 283
 284
 285 === IRC help ===
 286
 287 There's usually someone online in #mediawiki on irc.freenode.net