* (bug 12935, 12981) Fully-qualify archive URLs in delete, revert messages
[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 * The rollback permission can now be rate-limited using the normal mechanism.
29 * New configuration variable $wgExtraLanguageNames
30 * Behaviour of $wgAddGroups and $wgRemoveGroups changed. New behaviour:
31 * * Granting the userrights privilege allows arbitrary changing of rights.
32 * * Without the userrights privilege, a user will be able to add and/or
33 remove the groups specified in $wgAddGroups and $wgRemoveGroups for
34 any groups they are in.
35 * New permission userrights-interwiki for changing user rights on foreign wikis.
36 * $wgImplictGroups for groups that are hidden from Special:Listusers, etc.
37 * $wgAutopromote: automatically promote users who match specified criteria
38 * $wgGroupsAddToSelf, $wgGroupsRemoveFromSelf: allow users to add or remove
39 themselves from specified groups via Special:Userrights.
40 * When $wgUseTidy has been enabled, PHP's Tidy module is now used if it is
41 present, in preference to an external Tidy executable which may or may not
42 be present. To force use of external Tidy even when the PHP module is
43 available, set $wgTidyInternal to false.
44
45
46 === New features in 1.12 ===
47 * (bug 10735) Add a warning for non-descriptive filenames at Special:Upload
48 * Add {{filepath:}} parser function to get full path to an uploaded file,
49 complementing {{fullurl:}} for pages.
50 * (bug 11136) If using Postgres, search path is explicitly set if wgDBmwschema
51 is not set to 'mediawiki', allowing multiple mediawiki instances per user.
52 * (bug 11151) Add descriptive <title> to revision history page
53 * (bug 5412) Add feed links for the site to all pages
54 * (bug 11353) Add ability to retrieve raw section content via action=raw
55 * (bug 6909) Show relevant deletion log lines when uploading a previously
56 deleted file
57 * On SkinTemplate based skins (like MonoBook), omit confusing "edit"/"view
58 source" tab entirely if the page doesn't exist and the user isn't allowed to
59 create it
60 * Clarify instructions given when an exception is thrown
61 * AuthPlugin added strictUserAuth() method to allow per-user override
62 of the strict() authentication behavior.
63 * (bug 7872) Deleted revisions can now be viewed as diffs showing changes
64 against the previous revision, whether currently deleted or live.
65 * Added tooltips for the "Go" and "Search" buttons
66 * (bug 11649) Show input form when Special:Whatlinkshere has no parameters
67 * isValidEmailAddr hook added to User method of that name, to allow, e.g., re-
68 stricting e-mail addresses to a specific domain
69 * Removed "Clear" link in watchlist editor tools, as people were afraid to
70 click it. Existing clear links will fall back to the raw editor, which is
71 very easy to clear your watchlist with.
72 * (bug 1405) Add wgUseNPPatrol option to control patroling for new articles
73 on Special:Newpages
74 * LogLine hook added to allow formatting custom entries in Special:Log.
75 * Support for Iranian calendar
76 * (bug 1401) Allow hiding logged-in users, bots and patrolled pages on
77 Special:Newpages
78 * ChangesListInsertArticleLink hook added for adding extra article info to RC.
79 * MediaWikiPerformAction hook added for diverting control after the main
80 globals have been set up but before any actions have been taken.
81 * BeforeWatchlist hook added for filtering or replacing watchlist.
82 * SkinTemplateTabAction hook added for altering the properties of tab links.
83 * OutputPage::getRedirect public method added.
84 * (bug 11848, 12506) Allow URL parameters 'section', 'editintro' and 'preload'
85 in Special:Mypage and Special:Mytalk
86 * Add ot=raw to Special:Allmessages
87 * Support for Hebrew calendar
88 * Support for Hebrew numerals in dates and times
89 * (bug 11315) Signatures can be configured in [[MediaWiki:Signature]] and
90 [[MediaWiki:Signature-anon]]
91 * Signatures for anonymous users link to Special:Contributions page rather than
92 user page
93 * Added --override switch for disabled pages in updateSpecialPages.php
94 * Provide a unique message (ipb_blocked_as_range) if unblock of a single IP
95 fails
96 because it is part of a blocked range.
97 * (bug 3973) Use a separate message for the email content when an account is
98 created by another user
99 * dumpTextPass.php can spawn fetchText.php as a subprocess, which should restart
100 cleanly if database connections fail unpleasantly.
101 * (bug 12028) Add Special:Listbots as shortcut for Special:Listusers/bot
102 * (bug 9633) Add a predefined list of delete reasons to the deletion form
103 * Show a warning message when creating/editing a user (talk) page but the user
104 does not exists
105 * (bug 8396) Ignore out-of-date serialised message caches
106 * (bug 12195) Undeleting pages now requires 'undelete' permission
107 * (bug 11810) Localize displayed semicolons
108 * (bug 11657) Support for Thai solar calendar
109 * (bug 943) RSS feed for Recentchangeslinked
110 * Introduced AbortMove hook
111 * (bug 2919) Protection of nonexistent pages with regular protection interface.
112 * Special:Upload now lists permitted/prohibited file extensions.
113 * Split ambiguous filetype-badtype message into two new messages,
114 filetype-unwanted-type and filetype-banned-type.
115 * Added link to the old title in Special:Movepage
116 * On Special:Movepage, errors are now more noticeable.
117 * It is now possible to change rights on other local wikis without the MakeSysop
118 extension
119 * Add HTML ID's mw-read-only-warning and mw-anon-edit-warning to warnings when
120 editing to allow CSS styling.
121 * Parser now returns list of sections
122 * When a user is prohibited from creating a page, a title of "View source"
123 makes no sense, and there should be no "Return to [[Page]]" link.
124 * (bug 12486) Protected titles now give a warning for privileged editors.
125 * (bug 9939) Special:Search now sets focus to search input box when no existing
126 search is active
127 * For Special:Userrights, use GET instead of POST to search for users.
128 * Allow subpage syntax for Special:Userrights, i.e., Special:Userrights/Name.
129 * When submitting changes on Special:Userrights, show the full form again, not
130 just the search box.
131 * Added exception hooks
132 * (bug 12574) Allow bots to specify whether an edit should be marked as a bot
133 edit, via the parameter 'bot'. (Default: '1')
134 * (bug 12536) User should be able to get MediaWiki version from any page
135 * (bug 12622) A JavaScript constant to declare whether api.php is available
136 * Add caching to the AJAX search
137 * Add APCOND_INGROUPS
138 * Add DBA caching to installer
139 * (bug 18585) Added a bunch of parameters to the revertpage message
140 * Support redirects in image namespace
141 * (bug 10049) Prefix index search and namespaces in Special:Withoutinterwiki
142 * (bug 12668) Support for custom iPhone bookmark icon via $wgAppleTouchIcon
143 * Add option to include templates in Special:Export.
144 * (bug 12655) Added $wgUserEmailUseReplyTo config option to put sender
145 address in Reply-To instead of From for user-to-user emails.
146 This protects against SPF problems and privacy-leaking bounce messages
147 when using mailers that set the envelope sender to the From header value.
148 * (bug 11897) Add alias [[Special:CreateAccount]] & [[Special:Userlogin/signup]]
149 for Special:Userlogin?type=signup
150 * (bug 12214) Add a predefined list of delete reasons to the file deletion form
151 * Merged backends for OpenSearch suggestions and AJAX search.
152 Both now accept namespace prefixes, handle 'Media:' and 'Special:' pages,
153 and reject interwiki prefixes. PrefixSearch class centralizes this code,
154 and the backend part can be overridden by the PrefixSearchBackend hook.
155 * (bug 10365) Localization of Special:Version
156 * When installing using Postgres, the Pl/Pgsql language is now checked for
157 and installed when at the superuser level.
158 * The default robot policy for the entire wiki is now configurable via the
159 $wgDefaultRobotPolicy setting.
160 * (bug 12239) Use different separators for autocomments
161 * (bug 12857) Patrol link on new pages should clear floats
162 * (bug 12968) Render redirect wikilinks in a redirect class for customization
163 via user/site CSS.
164 * EditPageBeforeEditButtons hook added for altering the edit buttons below the edit box
165
166 === Bug fixes in 1.12 ===
167
168 * Subpages are now indexed for searching properly when using PostgreSQL
169 * (bug 3846) Suppress warnings from, e.g. open_basedir when scanning for
170 ImageMagick, diff3 et al. during installation [patch by Jan Reininghaus]
171 * (bug 7027) Shift handling of deletion permissions-checking to
172 getUserPermissionsErrors.
173 * Login and signup forms are now more correct for right-to-left languages.
174 * (bug 5387) Block log items on RecentChanges don't make use of possible
175 translations
176 * (bug 11211) Pass, as a parameter to the protectedpagetext interface
177 message, the level of protection.
178 * (bug 9611) Supply the blocker and reason for the cantcreateaccounttext
179 message.
180 * (bug 8759) Fixed bug where rollback was allowed on protected pages for wikis
181 where rollback is given to non-sysops.
182 * (bug 8834) Split off permission for editing user JavaScript and CSS from
183 editinterface to a new permission key editusercssjs.
184 * (bug 11266) Set fallback language for Fulfulde (ff) to French
185 * (bug 11179) Include image version deletion comment in public log
186 * Fixed notice when accessing special page without read permission and whitelist
187 is not defined
188 * (bug 9252) Fix for tidy funkiness when using editintro mode
189 * (bug 4021) Fix for MySQL wildcard search
190 * (bug 10699) Fix for MySQL phrase search
191 * (bug 11321) Fix width of gallerybox when option "width=xxx" is used
192 * (bug 7890) Special:BrokenRedirects links deleted redirects to a non-existent
193 page
194 * Fix initial statistics when installing: add correct values
195 * (bug 11342) Fix several 'returnto' links in permissions/error pages which
196 linked to the main page instead of targetted page
197 * Strike the link to the redirect rather than using an asterisk in
198 Special:Listredirects
199 * (bug 11355) Fix false positives in Safe Mode and other config detection
200 when boolean settings are disabled with 'Off' via php_admin_value/php_value
201 * (bug 11292) Fixed unserialize errors with Postgres by creating special Blob
202 object.
203 * (bug 11363) Make all metadata fields bytea when using Postgres.
204 * (bug 11331) Add buildConcat() and use CASE not IF for DB compatibility. Make
205 oldimage cascade delete via image table for Postgres, change fa_storage_key
206 TEXT.
207 * (bug 11438) Live Preview chops returned text
208 * Show the right message on account creation when the user is blocked
209 * (bug 11450) Fix creation of objectcache table on upgrade
210 * Fix namespace selection after submit of Special:Newpages
211 * Make input form of Special:Newpages nicer for RTL wikis
212 * (bug 11462) Fix typo in LanguageGetSpecialPageAliases hook name
213 * (bug 11474) Fix unintentional fall-through in math error handling
214 * (bug 11478) Fix undefined method call in file deletion interface
215 * (bug 278) Search results no longer highlight incorrect partial word matches
216 * Compatibility with incorrectly detected old-style DJVU mime types
217 * (bug 11560) Fix broken HTML output from weird link nesting in edit comments.
218 Nested links (as in image caption text) still don't work _right_ but they're
219 less wrong
220 * (bug 9718) Remove unnecessary css from main.css causing spacing issues on
221 some browsers.
222 * (bug 11574) Add an interface message loginstart, which, similarly to loginend,
223 appears just before the login form. Patch by MinuteElectron.
224 * Do not cache category pages if using 'from' or 'until'
225 * Created new hook getUserPermissionsErrors, to go with userCan changes.
226 * Diff pages did not properly display css/js pages.
227 * (bug 11620) Add call to User::isValidEmailAddr during accout creation.
228 * (bug 11629) If $wgEmailConfirmToEdit is true, require people to supply an
229 email address when registering.
230 * (bug 11612) Days to show in recent changes cannot be larger than 7
231 * (bug 11131) Change filearchive width/height columns to int for Postgres
232 * Support plural in undeleted{revisions,revisions-files,files}
233 * (bug 11343) If the database is read-only, ensure that undelete fails.
234 * (bug 11690) Show revert link for page moves in Special:Log to allowed users
235 only
236 * Initial-lowercase prefix checks in namespaceDupes.php now actually work.
237 * Fix regression in LinkBatch.php breaking PHP 5.0
238 * (bug 11452) wfMsgExt uses sometimes wrong language object for parsing magic
239 words when called with options ''parsemag'' or ''content''.
240 * (bug 11727) Support plural in 'historysize' message
241 * (bug 11744) Incorrect return value from Title::getParentCategories()
242 * (bug 11762) Fix native language name of Akan (ak)
243 * (bug 11722) Fix inconsistent case in unprotect tabs
244 * (bug 11795) Be more paranoid about confirming accept-encoding header is
245 present
246 * (bug 11809) Use formatNum() for more numbers
247 * (bug 11818) Fix native language name of Inuktitut (iu)
248 * Remove all commas when parsing float numbers in sorted tables
249 * Limit text field of deletion, protection and user rights changes reasons to
250 255 characters (already restricted in the database)
251 * In the deletion default reasons, calculate how much text to get from the
252 article text, rather than getting 150 characters (which may be too much)
253 * Add two messages for Special:Blockme which were used but undefined
254 * (bug 11921) Support plural in message number_of_watching_users_pageview
255 * If an IP address is blocked as part of a rangeblock, attempting to unblock
256 the single IP should not unblock the entire range.
257 * (bug 6695) Fix native language name of Southern Sotho (Sesotho) (st)
258 * Make action=render follow redirects by default
259 * If restricted read access was enabled, whitelist didn't work with special
260 pages which had spaces in theirs names
261 * If restricted read access was enabled, requests for non-existing special pages
262 threw an exception
263 * Feeds for recent changes now provide correct URLs for the change, not just
264 the page
265 * Check for if IP is blocked as part of a range when unblocking (see above bug-
266 fix) was faulty. Now fixed.
267 * Fixed wpReason URL parameter to action=delete.
268 * Do not force a password for account creation by email
269 * Ensure that rate-limiting is applied to rollbacks.
270 * Make a better rate-limiting error message (i.e. a normal MW error,
271 rather than an "Internal Server Error").
272 * Do not present an image bigger than the source when 'frameless' option is used
273 (to be consistent with the 'thumb' option now)
274 * Support {{PLURAL}} for import log
275 * Make sure that the correct log entries are shown on Special:Userrights even
276 for users with special characters in their names
277 * The number of watching users in watchlists was always reported as 1
278 * namespaceDupes.php no longer dies when coming across an illegal title
279 * (bug 12143) Do not show a link to patrol new pages for non existent pages
280 * (bug 12166) Fix XHTML validity for Special:Emailuser
281 * (bug 11346) Users who cannot edit a page can now no longer unprotect it.
282 * (bug 451) Add a generic Traditional / Simplified Chinese conversion table,
283 instead of a Traditional conversion with Taiwan variant, and a Simplified
284 conversion with China variant.
285 * (bug 12178) Fix wpReason parameter to action=delete, again.
286 * Graceful behavior for updateRestrictions.php if a page already has records
287 in the page_restrictions matching its old page_restrictions field.
288 May help with odd upgrade issues or race condition.
289 * (bug 11993) Remove contentsub "revision history"
290 * (bug 11952) Ensure we quote_ident() all schema names as needed
291 inside of the DatabasePostgres.php file.
292 * (bug 12184) Exceptions now sent to stderr instead of stdout for command-line
293 scripts, making for cleaner reporting during batch jobs. PHP errors will also
294 be redirected in most cases on PHP 5.2.4 and later, switching 'display_errors'
295 to 'stderr' at runtime.
296 * (bug 12148) Text highlight wasn't applied to cleanly deleted and added
297 lines in diff output
298 * (bug 10166) Fix a PHP warning in Language::getMagic
299 * Only mark rollback edits as minor if the user can normally mark edits minor
300 * Escape page names in the move successful page (e.g. for pages with two
301 apostrophes).
302 * (bug 12145) Add localized names of kk-variants
303 * (bug 12259) Localize the numbers in deleted pages on the sysop view
304 * Set proper page title for successful file deletion
305 * (bug 11221) Do not show 'Compare selected versions' button for a history page
306 with one revision only
307 * (bug 12267) Set the default date format to Thai solar calender for the Thai
308 language
309 * (bug 10184) Extensions' stylesheets and scripts should be loaded before
310 user-customized ones (like Common.css, Common.js)
311 * (bug 12283) Special:Newpages forgets parameters
312 * (bug 12031) All namespaces doesn't work in Special:Newpages
313 * (bug 585) Only create searchindex replica table for parser tests if db is
314 MySQL
315 * Allow --record option if parserTests.php to work when using Postgres
316 * (bug 12296) Simplify cache epoch in default LocalSettings.php
317 * (bug 12346) XML fix when body double-click and click handlers are present
318 * Fix regression -- missing feed links in sidebar on Special:Recentchanges
319 * (bug 12371) Handle more namespace case variants in namespaceDupes.php
320 * (bug 12380) Bot-friendly EditPage::spamPage
321 * (bug 8066) Spaces can't be entered in special page aliases
322 * Hide undo link if user can't edit article
323 * (bug 12416) Fix password setting for createAndPromote.php
324 * (bug 3097) Inconsistently usable titles containing HTML character entities
325 are now forbidden. A run of cleanupTitles.php will fix up existing pages.
326 * (bug 12446) Permissions check fix for undelete link
327 * (bug 12451) AJAX title normalization tweaks
328 * When a user creating a page is not allowed to either create the page nor edit
329 it, all applicable reasons are now shown.
330 * (bug 11428) Allow $wgScript inside $wgArticlePath when emulating PATH_INFO
331 Fixes 'root'-style rewrite configurations
332 * (bug 12493) Removed hardcoded MAX_FILE_SIZE from Special:Import upload form
333 * (bug 12489) Special:Userrights listed in restricted section again
334 * (bug 12553) Fixed invalid XHTML in edit conflict screen
335 * (bug 12505) Fixed section=0 with action=raw
336 * (bug 12614) Do not log user rights change that didn't change anything
337 * (bug 12584) Don't reset cl_timestamp when auto-updating sort key on move
338 * (bug 12588) Fix selection in namespace selector on Special:Newpages
339 * Use only default options when generating RSS and Atom syndication links.
340 This should help prevent infinite link loops that some software may follow,
341 and will generally keep feed behavior cleaner.
342 * (bug 12608) Unifying the spelling of getDBkey() in the code.
343 * (bug 12611) Bot flag ignored in recent changes
344 * (bug 12617) Decimal and thousands separators for Romanian
345 * (bug 12567) Fix for misformatted read-only messages on edit, protect.
346 Also added proper read-only checks to several special pages.
347 Have removed read-only checks from the general user permission framework.
348 * Creating a site with a name containing '#' is no longer permitted, since the
349 name will not work (but $wgSiteName is not checked if manually set).
350 * (bug 12695) Suppress dvips verbiage from web server error log
351 * (bug 12716) Unprotecting a non-protected page leaves a log entry
352 * Log username blocks with canonical form of name instead of input form
353 * (bug 11593, 12719) Fixes for overzealous invocation of thumb.php.
354 Non-image handlers and full-size images may now decline it, fixing
355 mystery failures when using $wgThumbnailScriptPath.
356 * (bug 12327) Comma in username no longer disrupts mail headers
357 * (bug 6436) Localization of Special:Import XML parser Error message(s).
358 * Security fix for API on MSIE
359 * (bug 12768) Database query syntax error in maintenance/storage/compressOld.inc
360 * (bug 12753) Empty captions in MediaWiki:Sidebar result in PHP errors
361 * (bug 12790) Page protection is not logged when edit-protection is used
362 and move-protection is not
363 * (bug 12793) Fix for restricted namespaces/pages in Special:Export
364 * Fix for Special:Export so it doesn't ignore the page named '0'
365 * Don't display rollback link if the user doesn't have all required permissions
366 * The comment of a time-limited protection now contains the date in the default
367 format
368 * (bug 12880) wfLoadExtensionMessages does not use $fallback from MessagesXx.php
369 * (bug 12885) Correction for Russian convertPlural function
370 * (bug 12768) Make DatabasePostgres->hasContraint() schema aware.
371 * (bug 12735) Truncate usernames in comments using mb_ functions.
372 * (bug 12892) Poor tab indexing on "delete file" form
373 * (bug 12660) When creating an account by e-mail, do not send the creator's IP
374 address
375 * (bug 12931) Fix wrong global variable in SpecialVersion
376 * (bug 12919) Use 'deletedrevision' message as content when deleting an old file
377 version
378 * (bug 12952) Using Nosuchusershort instead of Nosuchuser when account creation
379 is disabled
380 * (bug 12869) Magnify icon alignment should be adjusted using linked CSS
381 * Fixing message cache updates for MediaWiki messages moves
382 * (bug 12815) Signature timestamps were always in UTC, even if the timezone code
383 in parentheses after them claimed otherwise
384 * (bug 12732) Fix installer and searching to handle built-in tsearch2 for Postgres.
385 * (bug 12784) Change "bool" types to smallint to handle Postgres 8.3 strictness.
386 * (bug 12301) Allow maintenance/findhooks.php to search hooks in multiple directories.
387 * (bug 7681, 11559) Cookie values no longer override GET and POST variables.
388 * (bug 5262) Fully-qualified $wgStylePath no longer corrupted on XML feeds
389 * (bug 3269) Inaccessible titles ending in '/.' or '/..' now forbidden.
390 * (bug 12935, 12981) Fully-qualify archive URLs in delete, revert messages
391 * (bug 12938) Fix template expansion and 404 returns for action=raw with section
392 * (bug 11567) Fix error checking for PEAR::Mail. UserMailer::send() now returns
393 true-or-WikiError, which seems to be the calling convention expected by half
394 its callers already
395
396
397 == Parser changes in 1.12 ==
398
399 The parser pass order has changed from
400
401 * Extension tag strip and render
402 * HTML normalisation and security
403 * Template expansion
404 * Main section...
405
406 to
407
408 * Template and extension tag parse to intermediate representation
409 * Template expansion and extension rendering
410 * HTML normalisation and security
411 * Main section...
412
413 The main effect of this for the user is that the rules for uncovered syntax
414 have changed.
415
416 Uncovered main-pass syntax, such as HTML tags, are now generally valid, whereas
417 previously in some cases they were escaped. For example, you could have "<ta" in
418 one template, and "ble>" in another template, and put them together to make a
419 valid <table> tag. Previously the result would have been "&lt;table&gt;".
420
421 Uncovered preprocessor syntax is generally not recognised. For example, if you
422 have "{{a" in Template:A and "b}}" in Template:B, then "{{a}}{{b}}" will be
423 converted to a literal "{{ab}}" rather than the contents of Template:Ab. This
424 was the case previously in HTML output mode, and is now uniformly the case in
425 the other modes as well. HTML-style comments uncovered by template expansion
426 will not be recognised by the preprocessor and hence will not prevent template
427 expansion within them, but they will be stripped by the following HTML security
428 pass.
429
430 The rules for template expansion during message transformation were
431 counterintuitive, mostly accidental and buggy. There are a few small changes in
432 this version: for example, templates with dynamic names, as in "{{ {{a}} }}",
433 are fully expanded as they are in HTML mode, whereas previously only the inner
434 template was expanded. I'd like to make some larger breaking changes to message
435 transformation, after a review of typical use cases.
436
437 The header identification routines for section edit and for numbering section
438 edit links have been merged. This removes a significant failure mode and fixes a
439 whole category of bugs (tracked by bug #4899). Wikitext headings uncovered by
440 template expansion or comment removal will still be rendered into a heading tag,
441 and will get an entry in the TOC, but will not have a section edit link.
442 HTML-style headings will also not have a section edit link. Valid wikitext
443 headings present in the template source text will get a template section edit
444 link. This is a major break from previous behaviour, but I believe the effects
445 are almost entirely beneficial.
446
447 The main motivation for making these changes was performance. The new two-pass
448 preprocessor can skip "dead branches" in template expansion, such as unfollowed
449 #switch cases and unused defaults for template arguments. This provides a
450 significant performance improvement in template-heavy test cases taken from
451 Wikipedia. Parser function hooks can participate in this performance improvement
452 by using the new SFH_OBJECT_ARGS flag during registration.
453
454 The pre-expand include size limit has been removed, since there's no efficient
455 way to calculate such a figure, and it would now be meaningless for performance
456 anyway. The "preprocessor node count" takes its place, with a generous default
457 limit.
458
459 The context in which XML-style extension tags are called has changed, so
460 extensions which make use of the parser state may need compatibility changes.
461
462 === API changes in 1.12 ===
463
464 Full API documentation is available at http://www.mediawiki.org/wiki/API
465
466 * (bug 11275) Enable descending sort in categorymembers
467 * (bug 11308) Allow the API to output the image metadata
468 * (bug 11296) Temporary fix for escaping of ampersands inside links in
469 pretty-printed
470 help document.
471 * (bug 11405) Expand templates implementation in the API
472 * (bug 11218) Add option to feedwatchlist to display multiple revisions for each
473 page.
474 * (bug 11404) Provide name of exception caught in error code field of internal
475 api error messages.
476 * (bug 11534) rvendid doesn't work
477 * Fixed rvlimit of the revisions query to only enforce the lower query limit if
478 revision content is requested.
479 * Include svn revision number (if install is checked-out from svn) in siteinfo
480 query.
481 * (bug 11173) Allow limited wikicode rendering via api.php
482 * (bug 11572) API should provide interface for expanding templates
483 * (bug 11569) Login should return the cookie prefix
484 * (bug 11632) Breaking change: Specify the type of a change in the recentchanges
485 list as 'edit', 'new', 'log' instead of 0, 1, 2, respectively.
486 * Compatibility fix for PHP 5.0.x.
487 * Add rctype parameter to list=recentchanges that filters by type
488 * Add apprtype and apprlevel parameters to filter list=allpages by protection
489 types and levels
490 * Add apdir parameter to enable listing all pages from Z to A
491 * (bug 11721) Use a different title for results than for the help page.
492 * (bug 11562) Added a user_registration parameter/field to the list=allusers
493 query.
494 * (bug 11588) Preserve document structure for empty dataset in backlinks query.
495 * Outputting list of all user preferences rather than having to request them by
496 name
497 * (bug 11206) api.php should honor maxlag
498 * Make prop=info check for restrictions in the old format too.
499 * Add apihighlimits permission, default for sysops and bots
500 * Add limit=max to use maximal limit
501 * Add action=parse to render parser output. Use it instead of action=render
502 which has been removed
503 * Add rvtoken=rollback to prop=revisions
504 * Add meta=allmessages to get messages from site's messages cache.
505 * Use bold and italics highlighting only in API help
506 * Added action={block,delete,move,protect,rollback,unblock,undelete} and
507 list={blocks,deletedrevs}
508 * Fixed sessionid attribute in action=login
509 * Standardized limits. Revisions and Deletedrevisions formerly using
510 200 / 10000, now 500 / 5000, in line with other modules.
511 * Added list=allcategories module
512 * (bug 12321) API list=blocks reveals private data
513 * Fix output of wfSajaxSearch
514 * (bug 12413) meta=userinfo missing <query> tag
515 * Add list of sections to action=parse output
516 * Added action=logout
517 * Added cascade flag to prop=info&inprop=protections
518 * Added wlshow parameter to list=watchlist, similar to rcshow
519 (list=recentchanges)
520 * Added support for image thumbnailing to prop=imageinfo
521 * action={login,block,delete,move,protect,rollback,unblock,undelete} now must be
522 POSTed
523 * prop=imageinfo interface changed: iihistory replaced by iilimit, iistart and
524 iiend parameters
525 * Added amlang parameter to meta=allmessages
526 * Added apfilterlanglinks parameter to list=allpages, replacing
527 query.php?what=nolanglinks
528 * (bug 12718) Added action=paraminfo module that provides information about API
529 modules and their parameters
530 * Added iiurlwidth and iiurlheight parameters to prop=imageinfo
531 * Added format=txt and format=dbg, imported from query.php
532 * Added uiprop=editcount to meta=userinfo
533 * Added list=users which fetches user information
534 * Added list=random which fetches a list of random pages
535 * Added page parameter to action=parse to facilitate parsing of existing pages
536 * Added uiprop=ratelimits to meta=userinfo
537 * Added siprop=namespacealiases to meta=siteinfo
538 * Made multiple values for ucuser possible in list=usercontribs
539 * (bug 12944) Added cmstart and cmend parameters to list=categorymembers
540
541 === Languages updated in 1.12 ===
542
543 * Afrikaans (af)
544 * Akan (ak) (new)
545 * Amharic (am) (new)
546 * Aragonese (an)
547 * Old English (ang) (new)
548 * Arabic (ar)
549 * Aramaic (arc)
550 * Mapudungun (arn) (new)
551 * Assamese (as)
552 * Asturian (ast)
553 * Avaric (av)
554 * Kotava (avk) (new)
555 * Aymara (ay)
556 * Samogitian (bat-smg)
557 * Boarisch (bar)
558 * Bikol Central (bcl)
559 * Belarusian (be)
560 * Belarusian Taraskievica orthography (be-tarask)
561 * Bulgarian (bg)
562 * Bislama (bi) (new)
563 * Bamanankan (bm)
564 * Bengali (bn)
565 * Bishnupriya Manipuri (bpy)
566 * Breton (br)
567 * Buginese (bug) (new)
568 * Catalan (ca)
569 * Zamboangueño (cbk-zam) (new)
570 * Min Dong (cdo) (new)
571 * Chechen (ce)
572 * Cebuano (ceb) (new)
573 * Cherokee (chr) (new)
574 * Corsican (co) (new)
575 * Crimean Tatar (Cyrillic) (crh-cyrl) (new)
576 * Crimean Tatar (Latin) (crh-latn) (new)
577 * Czech (cs)
578 * Cassubian (csb)
579 * Old Church Slavonic (cu)
580 * Welsh (cy)
581 * Danish (da)
582 * German (de)
583 * German (de-formal) (new)
584 * Zazaki (diq) (new)
585 * Lower Sorbian (dsb) (new)
586 * Middle Dutch (dum) (new)
587 * Divehi (dv)
588 * Ewe (ee) (new)
589 * Greek (el)
590 * Emiliano-Romagnolo (eml)
591 * English (en)
592 * Spanish (es)
593 * Estonian (et)
594 * Euskara (eu)
595 * Extremaduran (ext)
596 * Finnish (fi)
597 * Persian (fa)
598 * Fulah (ff)
599 * Võro (fiu-vro)
600 * Fijian (fj) (new)
601 * Faroese (fo)
602 * French (fr)
603 * Cajun French (frc)
604 * Franco-Provençal (frp)
605 * Frisian (fy)
606 * Irish (ga)
607 * Gagauz (gag) (new)
608 * Gön-gnŷ (gan) (new)
609 * Scottish Gaelic (gd) (new)
610 * Galician (gl)
611 * Gilaki (glk) (new)
612 * Gothic (got) (new)
613 * Ancient Greek (grc) (new)
614 * Swiss German (gsw)
615 * Hakka (hak)
616 * Hawaiian (haw) (new)
617 * Hebrew (he)
618 * Croatian (hr)
619 * Upper Sorbian (hsb)
620 * Haitian Creole French (ht)
621 * Hungarian (hu)
622 * Armenian (hy)
623 * Interlingua (ia)
624 * Indonesian (id)
625 * Interlingue (ie) (new)
626 * Igbo (ig) (new)
627 * Eastern Canadian (Unified Canadian Aboriginal Syllabics) (ike-cans) (new)
628 * Eastern Canadian (Latin) (ike-latn) (new)
629 * Ingush (inh) (new)
630 * Ido (io) (new)
631 * Icelandic (is)
632 * Italian (it)
633 * Japanese (ja)
634 * Jutish (jut) (new)
635 * Georgian (ka)
636 * Kara-Kalpak (kaa)
637 * Kabyle (kab)
638 * Kazakh (kk)
639 * Kazakh Arabic (kk-arab) (new)
640 * Kazakh (China) (kk-cn)
641 * Kazakh Cyrillic (kk-cyrl) (new)
642 * Kazakh (Kazakhstan) (kk-kz)
643 * Kazakh Latin (kk-latn) (new)
644 * Kazakh (Turkey) (kk-tr)
645 * Kalaallisut (kl) (new)
646 * Kannada (kn)
647 * Korean (ko)
648 * Kölsch (ksh)
649 * Kurdish (Arabic) (ku-arab)
650 * Kurdish (Latin) (ku-latn)
651 * Cornish (kw) (new)
652 * Kirghiz (ky) (new)
653 * Latin (la)
654 * Ladino (lad) (new)
655 * Luxembourgish (lb) (new)
656 * Lingua Franca Nova (new)
657 * Lak (lbe) (new)
658 * Ganda (lg)
659 * Limbugian (li)
660 * Líguru (lij) (new)
661 * Lozi (loz) (new)
662 * Lingala (ln)
663 * Lithuanian (lt)
664 * Maithili (mai) (new)
665 * Moksha (mdf) (new)
666 * Malagasy (mg) (new)
667 * Malayalam (ml)
668 * Macedonian (mk)
669 * Marathi (mr)
670 * Malay (ms)
671 * Erzya (myv) (new)
672 * Nauru (na) (new)
673 * Nahuatl (nah)
674 * Min-nan (nan)
675 * Napolitan (nap)
676 * Low Saxon (nds)
677 * Dutch Low Saxon (nds-nl)
678 * Nepali (ne)
679 * Newari (new) (new)
680 * Dutch (nl)
681 * Norwegian (nynorsk) (nn)
682 * Norwegian (bokmål)‬ (no)
683 * Novial (nov) (new)
684 * Northern Sotho (nso) (new)
685 * Occitan (oc)
686 * Pangasinan (pag) (new)
687 * Pampanga (pam) (new)
688 * Papiamento (pap) (new)
689 * Deitsch (pdc) (new)
690 * Pfälzisch (pfl) (new)
691 * Polish (pl)
692 * Piemontèis (pms)
693 * Pontic (pnt) (new)
694 * Pashto (ps)
695 * Portugese (pt)
696 * Quechua (qu)
697 * Rhaeto-Romance (rm) (new)
698 * Romanian (ro)
699 * Russian (ru)
700 * Megleno-Romanian (ruq) (new)
701 * Megleno-Romanian (Cyrillic script) (ruq-cyrl) (new)
702 * Megleno-Romanian (Greek script) (ruq-grek) (new)
703 * Megleno-Romanian (Latin script) (ruq-latn) (new)
704 * Sakha (sah)
705 * Sardinian (sc)
706 * Sicilian (scn)
707 * Scots (sco) (new)
708 * Sindhi (sd)
709 * Sassarese (sdc) (new)
710 * Seri (sei) (new)
711 * Sango (sg) (new)
712 * Tachelhit (shi)
713 * Sinhalese (si) (new)
714 * Slovak (sk)
715 * Samoan (sm) (new)
716 * Southern Sami (sma) (new)
717 * Serbian (Cyrillic) (sr-ec)
718 * Swati (ss) (new)
719 * Southern Sotho (st) (new)
720 * Saterland Frisian (stq) (new)
721 * Sundanese (su)
722 * Swedish (sv)
723 * Swahili (sw) (new)
724 * Tamil (ta)
725 * Teluga (te)
726 * Tetun (tet) (new)
727 * Tajik (tg)
728 * Thai (th)
729 * Tagalog (tl) (new)
730 * Tonga (to) (new)
731 * Turkish (tr)
732 * Tuvinian (tyv)
733 * Uyghur (ug)
734 * Uzbek (uz)
735 * Venitian (vec)
736 * Vietnamese (vi)
737 * West Flemish (vls)
738 * Volapük (vo)
739 * Walloon (wa)
740 * Wolof (wo)
741 * Wu (wuu) (new)
742 * Xhosa (xh) (new)
743 * Mingrelian (xmf) (new)
744 * Yiddish (yi)
745 * Yoruba (yo) (new)
746 * Cantonese (yue)
747 * Zhuang (za)
748 * Zealandic (zea)
749 * Chinese (zh)
750 * Old Chinese/Late Time Chinese (zh-classical)
751 * Chinese (Simplified) (zh-hans)
752 * Chinese (Traditional) (zh-hant)
753 * Chinese (Taiwan) (zh-tw)
754 * Zulu (zu) (new)
755
756 == Compatibility ==
757
758 MediaWiki 1.12 requires PHP 5 (5.1 recommended). PHP 4 is no longer supported.
759
760 PHP 5.0.x fails on 64-bit systems due to serious bugs with array processing:
761 http://bugs.php.net/bug.php?id=34879
762 Upgrade affected systems to PHP 5.1 or higher.
763
764 MySQL 3.23.x is no longer supported; some older hosts may need to upgrade.
765 At this time we still recommend 4.0, but 4.1/5.0 will work fine in most cases.
766
767
768 == Upgrading ==
769
770 1.12 has several database changes since 1.11, and will not work without schema
771 updates.
772
773 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
774 new database fields are filled with data.
775
776 If upgrading from before 1.11, and you are using a wiki as a commons repository,
777 make sure that it is updated as well. Otherwise, errors may arise due to
778 database schema changes.
779
780 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
781 changes are made, and there is a slightly higher chance that things could
782 break. Don't forget to always back up your database before upgrading!
783
784 See the file UPGRADE for more detailed upgrade instructions.
785
786
787 === Caveats ===
788
789 Some output, particularly involving user-supplied inline HTML, may not
790 produce 100% valid or well-formed XHTML output. Testers are welcome to
791 set $wgMimeType = "application/xhtml+xml"; to test for remaining problem
792 cases, but this is not recommended on live sites. (This must be set for
793 MathML to display properly in Mozilla.)
794
795 For notes on 1.11.x and older releases, see HISTORY.
796
797
798 === Online documentation ===
799
800 Documentation for both end-users and site administrators is currently being
801 built up on MediaWiki.org, and is covered under the GNU Free Documentation
802 License (except for pages that explicitly state that their contents are in
803 the public domain) :
804
805 http://www.mediawiki.org/wiki/Documentation
806
807
808 === Mailing list ===
809
810 A MediaWiki-l mailing list has been set up distinct from the Wikipedia
811 wikitech-l list:
812
813 http://lists.wikimedia.org/mailman/listinfo/mediawiki-l
814
815 A low-traffic announcements-only list is also available:
816
817 http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
818
819 It's highly recommended that you sign up for one of these lists if you're
820 going to run a public MediaWiki, so you can be notified of security fixes.
821
822
823 === IRC help ===
824
825 There's usually someone online in #mediawiki on irc.freenode.net