* (bug 1107) Work around includes problem when parent dir is not readable
[mediawiki.git] / RELEASE-NOTES
blob2212408c1695330abde436ae24b24afbba7af035
1 = MediaWiki release notes =
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.
6 ** NOTE TO COMMITTERS: Before 1.5.0 release, rearrange these nicely
7 ** and move 1.4 stuff to HISTORY.
9 == MediaWiki 1.5 ==
11 New exciting things! Need further work and testing...
12 * user groups/permissions scheme
13 * e-mail change notifications
14 * 'live preview' reduces preview reload burden on supported browsers
15 * Schema reworking: http://meta.wikimedia.org/wiki/Proposed_Database_Schema_Changes/October_2004
16 * New WikiSyntax: -- turns into — or – depending on context
17 * (bug 15) Allow editors to view diff of their change before actually submitting an edit
18 * (bug 190) Hide your own edits on the watchlist
19 * (bug 510): Special:Randompage now works for other namespaces than NS_MAIN.
20 * (bug 1015) support for the full wikisyntax in <gallery> captions.
21 * (bug 1105) A "Destination filename" (save as) added to Special:Upload Upload.
22 * (bug 1352) Images on description pages now get thumbnailed regardless of whether the thumbnail is larger than the original.
23 * (bug 1662) A new magicword, {{CURRENTMONTHABBREV}} returns the abbreviation of the current month
24 * (bug 1668) 'Date format' supported for other languages than English, see:
25   http://mail.wikipedia.org/pipermail/wikitech-l/2005-March/028364.html
26 * (bug 1739) A new magicword, {{REVISIONID}} give you the article or diff database
27   revision id, useful for proper citation.
28 * It's now possible to invert the namespace selection at Special:Allpages and Special:Contributions
29 * ...and more!
31 Need to merge:
32 * stuff
35 == Version Enotif+Eauthent EN+EA v2.00/CVS, 14.12.2004 ==
36 written by Thomas Gries, Berlin and Markus Arndt, Munich
38 Executive summary for the impatient reader:
40 Enotif adds e-mail notification to MediaWiki and sends e-mails
41 to watching users when a watch-listed page or user_talk page is changed
42 http://bugzilla.wikipedia.org/show_bug.cgi?id=454
43 Visit the complete documentation on http://meta.wikipedia.org/Enotif
45 Eauthent is a mechanism to use a temporary one-time password cycle
46 to check whether the email address a user has entered is a valid one.
47 http://bugzilla.wikipedia.org/show_bug.cgi?id=866
48 Visit the complete documentation on http://meta.wikipedia.org/Eauthent
50 The current patch has only been checked for (see DefaultSettings.php):
52 - php mail()
53   ( = not using PEAR:Mail() module --- I do not know anyone who uses that)
54   $wgSMTP = false;
55 - MySQL database
56   ( = not using PostgreSQL --- I do not know anyone who uses that)
57   $wgDBtype = "mysql";
58   $wgSearchType = "MyISAM";
60 - STILL TODO:
61   NEW (newpageletter) and CORR (minoreditletter) markers needs
62   corresponding "spacers"
64 - table user_newtalk dropped; changes on usertalk pages and their
65   notifications are now fully handled via existing table watchlist
66   The user interface and behavious is unchanged to previous version.
67 - updaters.inc for compatibility with older mediawiki tables:
68   the conversion script converts existing user_newtalk entries
69   watchlist table entries
70   (user_newtalk) id ==> (watchlist) NS_USER_TALK:namefromId(id) timestamp=1
71 - minor bug fixes:
72   updated marker now correctly shown on watchlist page
73   watching users number display with enhanced RC view + RCUseModStyle
74 - wfUrlencode() instead of rawurlencode() in enotif mails
75 - duplicate enotif code moved from UserTalkUpdate.php and
76   merged into UserMailer.php and using usermailer() solely
77 - fixed an enotif mail text error for user names with spaces
78 - fixed missing part for suppressing watching user number
80 v1.36:
81 magic watchlist shows and counts now only the content page, notwithstanding
82 the content and talk page are stored separately in watchlist.
83 * bug fixed: rawurlencode for pagetitles in enotif mails
84 * bug fixed: link to userpages of anonymous user are correct now
86 * Enotif v1.34
87  bugs fixed regarding missing $oldid parameter
89 * v1.33
90 * Details:
91  Implements almost all enotif options as user preferences.
92  These are only shown on the user preference page, if they are globally
93  enabled by the corresponding admin option in DefaultSettings.php.
94  Added admin feature to let enotifs appear to come from the page editor.
95  This facilitates automatic mail sorting and anti-spam filtering; feature was
96  originally proposed by Nick Triantos, thank you !
97  Page editor's email address is however only shown, if this user enabled
98  the option "reveal my email address" in user preferences. Otherwise,
99  the enotifs appear to come from WikiAdmin as usual (tricky to program,
100  but simply trust the algorithm. or look into UserMailer.php and
101  UserTalkPage.php).
103 * Changes from previous enotif versions
104 * v1.31 is an improved version with many security and also cosmetic changes
105  applied after two first reviews by Brion Vibber. v1.31 is basically the same as
106  the older Enotif v1.30 and v1.22 versions.
108  Added UseMod style for recent changes view so that only the most recent
109  change of any page is listed. The (diff) and (hist) still allow to retrieve the
110  older versions at users' discretion, but the RC view is much cleaner for
111  trusted environments such as medium-size companies or family wikis.
113 * Enotif v1.30 redesign after review by Brion Vibber 25.10.2003
115 * v1.22 "updated (since my last visit)" also shown for users without stored
116  email address in preferences, so that they can see, what watched pages
117  have changed.
118 * show "updated (since my last visit)" markers in RC, history and watchlist
119 * Systemvariables to suppress updated marker in all views
120 * show number of watching users in RC and on bottom of articles in
121  classic skin and in monobook skin
122 * Systemvariables in DefaultSettings.php to enable or disable features
123 * v1.21 now suppresses displaying the marker "updated (since my last visit)"
124  in recent changes view for the older (already visited) versions of watched
125  pages - i.e. page versions before the enotif was sent do not bear that
126  marker any longer.
127 * enotif mails come with a link to the diff view between current and last
128  visited version of the watching user.
129 *database structure is changed automatically when installing via the
130  recommended way (starting index.php and re-using the old database name).
131         run php /maintenance/update.php
132  OR see /maintenance/archives/patch-email-notification.sql and apply the
133  command
134         ALTER TABLE  watchlist
135         ADD (wl_notificationtimestamp varchar(14) binary NOT NULL default '0');
136  manually to your database, which does not harm the non notification versions
138 *adding a page x to the watchlist does automatically add a watch
139   for the accompanying talk_page talk:x and vice versa;
141 == MediaWiki 1.4 BETA ==
143 [Not everything is 100% working in beta yet, the installer needs fixes still.]
145 Major changes from 1.3.x:
146 * Support for table prefixes for better sharing with other web apps
147 * (?) PostgreSQL support
148 * Optional article validation voting features
149 * 'Recentchanges Patrol' to mark new edits that haven't yet been viewed
150 * Support for faster C++ diff module (WikiDiff extension)
151 * More scary link caching modes
152 * Old manually maintained log pages replaced with searchable Special:Log
153 * Skins system more modular: templates and CSS are now in /skins/
154 * New user preference for limitting the image size for images on image description
155   pages 
156 * Error pages no more offer edit / talk / watch links (bug #502)
157 * Allow user to preview article on first edit (bug #530)
158 * New dark background skin named Amethyst (thanks Sorwena and Sorkhiri)
159 * [[RFC 1234]] will now make an internal link (bug #479)
160 * PhpTal skins shown bogus 'What links here' etc on special pages (bug #511)
161 * Experimental code to manage user and group rights (Special:Userlevels)
162 * UI language switching
163 * Adding filter and username exact search match for Special:Listusers (bug #770)
164 * Special:Listadmins outdated, use Special:Listusers instead (bug #857)
165 * Traditional/Simplified Chinese conversion
166 * New tag "<gallery>" to generate a table of image thumbnails
167 * Installer die if it can not write LocalSettings.php (bug #733)
168 * Various special pages no more show the rss/atom feed links (bug #705)
169 * Support for external authentication plug-ins
170 * (bug 114) use category backlinks in Special:Recentchangeslinked
171 * ... and more!
173 === Caveats ===
175 Some output, particularly involving user-supplied inline HTML, may not
176 produce 100% valid or well-formed XHTML output. Testers are welcome to
177 set $wgMimeType = "application/xhtml+xml"; to test for remaining problem
178 cases, but this is not recommended on live sites. (This must be set for
179 MathML to display properly in Mozilla.)
181 The new 'MonoBook' skin is not compatible with PHP 5 due to bugs in the
182 underlying PHPTAL library. It will be automatically disabled when running
183 on PHP5; the older look and feel will be used instead.
186 For notes on 1.3.x and older releases, see HISTORY.
189 === Online documentation ===
191 Documentation for both end-users and site administrators is currently being
192 built up on Meta-Wikipedia, and is covered under the GNU Free Documentation
193 License:
195   http://meta.wikipedia.org/wiki/Help:Contents
198 === Mailing list ===
200 A MediaWiki-l mailing list has been set up distinct from the Wikipedia
201 wikitech-l list:
203   http://mail.wikipedia.org/mailman/listinfo/mediawiki-l
206 === IRC help ===
208 There's usually someone online in #mediawiki on irc.freenode.net