update for the generic Chinese message file, when the $wgContLanguageCode is set...
[lhc/web/wiklou.git] / 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 * Marking edits as bot edits with Special:Contributions?bot=1 now requires the
23 markbotedit permission, rather than the rollback permission previously used.
24 This permission is assigned by default to the sysop group.
25 * MediaWiki now checks if serialized files are out of date. New configuration
26 variable $wgCheckSerialized can be set to false to enable old behavior (i.e.
27 to not check and assume they are always up to date)
28
29 === New features in 1.12 ===
30 * (bug 10735) Add a warning for non-descriptive filenames at Special:Upload
31 * Add {{filepath:}} parser function to get full path to an uploaded file,
32 complementing {{fullurl:}} for pages.
33 * (bug 11136) If using Postgres, search path is explicitly set if wgDBmwschema
34 is not set to 'mediawiki', allowing multiple mediawiki instances per user.
35 * (bug 11151) Add descriptive <title> to revision history page
36 * (bug 5412) Add feed links for the site to all pages
37 * (bug 11353) Add ability to retrieve raw section content via action=raw
38 * (bug 6909) Show relevant deletion log lines when uploading a previously
39 deleted file
40 * On SkinTemplate based skins (like MonoBook), omit confusing "edit"/"view
41 source" tab entirely if the page doesn't exist and the user isn't allowed to
42 create it
43 * Clarify instructions given when an exception is thrown
44 * AuthPlugin added strictUserAuth() method to allow per-user override
45 of the strict() authentication behavior.
46 * (bug 7872) Deleted revisions can now be viewed as diffs showing changes
47 against the previous revision, whether currently deleted or live.
48 * Added tooltips for the "Go" and "Search" buttons
49 * (bug 11649) Show input form when Special:Whatlinkshere has no parameters
50 * isValidEmailAddr hook added to User method of that name, to allow, e.g., re-
51 stricting e-mail addresses to a specific domain
52 * Removed "Clear" link in watchlist editor tools, as people were afraid to
53 click it. Existing clear links will fall back to the raw editor, which is
54 very easy to clear your watchlist with.
55 * (bug 1405) Add wgUseNPPatrol option to control patroling for new articles
56 on Special:Newpages
57 * LogLine hook added to allow formatting custom entries in Special:Log.
58 * Support for Iranian calendar
59 * (bug 1401) Allow hiding logged-in users, bots and patrolled pages on
60 Special:Newpages
61 * ChangesListInsertArticleLink hook added for adding extra article info to RC.
62 * MediaWikiPerformAction hook added for diverting control after the main
63 globals have been set up but before any actions have been taken.
64 * BeforeWatchlist hook added for filtering or replacing watchlist.
65 * SkinTemplateTabAction hook added for altering the properties of tab links.
66 * OutputPage::getRedirect public method added.
67 * (bug 11848) Allow URL parameters 'editintro' and 'preload' in Special:Mypage
68 and Special:Mytalk
69 * Add ot=raw to Special:Allmessages
70 * Support for Hebrew calendar
71 * Support for Hebrew numerals in dates and times
72 * (bug 11315) Signatures can be configured in [[MediaWiki:Signature]] and
73 [[MediaWiki:Signature-anon]]
74 * Signatures for anonymous users link to Special:Contributions page rather than
75 user page
76 * Added --override switch for disabled pages in updateSpecialPages.php
77 * Provide a unique message (ipb_blocked_as_range) if unblock of a single IP
78 fails
79 because it is part of a blocked range.
80 * (bug 3973) Use a separate message for the email content when an account is
81 created by another user
82 * dumpTextPass.php can spawn fetchText.php as a subprocess, which should restart
83 cleanly if database connections fail unpleasantly.
84 * (bug 12028) Add Special:Listbots as shortcut for Special:Listusers/bot
85 * (bug 9633) Add a predefined list of delete reasons to the deletion form
86 * Show a warning message when creating/editing a user (talk) page but the user
87 does not exists
88 * (bug 8396) Ignore out-of-date serialised message caches
89 * (bug 12195) Undeleting pages now requires 'undelete' permission
90 * Only show most recent 5000 revisions on Special:Undelete by default. Accept
91 limit and offset parameters. Undelete with no revisions selected still
92 undeletes all revisions, regardless of how many are displayed.
93 * Add "show all" option to Special:Undelete when some revisions are excluded,
94 despite that showing all revisions may fail less than gracefully.
95
96 === Bug fixes in 1.12 ===
97
98 * Subpages are now indexed for searching properly when using PostgreSQL
99 * (bug 3846) Suppress warnings from, e.g. open_basedir when scanning for
100 ImageMagick, diff3 et al. during installation [patch by Jan Reininghaus]
101 * (bug 7027) Shift handling of deletion permissions-checking to
102 getUserPermissionsErrors.
103 * Login and signup forms are now more correct for right-to-left languages.
104 * (bug 5387) Block log items on RecentChanges don't make use of possible
105 translations
106 * (bug 11211) Pass, as a parameter to the protectedpagetext interface
107 message, the level of protection.
108 * (bug 9611) Supply the blocker and reason for the cantcreateaccounttext
109 message.
110 * (bug 8759) Fixed bug where rollback was allowed on protected pages for wikis
111 where rollback is given to non-sysops.
112 * (bug 8834) Split off permission for editing user JavaScript and CSS from
113 editinterface to a new permission key editusercssjs.
114 * (bug 11266) Set fallback language for Fulfulde (ff) to French
115 * (bug 11179) Include image version deletion comment in public log
116 * Fixed notice when accessing special page without read permission and whitelist
117 is not defined
118 * (bug 9252) Fix for tidy funkiness when using editintro mode
119 * (bug 4021) Fix for MySQL wildcard search
120 * (bug 10699) Fix for MySQL phrase search
121 * (bug 11321) Fix width of gallerybox when option "width=xxx" is used
122 * (bug 7890) Special:BrokenRedirects links deleted redirects to a non-existent
123 page
124 * Fix initial statistics when installing: add correct values
125 * (bug 11342) Fix several 'returnto' links in permissions/error pages which
126 linked to the main page instead of targetted page
127 * Strike the link to the redirect rather than using an asterisk in
128 Special:Listredirects
129 * (bug 11355) Fix false positives in Safe Mode and other config detection
130 when boolean settings are disabled with 'Off' via php_admin_value/php_value
131 * (bug 11292) Fixed unserialize errors with Postgres by creating special Blob
132 object.
133 * (bug 11363) Make all metadata fields bytea when using Postgres.
134 * (bug 11331) Add buildConcat() and use CASE not IF for DB compatibility. Make
135 oldimage cascade delete via image table for Postgres, change fa_storage_key
136 TEXT.
137 * (bug 11438) Live Preview chops returned text
138 * Show the right message on account creation when the user is blocked
139 * (bug 11450) Fix creation of objectcache table on upgrade
140 * Fix namespace selection after submit of Special:Newpages
141 * Make input form of Special:Newpages nicer for RTL wikis
142 * (bug 11462) Fix typo in LanguageGetSpecialPageAliases hook name
143 * (bug 11474) Fix unintentional fall-through in math error handling
144 * (bug 11478) Fix undefined method call in file deletion interface
145 * (bug 278) Search results no longer highlight incorrect partial word matches
146 * Compatibility with incorrectly detected old-style DJVU mime types
147 * (bug 11560) Fix broken HTML output from weird link nesting in edit comments.
148 Nested links (as in image caption text) still don't work _right_ but they're
149 less wrong
150 * (bug 9718) Remove unnecessary css from main.css causing spacing issues on
151 some browsers.
152 * (bug 11574) Add an interface message loginstart, which, similarly to loginend,
153 appears just before the login form. Patch by MinuteElectron.
154 * Do not cache category pages if using 'from' or 'until'
155 * Created new hook getUserPermissionsErrors, to go with userCan changes.
156 * Diff pages did not properly display css/js pages.
157 * (bug 11620) Add call to User::isValidEmailAddr during accout creation.
158 * (bug 11629) If $wgEmailConfirmToEdit is true, require people to supply an
159 email address when registering.
160 * (bug 11612) Days to show in recent changes cannot be larger than 7
161 * (bug 11131) Change filearchive width/height columns to int for Postgres
162 * Support plural in undeleted{revisions,revisions-files,files}
163 * (bug 11343) If the database is read-only, ensure that undelete fails.
164 * (bug 11690) Show revert link for page moves in Special:Log to allowed users
165 only
166 * Initial-lowercase prefix checks in namespaceDupes.php now actually work.
167 * Fix regression in LinkBatch.php breaking PHP 5.0
168 * (bug 11452) wfMsgExt uses sometimes wrong language object for parsing magic
169 words when called with options ''parsemag'' or ''content''.
170 * (bug 11727) Support plural in 'historysize' message
171 * (bug 11744) Incorrect return value from Title::getParentCategories()
172 * (bug 11762) Fix native language name of Akan (ak)
173 * (bug 11722) Fix inconsistent case in unprotect tabs
174 * (bug 11795) Be more paranoid about confirming accept-encoding header is
175 present
176 * (bug 11809) Use formatNum() for more numbers
177 * (bug 11818) Fix native language name of Inuktitut (iu)
178 * Remove all commas when parsing float numbers in sorted tables
179 * Limit text field of deletion, protection and user rights changes reasons to
180 255 characters (already restricted in the database)
181 * In the deletion default reasons, calculate how much text to get from the
182 article text, rather than getting 150 characters (which may be too much)
183 * Add two messages for Special:Blockme which were used but undefined
184 * (bug 11921) Support plural in message number_of_watching_users_pageview
185 * If an IP address is blocked as part of a rangeblock, attempting to unblock
186 the single IP should not unblock the entire range.
187 * (bug 6695) Fix native language name of Southern Sotho (Sesotho) (st)
188 * Make action=render follow redirects by default
189 * If restricted read access was enabled, whitelist didn't work with special
190 pages which had spaces in theirs names
191 * If restricted read access was enabled, requests for non-existing special pages
192 threw an exception
193 * Feeds for recent changes now provide correct URLs for the change, not just
194 the page
195 * Check for if IP is blocked as part of a range when unblocking (see above bug-
196 fix) was faulty. Now fixed.
197 * Fixed wpReason URL parameter to action=delete.
198 * Do not force a password for account creation by email
199 * Ensure that rate-limiting is applied to rollbacks.
200 * Make a better rate-limiting error message (i.e. a normal MW error,
201 rather than an "Internal Server Error").
202 * Do not present an image bigger than the source when 'frameless' option is used
203 (to be consistent with the 'thumb' option now)
204 * Support {{PLURAL}} for import log
205 * Make sure that the correct log entries are shown on Special:Userrights even
206 for users with special characters in their names
207 * The number of watching users in watchlists was always reported as 1
208 * namespaceDupes.php no longer dies when coming across an illegal title
209 * (bug 12143) Do not show a link to patrol new pages for non existent pages
210 * (bug 12166) Fix XHTML validity for Special:Emailuser
211 * (bug 11346) Users who cannot edit a page can now no longer unprotect it.
212 * (bug 451) Add a generic Traditional / Simplified Chinese conversion table,
213 instead of a Traditional conversion with Taiwan variant, and a Simplified
214 conversion with China variant.
215 * (bug 12178) Fix wpReason parameter to action=delete, again.
216 * Graceful behavior for updateRestrictions.php if a page already has records
217 in the page_restrictions matching its old page_restrictions field.
218 May help with odd upgrade issues or race condition.
219 * (bug 11993) Remove contentsub "revision history"
220
221 == Parser changes in 1.12 ==
222
223 The parser pass order has changed from
224
225 * Extension tag strip and render
226 * HTML normalisation and security
227 * Template expansion
228 * Main section...
229
230 to
231
232 * Template and extension tag parse to intermediate representation
233 * Template expansion and extension rendering
234 * HTML normalisation and security
235 * Main section...
236
237 The main effect of this for the user is that the rules for uncovered syntax
238 have changed.
239
240 Uncovered main-pass syntax, such as HTML tags, are now generally valid, whereas
241 previously in some cases they were escaped. For example, you could have "<ta" in
242 one template, and "ble>" in another template, and put them together to make a
243 valid <table> tag. Previously the result would have been "&lt;table&gt;".
244
245 Uncovered preprocessor syntax is generally not recognised. For example, if you
246 have "{{a" in Template:A and "b}}" in Template:B, then "{{a}}{{b}}" will be
247 converted to a literal "{{ab}}" rather than the contents of Template:Ab. This
248 was the case previously in HTML output mode, and is now uniformly the case in
249 the other modes as well. HTML-style comments uncovered by template expansion
250 will not be recognised by the preprocessor and hence will not prevent template
251 expansion within them, but they will be stripped by the following HTML security
252 pass.
253
254 The rules for template expansion during message transformation were
255 counterintuitive, mostly accidental and buggy. There are a few small changes in
256 this version: for example, templates with dynamic names, as in "{{ {{a}} }}",
257 are fully expanded as they are in HTML mode, whereas previously only the inner
258 template was expanded. I'd like to make some larger breaking changes to message
259 transformation, after a review of typical use cases.
260
261 The header identification routines for section edit and for numbering section
262 edit links have been merged. This removes a significant failure mode and fixes a
263 whole category of bugs (tracked by bug #4899). Wikitext headings uncovered by
264 template expansion or comment removal will still be rendered into a heading tag,
265 and will get an entry in the TOC, but will not have a section edit link.
266 HTML-style headings will also not have a section edit link. Valid wikitext
267 headings present in the template source text will get a template section edit
268 link. This is a major break from previous behaviour, but I believe the effects
269 are almost entirely beneficial.
270
271 The main motivation for making these changes was performance. The new two-pass
272 preprocessor can skip "dead branches" in template expansion, such as unfollowed
273 #switch cases and unused defaults for template arguments. This provides a
274 significant performance improvement in template-heavy test cases taken from
275 Wikipedia. Parser function hooks can participate in this performance improvement
276 by using the new SFH_OBJECT_ARGS flag during registration.
277
278 The pre-expand include size limit has been removed, since there's no efficient
279 way to calculate such a figure, and it would now be meaningless for performance
280 anyway. The "preprocessor node count" takes its place, with a generous default
281 limit.
282
283 The context in which XML-style extension tags are called has changed, so
284 extensions which make use of the parser state may need compatibility changes.
285
286 === API changes in 1.12 ===
287
288 Full API documentation is available at http://www.mediawiki.org/wiki/API
289
290 * (bug 11275) Enable descending sort in categorymembers
291 * (bug 11308) Allow the API to output the image metadata
292 * (bug 11296) Temporary fix for escaping of ampersands inside links in
293 pretty-printed
294 help document.
295 * (bug 11405) Expand templates implementation in the API
296 * (bug 11218) Add option to feedwatchlist to display multiple revisions for each
297 page.
298 * (bug 11404) Provide name of exception caught in error code field of internal
299 api error messages.
300 * (bug 11534) rvendid doesn't work
301 * Fixed rvlimit of the revisions query to only enforce the lower query limit if
302 revision content is requested.
303 * Include svn revision number (if install is checked-out from svn) in siteinfo
304 query.
305 * (bug 11173) Allow limited wikicode rendering via api.php
306 * (bug 11572) API should provide interface for expanding templates
307 * (bug 11569) Login should return the cookie prefix
308 * (bug 11632) Breaking change: Specify the type of a change in the recentchanges
309 list as 'edit', 'new', 'log' instead of 0, 1, 2, respectively.
310 * Compatibility fix for PHP 5.0.x.
311 * Add rctype parameter to list=recentchanges that filters by type
312 * Add apprtype and apprlevel parameters to filter list=allpages by protection
313 types and levels
314 * Add apdir parameter to enable listing all pages from Z to A
315 * (bug 11721) Use a different title for results than for the help page.
316 * (bug 11562) Added a user_registration parameter/field to the list=allusers
317 query.
318 * (bug 11588) Preserve document structure for empty dataset in backlinks query.
319 * Outputting list of all user preferences rather than having to request them by
320 name
321 * (bug 11206) api.php should honor maxlag
322 * Make prop=info check for restrictions in the old format too.
323 * Add apihighlimits permission, default for sysops and bots
324 * Add limit=max to use maximal limit
325 * Add action=parse to render parser output. Use it instead of action=render which is deprecated.
326 * Add rvtoken=rollback to prop=revisions
327 * Add meta=allmessages to get messages from site's messages cache.
328 * Use bold and italics highlighting only in API help
329 * Added action={block,changerights,delete,move,protect,rollback,unblock,undelete} and list={blocks,deletedrevs}
330 * Fixed sessionid attribute in action=login
331
332 === Languages updated in 1.12 ===
333
334 * Afrikaans (af)
335 * Akan (ak) (new)
336 * Amharic (am) (new)
337 * Aragonese (an)
338 * Old English (ang) (new)
339 * Arabic (ar)
340 * Aramaic (arc)
341 * Mapudungun (arn) (new)
342 * Assamese (as)
343 * Asturian (ast)
344 * Aymara (ay)
345 * Samogitian (bat-smg)
346 * Boarisch (bar)
347 * Bikol Central (bcl)
348 * Belarusian Taraskievica orthography (be-tarask)
349 * Bulgarian (bg)
350 * Bislama (bi) (new)
351 * Bamanankan (bm)
352 * Bengali (bn)
353 * Bishnupriya Manipuri (bpy)
354 * Breton (br)
355 * Buginese (bug) (new)
356 * Catalan (ca)
357 * Zamboangueño (cbk-zam) (new)
358 * Min Dong (cdo) (new)
359 * Chechen (ce)
360 * Cebuano (ceb) (new)
361 * Crimean Tatar (Cyrillic) (crh-cyrl) (new)
362 * Crimean Tatar (Latin) (crh-latn) (new)
363 * Czech (cs)
364 * Cassubian (csb)
365 * Old Church Slavonic (cu)
366 * Welsh (cy)
367 * Danish (da)
368 * German (de)
369 * Lower Sorbian (dsb) (new)
370 * Middle Dutch (dum) (new)
371 * Divehi (dv)
372 * Ewe (ee) (new)
373 * Greek (el)
374 * English (en)
375 * Spanish (es)
376 * Estonian (et)
377 * Euskara (eu)
378 * Extremaduran (ext)
379 * Finnish (fi)
380 * Persian (fa)
381 * Fulah (ff)
382 * Võro (fiu-vro)
383 * Faroese (fo)
384 * French (fr)
385 * Cajun French (frc)
386 * Franco-Provençal (frp)
387 * Frisian (fy)
388 * Irish (ga)
389 * Gön-gnŷ (gan) (new)
390 * Galician (gl)
391 * Gilaki (glk) (new)
392 * Ancient Greek (grc) (new)
393 * Swiss German (gsw)
394 * Hakka (hak)
395 * Hebrew (he)
396 * Croatian (hr)
397 * Upper Sorbian (hsb)
398 * Hungarian (hu)
399 * Armenian (hy)
400 * Interlingua (ia)
401 * Indonesian (id)
402 * Interlingue (ie) (new)
403 * Ingush (inh) (new)
404 * Ido (io) (new)
405 * Icelandic (is)
406 * Italian (it)
407 * Japanese (ja)
408 * Georgian (ka)
409 * Kara-Kalpak (kaa)
410 * Kabyle (kab)
411 * Kazakh (kk)
412 * Kannada (kn)
413 * Korean (ko)
414 * Kölsch (ksh)
415 * Kurdish (Latin) (ku-latn)
416 * Cornish (kw) (new)
417 * Latin (la)
418 * Luxembourgish (lb) (new)
419 * Lak (lbe) (new)
420 * Limbugian (li)
421 * Lozi (loz) (new)
422 * Lingala (ln)
423 * Lithuanian (lt)
424 * Malayalam (ml)
425 * Macedonian (mk)
426 * Malay (ms)
427 * Erzya (myv) (new)
428 * Nahuatl (nah)
429 * Min-nan (nan)
430 * Napolitan (nap)
431 * Low Saxon (nds)
432 * Dutch Low Saxon (nds-nl)
433 * Newari (new) (new)
434 * Dutch (nl)
435 * Norwegian (no)
436 * Novial (nov) (new)
437 * Occitan (oc)
438 * Deitsch (pdc) (new)
439 * Polish (pl)
440 * Piemontèis (pms)
441 * Pontic (pnt) (new)
442 * Pashto (ps)
443 * Portugese (pt)
444 * Quechua (qu)
445 * Rhaeto-Romance (rm) (new)
446 * Romanian (ro)
447 * Russian (ru)
448 * Sakha (sah)
449 * Sardinian (sc)
450 * Sicilian (scn)
451 * Scots (sco) (new)
452 * Sindhi (sd)
453 * Sassarese (sdc) (new)
454 * Seri (sei) (new)
455 * Tachelhit (shi)
456 * Slovak (sk)
457 * Serbian (Cyrillic) (sr-ec)
458 * Swati (ss) (new)
459 * Saterland Frisian (stq) (new)
460 * Sundanese (su)
461 * Swedish (sv)
462 * Tamil (ta)
463 * Teluga (te)
464 * Tetun (tet) (new)
465 * Tajik (tg)
466 * Tagalog (tl) (new)
467 * Turkish (tr)
468 * Tuvinian (tyv)
469 * Uyghur (ug)
470 * Uzbek (uz)
471 * Venitian (vec)
472 * Vietnamese (vi)
473 * West Flemish (vls)
474 * Volapük (vo)
475 * Walloon (wa)
476 * Wolof (wo)
477 * Wu (wuu) (new)
478 * Yiddish (yi)
479 * Cantonese (yue)
480 * Zhuang (za)
481 * Zealandic (zea)
482 * Chinese (zh)
483 * Old Chinese/Late Time Chinese (zh-classical)
484 * Chinese (Simplified) (zh-hans)
485 * Chinese (Traditional) (zh-hant)
486 * Chinese (Taiwan) (zh-tw)
487
488 == Compatibility ==
489
490 MediaWiki 1.12 requires PHP 5 (5.1 recommended). PHP 4 is no longer supported.
491
492 PHP 5.0.x fails on 64-bit systems due to serious bugs with array processing:
493 http://bugs.php.net/bug.php?id=34879
494 Upgrade affected systems to PHP 5.1 or higher.
495
496 MySQL 3.23.x is no longer supported; some older hosts may need to upgrade.
497 At this time we still recommend 4.0, but 4.1/5.0 will work fine in most cases.
498
499
500 == Upgrading ==
501
502 1.12 has several database changes since 1.11, and will not work without schema
503 updates.
504
505 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
506 new database fields are filled with data.
507
508 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
509 changes are made, and there is a slightly higher chance that things could
510 break. Don't forget to always back up your database before upgrading!
511
512 See the file UPGRADE for more detailed upgrade instructions.
513
514
515 === Caveats ===
516
517 Some output, particularly involving user-supplied inline HTML, may not
518 produce 100% valid or well-formed XHTML output. Testers are welcome to
519 set $wgMimeType = "application/xhtml+xml"; to test for remaining problem
520 cases, but this is not recommended on live sites. (This must be set for
521 MathML to display properly in Mozilla.)
522
523 For notes on 1.11.x and older releases, see HISTORY.
524
525
526 === Online documentation ===
527
528 Documentation for both end-users and site administrators is currently being
529 built up on MediaWiki.org, and is covered under the GNU Free Documentation
530 License (except for pages that explicitly state that their contents are in
531 the public domain) :
532
533 http://www.mediawiki.org/wiki/Documentation
534
535
536 === Mailing list ===
537
538 A MediaWiki-l mailing list has been set up distinct from the Wikipedia
539 wikitech-l list:
540
541 http://lists.wikimedia.org/mailman/listinfo/mediawiki-l
542
543 A low-traffic announcements-only list is also available:
544
545 http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
546
547 It's highly recommended that you sign up for one of these lists if you're
548 going to run a public MediaWiki, so you can be notified of security fixes.
549
550
551 === IRC help ===
552
553 There's usually someone online in #mediawiki on irc.freenode.net