docs/CHANGES
author Thomas Waldmann <tw AT waldmann-edv DOT de>
Thu, 02 May 2013 22:57:54 +0200
changeset 5985 0063e98b14aa
parent 5983 9bd355d893f4
permissions -rw-r--r--
cfg.recovery_token_lifetime to determine how long the recovery token will be valid
     1 MoinMoin Version History
     2 ========================
     3 
     4 Please note: Starting from the MoinMoin version you used previously, you
     5 should read all more recent entries (or at least everything marked with HINT).
     6 
     7 This release has known bugs (see MoinMoin:MoinMoinBugs), but we think it is
     8 already better than the previous stable release. Our release policy is not
     9 trying to make a "perfect release" (as that release might NEVER get released),
    10 but to make progress and don't delay releases too much.
    11 
    12 Known main issues:
    13 
    14   * The GUI WYSIWYG editor has still some issues and limitations.
    15     If you can't live with those, you can simply switch it off by using:
    16     editor_force = True
    17     editor_default = 'text'  # internal default, just for completeness
    18 
    19 Version 1.9.current:
    20   SECURITY HINT: make sure you have allow_xslt = False (or just do not use
    21   allow_xslt at all in your wiki configs, False is the internal default).
    22   Allowing XSLT/4suite is very dangerous, see HelpOnConfiguration wiki page.
    23 
    24   HINT: Python >= 2.5 is maybe required! See docs/REQUIREMENTS for details.
    25 
    26   New features:
    27   * cfg.log_events_format can be used to configure the format of the records
    28     written to <data_dir>/event-log:
    29     0 = dot not create event-log entries (saves disk space, disk I/O)
    30     1 = standard (like in moin <= 1.9.7) [default]
    31     2 = extended (add infos about username, wikiname, url)
    32   * add a tool to output the contents of the event-log to CSV:
    33     moin export eventlog --file=output.csv
    34     Output encoding is utf-8, columns are in this order:
    35     time, event, username, ip, wikiname, pagename, url, referrer, ua
    36     time: UNIX timestamp (float)
    37 
    38 
    39 Version 1.9.7:
    40   New features:
    41   * passlib support - enhanced password hash security. Special thanks go to
    42     the Python Software Foundation (PSF) for sponsoring development of this!
    43 
    44     Docs for passlib: http://packages.python.org/passlib/
    45 
    46     If cfg.passlib_support is True (default), we try to import passlib and set
    47     it up using the configuration given in cfg.passlib_crypt_context (default
    48     is to use sha512_crypt with default configuration from passlib).
    49 
    50     The passlib docs recommend 3 hashing schemes that have good security, but
    51     some of them have additional requirements:
    52     sha512_crypt needs passlib >= 1.3.0, no other requirements.
    53     pbkdf2_sha512 needs passlib >= 1.4.0, no other requirements.
    54     bcrypt has additional binary/compiled package requirements, please refer to
    55     the passlib docs.
    56 
    57     cfg.password_scheme should be '{PASSLIB}' (default) to tell that passlib is
    58     wanted for new password hash creation and also for upgrading existing
    59     password hashes.
    60 
    61     For the moin code as distributed in our download release archive, passlib
    62     support should just work, as we have passlib 1.6.1 bundled with MoinMoin
    63     as MoinMoin/support/passlib. If you use some other moin package, please
    64     first check if you have moin AND passlib installed (and also find out the
    65     passlib version you have installed).
    66 
    67     If you do NOT want to (not recommended!) or can't use (still using python
    68     2.4?) passlib, you can disable it your wiki config:
    69 
    70         passlib_support = False  # do not import passlib
    71         password_scheme = '{SSHA}'  # use best builtin hash (like moin < 1.9.7)
    72 
    73     Please note that after you have used moin with passlib support and have user
    74     profiles with passlib hashes, you can't just switch off passlib support,
    75     because if you did, moin would not be able to log in users with passlib
    76     password hashes. Password recovery would still work, though.
    77 
    78     password_scheme always gives the password scheme that is wanted for new or
    79     recomputed password hashes. The code is able to upgrade and downgrade hashes
    80     at login time and also when setting / resetting passwords for one or all
    81     users (via the wiki web interface or via moin account resetpw script
    82     command).
    83 
    84     So, if you want that everybody uses strong, passlib-created hashes,
    85     resetting the passwords for all users is strongly recommended:
    86     First have passlib support switched on (it is on by default), use
    87     password_scheme = '{PASSLIB}' (also default), then reset all passwords.
    88 
    89     Same procedure can be used to go back to weaker builtin hashes (not
    90     recommended): First switch off passlib support, use password_scheme =
    91     '{SSHA}', then reset all passwords.
    92 
    93     Wiki farm admins sharing the same user_dir between multiple wikis must use
    94     consistent password hashing / passlib configuration settings for all wikis
    95     sharing the same user_dir. Using the builtin defaults or doing the
    96     configuration in farmconfig.py is recommended.
    97 
    98     Admins are advised to read the passlib docs (especially when experiencing
    99     too slow logins or when running old passlib versions which may not have
   100     appropriate defaults for nowadays):
   101     http://packages.python.org/passlib/new_app_quickstart.html#choosing-a-hash
   102     http://packages.python.org/passlib/password_hash_api.html#choosing-the-right-rounds-value
   103 
   104   * Password mass reset/invalidation support, see docs/resetpw/.
   105     This is useful to make sure everybody sets a new password and moin computes
   106     the password hash using the current configuration.
   107 
   108   * Customizable default password checker:
   109     Moin's default password checker used and still uses min_length=6 (minimum pw
   110     length) and min_different=4 (minimum count of different chars in the password).
   111     If you feel that you need to require better passwords from your users, you
   112     can customize it now like that in your wiki config:
   113 
   114     password_checker = lambda cfg, request, name, pw: multiconfig._default_password_checker(cfg, request, name, pw, min_length=10, min_different=7)
   115 
   116   * Removing/disabling inactive users (moin ... account inactive)
   117     Many wikis have a lot of inactive users, that never ever made a single edit.
   118     See help of the command for more details, be careful.
   119   * SystemAdmin user browser: show disabled user accounts at the bottom of
   120     the list
   121   * At startup, announce moin version and code path in log output (makes
   122     support and debugging easier).
   123   * AttachList: introduced search_term parameter (optional) for listing
   124     attachments filtered by a regular expression on their name.
   125   * sign release archive using GnuPG with the key of tw@waldmann-edv.de
   126     ID 31A6CB60 (main key ID FAF7B393)
   127 
   128   Fixes:
   129   * logging: if the logging config file can't be read, give a helpful error msg
   130   * logging: use info loglevel (not warning) for telling about using the builtin
   131     default logging config
   132   * moin script commands: warn if someone gave ... to the moin script, avoids a
   133     strange and unhelpful 'empty module name' error message
   134   * reorder html input fields in recoverpass form, to help browsers remember
   135     the user name and password (not erroneously the recovery token and password)
   136   * don't try to send password recovery email to user if email address in
   137     user profile is empty
   138   * cache action: fix 304 http status
   139   * rst parser: fix safe_import for level param in __import__ call of docutils 0.10
   140   * moin maint cleancache: also kill the i18n cache 'meta' pickle file
   141   * sendmail: catch unicode errors when E-Mail addr has non-ascii chars
   142   * redirect last visited: if last visited page is on same wiki, use a local
   143     redirect, do not compute via interwiki map (fixes https: usage)
   144 
   145 
   146 Version 1.9.6:
   147 
   148   Fixes:
   149   * fix remote code execution vulnerability in twikidraw/anywikidraw action
   150   * fix path traversal vulnerability in AttachFile action
   151   * fix XSS issue, escape page name in rss link
   152   * escape user- or admin-defined css url
   153   * make taintfilename more secure
   154   * use a constant time str comparison function to prevent timing attacks
   155   * Attachment handler: catch all Zip-related errors
   156 
   157 
   158 Version 1.9.5:
   159 
   160   Fixes:
   161    * Security fix: fix virtual group bug in ACL evaluation.
   162    * Avoid crash if #refresh processing instruction is used without arguments.
   163    * Fix issue with non-ASCII textchas.
   164    * Xapian indexing: remove copy.copy() that crashed on Windows/IIS/isapi-wsgi
   165      after page save.
   166    * Fix dictionary file reading crash under Windows.
   167    * Work around crash of AdvancedSearch macro rendering caused by non-ascii
   168      mimetypes.types_map entries.
   169    * Added migration script for moin 1.8.9.
   170    * rss_rc: Fix diffs added in RSS with diffs=1 (now they correspond to item
   171      listed in feed and not just last page diffs). Links generated with ddiffs=1
   172      also fixed.
   173    * rss_rc: fix double escaping issue.
   174    * rss_rc: respect show_names configuration option.
   175    * rss_rc: proper support of rename, revert, page creation.
   176    * modern/modernized theme: fix padding/width for editor preview
   177    * group/pagelinks formatters: avoid to create unnecessary output, redirect
   178      output of send_page call with the groups formatter, it must not be written
   179      to the output stream
   180    * rst parser: fix include and macro directives
   181    * wikisync: fix unicode pagename sending for python 2.7 httplib
   182 
   183   New features:
   184    * add a comment_required config option (default: False) to require a
   185      non-empty comment when saving a page
   186    * when a save error happens, show the editor again and highlight the error
   187    * rss_rc: several new options added: lines parameter gives ability to set
   188      maximum size of diffs showed in RSS. show_att parameter gives ability
   189      to show information aboout attachment-related items in RSS. page parameter
   190      gives ability to specify set of pages for which changes RSS feed should be
   191      generated. Configuration of defaults and limits can now be done via wiki
   192      configuration mechanism.
   193    * As soon as it is now possible to provide RSS for page change history,
   194      appropriate alternate link is now added for every page (controlled by
   195      rss_show_page_history_link configuration parameter).
   196    * Search: "no_highlight:" search query option provided for suppressing
   197      highlighting search results.
   198    * Search macros: new options for FullSearch, FullSearchCached and PageList
   199      available:
   200      * highlight_titles option controls highlighting of matches in search
   201        results provided by these macros. Default value is set in
   202        search_macro_highlight_titles configuration option)
   203      * highlight_pages option controls adding of highlight URL parameter to
   204        page links (so search term is highlighted when user goes to one of
   205        these pages via provided link) in search results. Default value is set
   206        in search_macro_highlight_pages configuration option.
   207      Usage of these options is disabled (via search_macro_parse_args
   208      configuration option) by default due to behavioural changes introduced
   209      in macro parameter parsing mechanism to support them. Related to
   210      http://moinmo.in/FeatureRequests/FullSearchResultsWithoutHighlight .
   211 
   212   Other changes:
   213    * Remove 4suite dependency for docbook formatter, use minidom (included in
   214      Python).
   215    * Upgraded FCKeditor to 2.6.8.
   216 
   217 
   218 Version 1.9.4:
   219 
   220   HINT: Python >= 2.5 is maybe required! See docs/REQUIREMENTS for details.
   221 
   222   Fixes:
   223    * Fix XSS / remove javascript URL support in rst parser (CVE-2011-1058).
   224    * werkzeug: Removed a dummy import. Fixes Python 2.7 compatibility.
   225    * Fix linux-to-windows edit-log migration/upgrade issue (wrong line endings)
   226    * logfile: strip \n lineends from line data (\n is part of the file
   227      structure, not of the data)
   228    * Fix for MoinMoinBugs/SinglePageSlideShowAndParserMarkup.
   229    * Simplify auto scroll initialization; fix bug in IE init discovered when
   230      using IE7 on pages with wide tables.
   231    * Fix timestamp in edit lock message to show the time when edit-locking ends.
   232    * Updated wikiserverconfig.py from internal defaults, sync the one in
   233      toplevel dir and the one in wiki/server/ - fixes hostname setting.
   234    * SubProcess: make sure files are closed at the end (experimental change).
   235    * text plain formatter: fix bullet_list, see number_list.
   236    * Add some image mimetypes to MIMETYPES_MORE to fix windows issues.
   237    * Include page name in password reset URL.
   238    * Fix moin export dump to generate relative URLs.
   239    * Fix MonthCalendar mouseover for pages with ampersand in page name.
   240    * ldap_login: assign server early, it is used in exception handler.
   241    * OpenID server preferences: fix traceback related to request method.
   242    * Work around page.mtime_usecs() returning 0 for pages without edit-log.
   243    * revert action: catch and display all SaveErrors when revert failed.
   244    * Fixed bug in groups formatter which caused the last list item to be not in the group.
   245    * Avoid strange exception in zipfile.py for pre-1980 timestamps.
   246    * TableOfContents: fix for other markups than default wiki markup, e.g. rst
   247    * script.account.homepage: added wiki format to homepage_default_text
   248    * Enable webkit based browsers (try chrome/safari/konqueror now) for GUI
   249      editing (after fixing selection FCKeditor plugin for chrome).
   250    * Parsers: avoid crash when Parser.format() call gets inhibit_p kw arg.
   251    * advancedsearch: fix problem with non-ascii chars breaking up words for OR
   252      and NOT terms
   253    * fix globaledit script to keep comments on Homepage...Template pages
   254 
   255   New features:
   256    * Added print mode to action.SlideShow, see
   257      FeatureRequests/PrintableSinglePageSlideshows.
   258    * xmlrpc: new methods xmlrpc_getProcessingInstruction(Version)
   259    * Add support for other password hashes (all of them will get auto-upgraded
   260      to SSHA when user logs in):
   261      * {DES} (Unix crypt(3))
   262      * {MD5} (MD5-based crypt())
   263      * {APR1} (Apache .htpasswd). 
   264    * Experimental queued indexing support to work around memory leak - use it like this:
   265      # put all pages into indexer queue:
   266      python MoinMoin/script/moin.py index build --mode=makequeue
   267      # take <count> pages out of the indexer queue and index them,
   268      # you need to repeat the following line respective to the total amount of pages
   269      # in your wiki (doing more indexer calls does no harm, doing less means an
   270      # incomplete index):
   271      python MoinMoin/script/moin.py index build --mode=buildnewindexqueued --count=500
   272      python MoinMoin/script/moin.py index build --mode=buildnewindexqueued --count=500
   273      python MoinMoin/script/moin.py index build --mode=buildnewindexqueued --count=500
   274      # ...
   275      # switch to new index:
   276      python MoinMoin/script/moin.py index build --mode=usenewindex 
   277 
   278   Other changes:
   279    * Raise exceptions as recommended in PEP 8.
   280    * Updated i18n / underlay pages.
   281    * Updated interwiki map.
   282    * Use logging.traceback to get more information if a indexing filter crashes.
   283    * u200b is not considered a space any more in unicode 4.0.1.
   284    * Improve textcha security, use some crypto and timing to make cheating
   285      harder - use cfg.textchas_expiry_time = 600 (default, seconds) to set the
   286      time a textcha is valid.
   287    * Upgraded bundled werkzeug to 0.8.1, pygments to 1.4, flup to repo tip.
   288 
   289 
   290 Version 1.9.3:
   291   Fixes:
   292   * Fix XSS in Despam action (CVE-2010-0828).
   293   * Fix XSS issues (see MoinMoinBugs/1.9.2UnescapedInputForThemeAddMsg):
   294     * by escaping template name in messages
   295     * by fixing other places that had similar issues
   296   * Make moin compatible to werkzeug 0.5 .. 0.6.2 (1.9.2 had issues
   297     with xmlrpc when used with werkzeug 0.6.x).
   298   * MoinMoin.util.filesys: disable usage of dircache, deprecate dc* functions,
   299     because the dircache stdlib module can't work correctly for fast updates of
   300     directories.
   301   * rss_rc and sisterpages actions: fix Content-Type header (mimetype)
   302   * Fix associating OpenID identity with user, wasn't adapted to werkzeug yet.
   303   * openidrp auth: fix undefined _ (gettext)
   304   * Fix auth.cas and userprefs.oidserv request object usage.
   305   * highlight parser: fixed MoinMoinBugs/LineNumberSpansForProcessInstructionsMissed
   306   * Pygments syntax highlighting: add missing code files
   307   * Notifications: use same email subject format for every notification
   308   * Fix docbook formatter crashing, see MoinMoinPatch/IncludeMacroWithDocBookFormatter
   309   * Fix regex content search for xapian search.
   310   * Get rid of the empty line at the end of code highlights.
   311   * GUI editor: compute editor height like the text editor does.
   312   * Added help texts for: standalone server and moin migration.
   313   * script.maint.cleancache: clean also i18n cache files
   314   * Improved formatter.text_plain, see FeatureRequests/TextPlainFormatterRewrite
   315     (fixes many issues of this formatter).
   316   * text_html_text_moin_wiki: fixed index error for width="", see also:
   317     MoinMoinBugs/GUI_convertor_list_index_out_of_range
   318   * xmlrpc: disable editor backup for putPage, renamePage and revertPage
   319     because if pages get uploaded by xmlrpc then the draft cache file can
   320     rapidly increase in size, causing high memory usage because it needs to
   321     get loaded into memory for updating/processing.
   322   * Emit Content-Type header (with charset) for SlideShow action and many other
   323     actions that just call send_title().
   324   * ActionBase: better compatibility to moin 1.8, use request.values by
   325     default, optionally use request.form data only
   326 
   327   New features:
   328   * RenamePage action: added ability to create redirect pages when renaming
   329     (turned off by default, see show_rename_redirect config option).
   330   * formatter/text_html: Added line number links to code blocks.
   331   * diff action:
   332     * Fixed whitespace in generated (html) diff view table so white-space: pre
   333       can be used (and whitespace in diffs preserved).
   334     * Added links to first/last revision.
   335   * MoinMoin.widget.browser: introduced feature for sorting tables, see:
   336     http://moinmo.in/FeatureRequests/SortableTables
   337   * SystemAdmin user and attachment browsers: sorting feature used there now
   338   * Scrolling the text editor to the double clicked line.
   339   * Enable double-click-editing by default.
   340   * WikiConfigHelp macro: make heading and description display optional,
   341     heading level as a parameter (default 2)
   342   * If edit ticket check fails, send the editor with the current content.
   343   * moin import wikipage - use this script to import local files as a wiki page
   344 
   345   Other changes:
   346   * upgraded pygments from 1.2.2 to 1.3.1
   347   * upgraded FCKeditor from 2.6.4.1 to 2.6.6
   348   * added configuration snippet for ldap authentication against 2 servers
   349   * improved script help output
   350 
   351 Version 1.9.2:
   352   Fixes:
   353   * Fixed CVE-2010-0668: major security issues were discovered in misc. parts
   354     of moin.
   355     HINT: if you have removed superuser configuration to workaround the issue
   356     (following our security advisory), you may re-add it after installing this
   357     moin release. If you don't need superuser capabilities often, it might be
   358     wise to not have superusers configured all the time, though.
   359   * Fixed CVE-2010-0669: potential security issue due to incomplete user profile
   360     input sanitizing.
   361   * Improved package security: cfg.packagepages_actions_excluded excludes
   362     unsafe or otherwise questionable package actions by default now.
   363   * wiki parser: fixed transclusion of (e.g. video) attachments from other
   364     pages.
   365   * Fixed edit locking for non-logged in editors and cfg.log_remote_addr=False.
   366   * mailimport: fix missing wikiutil import for normalize_pagename
   367   * SubProcess: fix "timeout" AttributeError
   368   * "standalone" wikiserver.py: fixed calling non-existing os.getuid on win32
   369   * HTTPAuth deprecation warning moved from class level to __init__
   370   * Fixed MoinMoinBugs/1.9DiffActionThrowsException.
   371   * Fixed misc. session related problems, avoid unneccessary session file
   372     updates.
   373   * Fix/improve rename-related problems on Win32 (depending on Windows version).
   374   * Fixed spider / user agent detection.
   375   * Make sure to use language_default when language_ignore_browser is set.
   376   * diff action: fix for case when user can't revert page.
   377   * Fix trail size (was off by one).
   378   * Updated bundled flup middleware (upstream repo checkout), avoids
   379     socket.fromfd AttributeError on win32 if cgi is forced, gives helpful
   380     exception msg.
   381   * wikiutil: Fixed required_arg handling (no exception when trying to raise
   382     exception that choice is wrong).
   383   * Do not use MoinMoin.support.* to import 3rd party code, give dist packages
   384     a chance.
   385   * wikiutil.clean_input: avoid crash if it gets str type
   386   * request: fixed for werkzeug 0.6 and 0.5.1 compatibility. Please note that
   387     we didn't do much testing with 0.6 yet. So, if you use 0.6, please do some
   388     testing and provide feedback to us.
   389   * AttachFile._build_filelist: verifies readonly flag for unzip file link
   390   * attachUrl: fix wrongly generated tickets (e.g. for AttachList macro)
   391   * http headers: fix duplicated http headers (e.g. content-type)
   392 
   393   New features:
   394   * info action: added pagination ability to revision history viewer.
   395     Use cfg.history_paging = True [default] / False to enable/disable it.
   396   * ldap_login auth: add report_invalid_credentials param to control wrong
   397     credentials error message (this is typically used when using multiple
   398     ldap authenticators).
   399   * Add RenderAsDocbook to actions_excluded if we have no python-xml.
   400   * Upgraded pygments to 1.2.2 (some fixes, some new lexers).
   401   * Text editor: if edit_rows==0 (user profile or config), we dynamically size
   402     the text editor height. This avoids double sliders for the editor page
   403     in most cases.
   404 
   405   Other changes:
   406   * New docs/REQUIREMENTS.
   407   * Added a less magic cgi/fcgi driver (moin.fcgi), added fixer middleware
   408     for apache2/win32 to it.
   409 
   410 
   411 Version 1.9.1:
   412   Bug fixes:
   413   * Fixed CVE-2010-0667: sys.argv security issue.
   414   * Fixed FileSessionService - use session_dir from CURRENT request.cfg (it
   415     mixed up session_dirs in farm setups).
   416     HINT: if you added the hotfix to your wikiconfig, please remove it now.
   417   * Fixed creation of lots of session files (if anon session were enabled and
   418     user agent did not support cookies).
   419   * Fixed session file storage for a non-ascii base path.
   420   * Fixed session cookie confusion for nested URL paths (like path=/ and
   421     path=/mywiki - for more info, see also "New features").
   422   * Handle cookie_lifetime / anonymous_session_lifetime upgrade issue
   423     gracefully: emit errors/warnings to log, use old settings to create
   424     cfg.cookie_lifetime as expected by moin 1.9.
   425   * flup based frontends: fixed SCGI and AJP (didn't work).
   426   * farmconfig example: remove wrong comment, add sample http/https entry.
   427   * Fixed password reset url (email content needs full URL).
   428   * Page: fixed adding of page contents (only data added now, without metadata) -
   429     fixes MoinMoinBugs/DeprecatedPageInclusionErrornousPageInstructionsProcessing
   430   * xmlrpc:
   431     * Process attachname in get/putAttachment similarly.
   432     * revertPage: convert pagename to internal representation.
   433     * Fixed auth calls used by jabberbot (needs more work).
   434   * Added missing config.umask support code (setting was not used), fixed
   435     config.umask usage for page packages.
   436   * Fixed browser language detection.
   437   * Fixed language pack generation/installation for pt-br, zh, zh-tw.
   438   * Fixed caching of formatted msgs, see MoinMoinBugs/1.9EditPageHelpLinksBroken.
   439   * Fixed usage of i18n.wikiLanguages() on class level (moved to method), failed
   440     when tools import the module (e.g. pydoc -k foo).
   441   * highlight parser:
   442     * fixed caching issue for "toggle line numbers" link.
   443     * added missing support for console/bash session
   444   * Fixed precedence of parsers: more special parsers now have precedence
   445     before moin falls back to using the HighlightParser (syntax highlighting).
   446   * Added extensions to the rst, moin and creole parser (example.rst, example.moin and
   447     example.creole attachments are rendered now when viewed).
   448   * Fixed MoinMoinBugs/LineNumberSpansForProcessInstructionsMissed for
   449     moin_wiki, highlight and plain parser.
   450   * Fixed MoinMoinBugs/LineNumberAnchorsInPreformattedText for highlight and
   451     plain parser.
   452   * Fixed MoinMoinBugs/TableOfContentsBrokenForIncludedPages.
   453   * Exception raised on calling add_msg() after send_title(), which leads to 
   454     Internal Server Error on calling several actions (diff, preview) for 
   455     deprecated pages, is replaced with warning and call stack information in 
   456     the log.
   457   * AttachFile.move_file: send events (so e.g. xapian index update happens)
   458   * SubProcess: fixed win32-specific parts, fixed imports (fixes calling of
   459     external xapian index filters)
   460   * Fixed auth methods that use redirects (like OpenID).
   461   * OpenID client:
   462     * Add setting cfg.openidrp_allowed_op, default is [].
   463     * Fixed logging in with openid and associating with an existing account.
   464     * openidrp_sreg extension: handle UnknownTimeZoneError gracefully
   465   * OpenID server:
   466     * Fixed TypeError.
   467     * Fixed processing POSTed form data AND URL args.
   468 
   469   New features:
   470   * diff: Added displaying of information about revisions (editor, size, 
   471     timestamp, comment), added revision navigation.
   472   * text editor: added @TIMESTAMP@ variable for adding a raw time stamp
   473   * xmlrpc: added renamePage and deleteAttachment methods.
   474   * Accept "rel" attribute for links (moin wiki parser).
   475   * Generate session cookie names to fix cookie path confusion and enable port-
   476     based wiki farming.
   477 
   478     HINT: New setting cfg.cookie_name:
   479 
   480     None (default): use MOIN_SESSION_<PORT>_<PATH> as session cookie name. This
   481                     should work out-of-the-box for most setups.
   482 
   483     'siteidmagic': use MOIN_SESSION_<SITEID>, which is unique within a wiki farm
   484                    created by a single farmconfig (currently, cfg.siteid is just
   485                    the name of the wiki configuration module).
   486 
   487     'other_value': use MOIN_SESSION_other_value - this gives YOU control. Just
   488                    use same value to share the session between wikis and use a
   489                    different value, if you want a separate session.
   490 
   491     HINT: Please do not use cfg.cookie_path any more - it usually should not be
   492     needed any more, as we now always put path=/ into the cookie except if you
   493     explicitly configure something else (only do that if you know exactly what
   494     you're doing and if the default does not work for you).
   495 
   496     HINT: see also the HelpOnSessions page which shows some typical configs.
   497   * Store expiry into sessions, use moin maint cleansessions script to clean up.
   498     HINT: use moin ... maint cleansessions --all once after upgrading.
   499     HINT: you may want to add a cron job calling moin ... maint cleansessions
   500           to regularly cleanup expired sessions (it won't remove not expired
   501           sessions).
   502 
   503   Other changes:
   504   * Added rtsp, rtp, rtcp protocols to url_schemas.
   505   * Added more info about index building to xapian wikiconfig snippet.
   506   * Updated the wikicreole parser to version 1.1.
   507 
   508 
   509 Version 1.9.0:
   510   Note: This is a reduced CHANGES, ommitting details from rc/beta test and
   511         also less interesting minor changes and fixes. It shows changes
   512         relative to 1.8.6 release.
   513         If you want to see full detail, read it there:
   514         http://hg.moinmo.in/moin/1.9/file/b290d938be63/docs/CHANGES
   515 
   516   New features: ==============================================================
   517   * HINT: MoinMoin requires Python 2.4 now. If you only have Python 2.3 and
   518     you don't want to upgrade it, please use MoinMoin 1.8.x.
   519   * HINT: MoinMoin is now a WSGI application.
   520     Please read the new install docs about how to use it, see:
   521     http://master19.moinmo.in/InstallDocs
   522     You also have a local copy of that page as docs/INSTALL.html.
   523   * HINT: due to big changes in the request processing and the request
   524     object (related to the WSGI refactoring), many 3rd party plugins might
   525     need code updates to work with moin 1.9.
   526   * HINT: We now offer different sized sets of system/help pages and the default
   527     underlay just contains a single page: LanguageSetup. You need to be
   528     superuser, visit that page and then install the language packs you like
   529     (minimum is the essential set for English).
   530   * HINT: LanguageSetup is the default page_front_page, you need to change that
   531     after installing language packs (see above).
   532 
   533   * New modular group and dict data access, you can use group and dict 
   534     backend modules to access group and dict data stored anywhere you like.
   535     Currently we provide these backends:
   536       * WikiGroups and WikiDicts backends get data from wikipages. They work
   537         similar to old wikidicts code (but with less caching issues :).
   538       * ConfigGroups and ConfigDicts backends get data from a dictionary
   539         defined in the wiki config.
   540       * CompositeGroups and CompositeDicts compose several backends, so data
   541         may be retrieved from several sources. For example, groups may be
   542         defined in the wiki config and on wiki pages.
   543     * Using cfg.groups and cfg.dicts, you can define the backend to use to
   544       access group and dict information (default: WikiGroups / WikiDicts
   545       backend).
   546       See the wiki/config/more_samples/ directory (groups_wikiconfig_snippet
   547       and dicts_wikiconfig_snippet).
   548     * See also the new HelpOnDictionaries and HelpOnGroups pages.
   549 
   550   * Improved Xapian indexing / search:
   551     * Moin's Xapian based search code was refactored:
   552       * It is now based on the xappy library (see MoinMoin.support.xappy).
   553       * Minimum Xapian requirement is 1.0.6 now.
   554       * Outdated and unmaintained xapwrap lib was removed.
   555       * regex search with Xapian enabled also is based on the xapian index now
   556     * Safe 2-stage xapian index rebuilding:
   557       moin index build --mode=buildnewindex  # slow, concurrent
   558       <stop wiki>
   559       moin index build --mode=usenewindex  # fast
   560       <start wiki>
   561     * Added wikiconfig snippet for xapian search.
   562 
   563   * Improved drawing support:
   564     * TWikiDraw:
   565       * Support code was refactored/moved to the twikidraw action.
   566       * Use drawing:example.tdraw to invoke it (drawing:example also still
   567         works for backwards compatibility)
   568       * Drawings are now stored as a single attachment foo.tdraw.
   569         We added a migration script that converts your existing drawings.
   570     * AnyWikiDraw:
   571       * Java applet added, source code see contrib/.
   572       * Support code for it is in anywikidraw action.
   573       * Use drawing:example.adraw to invoke it.
   574       * Drawings are stored in a similar way as foo.adraw.
   575     * cfg.extensions_mapping added for mapping of attachment file extensions
   576       to actions (currently used for anywikidraw/twikidraw action)
   577 
   578   * Themes / static files related:
   579     * Added modernized_cms theme (hides most wiki widgets from modernized if the
   580       user is not logged in).
   581     * Static file serving built-in (moved wiki/htdocs to MoinMoin/web/static/htdocs).
   582       MoinMoin.web.static has a static file serving wrapper that uses the files
   583       from htdocs subdirectory by default (docs=True).
   584       You can also give another path or switch off creation of that static wrapper.
   585       See the docstring of the static package for details.
   586     * Theme packages: do_copythemefile now copies theme files to
   587       MoinMoin/web/static/htdocs.
   588 
   589   * Syntax highlighting is based on the pygments library now, it does this for
   590     LOTS of stuff (programming languages, config files, ...) - use it like this:
   591     {{{#!highlight xxx
   592     ...
   593     }}}
   594     xxx is any of the markups pygments supports (see HelpOnParsers).
   595     Note: we still have some (deprecated) small wrappers around pygments,
   596     so the old syntax #!python/pascal/cplusplus/... still works.
   597 
   598   * Authentication improvements:
   599     * HTTP auth related (see also HelpOnAuthentication):
   600       * HTTPAuthMoin: http basic auth done by moin
   601       * HINT: auth.http.HTTPAuth is now auth.GivenAuth
   602         This was badly named from the beginning as for most servers, it just
   603         looked at REMOTE_USER environment variable and relied on the server
   604         doing the authentication (could be http basic auth or any other auth).
   605     * LDAP/AD auth: new name_callback param to create a custom wiki username (not
   606       the ldap login username)
   607     * OpenID auth:
   608       * Support for Simple Registration (SREG) extension.
   609         Basic profile fields can be copied from OpenID provider when logging in.
   610       * Support for Teams extension.
   611       * Ability to accept logins from specific OpenID providers.
   612         Login form changes based on configuration for better usability:
   613         * 0 providers: normal text input box for OpenID URL
   614         * 1 provider: hidden field, automatic form submission with JavaScript
   615         * 2+ providers: select field, uses directed identity
   616 
   617   * Sessions / cookies:
   618     * HINT: cfg.cookie_lifetime is now a tuple (anon, loggedin), giving the
   619       lifetime of the cookie in hours, accepting floats, for anon sessions and
   620       logged-in sessions. Default is (0, 12). 0 means not to use a session
   621       cookie (== not to establish a session) and makes only sense for anon users.
   622     * cfg.cookie_httponly is new and defaults to False. Please note that if you
   623       set it to True, TWikiDraw and similar stuff won't be able to use the session
   624       cookie. Thus, if your wiki page doesn't allow writing for everybody, saving
   625       a drawing will fail, because there is no session (== no logged in user) for
   626       the TWikiDraw applet's saving POSTs.
   627 
   628   * Macros:
   629     * WikiConfigHelp: added section keyword for selecting a subset of the
   630       description, e.g. <<WikiConfigHelp(section="xapian")>>
   631     * HighlighterList: show Pygments syntax highlighters (see HelpOnParsers)
   632 
   633   * Actions:
   634     * SlideShow action added (please use the "modernized" theme [default])
   635     * raw action mimetype support: ...?action=raw&mimetype=text/css
   636     * PackagePages: create package file on-the-fly in memory and send it to the
   637       client (do NOT create package.zip attachment)
   638 
   639   * Improved logging / debugging / developer support:
   640     * Main exception handler: include request url in log output.
   641     * Environment variable MOIN_DEBUGGER=off/web/external (default is "off").
   642     * Handle wikiserverconfig(_local) in the same way as wikiconfig(_local).
   643 
   644   * GUI editor: improved attachment dialog
   645 
   646   * "moin ... account homepage" script to create user homepages.
   647 
   648 
   649   Removed features: ==========================================================
   650   * Removed cfg.traceback_* settings (use logging configuration)
   651   * Removed old session code and settings:
   652     * Removed cfg.session_handler and session_id_handler (use cfg.session_service)
   653     * Removed cfg.anonymous_session_lifetime (use cfg.cookie_lifetime)
   654 
   655 
   656   Bug fixes: =================================================================
   657   * Xapian indexing:
   658     * Rely on xapian's locking (remove moin's additional and sometimes broken
   659       locking, that blocked index-rebuilds or updates sometimes).
   660     * Removed indexer threading.
   661     * Fixed (reimplemented) indexer queue.
   662     * Less disruptive xapian index rebuild.
   663   * AdvancedSearch: example didn't work, fixed
   664 
   665   * With the groups/dicts code rewrite, we fixed the caching problems that the
   666     old code (< 1.9) sometimes had.
   667 
   668   * Actions:
   669     * Abort RenamePage if renaming of main page fails (do not try to rename
   670       subpages).
   671     * AttachFile do=view: quote filename and pagename params for EmbedObject
   672       macro call
   673     * unsubscribe action: add msg types so icons get displayed
   674 
   675   * Parsers:
   676     * fixed MoinMoinBugs/LineNumbersWorkingBuggyWithHighlightParser
   677 
   678   * GUI editor: roundtripping works now for .pdf/doc/... attachment transclusion
   679 
   680   * AttachFile: added remove_attachment() and FileRemovedEvent (mail and xapian
   681     support, no jabber support yet).
   682 
   683   * Fix makeForbidden403() calls - is makeForbidden(403, ...) now.
   684   * sendmail: add more debug logging, check for empty recipients list
   685   * Fix MoinMoinBugs/MissingPageShouldn'tOfferToCreatePageForReadonlyUsers
   686   * Fix MoinMoinBugs/1.6XmlRpcPutPagePagenameEscape
   687   * Bug with "language:en" was fixed for the Moin search. Now language:
   688     behaves like described on HelpOnSearching.
   689   * Fixed MoinMoinBugs/DeprecatedIsNotRespected (search ranking, WantedPages).
   690   * OpenID: always return error messages with CancelLogin if OpenID process fails.
   691   * suid: simplify and fix, bigger selection box
   692 
   693   * patch werkzeug 0.5.1 to catch OverFlowError and ValueError so it doesn't
   694     crash when receiving invalid If-modified-since header from client.
   695 
   696 
   697   Other changes: =============================================================
   698   * 'modernized' theme:
   699     * use it by default (1.8 used 'modern')
   700     * move title_with_separators() from Modernized theme to ThemeBase
   701     * add a span with "pagepath" class to title_with_separators
   702   * add the sidebar() method from Mandarin and Gugiel themes to ThemeBase
   703   * updated flup to 1.0.2+ ( http://hg.saddi.com/flup-server/rev/6ea1ffac1bcb )
   704   * updated pygments to 1.1.1+ ( http://dev.pocoo.org/hg/pygments-main/rev/948f8885af16 )
   705   * updated parsedatetime to 0.8.7
   706   * increase surge protection limits for AttachFile to avoid trouble with image galleries
   707   * HINT: simplify wikiserver configuration by using same names as werkzeug's
   708     run_simple() call.
   709   * Removed moin account check's --lastsaved option, it is default now
   710     (checking last use with trail file did not work in 1.9 anyway).
   711   * ImageLink page has been killed (ImageLink macro is gone since 1.6.1).
   712   * Allowed disabling of timezone and language user prefs if they are
   713     part of the user's login fields (i.e. OpenID SREG).
   714   * Added option to disable local registration links and direct user
   715     to registration page at an OpenID provider instead.
   716 
   717   Developer notes: ===========================================================
   718   * groups and dicts API changes:
   719     * request.groups and request.dicts provide access to groups and dicts.
   720     * MoinMoin.wikidicts is gone, please use MoinMoin.datastruct.
   721     * LazyGroup and LazyGroupsBackend base classes for implementing backends
   722       which potentially deal with huge amounts of data (like a LDAP directory).
   723       Use MoinMoin/datastruct/backends/config_lazy_groups.py as a draft for
   724       new backends.
   725     * See http://moinmo.in/Groups2009 for more details.
   726   * i18n: new approach for defining sets of system/help pages (see i18n.strings).
   727     CheckTranslation, page packager, wikiutil.isSystemPage() use those sets.
   728   * killed deprecated macro.form attribute (didn't work as expected anyway due
   729     to WSGI refactoring) - please use macro.request.{args,form,values}
   730 
   731 
   732 Version 1.8.8:
   733   Fixes:
   734     * Fixed XSS issues (see MoinMoinBugs/1.9.2UnescapedInputForThemeAddMsg).
   735     * Fixed XSS in Despam action (CVE-2010-0828).
   736     * wikiutil.clean_input: avoid crash if it gets str type
   737     * Add RenderAsDocbook to actions_excluded if we have no python-xml
   738     * AttachFile._build_filelist: verifies readonly flag for unzip file link
   739     * attachUrl: fix wrongly generated tickets (e.g. for AttachList macro)
   740     * MoinMoin.util.filesys.dc* (dircache can't work reliably):
   741       * disable usage of dircache, deprecate dc* functions
   742       * remove all calls to filesys.dc* (dclistdir, dcdisable)
   743     * Fixed crash, see MoinMoinPatch/IncludeMacroWithDocBookFormatter
   744     * Avoid hardly recoverable crashes if #format specification is invalid
   745 
   746   New features:
   747     * auth.ldap_login: add report_invalid_credentials param to control wrong
   748       credentials error message (typically used when using multiple ldap
   749       authenticators)
   750 
   751 
   752 Version 1.8.7:
   753   Fixes:
   754   * Fixed major security issues in miscellaneous parts of moin.
   755     HINT: if you have removed superuser configuration to workaround the issue
   756     (following our security advisory), you may re-add it after installing this
   757     moin release. If you don't need superuser capabilities often, it might be
   758     wise to not have superusers configured all the time, though.
   759   * Improved package security: cfg.packagepages_actions_excluded excludes
   760     unsafe or otherwise questionable package actions by default now.
   761   * wiki parser: fixed transclusion of (e.g. video) attachments from other
   762     pages.
   763   * Fixed edit locking for non-logged in editors and cfg.log_remote_addr=False.
   764   * xmlrpc:
   765     * Process attachname in get/putAttachment similarly.
   766     * revertPage: convert pagename to internal representation.
   767   * Fixed config.umask usage for page packages.
   768   * Fixed usage of i18n.wikiLanguages() on class level (moved to method),
   769     failed when tools import the module (e.g. pydoc -k foo).
   770   * SubProcess: fixed win32-specific parts, fixed imports (fixes calling of
   771     external xapian index filters)
   772 
   773 
   774 Version 1.8.6:
   775   Bug fixes:
   776   * Xapian indexing / indexing filters:
   777     * fix deadlocks with well- and misbehaving external filters
   778     * work around indexing run crashing when encountering encoding problems
   779       with non-ascii filenames
   780     * OpenOffice/OpenDocument filters: catch UnicodeDecodeErrors (happens
   781       with password protected files)
   782   * i18n: check if languages is not initialized yet, don't crash
   783   * http_redirect: use 301 redirect for some cases
   784   * do not use httponly session cookies, makes trouble with twikidraw and ACLs
   785   * GetText2 macro: fix for named placeholder
   786   * Fix SHA -> SSHA password hash upgrade for old user profiles.
   787   * abort RenamePage if renaming of main page fails (do not try to rename
   788     subpages)
   789 
   790   New features:
   791   * search: improve search result ordering
   792   * add MS Powerpoint indexing filter (needs catppt from catdoc package)
   793   * migration scripts: make finding damaged edit-log entries easier
   794   * SubscribeUser action: support username regexes and unsubscribing.
   795     Usage (enter this into the input form field you get after invoking
   796     SubscribeUser action from the "More Actions" menu:
   797     [+|-][re:]username[,username,...] 
   798 
   799     +username: subscribes user <username> (+ is optional/default)
   800     -username: unsubscribes user <username>
   801     +re:username_re: subscribes users who match <username_re> regex.
   802     -re:username_re: unsubscribes users who match <username_re> regex.
   803 
   804 
   805 Version 1.8.5:
   806   Bug fixes:
   807     * Attachment links: fix processing of attributes (e.g. 'target', 'title')
   808     * Upgrade FCKeditor from 2.6.4 to 2.6.4.1.
   809     * PDF embedding: fix html, works better with PDF browser plugins now.
   810     * Fix typo in rightsidebar CSS.
   811     * Action revert: avoids reverting to a deleted current revision.
   812     * Action diff: enable prev/next button only in the range of given revisions.
   813     * Add a Auto-Submitted: auto-generated header to generated mails.
   814     * Include comment in email notifies.
   815     * mailimport: fix endless looping while trying to import a forwarded mail.
   816     * fuid: keep same fake_mtime for intervals of max_staleness duration.
   817     * Fixes a bug with empty list items in the GUI editor.
   818     * Improve filesys.rename compatibility code (win32).
   819     * Fix locking for CacheEntry.
   820     * Xapian indexing: catch exception when a bad zip file is encountered.
   821     * openidrp / botbouncer: fix param count for CancelLogin().
   822 
   823   New features:
   824     * Added CAS authentication.
   825     * Added httponly cookie support and use it for session cookie.
   826 
   827   Other changes:
   828     * HTTP auth: added debug logging.
   829     * Minor LDAP auth improvements.
   830     * Data browser widget:
   831       * Add (h)column<idx> css class to make it styleable.
   832       * Include only necessary autofilter options.
   833     * moin maint cleancache purges now drafts, too.
   834     * Add gopher and apt protocols to url_schemas.
   835     * Add .csv, .flv, .swf to MIMETYPES_MORE.
   836 
   837 
   838 Version 1.8.4:
   839   Bug fixes:
   840     * ACL security: fix bug in hierarchical ACL processing, more restrictive
   841       sub page ACLs did not work if the current user name did not give a match
   842       within the sub page ACL (instead, the less restrictive parent page ACL
   843       was used).
   844       Non-hierarchical ACL processing (the default) is NOT affected.
   845     * Creole parser: fix spaces in multiline elements.
   846     * Use msie.css only for Internet Explorer older than version 8, fixes
   847       e.g. the double rendering of link icons.
   848     * http auth: do auth_type comparisons case-insensitively (spec-compliant)
   849 
   850   New features:
   851     * EmbedObject macro: changed default width value for PDF files to 100%
   852                          (use a recent Adobe Reader to make this work).
   853     * CopyPage action: added a TextCha for it
   854 
   855   Other changes:    
   856     * Creole parser: Add second license: BSD
   857 
   858 
   859 Version 1.8.3:
   860   Bug fixes:
   861     * AttachFile XSS fixes: move escaping to error_msg / upload_form
   862     * AttachFile move: add more escaping (maybe not XSS exploitable though)
   863     * email attachments import with xapian indexing enabled: fix AttributeError
   864     * fix wrong links in attachment notifications
   865     * AttachFile do=view: quote filename and pagename params for EmbedObject
   866       macro call
   867     * AttachFile: fix exception when someone just clicks on upload, without
   868       giving a file
   869     * ldap_login: use None as default value for ssl certs/keys (using '' for
   870       the pathes lets it fail with Connect Error)
   871     * release edit lock if someone saves an unchanged page
   872     * fix sendmail.encodeAddress (do not [QP] encode blanks, do not un-
   873       necessarily use [QP] encoding for pure ascii mail addresses)
   874     * Fixed docs bug: see HINT about secrets configuration at version 1.8.0
   875       (1.8.0 Other changes).
   876     * backup action: add 'self' dummy argument for backup_exclude function
   877     * login action: fix formatting of error messages
   878     * unsubscribe action: add msg types so icons get displayed
   879     * fix quoting for pagehits stats (info action) - was not working for pagenames with blanks
   880     * macro.TableOfContents: bug fix for MoinMoinBugs/TableOfContentsIgnoresSectionNumbersPragma
   881 
   882   New features:
   883     * added modernized_cms theme
   884     * use url_prefix_fckeditor if you don't want to use the builtin FCKeditor
   885       of moin, but a separate one at some specific url
   886     * action.Load: added textcha feature
   887     * add mumble protocol (nice and good quality F/OSS VOIP conference chat sw)
   888     * ldap auth: new name_callback param to create a custom wiki username (not
   889       the ldap login username).
   890 
   891   Other changes:
   892     * add compatibility code for set to xapwrap.index (fix py 2.6 warnings)
   893     * wikiutil: MIMETYPES_MORE extended for .md5 as text/plain
   894 
   895 
   896 Version 1.8.2:
   897   Bug fixes:
   898     * Fix AttachFile and antispam XSS issues.
   899     * Modernized, modern and rightsidebar themes: make nonexistent or
   900       badinterwiki links gray also when they are already visited.
   901     * Fix anchor parsing for interwiki links and #redirect processing
   902       instruction.
   903     * user.apply_recovery_token: key must be of type string (for Python 2.6).
   904     * Fix MoinMoinBugs/GuiEditorBreaksIndentedTable.
   905     * Fix autofilter javascript breakage caused by including a databrowser
   906       widget.
   907     * Use per-wiki i18n cache (fixes wrong links to other farm wikis).
   908     * Made cfg.interwikiname and cfg.user_homewiki unicode objects (str only
   909       worked for ascii names).
   910     * Xapian search: fixed historysearch.
   911     * Xapian search indexing:
   912       * Fix index updating for trivial changes.
   913       * With history search enabled and in update mode, do not try to re-index
   914         old page revisions again.
   915       * With history search enabled, index page attachments only once.
   916       * Fix last modified time of xapian index (shown on SystemInfo page).
   917     * Make logging handlers defined in logging.handlers work (e.g.
   918       class=handlers.RotatingFileHandler)
   919     * Jabber notifications:
   920       * Use an RFC compliant message type.
   921       * Fix user creation notifications.
   922     * OpenID: Compatibility fix for python-openid 2.x.x (also works with
   923       1.x.x), fixes crash when trying to associate moin user to OpenID.
   924     * Have a wikiserverconfig.py in wiki/server/ so setup.py copies it.
   925     * Fixed inconsistent handling of fragments / anchor IDs:
   926       * Fixed creole and wiki parser, other parsers might need similar fixes.
   927       * IDs with blanks, non-ASCII chars etc. are now sanitized in the same way
   928         for links as well as for link targets, so the user editing a page won't
   929         have to bother with it.
   930         E.g. [[#123 foo bar]] will link to:
   931         * <<Anchor(123 foo bar)>> (moin) or {{#123 foo bar}} (creole)
   932         * headline = 123 foo bar = (moin / creole)
   933         Simple rule: if the link and the target are consistent, it should work.
   934       * The creole wiki parser created non-human-readable sha1 heading IDs
   935         before 1.8.2, now it creates same (sometimes readable) heading IDs as
   936         the moin wiki parser.
   937       * TitleIndex/WordIndex now also use IDs sanitized in that way internally.
   938       HINT: if you manually worked around the inconsistencies/bugs before, you
   939             likely have to remove those workarounds now. Same thing if you used
   940             creole's sha1 heading IDs or IDs on TitleIndex/WordIndex.
   941 
   942   Other changes:
   943     * Updated FCKeditor to 2.6.4 (== many bug fixes in the GUI editor).
   944     * Enhanced privacy by a new setting: cfg.log_remote_addr (default: True),
   945       it controls whether moin logs the remote's IP/hostname to edit-log and
   946       event-log. Use log_remote_addr = False to enhance privacy.
   947     * Streamline attachment_drawing formatter behaviour.
   948     * Search results: only redirect to a single search result for titlesearch
   949       (fuzzy goto functionality), but not for fulltext search results.
   950 
   951 
   952 
   953 Version 1.8.1:
   954   Bug fixes:
   955     * Workaround win32 locking problems (caused by spurious access denied
   956       exceptions on that platform).
   957     * Fix unicode errors that happened when password checker failed a password
   958     * WikiConfig/WikiConfigHelp: fixed wrong language table headings
   959     * Themes: make the margins around trail line work properly
   960     * "modernized" theme:
   961       * make broken links gray
   962       * add new right/center/left/justify css classes
   963       * don't force Arial
   964     * Standalone server: be more specific when catching socket exceptions,
   965       treat socket errors in http header emission in the same way.
   966     * GUI editor:
   967       * Fix heading levels when inserting new headings.
   968       * Fix headers already sent exception when using e.g. edit LOCKing.
   969     * Xapian indexing: fixed missing import for execfilter (only happened on
   970       non-posix platforms like win32)
   971 
   972   * New features:
   973     * Themes:
   974      * Make the TOC shrinkwrap, add white background to navigation macro.
   975        The table of contents looked bad spanning the whole width of the page.
   976        It's made to shrinkwrap now, so it will only get as wide, as the longest
   977        heading. We use display:inline-table, so this won't work in MS IE6,
   978        which still displays it the old way.
   979        Navigation macro now has a white background, to make it more readable
   980        when it's floating over a pre block or TOC.
   981      * Make the numbers in lists in table of contents right-aligned.
   982      * Refactored and extended theme.html_stylesheets() to make alternate
   983        stylesheets possible. Stylesheet definitions now can either be:
   984        2-tuples: (media, href)  # backwards compatibility
   985        or:
   986        3-tuples: (media, href, title)  # new, for defining alternate stylesheets
   987        This works within themes as well as in the wiki config.
   988        See also: http://www.w3.org/Style/Examples/007/alternatives.html
   989 
   990 
   991 Version 1.8.0:
   992   Note: This is a reduced CHANGES, ommitting details from rc/beta test and
   993         also less interesting minor changes and fixes. It shows changes
   994         relative to 1.7.2 release.
   995         If you want to see full detail, read it there:
   996         http://hg.moinmo.in/moin/1.8/file/6130eab15936/docs/CHANGES
   997 
   998   New Features: ==============================================================
   999     * HINT: New "modernized" theme - if you use "modern" [default], try:
  1000       theme_default = 'modernized'
  1001       If you find problems with "modernized", please report them because we
  1002       want to use it as default theme in future.
  1003     * GUI Editor:
  1004       * upgraded to use FCKEditor version 2.6.3
  1005       * user can insert and modify various types of MoinMoin links
  1006     * New plugin_dirs setting to allow multiple plugin pathes (additional to
  1007       the automatically configured plugin_dir [default: data_dir/plugin]).
  1008     * @EMAIL@ expands to a MailTo macro call with the obfuscated email address
  1009       of the current user.
  1010     * New macros "WikiConfig" and "WikiConfigHelp".
  1011     * Per-parser quickhelp, 'quickhelp' class variable of parser class.
  1012     * Secure session cookies for https (see cfg.cookie_secure).
  1013     * Added left/center/right/justify css classes to builtin themes.
  1014       Use them like:
  1015       {{{#!wiki justify
  1016       this content is justified....
  1017       }}}
  1018 
  1019   Removed Features: ==========================================================
  1020     * HINT: url_prefix setting (use url_prefix_static or just use the default)
  1021     * traceback_log_dir setting (we just use logging.exception)
  1022     * editor_quickhelp setting (replaced by per-parser quickhelp)
  1023     * Restoring backups with the backup action and related settings (while
  1024       creating backups is no big issue and should work OK, restoring them
  1025       had fundamental issues related to overwriting or not-overwriting of
  1026       existing files - thus we removed the "restore" part of the action and
  1027       recommend that you just contact the wiki server admin in case of trouble,
  1028       give him your wiki backup file and let him carefully restore it.)
  1029     * Removed unmaintained DesktopEdition (moin 1.5.x style) and phpwiki
  1030       migration scripts from contrib/ directory.
  1031 
  1032   Bug Fixes: =================================================================
  1033     * GUI Editor - fixed lots of bugs.
  1034     * Fixing https detection for servers using HTTPS=1 and also for WSGI
  1035       servers not using HTTPS/SSL_ environment, but just wsgi.url_scheme.
  1036     * Search results: link to 'view' rendering of found attachments.
  1037     * Standalone server: fix serverClass and interface argument processing,
  1038       announce used serverClass in log output.
  1039     * mointwisted: fixed Twisted start script.
  1040     * Logging:
  1041       * Use logging framework for messages emitted by warnings module (e.g.
  1042         DeprecationWarning), silence some specific warnings.
  1043       * Removed superfluous linefeeds in timing log output.
  1044     * Bug fix for language not installed (MoinMoinBugs/WikiLanguageNotDefined).
  1045     * Fixed editbar hidden comment link cosmetics for sidebar themes (hide the
  1046       complete list element).
  1047     * MoinMoinBugs/DoubleScriptNameInSitemap (fixing urls given by sitemap
  1048       action, if the wiki does not run in the root url of the site)
  1049     * Fixed backup action configuration (broke on win32).
  1050     * Fixed MoinMoinBugs/PackagesAddRevision.
  1051     * SyncPages: add workaround for callers calling log_status with encoded
  1052       bytestrings.
  1053     * Fixed dbw_hide_buttons javascript.
  1054     * HINT: Jabber bot can now be configured to use an authentication realm
  1055       which is different from the server's hostname; the xmpp_node
  1056       configuration parameter can now contain a full JID and the xmpp_resource
  1057       parameter is no longer supported.
  1058 
  1059   Other Changes: =============================================================
  1060     * HINT: new configuration for misc. secrets, please use either:
  1061           secrets = "MySecretLooongString!" # one secret for everything
  1062       or:
  1063           secrets = {
  1064               'xmlrpc/ProcessMail': 'yourmailsecret', # for mailimport
  1065               'xmlrpc/RemoteScript': 'yourremotescriptsecret',
  1066               'action/cache': 'yourcachesecret', # unguessable cache keys
  1067               'wikiutil/tickets': 'yourticketsecret', # edit tickets
  1068               'jabberbot': 'yourjabberbotsecret', # jabberbot communication
  1069           }
  1070       Secret strings must be at least 10 chars long.
  1071       Note: mail_import_secret setting is gone, use
  1072             secrets["xmlrpc/ProcessMail"] instead of it.
  1073       Note: jabberbot secret setting is gone, use
  1074             secrets["jabberbot"] instead of it.
  1075     * HINT: user_autocreate setting was removed from wiki configuration and
  1076       replaced by a autocreate=<boolean> parameter of the auth objects that
  1077       support user profile auto creation.
  1078     * moin import irclog: use irssi parser to format logs, mapped .irc
  1079       extension to text/plain mimetype.
  1080     * HINT: backup action: backup_exclude (default: "do not exclude anything")
  1081       is now a function f(filename) that tells whether a file should be
  1082       excluded from backup.
  1083       You can get the old regex exclusion functionality by using:
  1084       backup_exclude = re.compile(your_regex).search
  1085       Be careful with your regex, you might need to use re.escape() to escape
  1086       characters that have a special meaning in regexes (e.g.: \.[] etc.).
  1087       If in doubt, maybe just leave backup_exclude at the default and don't
  1088       exclude anything.
  1089     * Speed up javascript comments processing on IE by getElementsByClassName()
  1090     * Added sk (slovak) i18n, updated i18n.
  1091 
  1092 
  1093 1.7.3:
  1094   New features:
  1095     * Secure session cookies for https, see cfg.cookie_secure.
  1096     * Add left/center/right/justify classes to builtin themes.
  1097 
  1098   Fixes:
  1099     * Python 2.3 compatibility fixes.
  1100     * Fixed https detection for servers using HTTPS=1 and also for wsgi servers
  1101       not using HTTPS/SSL_ environment, but just wsgi.url_scheme.
  1102     * GUI editor:
  1103       * Fix crash when editing a page with non-ASCII pagename and inserting a link
  1104       * Fix "headers already sent exception" with edit LOCKs.
  1105     * i18n.__init__: Bug fix for wiki language not installed.
  1106     * Fixed URLs given by sitemap action, if the wiki does not run at / URL.
  1107     * Search results: link to 'view' rendering of found attachments
  1108     * Logging:    
  1109       * Removed superfluous linefeed in timing log output.
  1110       * Use logging framework for messages emitted by warnings module (e.g.
  1111         DeprecationWarning), silence some specific warnings.
  1112     * Fix dbw_hide_buttons javascript.
  1113     * Standalone server:
  1114       * fix serverClass argument processing
  1115       * fix --interface="" argument processing
  1116     * mointwisted:
  1117       * added missing pidFile parameter
  1118       * better use Config.name for pidFile to avoid conflicts and keep same
  1119         behaviour as in the past
  1120     * Jabber bot can now be configured to use an authentication realm which
  1121       is different from the server's hostname
  1122 
  1123 
  1124 Version 1.7.2:
  1125   Fixes:
  1126     * Fix leakage of edit-log file handles (leaked 1 file handle / request!).
  1127     * Fix for MoinMoinBugs/SystemAdminMailAccountData (using POST and forms)
  1128     * Wiki parser: avoid IndexError for empty #! line
  1129     * MonthCalendar macro: fix parameter parsing / url generation
  1130     * Xapian indexing filters (MoinMoin/filter/ or data/plugin/filter/):
  1131       Some indexing filter scripts (e.g. for MS Word documents or PDF files)
  1132       failed on windows because of the single-quote quoting we used (that
  1133       works on Linux and other Posix systems). The fix introduces platform-
  1134       dependant automatic quoting, using double-quotes on win32 and single-
  1135       quotes on posix.
  1136       HINT: if you use own filter plugins based on execfilter, you have to
  1137       update them as the filename quoting (was '%s') is now done automatically
  1138       and must not be part of the command string any more (now just use %s).
  1139       See MoinMoin/filter/ for some up-to-date code (esp. the PDF filter).
  1140     * Prevent CategoryTemplate being listed as a category (it is a Template,
  1141       but matched also the category regex) - added to sample wikiconfig.
  1142     * LDAP auth: fix processing of TLS options
  1143     * UpdateGroup xmlrpc server side: fix wrong arg count error
  1144     * UpdateGroup client: use multicall / auth_token, refactor code so that
  1145       updateGroup function is reusable.
  1146     * Improve Python 2.3 compatibility, add notes where 2.4 is required.
  1147 
  1148 
  1149 Version 1.7.1:
  1150   New features:
  1151     * New 'cache' action (see developer notes).
  1152 
  1153   Fixes:
  1154     * Security fix: XSS fix for advanced search form
  1155     * Avoid creation of new pagedirs with empty edit-log files by just
  1156       accessing a non-existant page. If you used 1.7 before, you likely have
  1157       quite some trash pagedirs now and you can clean them up by using:
  1158       moin --config-dir=... --wiki-url=... maint cleanpage
  1159       This will output some shell script (please review it before running!)
  1160       that can be used to move trash pages into some trash/ directory and also
  1161       moves deleted pages into some deleted/ directory. Maybe keep a copy of
  1162       those directories for a while just for the case.
  1163     * Server specific fixes:
  1164       * standalone (wikiserver.py): fix --pidfile and --group option, fix
  1165         operation without a wikiserverconfig.py (use builtin defaults).
  1166       * mod_python: work around mod_python 3.3.1 problems with file uploads.
  1167         Note: if you are still using mod_python, we strongly recommend you
  1168 	      try out mod_wsgi (in daemon mode) - it has less bugs, better
  1169 	      security, better separation, WSGI is a Python standard, and moin
  1170 	      developers also use WSGI. See HelpOnInstalling/ApacheWithModWSGI.
  1171     * revert action: fixed for deleted pages.
  1172     * Search:
  1173       * Xapian indexing: Removed crappy "hostname" tokenization.
  1174         Fixes MoinMoinBugs/1.7 XapianNotWorkingWithLeadingNumbersInTitle.
  1175         Also tokenize CamelCase parts of non-wikiwords.
  1176       * Make query parser reject more invalid input.
  1177       * If query parsing raises a BracketError, at least tell what the problem
  1178         is (and not just raise empty  ValueError).
  1179       * Category search: ignore traling whitespace after ----
  1180     * Argument parser:
  1181       * Fixed sort() usage in UnitArgument to be Python 2.3 compatible.
  1182       * Fixed MoinMoinBugs/TypeErrorInWikiutils.
  1183     * Macros:
  1184       * TableOfContents: skip outer-most <ol> levels when page isn't using
  1185         the biggest headings
  1186       * MonthCalendar: fix MoinMoinBugs/MonthCalendarBreaksOnApostrophe
  1187     * xslt parser: fix MoinMoinBugs/DoNotConvertUnicodeToUTF8ForXsltParser
  1188     * OpenID RP: make it compatible to python-openid 2.2.x
  1189     * PackagePages.collectpackage: removed encoding from file name of zipfile
  1190     * Surge protection: exclude localnet no matter whether user is known or not.
  1191     * Notifications: fix MoinMoinBugs/DuplicateNewUserNotification
  1192     * Script moin account create/disable/resetpw: checks for already existing
  1193       user now.
  1194 
  1195   Other changes:
  1196     * Prevent CategoryTemplate being listed as a category (it is a Template)
  1197       by changing the default page_category_regex.
  1198 
  1199   Developer notes:
  1200     * New MoinMoin.action.cache - can be used to cache expensively rendered
  1201       output, e.g. generated images). Once put into the cache, moin can emit
  1202       a http response for that content very fast and very efficient (including
  1203       "304 not changed" handling.
  1204     * New file-like API in MoinMoin.caching (good for dealing with medium
  1205       to large files without consuming lots of memory).
  1206     * wikiutil.importPlugin supports getting the whole plugin module object
  1207       by giving function=None.
  1208 
  1209 
  1210 Version 1.7.0:
  1211   Note: This is a reduced CHANGES, ommitting details from rc/beta test and
  1212         also less interesting minor changes and fixes. It shows changes
  1213         relative to 1.6.3 release.
  1214         If you want to see full detail, read it there:
  1215         http://hg.moinmo.in/moin/1.7/file/76265568e8d3/docs/CHANGES
  1216 
  1217   New Features: ==============================================================
  1218     * HINT: we added generic UPDATE instructions as docs/UPDATE.html.
  1219 
  1220     * HINT: Standalone server usage changed:
  1221       * Standalone server can now be started via the "moin" script command,
  1222         optionally backgrounding itself.
  1223         See: moin server standalone --help
  1224       * In the toplevel dir, we have renamed moin.py to wikiserver.py (it was
  1225         often confused with the moin scripting command).
  1226         Now you have:
  1227         * wikiserver.py - to start the standalone server
  1228         * wikiserverconfig.py - to configure the standalone server
  1229         * wikiserverlogging.conf - to configure logging for it (default config
  1230           is ok for all day use, but can easily be modified for debugging)
  1231         * wikiconfig.py - to configure the wiki engine
  1232       * Removed old moin daemonizing script (replaced by moin server standalone
  1233         --start/stop)
  1234       * We now provide the "moin" script command also for people not using
  1235         setup.py, see wiki/server/moin.
  1236 
  1237     * Logging
  1238       * New powerful and flexible logging, please see wiki/config/logging/ -
  1239         HINT: you have to upgrade your server adaptor script (e.g. moin.cgi)
  1240         and load a logging configuration that fits your needs from there, or
  1241         alternatively you can also set MOINLOGGINGCONF environment variable
  1242         to point at your logging config file.
  1243         If you use some of our sample logging configs, make sure you have a
  1244         look INTO them to fix e.g. the path of the logfile it will use.
  1245       * Moin now logs the path from where it loaded its configuration(s).
  1246 
  1247     * Authentication / Sessions:
  1248       * HINT: New authentication plugin system, see HelpOnAuthentication. If
  1249         you do not use the builtin default for 'auth' list, you likely have to
  1250         change your configuration. See wiki/config/snippets/ for some samples.
  1251       * HINT: New session handling system (no moin_session any more, now done
  1252         internally and automatically), see HelpOnSessions for details.
  1253       * Added OpenID client and server support.
  1254         See: HelpOnAuthentication and HelpOnOpenIDProvider.
  1255       * cfg.trusted_auth_methods is a list of auth methods that put an
  1256         authenticated user into the "Trusted" ACL group.
  1257 
  1258     * User profiles / password recovery / notification:
  1259       * New newacount action for creating new user accounts/profiles. If you
  1260         don't want users creating new accounts on their own, you can add this
  1261         action to actions_excluded list.
  1262       * New recoverpass action for password recovery:
  1263         If you forgot your password, recoverpass sends you an email with a
  1264         password recovery token (NOT the encrypted password) that is valid
  1265         for 12 hours.
  1266       * New moin account resetpw script for resetting a user's password by
  1267         the wiki admin.
  1268       * New preferences plugin system, see MoinMoin/userprefs/__init__.py.
  1269       * New notification system with an optional jabber notification bot, see
  1270         HelpOnNotification. HINT: wiki users have to check their notification
  1271         settings, esp. if they want to receive trivial update notifications.
  1272 
  1273     * The diff action now has navigation buttons for prev/next change and also
  1274       a revert button to revert to the revision shown below the diff display.
  1275     * ThemeBase: support Universal Edit Button, see there for details:
  1276       http://universaleditbutton.org/
  1277     * ?action=info&max_count=42 - show the last 42 history entries of the page.
  1278       max_count has a default of default_count and a upper limit of
  1279       limit_max_count - you can configure both in your wiki config:
  1280       cfg.history_count = (100, 200) # (default_count, limit_max_count) default
  1281     * The CSV parser can sniff the delimiter from the first CSV line so other
  1282       delimeters than ";" can be used.
  1283     * Admonition support. Added styling for tip, note, important, warning 
  1284       and caution in the modern theme. For more info see HelpOnAdmonitions.
  1285     * DocBook-formatter:
  1286       * supports HTML entities like &rarr; and &#9731;
  1287       * supports the FootNote macro
  1288       * supports bulletless lists
  1289       * support for admonitions
  1290       * will export the wiki page's edit history as the generated article's
  1291         revision history. Doesn't add history of included pages.
  1292       * supports for the MoinMoin comment element, though only inline comments
  1293         are likely to be valid since the DocBook remark is an inline element.
  1294     * New Hits macro: shows the total hits for the page it is used on.
  1295 
  1296   Removed Features: ==========================================================
  1297     * HINT: Removed attachments direct serving (cfg.attachments - this was
  1298             deprecated since long!). Use AttachFile action to serve attachments.
  1299     * Duplicated file attachment upload code was removed from Load action (just
  1300       use AttachFile action to deal with attachments).
  1301     * Removed 'test' action. If you like to run unit tests, use py.test.
  1302     * Removed Login macro.
  1303 
  1304   Bug Fixes: =================================================================
  1305     * Better handling of ImportErrors (farmconfig, macros, wikiserverconfig).
  1306     * Fix failure of detection of on-disk cache updates.
  1307     * Fix traceback in filesys.py on Mac OS X when "import Carbon" fails.
  1308 
  1309     * AttachFile action / file up- and download / zip support:
  1310       * WSGI: use wsgi.file_wrapper (or a builtin simple wrapper). Fixes memory
  1311         consumption for sending of large file attachments.
  1312       * FastCGI: flush often. Fixes memory consumption for sending of large
  1313         file attachments.
  1314       * Use the open temporary file for receiving file attachment uploads
  1315         (fixes big memory consumption for large file uploads).
  1316       * Catch runtime errors raised by zipfile stdlib modules when trying to
  1317         process a defective zip.
  1318       * When unzipping member files, decode their filenames from utf-8 and
  1319         replace invalid chars.
  1320       * Make error msg less confusing when trying to overwrite a file attachment
  1321         without having 'delete' rights.
  1322 
  1323     * HINT: page_*_regex processing had to be changed to fix category search.
  1324       If you don't use the builtin (english) defaults, you will have to change
  1325       your configuration:
  1326         old (default): page_category_regex = u'^Category[A-Z]'
  1327         new (default): page_category_regex = ur'(?P<all>Category(?P<key>\S+))'
  1328       As you see, the old regex did work for detecting whether a pagename is
  1329       a category, but it could not be used to search for a category tag in the
  1330       page text. The new regex can be used for both and identifies the complete
  1331       category tag (match in group 'all', e.g. "CategoryFoo") as well as the
  1332       category key (match in group 'key', e.g. "Foo") by using named regex
  1333       groups. \S+ means the category key can be anything non-blank.
  1334       If you like to simultaneously support multiple languages, use something
  1335       like this: ur'(?P<all>(Kategorie|Category)(?P<key>\S+))'
  1336       HINT: after changing your configuration, please rebuild the cache:
  1337         * stop moin
  1338         * moin ... maint cleancache
  1339         * start moin
  1340       If you don't do this, your groups / dicts will stop working (and also
  1341       your ACLs that use those groups). You better do a test whether it works.
  1342 
  1343     * Xapian search / indexing / stemming:
  1344       * Use text/<format> as mimetype for pages.
  1345       * Index also major and minor for mimetypes, so it will find 'text' or
  1346         'plain' as well as 'text/plain'
  1347       * Fix searching for negative terms.
  1348       * Improve result list ordering.
  1349       * Index filters: redirect stderr to logging system.
  1350       * Remove crappy num regex from WikiAnalyzer, improve tokenization.
  1351       * Fix AttributeError that happened when trying to access an attribute only
  1352         used with xapian search (but regex search is not done by xapian)
  1353       * Fix IndexErrors happening when pages are renamed/nuked after the index
  1354         was built.
  1355       * Fixed indexing of WikiWords (index "WikiWords", "Wiki" and "Words").
  1356       * Fix crash if default language is un-stemmable.
  1357       * xapian_stemming: removed some strange code (fixes search
  1358         title:lowercaseword with xapian_stemming enabled)
  1359       * Fixed category indexing (index CategoryFoo correctly as CategoryFoo, not
  1360         Foo - for all languages, see page_*_regex change above).
  1361     * Builtin search: support mimetype: search for pages for the builtin search
  1362       engine (using text/<format>).
  1363 
  1364     * Parser fixes:
  1365       * Wiki: fix subscript parsing (was broken for cases like 'a,,1,2,,').
  1366       * Docbook: fixed detection of WikiWords.
  1367       * All: Add ssh protocol to url_schemas for ssh:... URLs.
  1368 
  1369     * XMLRPC:
  1370       * Fix xmlrpc request.read() call to use content-length, if available,
  1371         fixes hangs with wsgiref server.
  1372       * Wiki xmlrpc getPageInfoVersion() fixed:
  1373         * works correctly now for old page versions (was unsupported)
  1374         * works correctly now for current page version (reported wrong
  1375           data when a page had attachment uploads after the last page
  1376           edit)
  1377         * returns a Fault if it did not find a edit-log entry
  1378 
  1379   Other Changes: =============================================================
  1380     * Using better ACLs and comments on system/help pages now, just taking
  1381       away 'write' permission, but using default ACLs for everything else.
  1382     * HINT: If you want to use xapian based indexed search, you need to have
  1383       Xapian >= 1.0.0 (and you can remove PyStemmer in case you have installed
  1384       it just for moin - we now use the stemmer built into Xapian as it
  1385       supports utf-8 since 1.0.0).
  1386     * Changed default value of cfg.search_results_per_page to 25.
  1387     * Surge Protection: If a user is authenticated by a trusted authentication
  1388       (see also cfg.auth_methods_trusted) then he/she won't trigger surge
  1389       protection, but moin will just log a INFO level log msg with the user's
  1390       name so you can find the culprit in case he/she is overusing ressources.
  1391     * HINT: Added MyPages and CopyPage to actions_excluded because MyPages
  1392       doesn't work without special SecurityPolicy anyway and CopyPage has
  1393       questionable behaviour.
  1394     * Load action now just creates a new revision of the target page, the
  1395       target pagename defaults to the current page name and can be edited.
  1396       If the target pagename is empty, moin tries to derive the target pagename
  1397       from the uploaded file's name.
  1398       Load tries to decode the file contents first using utf-8 coding and, if
  1399       that fails, it forces decoding using iso-8859-1 coding (and replacing
  1400       invalid characters).
  1401     * HINT: cfg.show_login is gone, see code in theme/__init__.py, this may
  1402       affect many themes!
  1403     * HINT: a new userprefs/ plugin directory will be created by the usual
  1404       "moin migration data" command.
  1405     * DocBook-formatter:
  1406       * generates a valid DOCTYPE
  1407       * table support has been improved
  1408       * handling of definitions and glossaries is more robust
  1409       * supports program language and line numbering in code areas
  1410     * HINT: ldap_login behaves a bit different now:
  1411       In previous moin versions, ldap_login tended to either successfully
  1412       authenticate a user or to completely cancel the whole login process in
  1413       any other case (including ldap server down or exceptions happening).
  1414       This made subsequent auth list entries rather pointless.
  1415       Now it behaves like this:
  1416         * user not found in LDAP -> give subsequent auth list entries a
  1417           chance to authenticate the user (same happens if it finds multiple
  1418           LDAP entries when searching - it logs an additional warning then).
  1419         * user found, but wrong password -> cancel login
  1420         * ldap server not reachable or other exceptions -> give subsequent
  1421           auth list entries a chance
  1422       So please make sure that you really trust every auth list entry you have
  1423       configured when upgrading or it might maybe change behaviour in a
  1424       unexpected or unwanted way.
  1425     * ldap_login now supports failover: if it can't contact your LDAP server
  1426       (e.g. because it is down or unreachable), it will just continue and
  1427       try to authenticate with other authenticators (if there are any in
  1428       cfg.auth list). So if you have some mirroring LDAP backup server, just
  1429       put another authenticator querying it there:
  1430           ldap_auth1 = LDAPAuth(server_uri='ldap://mainserver', ...)
  1431           ldap_auth2 = LDAPAuth(server_uri='ldap://backupserver', ...)
  1432           auth = [ldap_auth1, ldap_auth2, ]
  1433 
  1434   Developer notes: ===========================================================
  1435     * Page.last_edit() is DEPRECATED, please use Page.edit_info().
  1436     * Page._last_edited() is GONE (was broken anyway), please use
  1437       Page.editlog_entry().
  1438     * New request.send_file() call, making it possible to use server-specific
  1439       optimizations.
  1440     * getText's (aka _()) 'formatted' keyword param (default: True in 1.6 and
  1441       early 1.7) was renamed/changed: it is now called 'wiki' and defaults to
  1442       False. Example calls:
  1443       _('This will NOT get parsed/formatted by MoinMoin!')
  1444       _('This will be parsed/formatted by MoinMoin!', wiki=True)
  1445       _('This will be used as a left side of percent operator. %s',
  1446         wiki=True, percent=True)
  1447     * Page.url 'relative' keyword param (default: True in 1.6 and early 1.7)
  1448       was changed to default False).
  1449     * The themedict no longer contains 'page_user_prefs' and 'user_prefs',
  1450       this may affect custom themes.
  1451     * The rst-parser's admonition class names are no longer prepended with
  1452       "admonition_". Instead the class names are now for example "note"
  1453       and not "admonition_note".
  1454 
  1455 
  1456 Version 1.6.3:
  1457   Fixes:
  1458     * Security fix: a check in the user form processing was not working as
  1459       expected, leading to a major ACL and superuser priviledge escalation
  1460       problem. If you use ACL entries other than "Known:" or "All:" and/or
  1461       a non-empty superuser list, you need to urgently install this upgrade.
  1462     * Security fix: if acl_hierarchic=True was used (False is the default),
  1463       ACL processing was wrong for some cases, see
  1464       MoinMoinBugs/AclHierarchicPageAclSupercededByAclRightsAfter
  1465     * For {{transclusion_targets}} we checked the protocol to be http(s),
  1466       this check was removed (because file: and ftp: should work also) and
  1467       it's not moin's problem if the user uses silly protocols that can't
  1468       work for that purpose.
  1469     * Fixed TableOfContents macro for included pages.
  1470     * server_fastcgi: added Config.port = None. If you want to use some port
  1471       (not a fd), you can set it now in your Config, e.g. port = 8888.
  1472     * category: search matches categories even if there are comment lines
  1473       between the horizontal rule and the real categories, e.g.:
  1474       ... some page text ...
  1475       ----
  1476       ## optionally some comments, e.g. about possible categories:
  1477       ## CategoryJustACommentNotFound
  1478       CategoryTheRealAndOnly
  1479 
  1480       Note: there might be multiple comment lines, but all real categories
  1481             must be on a single line either directly below the ---- or
  1482             directly below some comment lines.
  1483   
  1484   Other changes:
  1485     * Added 'notes' to config.url_schemas, so you can use notes://notessrv/...
  1486       to invoke your Lotus Notes client.
  1487     * After creating a new user profile via UserPreferences, you are logged
  1488       in with that user (no need to immediately enter the same name/password
  1489       again for logging in).
  1490 
  1491 
  1492 Version 1.6.2:
  1493   Fixes:
  1494     * Security fix: check the ACL of the included page for the rst parser's
  1495       include directive.
  1496     * Potential security/DOS fix: we removed cracklib / python-crack support
  1497       in password_checker as it is not thread-safe and caused segmentation
  1498       faults (leading to server error 500 because the moin process died).
  1499     * Fix moin_session code for auth methods other than moin_login (e.g. http).
  1500       If you have worked around this using moin_anon_session, you can remove
  1501       this workaround now (except if you want anon sessions for other reasons).
  1502     * Fix moin_session code to delete invalid session cookies and also create
  1503       a new session cookie if it got a valid user_obj at the same time.
  1504     * Fix xmlrpc applyAuthToken: give good error msg for empty token.
  1505     * Fixed category search, use category:CategoryFoo as search term.
  1506     * xapian_stemming = False (changed default) to workaround some problems
  1507       in the code enabled by it. Fixes the problems when searching for
  1508       lowercase or numeric titles or word fragments with the builtin search.
  1509     * Fix trail for anon users without a session, do not show a single page.
  1510     * Fix MoinMoinBugs/WikiSyncComplainsAboutTooOldMoin.
  1511     * Wiki parser: fixed strange insertion of unwanted paragraphs.
  1512     * Wiki parser: fix interwiki linking:
  1513       Free interwiki links did not change since 1.5 (they still require to match
  1514       [A-Z][A-Za-z]+ for the wikiname part, i.e. a ASCII word beginning with an
  1515       uppercase letter).
  1516       Bracketed interwiki links now behave similar to how they worked in 1.5:
  1517       Moin just splits off the part left of the colon - no matter how it looks
  1518       like. It then tries to find that in the interwiki map. If it is found,
  1519       a interwiki link gets rendered. If it is not found, moin will render a
  1520       link to a local wiki page (that has a colon in the pagename). It will
  1521       also render a local wiki page link if there is no colon at all, of course.
  1522       Examples:
  1523       [[lowercasewikiname:somepage]] does an interwiki link (if in the map).
  1524       [[ABC:n]] does a local link to page ABC:n (if ABC is NOT in the map).
  1525     * Wiki parser: fix interwiki linking for the case that there are query args
  1526       in the interwiki map entry and you give additional query args via link
  1527       markup (uses correct query arg separator now), e.g.:
  1528       [[Google:searchterm|search this|&foo=bar]]
  1529     * Creole parser: fixed bug that prevents images inside links.
  1530     * Python parser: catch indentation error.
  1531     * PageEditor: fixed copyPage for write restricted pages.
  1532     * GUI editor: fixed javascript error with too complex word_rule regex,
  1533       see MoinMoinBugs/GuiEditorSyntaxError.
  1534     * Fixed FCKeditor dialog boxes for FireFox3.
  1535     * NewPage macro/newpage action: fixed for non-ascii template pagenames.
  1536     * FootNote macro: Fix MoinMoinBugs/FootNoteNumbering.
  1537     * EmbedObject macro: bug fix for image mimetype
  1538     * WSGI:
  1539       * fix TWikiDraw saving a drawing by also evaluating the query args.
  1540       * work around unpythonic WSGI 1.0 read() API, fixing broken xmlrpc
  1541         putPage with mod_wsgi
  1542     * Fix highlighting (see MoinMoinBugs/SearchForPagesWithComments).
  1543     * Fix logfile code for EACCESS errors.
  1544     * Removed the "logging initialized" log messages because it was issued once
  1545       per request for CGI.
  1546 
  1547   Other changes:
  1548     * Show "Comments" toggling link in edit bar only if the page really
  1549       contains comments.
  1550     * Made default configuration of surge protection a bit more forgiving,
  1551       especially for edit action which is currently also used for previews.
  1552     * Updated i18n, system/help pages, added Macedonian system text translation.
  1553     * Improved moin xmlrpc write command's builtin docs and auto-append
  1554       ?action=xmlrpc2 to the target wiki url given.
  1555 
  1556 
  1557 Version 1.6.1:
  1558   New features:
  1559     * Improved params for [[target|label|params]]:
  1560       Added accesskey link tag attribute, e.g.: [[target|label|accesskey=1]].
  1561       Additionally to specifying link tag attributes (like class=foo), you can
  1562       now also specify &key=value for getting that into the query string of
  1563       the link URL.
  1564       The "&" character is important, don't forget it or it won't get into the
  1565       query string!
  1566       E.g. for an attachment, you can use:
  1567       [[attachment:foo.pdf|Direct download of foo.pdf|&do=get]]
  1568       E.g. for linking to some specific diff, you can use:
  1569       [[SomePage|see that diff|&action=diff,&rev1=23,&rev2=42]]
  1570       See also the updated HelpOnLinking page!
  1571     * AdvancedSearch: make multipe categories/languages/mimetype selections possible
  1572     * Added a configuration directive to only do one bind to the LDAP server.
  1573       This is useful if you bind as the user the first time.
  1574       ldap_bindonce = False # default
  1575 
  1576   Fixes:
  1577     * Fix XSS issue in login action.
  1578     * Fix wrong pagename when creating new pages on Mac OS X - that was a big
  1579       showstopper for moin 1.6.0 on Mac OS X.
  1580     * Fixed 1.6 migration script:
  1581       Make sorting python 2.3 compatible.
  1582       Just skip corrupted event log lines.
  1583       Fix link conversion by using data.pre160 as data_dir.
  1584       Fix bad /InterWiki pagenames when encountering interwiki links with bad
  1585       wiki names.
  1586       Improve ImageLink conversion by using its argument parser code.
  1587       Added STONEAGE_IMAGELINK (default: False) switch to wiki markup converter,
  1588       toggle it if you had a very old ImageLink macro in production and the
  1589       converter output has target and image interchanged.
  1590       Fixed UnicodeDecodeError for wrongly encoded attachment filenames.
  1591     * Wiki parser:
  1592       Fix parsing of link/transclusion description and params.
  1593       Fix relative attachment targets.
  1594       Fix supported URL schemes (some got lost since 1.5.8).
  1595       Showing an upload link for non-existing non-text/non-image transclusions
  1596       now (like e.g. *.pdf).
  1597     * RST parser: fix attachment: and drawing: processing
  1598     * Fix quickhelp when editing RST markup pages.
  1599     * Fix Despam action: editor grouping was broken, increase time interval
  1600       to 30 days.
  1601     * Fix AdvancedSearch domain:system search crashing.
  1602     * Only switch off xapian search if we didn't use it because of missing index.
  1603     * Fix saving twikidraw drawings by removing 'java' from spider regex.
  1604     * Fix classic theme's unsubscribe icon's action link.
  1605     * Fix AttachFile action: don't show unzip for packages, only show install
  1606       for superuser.
  1607     * Fix "su user" troubles on UserPreferences.
  1608     * Removed unit tests from ?action=test (due to changes in our test
  1609       environment, using py.test now, this was broken).
  1610     * Duplicated the top directories' moin.py to wiki/server/moin.py so it gets
  1611       installed by setup.py.
  1612     * Fix MoinMoinBugs/1.6.0LanguageIgnoreBrowserConfigurationError
  1613     * Fix MoinMoinBugs/MoveAttachmentNotWorkingWithModPython
  1614     * Fix MoinMoinBugs/1.6.0SupplementationAndAccessRights
  1615     * Fix MoinMoinBugs/RenamingUserAllowsOldUsernameToLogin
  1616     * Fix MoinMoinBugs/GuiEditorExcelPasteExpatErrorUnboundPrefix
  1617 
  1618   Other changes:
  1619     * I18n texts, system and help pages updated, please update your underlay
  1620       directory (see wiki/underlay/...).
  1621     * Improved "moin" script help, invoke it with "moin ... package command --help".
  1622     * Added some .ext -> mimetype mappings missing on some systems (like Mac OS X).
  1623     * Removed ImageLink macro, as this can be easily done with moin wiki link
  1624       syntax now - see HelpOnMacros/ImageLink (the 1.6 migration scripts convert
  1625       all ImageLink calls to moin wiki link syntax).
  1626     * Updated EmbedObject macro.
  1627 
  1628 
  1629 Version 1.6.0:
  1630  * This is a reduced CHANGES, ommitting details from rc/beta test and also
  1631    less interesting minor changes and fixes. If you want to see full detail,
  1632    read it there: http://hg.moinmo.in/moin/1.6/file/640f21787334/docs/CHANGES
  1633 
  1634    It took MoinMoin development a lot of work and time to implement all the new
  1635    and fixed stuff, so please, before asking for support:
  1636    * take the time to read all the stuff below
  1637    * read the new help pages (copy them from wiki/underlay/ directory)
  1638 
  1639  * HINT: If you are upgrading from a older moin version and want to keep your
  1640    existing data directory, it is essential that you read and follow
  1641    README.migration because the wiki markup and user profiles changed significantly.
  1642    See also more HINTs below...
  1643 
  1644   New features: ==============================================================
  1645 
  1646   User interface: ------------------------------------------------------------
  1647     * Removed "underscore in URL" == "blank in pagename magic" - it made more
  1648       trouble than it was worth. If you still want to have a _ in URL, just
  1649       put a _ into pagename.
  1650     * Discussion pages, see FeatureRequests/DiscussionAndOrCommentPages.
  1651     * cfg.password_checker (default: use some simple builtin checks for too
  1652       easy passwords and, if available, python-crack).
  1653       Use password_checker = None to disable password checking.
  1654     * We now have a drafts functionality (no */MoinEditorBackup pages any
  1655       more):
  1656       * If you edit a page and cancel the edit, use preview or save, a draft
  1657         copy gets saved for you to a internal cache area (data/cache/drafts/).
  1658       * If it is a save what you did and it succeeds, the draft copy gets
  1659         killed right afterwards.
  1660       * If you accidentally used cancel or your browser or machine crashes
  1661         after you used preview, then just visit that page again and edit it.
  1662         the editor will notify you that there is a draft of this page and you
  1663         will see a "Load draft" button. Click on it to load the draft into the
  1664         editor and save the page.
  1665       * The draft storage is per user and per page, but only one draft per page.
  1666     * cfg.quicklinks_default and cfg.subscribed_pages_default can be used to
  1667       preload new user profiles with configurable values.
  1668     * attachment links for non-existing attachments look different now:
  1669       the note about the non-existing attachment moved to the link title,
  1670       the link is shown with nonexistent class (grey).
  1671     * attachment embeddings for non-existing attachments show a grey clip
  1672     * The list of InterWiki sites is editable in the wiki (page InterWikiMap),
  1673       it is getting reloaded every minute.
  1674     * We support some new languages and also have new underlay pages, thanks
  1675       to all translators and people helping with the docs!
  1676 
  1677   Actions: -------------------------------------------------------------------
  1678     * Synchronisation of wikis using the SyncPages action.
  1679     * Xapian (see http://xapian.org/) based indexed search code.
  1680       To use this:
  1681       * Install xapian-core and xapian-bindings on your machine.
  1682         We used 0.9.4, but newer code should hopefully work, too.
  1683       * cfg.xapian_search = True
  1684       * Execute this to build the index:
  1685         $ moin ... index build   # indexes pages and attachments
  1686         $ moin ... index build --files=files.lst  # same plus a list of files
  1687         You should run those commands as the same user you use for your wiki,
  1688         usually this is the webserver userid, e.g.:
  1689         $ sudo -u www-data moin --config=... --wiki-url=wiki.example.org/ \
  1690                index build --files=files.lst
  1691     * New searches:
  1692         - LanguageSearch: language:de
  1693         - CategorySearch: category:Homepage
  1694         - MimetypeSearch: mimetype:image/png (for attachments/files)
  1695         - DomainSearch: domain:underlay or domain:standard
  1696         - History Search: available in advanced ui
  1697       Note: Some currently only available when Xapian is used.
  1698     * New config options and their defaults:
  1699         xapian_search        False  enables xapian-powered search
  1700         xapian_index_dir     None   directory for xapian indices
  1701                                     (can be shared for wiki farms)
  1702         xapian_stemming      True   toggles usage of stemmer, fallback
  1703                                     to False if no stemmer installed
  1704         search_results_per_page 10  determines how many hits should be
  1705                                     shown on a fullsearch action
  1706         xapian_index_history False  indexes all revisions of pages to
  1707                                     allow searching in their history
  1708     * Speeded up linkto search by avoiding read locks on the pagelinks file.
  1709 
  1710     * The action menu now calls the actions for the revision of the page you
  1711       are currently viewing. If you are viewing the current page revision, you
  1712       get the same behaviour as in moin 1.5, but if you are viewing an old
  1713       page revision, action "raw" will now show you the raw text of this OLD
  1714       revision (not of the current revision as moin 1.5 did it).
  1715       Note that not every action does evaluate the rev=XX parameter it gets.
  1716       Also please note that the edit, info, ... links in the editbar do NOT
  1717       use the rev parameter, but operate on the latest page revision (as
  1718       they did in moin 1.5).
  1719     * Info action lost the links for "raw", "print" and "revert" actions,
  1720       because you can now just view an old revision and select those actions
  1721       from the menu there.
  1722     
  1723     * ?action=sitemap emits a google sitemap (XML), listing all your wiki pages
  1724       and the wiki root URL.
  1725       Page                      Priority / Frequency / Last modification
  1726       --------------------------------------------------------------------
  1727       /                         1.0 / hourly / <now>
  1728       cfg.page_front_page       1.0 / hourly / page last edit
  1729       TitleIndex,RecentChanges  0.9 / hourly / <now>
  1730       content pages             0.5 / daily / page last edit
  1731       system/help pages         0.1 / yearly / page last edit
  1732 
  1733     * Action DeletePage and RenamePage can now be used for subpages of a page, too.
  1734     * Added Action CopyPage so you can use now an existing page or page hierarchy
  1735       as template for a new page, see FeatureRequests/CloneOrCopyPages.
  1736     * "Package Pages" action supports attachments now.
  1737     * Added SisterPages support:
  1738       * action=sisterpages will generate a list of url pagename lines for all
  1739         pages in your moin wiki.
  1740       * action=pollsistersites will poll all sister sites listed in
  1741         cfg.sistersites = [(wikiname, fetchURL), ...]
  1742         The fetch URL for the sistersites depends on the wiki engine, e.g.:
  1743         # moin based wiki:
  1744         ('MoinExample', 'http://moin.example.org/?action=sisterpages')
  1745         # oddmuse based wiki:
  1746         ('EmacsWiki', 'http://www.emacswiki.org/cgi-bin/test?action=sisterpages')
  1747         # JspWiki based wiki:
  1748         ('JspWiki', 'http://www.jspwiki.org/SisterSites.jsp')
  1749       * If the current page exists on some sister wiki, a link to it will be
  1750         added to the navibar.
  1751       You can use sister wikis for adding another dimension to your wiki UI: use
  1752       it for simple multi language support, or for comments, or anything else
  1753       "related" you need.
  1754       TODO: add sistersites_force with sister sites we link to even if they do not
  1755             have the page yet (will work only for moin as we don't know
  1756             pagename>url transformation of other wikis)
  1757     * showtags action that lists all tags related to a page.
  1758     * action=view does use mimetypes of EmbedObject too and text files will be shown
  1759       by using their colorized parsers
  1760 
  1761   Macros: --------------------------------------------------------------------
  1762     * RecentChanges:
  1763       * If a change has happened after your bookmark, the updated/new/renamed
  1764         icon links to the bookmark diff.
  1765       * If a page does not exist any more (because it was deleted or renamed),
  1766         we link the deleted icon to the diff showing what was deleted (for the
  1767         delete action). For the rename action, we just show the deleted icon.
  1768     * Conflict icon in RecentChanges is shown if a edit conflict is detected.
  1769     * Enhanced SystemAdmin's user browser, so a SuperUser can enable/disable
  1770       users from there.
  1771     * Included EmbedObject macro for embedding different major mimetypes:
  1772       application, audio, image, video, chemical, x-world. 
  1773       You are able to change the defaults of allowed mimetypes in the config
  1774       var mimetypes_embed. The config var mimetypes_xss_protect is used to deny
  1775       mimetypes. The order of both variables is Allow, Deny (mimetypes_embed,
  1776       mimetypes_xss_protect).
  1777     * Added support for @SELF to the NewPage macro.
  1778     * GetText2 macro that allows to translate messages that contain data.
  1779     * Make the FootNote macro filter duplicates and display a list of numbers
  1780       instead of a list of identical footnotes. Thanks to Johannes Berg for the
  1781       patch.
  1782 
  1783   Parsers: -------------------------------------------------------------------
  1784     * Moin Wiki parser: Changed markup for links, images and macros, see these
  1785       wiki pages: HelpOnLinking, HelpOnMacros
  1786     * New wiki markup for /* inline comments */ - they get rendered as a span
  1787       with class="comment", see next item:
  1788     * There is a new item in the edit bar: "Comments". If you click it, the
  1789       visibility of all class "comment" tags will be toggled. There is a user
  1790       preferences item "show_comments" to set if the default view shows them or not.
  1791     * The wiki parser can be used with css classes now:
  1792       {{{#!wiki comment
  1793       This will render output within a div with class "comment".
  1794       You can use any wiki markup as usual.
  1795       }}}
  1796       You can also combine multiple css classes like this:
  1797       {{{#!wiki red/dotted/comment
  1798       This will render a red background, dotted border comment section.
  1799       }}}
  1800       The same thing will work for any other css classes you have.
  1801       If the css classes contain the word "comment", they will trigger some
  1802       special feature, see next item:
  1803     * Wiki nested parser/pre sections work now, using this syntax:
  1804       a) just use more curly braces if you have 3 closing in your content:
  1805          {{{{
  1806          }}} <- does not terminate the section!
  1807          }}}}
  1808       b) use {{{ + some magic string:
  1809          {{{somemagicstring
  1810          }}} <- does not terminate the section!
  1811          somemagicstring}}}
  1812       c) {{{whatever#!python
  1813          # py code
  1814          whatever}}}
  1815       Pitfall: stuff like below does not work as it did in 1.5:
  1816          {{{aaa
  1817          bbb}}}
  1818       Solution:
  1819          {{{
  1820          aaa
  1821          bbb
  1822          }}}
  1823     * Added support for ircs: URLs (secure IRC).
  1824     * New text/creole parser that allows you to use WikiCreole 1.0 markup,
  1825       use #format creole.
  1826     * HTML parser (called "html") that allows you to use HTML on the page.
  1827       Thanks to the trac team for the nice code.
  1828     * Added the diff parser from ParserMarket, thanks to Emilio Lopes, Fabien
  1829       Ninoles and Juergen Hermann.
  1830 
  1831   XMLRPC: --------------------------------------------------------------------
  1832     * actions_excluded now defaults to ['xmlrpc'] - this kind of disables the
  1833       built-in wiki xmlrpc server code (not completely: it will just answer
  1834       with a Fault instance for any request). If you want to use xmlrpc v1 or
  1835       v2, you have to remove 'xmlrpc' from the actions_excluded list (for
  1836       example if you want to use wikisync, mailimport or any other feature
  1837       using xmlrpc). If you enable xmlrpc, it will be possible that someone
  1838       changes your wiki content by using xmlrpc (it will of course honour ACLs).
  1839     * New XMLRPC methods (see doc strings for details):
  1840       * getMoinVersion
  1841       * system.multicall -- multicall support
  1842       * Authentication System: getAuthToken/appyAuthToken
  1843       * getDiff -- method to get binary diffs
  1844       * mergeDiff -- method to local changes remotely
  1845       * interwikiName -- method to get the IWID and the interwiki moniker
  1846       * getAllPagesEx -- method to get the pagelist in a special way (revnos,
  1847         no system pages etc.)
  1848       * getAuthToken -- make and authentication token by supplying username/password
  1849       * applyAuthToken -- set request.user for following xmlrpc calls (within the
  1850                           same multicall)
  1851       * getUserProfile -- method to get user profile data for request.user
  1852     * Added XMLRPC methods for attachment handling. Thanks to Matthew Gilbert.
  1853     * XMLRPC putPage method adjusted to new AuthToken, config vars 
  1854       xmlrpc_putpage_enabled and xmlrpc_putpage_trusted_only removed.
  1855 
  1856   Scripts / Commandline interface: -------------------------------------------
  1857     * moin export dump now better conforms to the theme guidelines.
  1858     * Added a --dump-user option to the moin export dump command.
  1859       Thanks to Oliver O'Halloran.
  1860 
  1861   Security / Auth / AntiSpam / etc.: -----------------------------------------
  1862     * Hierarchical ACLs are now supported, i.e. pages inheriting permissions
  1863       from higher-level pages. See HelpOnAccessControlLists.
  1864     * If you have "#acl" (without the quotes) on a page, this means now:
  1865       "this page has own (empty) ACLs, so do not use acl_rights_default here"
  1866       Please note that this is COMPLETELY DIFFERENT from having no ACL line at
  1867       all on the page (acl_rights_default is used in that case).
  1868     * Antispam master url is now configurable via cfg.antispam_master_url.
  1869       The default is to fetch the antispam patterns from MoinMaster wiki.
  1870     * Antispam now checks the edit comments against BadContent also.
  1871     * TextCHAs (text-form CAPTCHAs).
  1872       Due to increasingly annoying wiki spammers, we added the option to use
  1873       TextCHAs (for page save (not for preview!), for attachment upload, for
  1874       user creation (not for profile save)).
  1875       This function is disabled by default. If you run a wiki that is editable
  1876       by anonymous or non-approved users from the internet (i.e. All: or Known:
  1877       in ACL terms), you should enable it in your wiki config by:
  1878       textchas = { # DO NOT USE EXACTLY THESE QUESTIONS!!!
  1879           'en': {
  1880               u'H2O is ...': u'water', # bad: too common
  1881               u'2 apples and three bananas makes how many fruits?': ur'(five|5)', # good
  1882               u'2 apples and three pigs makes how many fruits?': ur'(two|2)', # good
  1883               u'2+3': ur'5', # bad: computable
  1884               u'
  1885           },
  1886           'de': { # for german users
  1887               u'H2O ist ...': u'wasser',
  1888           },
  1889       }
  1890       This means that english users will get some random question from the 'en'
  1891       set, german users will get some from the 'de' set. If there is no 'de'
  1892       set configured, moin will fallback to language_default and then to 'en',
  1893       so make sure that you at least have a 'en' set configured (or whatever
  1894       you have set as language_default).
  1895       You need to use unicode for the questions and answers (see that u"...").
  1896       For the answer, you need to give a regular expression:
  1897       * In the easiest case, this is just some word or sentence (first en
  1898         example). It will be matched in a case-insensitive way.
  1899       * For more complex stuff, you can use the power of regular expressions,
  1900         e.g. if multiple answers are correct (second en example). Any answer
  1901         matching the regular expression will be considered as correct, any
  1902         non-matching answer will be considered as incorrect.
  1903 
  1904       Tipps for making it hard to break for the spammers and easy for the users:
  1905       * Use site-specific (not too common) questions.
  1906       * Don't use too hard questions (annoys legitimate users).
  1907       * Don't use computable questions.
  1908       * Don't reuse textchas from other sites.
  1909 
  1910       textchas_disabled_group = None # (default)
  1911       Set this to some group name and noone in this group will get textchas.
  1912       E.g.: textchas_disabled_group = u'NoTextChasGroup'
  1913 
  1914     * The login page gives now the possibility to recover a lost password, thanks to 
  1915       Oliver Siemoneit. This is especially useful for wikis where access to user 
  1916       preferences is restricted by acl.
  1917     * Session handling for logged-in users and (not by default due to expiry
  1918       problems) anonymous users.
  1919     * Updated the ldap_login code from 1.5 branch, supports TLS now.
  1920       See MoinMoin/config/multiconfig.py for supported configuration options
  1921       and their defaults (and please just change what you need to change,
  1922       in your wikiconfig).
  1923     * Interwiki auth: You need to define cfg.trusted_wikis and
  1924        cfg.user_autocreate to use it. Logging in works by entering:
  1925       Name: RemoteWikiName RemoteUserName
  1926       Password: remotepass
  1927       Then moin contacts RemoteWikiName after looking it up in the interwiki
  1928       map and tries to authenticate there using RemoteUserName and remotepass.
  1929       If it succeeds, the remote wiki will return the remote user profile items
  1930       and your local moin will autocreate an account with these values.
  1931 
  1932   Server / Network / Logging: ------------------------------------------------
  1933     * The standalone server script moved to the toplevel directory. This makes
  1934       it possible to directly start moin.py without additional configuration
  1935       to run a MoinMoin DesktopEdition like wiki setup.
  1936       Be careful: DesktopEdition uses relaxed security settings only suitable
  1937       for personal and local use.
  1938     * Added TLS/SSL support to the standalone server. Thanks to Matthew Gilbert.
  1939       To use TLS/SSL support you must also install the TLSLite library
  1940       (http://trevp.net/tlslite/). Version 0.3.8 was used for development and
  1941       testing.
  1942 
  1943     * cfg.log_reverse_dns_lookups [default: True] - you can set this to False
  1944       if rev. dns lookups are broken in your network (leading to long delays
  1945       on page saves). With False, edit-log will only contain IP, not hostname.
  1946     * Added support for "304 not modified" response header for AttachFile get
  1947       and rss_rc actions - faster, less traffic, less load.
  1948 
  1949     * Added logging framework, using stdlib's "logging" module. Just do
  1950       import logging ; logging.debug("your text"). Depending on configuration
  1951       in the server Config class, your stuff will be written to screen (stderr),
  1952       to a moin logfile, to apache's error.log, etc.:
  1953       logPath = None # 'moin.log'
  1954       loglevel_file = None # logging.DEBUG/INFO/WARNING/ERROR/CRITICAL
  1955       loglevel_stderr = None # logging.DEBUG/INFO/WARNING/ERROR/CRITICAL
  1956       NOTE: this is NOT in wikiconfig, but e.g. in moin.cgi or moin.py or ...
  1957 
  1958     * Added some experimental and disabled code, that uses x-forwarded-for
  1959       header (if present) to get the right "outside" IP before a request
  1960       enters our chain of trusted (reverse) proxies.
  1961       This code has the problem that we can't configure it in wikiconfig, so
  1962       if you want to use it / test it, you have to edit the moin code:
  1963       MoinMoin/request/__init__.py - edit proxies_trusted (near the top).
  1964       We will try to make this easier to configure, but there was no time left
  1965       before 1.6.0 release for doing bigger code refactorings needed for that.
  1966 
  1967   Mail: ----------------------------------------------------------------------
  1968     * You can send email to the wiki now (requires xmlrpc), see:
  1969       FeatureRequests/WikiEmailIntegration, HelpOnConfiguration/EmailSupport
  1970 
  1971     * Mail notifications contain a link to the diff action so the user
  1972       can see the coloured difference more easily. Thanks to Tobias Polzin.
  1973 
  1974   Other changes: =============================================================
  1975     * HINT: please copy a new version of your server script from the wiki/server/
  1976       directory and edit it to match your setup.
  1977     * HINT: instead of "from MoinMoin.multiconfig import DefaultConfig" you
  1978       need to use "from MoinMoin.config.multiconfig import DefaultConfig" now.
  1979       You need to change this in your wikiconfig.py or farmconfig.py file.
  1980       See MoinMoin/multiconfig.py for an alternative way if you can't do that.
  1981     * HINT: you need to change some imports (if you have them in your config):
  1982       Old: from MoinMoin.util.antispam import SecurityPolicy
  1983       New: from MoinMoin.security.antispam import SecurityPolicy
  1984       Old: from MoinMoin.util.autoadmin import SecurityPolicy
  1985       New: from MoinMoin.security.autoadmin import SecurityPolicy
  1986     * HINT: you need to change your auth stuff, the new way is:
  1987       from MoinMoin.auth import moin_login, moin_session
  1988       from MoinMoin.auth.http import http
  1989       auth = [http, moin_login, moin_session]
  1990       Do it in a similar way for other auth methods.
  1991     * HINT: you need to change your url_prefix setting in 2 ways:
  1992       1. The setting is now called url_prefix_static (to make it more clear
  1993          that we mean the static stuff, not the wiki script url).
  1994       2. The strongly recommended (and default) value of it is '/moin_static160'
  1995          for moin version 1.6.0 (and will be ...161 for moin 1.6.1). It is
  1996          possible and recommended to use a very long cache lifetime for static
  1997          stuff now (Expires: access plus 1 year), because we require to change
  1998          the URL of static stuff when the static stuff changes (e.g. on a
  1999          version upgrade of moin) to avoid problems with stale cache content.
  2000          Your moin will be faster with lower load and traffic because of this.
  2001          For standalone server, we use 1 year expiry for static stuff now.
  2002          For Apache, Lighttpd and other "external" servers, you have to care
  2003          for configuring them to use a long expiry and change url_prefix_static
  2004          related configuration on upgrade.
  2005       HINT: if you run standalone or Twisted server, the easiest way to get a
  2006             working configuration (with server configuration matching wiki
  2007             configuration) is to NOT set url_prefix_static at all. Moin will
  2008             use matching configuration defaults in this case.
  2009     * url_prefix_action ['action'] was introduced for lowering load and traffic
  2010       caused by searchengine crawlers. Up to now, crawlers where causing a high
  2011       load in internet moin wikis because they tried to get about everything,
  2012       including all actions linked from the user interface.
  2013       Known crawlers only get 403 for most actions, but nevertheless they first
  2014       tried. There was no means keeping them away from actions due to the rather
  2015       braindead robots.txt standard. You can only disallow pathes there, but
  2016       moin's actions were querystring based, not path based (this would need
  2017       regex support in robots.txt, but there is no such thing).
  2018       This changed now. Moin is able to generate action URLs you can handle in
  2019       robots.txt, like /action/info/PageName?action=info. So if you don't want
  2020       bots triggering actions, just disallow /action/ there. Keep in mind that
  2021       attachments are handled by /action/AttachFile, so if you want attached
  2022       files and pictures indexed by search engine, don't disallow
  2023       /action/AttachFile/ in your robots.txt. In order to use this feature,
  2024       set url_prefix_action in your wikiconfig to e.g. "action".
  2025     * We use (again) the same browser compatibility check as FCKeditor uses
  2026       internally, too. So if GUI editor invocation is broken due to browser
  2027       compatibility issues or a wrong browser version check, please file a bug
  2028       at FCKeditor development or browser development.
  2029     * HINT: We removed Lupy based indexed search code. If you were brave enough
  2030       to use cfg.lupy_search, you maybe want to try cfg.xapian_search instead.
  2031 
  2032   Developer notes: ===========================================================
  2033     * We moved the IE hacks to theme/css/msie.css that gets included after all
  2034       other css files (but before the user css file) using a conditional
  2035       comment with "if IE", so it gets only loaded for MSIE (no matter which
  2036       version). The file has some standard css inside (evaluated on all MSIE
  2037       versions) and some * html hacks that only IE < 7 will read.
  2038       HINT: if you use custom themes, you want to update them in the same way.
  2039     * autofilters for databrowser widget. Thanks to Johannes Berg for the patch.
  2040     * changed formatter.attachment_link call (it is now more flexible,
  2041       because you can render the stuff between link start and link end yourself)
  2042     * Page.url() does not escape any more. You have to use wikiutil.escape()
  2043       yourself if you want to write the URL to HTML and it contains e.g. &.
  2044     * The testing wikiconfig moved to tests/wikiconfig.py, the testing wiki
  2045       is now created in tests/wiki/...
  2046     * HINT: Killed "processors" (finally), formatter method changed to:
  2047       formatter.parser(parsername, lines)
  2048     * Refactored some actions to use ActionBase base class.
  2049     * Moved "test" action from wikiaction to MoinMoin/action/
  2050       (and use ActionBase).
  2051     * Moved MoinMoin/config.py to MoinMoin/config/__init__.py.
  2052     * Moved MoinMoin/multiconfig.py to MoinMoin/config/multiconfig.py.
  2053     * Moved "SystemInfo" macro from wikimacro to MoinMoin/macro/.
  2054     * Moved wikiaction.py stuff to MoinMoin/action/__init__.py.
  2055     * Moved wikimacro.py stuff to MoinMoin/macro/__init__.py.
  2056     * Moved wikirpc.py stuff to MoinMoin/xmlrpc/__init__.py.
  2057     * Moved wikitest.py stuff to action/test.py (only used from there).
  2058     * Moved formatter/base.py to formatter/__init__.py (FormatterBase).
  2059     * Moved util/ParserBase.py to parser/ParserBase.py.
  2060     * Moved / splitted request.py into MoinMoin/request/*.
  2061       Most stuff will be broken, please help fixing it (usually some imports
  2062       will be missing and the adaptor script will need a change maybe):
  2063       Tested successfully: CGI, CLI, STANDALONE, FCGI, TWISTED
  2064     * Moved security.py to security/__init__.py.
  2065     * Moved wikiacl.py to security/__init__.py.
  2066     * Moved logfile/logfile.py to logfile/__init__.py.
  2067     * Moved mailimport.py to mail/mailimport.py.
  2068     * Moved util/mail.py to mail/sendmail.py.
  2069     * Moved auth.py to auth/__init__.py.
  2070       Moved util/sessionParser.py to auth/_PHPsessionParser.py.
  2071       teared auth code into single modules under auth/* - moin_session handling
  2072       and the builting moin_login method are in auth/__init__.py.
  2073     * Added wikiutil.MimeType class (works internally with sanitized mime
  2074       types because the official ones suck).
  2075     * Renamed parsers to module names representing sane mimetypes, e.g.:
  2076       parser.wiki -> parser.text_moin_wiki
  2077     * Added thread_monitor debugging aid. It can be activated using:
  2078       from MoinMoin.util import thread_monitor; thread_monitor.activate_hook()
  2079       and then triggered by requesting URL ...?action=thread_monitor - please
  2080       be aware that monitoring threads has a big performance impact on its own,
  2081       so you only want to temporarily enable this for debugging.
  2082       By default, it dumps its output to the data_dir as tm_<timestamp>.log,
  2083       you can change this at bottom of action/thread_monitor.py if you want to
  2084       see output in your browser.
  2085     * Introduced scope parameter to CacheEntry() - if you specify 'farm', it
  2086       will cache into a common directory for all wikis in the same farm, if you
  2087       specify 'wiki', it will use a cache directory per wiki and if you specify
  2088       'item', it will use a cache directory per item (== per page).
  2089       Creating a CacheEntry without explicit scope is DEPRECATED.
  2090     * Smileys moved from MoinMoin.config to MoinMoin.theme.
  2091     * Removed all _ magic in URLs and filenames.
  2092     * request.action now has the action requested, default: 'show'.
  2093     * Cleaned up duplicated http_headers code and DEPRECATED this function
  2094       call (it was sometimes confused with setHttpHeaders call) - it will
  2095       vanish with moin 1.7, so please fix your custom plugins!
  2096       The replacement is:
  2097           request.emit_http_headers(more_headers=[])
  2098       This call pre-processes the headers list (encoding from unicode, making
  2099       sure that there is exactly ONE content-type header, etc.) and then
  2100       calls a server specific helper _emit_http_headers to emit it.
  2101       Tested successfully: CGI, STANDALONE, FCGI, TWISTED
  2102     * setResponseCode request method DEPRECATED (it only worked for Twisted
  2103       anyway), just use emit_http_headers and include a Status: XXX header.
  2104       Method will vanish with moin 1.7.
  2105     * cfg.url_prefix is DEPRECATED, please use cfg.url_prefix_static.
  2106     * d['title_link'] is not supported any more. You can easily make that link
  2107       on your own in your theme, see example in MoinMoin/theme/__init__.py,
  2108       function "title".
  2109     * There is a new Page method called Page.get_raw_body_str that returns
  2110       the encoded page body. This is useful if you just deal with byte data
  2111       (e.g. while generating binary diffs).
  2112     * The TagStore/PickleTagStore system is used to store the syncronisation tags.
  2113     * XMLRPC functions may return Fault instances from now on
  2114     * Moin got multicall support, including a module that makes it usable on the
  2115       client-side without requiring Python 2.4
  2116     * Added no_magic to text_html formatter to disable tag autoclosing.
  2117     * MOIN_DEBUG can be set in the environment to let MoinMoin ignore exceptions
  2118       that would lead to a traceback in the browser. Thanks to Raphael Bossek.
  2119     * There is a new MoinMoin.Page.ItemCache class now with automatic cache
  2120       invalidation based on global edit-log. We currently use it to cache page
  2121       acls, speedup Page.get_rev and reading the page local edit-log.
  2122     * Added wikiutil.renderText parse and format raw wiki markup with all page elements.
  2123     * The user file format has changed, old files will be read correctly but
  2124       will silently be upgraded to the new format so old versions will not
  2125       read the new files correctly (this only affects 'subscribed_pages' and
  2126       'quicklinks' which will be lost when downgrading.)
  2127 
  2128 
  2129 Version 1.5.8:
  2130   New features:
  2131     * Added timing.log to help performance debugging. Use cfg.log_timing = True
  2132       to update <data_dir>/timing.log (default is False, meaning no logging).
  2133 
  2134       Example log entries:
  2135 
  2136 
  2137       Timestamp       PID   Timing Flag action     URL
  2138       -----------------------------------------------------------------------------
  2139       20070512 184401 22690 vvv         None       moinmoin.wikiwikiweb.de/RssFeeds
  2140       20070512 184401 22690 0.267s    - show       moinmoin.wikiwikiweb.de/RssFeeds
  2141 
  2142       Timestamp: YYYYMMDD HHMMSS (UTC)
  2143       PID: the process ID of the moin process
  2144       Timing: when action starts, it will be "vvv"
  2145               when it ends, it logs the total time it needed for execution
  2146       Flag (some are only logged at end of action):
  2147       +   Page exists
  2148       -   Page does not exist
  2149       B   user agent was recognized as bot / spider
  2150       !x! Action took rather long (the higher the x, the longer it took - this
  2151           makes it easy to grep for problematic stuff).
  2152       Action: action name (None is when no action was specified, moin assumes
  2153               "show" for that case)
  2154       URL: the requested URL
  2155 
  2156       For more information about tuning your moin setup, see:
  2157       http://moinmoin.wikiwikiweb.de/PerformanceTuning
  2158     * Added support for ircs, webcal, xmpp, ed2k and rootz protocols - we
  2159       moved all protocols to config.url_schemas, so this is not empty any more.
  2160       It is possible to use these protocols now on wiki pages and in the
  2161       navi_bar. We just generate the URLs, it is up to your browser what it
  2162       does when clicking on those links.
  2163     * cfg.traceback_show (default: 1) can be used to disable showing tracebacks.
  2164       cfg.traceback_log_dir (default: None) can be used to set a directory
  2165       that is used to dump traceback files to. Your users will get a notice to
  2166       which (random) file in that directory the traceback was been written.
  2167       NOTE: while you can feel free to set traceback_show = 0 and
  2168       traceback_log_dir = None, we will also feel free to reject bug reports
  2169       when you (or your site's users) don't give us enough information (like a
  2170       traceback file) to debug the problem. If you set traceback_show = 0,
  2171       we recommend pointing traceback_log_dir to a directory with reasonable
  2172       free space and putting a page onto your wiki that describes who has to
  2173       get contacted (usually the wiki server admin) in case a traceback happens.
  2174       The admin can then locate the traceback file and submit it to moin
  2175       development, if the bug is not already known (see MoinMoin:MoinMoinBugs).
  2176       Of course we will also need all the other details of a bug report, not
  2177       only the traceback file.
  2178 
  2179   Other changes:
  2180     * Updated spider agents list.
  2181     * Reduce bot/spider cpu usage for SystemInfo, OrphanedPages, WantedPages,
  2182       PageHits, PageSize, WordIndex macros (we just return nothing for bots).
  2183 
  2184   Bugfixes:
  2185     * XSS fixes, see http://secunia.com/advisories/24138/ (item 1 and 2).
  2186     * ACL security fixes:
  2187       * MonthCalendar respects ACLs of day pages now.
  2188       * Check the ACL for the rst markup include directive.
  2189     * Fixed cleaning of edit comments (control chars in there could damage
  2190       edit-log).
  2191     * Fixed in-process caching of antispam patterns (didn't update the cache
  2192       for multi-process, persistent servers).
  2193     * Correct encoding/decoding for surge-log data, fixes leftover
  2194       surge-logXXXXXXX.tmp files in data/cache/surgeprotect.
  2195     * Fixed mode of cache files (mkstemp creates them with 0600 mode).
  2196     * Symbolic entities with numbers (like &sup2;) did not work, fixed.
  2197     * We open data/error.log earlier now and we also use it for FastCGI.
  2198     * Fixed unicode cfg.page_group_regex.
  2199     * Fixed moin.spec to use english date format.
  2200     * GUI converter: fixed conversion of relative wiki links.
  2201     * Fixed NewPage macro button label to not be formatted as wiki text.
  2202 
  2203 Version 1.5.7:
  2204   New features:
  2205     * added url_prefix_local which is used for stuff that must be loaded from
  2206       same site as the wiki engine (e.g. FCKeditor GUI editor applet), while
  2207       url_prefix can be a remote server serving the static files (css/img).
  2208       If not set (or set to None), url_prefix_local will default to the value
  2209       of url_prefix.
  2210     * We save some CPU and disk I/O by having EditTemplates and LikePages macro
  2211       (both used on MissingPage) check whether the requesting entity was
  2212       identified as a spider (e.g. search engine bot) and do nothing in that
  2213       case. Normal users won't see any difference.
  2214     * For AttachFile, you can now choose to overwrite existing files of same
  2215       name (nice for updating files).
  2216 
  2217   Bugfixes:
  2218     * XSS Fixes:
  2219       * fixed unescaped page info display.
  2220       * fixed unescaped page name display in AttachFile, RenamePage and
  2221         LocalSiteMap actions
  2222     * WantedPages listed existing pages that are not readable for the user,
  2223       but are linked from pages that ARE readable for the user (so this is NOT
  2224       a privacy/security issue). We now don't list those pages any more as it
  2225       is pointless/confusing, the user can't read or edit there anyway.
  2226     * MoinMoin: href="http://moinmo.in/MoinMoinBugs/TableOfContentsUsesNonExistingIncludeLinks">MoinMoinBugs/TableOfContentsUsesNonExistingIncludeLinks
  2227     * MoinMoin: href="http://moinmo.in/MoinMoinBugs/ActionsExcludedTriggerError">MoinMoinBugs/ActionsExcludedTriggerError
  2228     * GUI editor/converter:
  2229       * ignore <col>/<colgroup>/<meta> elements
  2230       * support <a> within blockquote
  2231     * Remove generated=... attribute from pagelink html output (this attr is
  2232       for internal use only). w3c validator is now happier again.
  2233     * Fixed css class "userpref" (not: "userprefs") of the Login form.
  2234     * Fixed the version number check in the xslt parser for 4suite >= 1.0.
  2235     * We reset the umask to the wanted value every request. This should fix
  2236       wrong file modes when used with Twisted (twistd uses a hardcoded 0077
  2237       umask in daemonize()).
  2238     * Avoid trouble when saving pages with antispam function when MoinMaster
  2239       wiki is having troubles (catch xmlrpc Fault).
  2240 
  2241   Other changes:
  2242     * Standalone server does not do reverse DNS lookups any more (this is a
  2243       standard feature of BaseHTTPServer stdlib module, but we override this
  2244       now and just print the IP).
  2245     * We moved the IE hacks to theme/css/msie.css that gets included after all
  2246       other css files (but before the user css file) using a conditional
  2247       comment with "if IE", so it gets only loaded for MSIE (no matter which
  2248       version). The file has some standard css inside (evaluated on all MSIE
  2249       versions) and some * html hacks that only IE < 7 will read.
  2250       HINT: if you use custom themes, you want to update them in the same way.
  2251     * Improved ldap auth:
  2252       * cfg.ldap_name_attribute was removed because of new cfg.ldap_filter.
  2253         If you had ldap_name_attribute = 'sAMAccountName' before, just use
  2254         ldap_filter = '(sAMAccountName=%(username)s)' now.
  2255       * New cfg.ldap_filter used for the ldap filter string used in the ldap
  2256         search instead of the rather limited, partly hardcoded filter we used
  2257         before. This is much more flexible:
  2258         ldap_filter = '(sAMAccountName=%(username)s)'
  2259         You can also do more complex filtering expressions like:
  2260         '(&(cn=%(username)s)(memberOf=CN=WikiUsers,OU=Groups,DC=example,DC=org))'
  2261       * Added some processing to filter out result entries with dn == None.
  2262       * We set REFERRALS option to 0 before initializing the ldap server
  2263         connection (this seems to be needed for Active Directory servers).
  2264       * We support self-signed ssl certs for ldaps - completely untested.
  2265       * New cfg.ldap_surname_attribute (usually 'sn'), was hardcoded before.
  2266       * New cfg.ldap_givenname_attribute (usually 'givenName'), hardcoded before.
  2267       * New cfg.ldap_aliasname_attribute (usually 'displayName') - if this
  2268         attribute is not there or empty (in the results of the ldap lookup for
  2269         the user), we just make up the aliasname from surname and givenname
  2270         attribute.
  2271       * We only request the attributes we need from ldap (was: all attrs).
  2272       * We deny user login (and break out of auth chain) for the following cases:
  2273         * if a user is not found by ldap lookup
  2274         * if we find more than one matching entry
  2275         * if the password is empty or incorrect
  2276         * if some exception happens
  2277       * Please note that there is an updated ldap sample config in directory
  2278         wiki/config/more_samples/.
  2279       * Added experimental LDAP SSL/TLS support (untested, please help testing),
  2280         see also the sample config.
  2281     * Work around a IE7 rendering problem with long pages getting more and
  2282       more narrow. We just applied the same "fix" as we used for IE6, using
  2283       "display: none" for span.anchor for IE browsers.
  2284     * RSS feed related:
  2285       * We used to emit a <link> tag for the action=rss_rc RSS feed on any
  2286         page. This was changed, we now emit that link only on RecentChanges and
  2287         the current user's language translation of RecentChanges.
  2288         This was changed because Google Toolbar requests the RSS feed linked
  2289         by such a link tag every time it sees one. Thus, if you used the wiki
  2290         normally, it requested the RSS feed every few seconds and caused
  2291         problems due to surge protection kicking in because of that.
  2292       * HINT for custom theme users: if your theme code calls
  2293         rsslink(), then you need to change that to rsslink(d) for 1.5.7+.
  2294 
  2295 
  2296 Version 1.5.6:
  2297   A general security notice:
  2298       Check your Python version, there was a buffer overflow issue in Python
  2299       recently! Details: http://moinmoin.wikiwikiweb.de/PythonUnicodeEscapeBug
  2300 
  2301   Bugfixes:
  2302     * Fix AttributeError traceback with Standalone server (if_modified_since)
  2303     * Fix AttachFile "304 not modified" and redirect status code for Twisted
  2304     * http auth: we now decode username and password to unicode (using
  2305       config.charset == utf-8). Same for SSL client cert auth and CN.
  2306     * Avoid infinite recursion in Page.parsePageLinks.
  2307     * Fixed standalone server failing to shutdown if interface == "".
  2308     * Now MoinMoin does not think anymore that every page links to various user
  2309       homepages.
  2310     * Made the irssi parser more tolerant (Thanks to "TheAnarcat").
  2311     * Now multiple formatters can be used per request, the send_page code was
  2312       not reentrant to this regard. Fixes "empty" search results.
  2313     * Fixed problem with "=" in ImageLink macro links.
  2314     * Not a moin bug, but a silly stdlib os.tempnam function made trouble to
  2315       some people because it lets you override the path given in the code
  2316       by setting the environment variable TMP(DIR). We now use a different
  2317       function to avoid renaming trouble when TMP(DIR) points to a different
  2318       file system.
  2319     * Fixed antispam update on every save (Thanks to "TheAnarcat").
  2320     * GUI converter: don't throw away rowclass for tables.
  2321     * GUI editor formatter: allow height for table cells.
  2322     * GUI editor formatter: comment texts are output using the formatter now. 
  2323 
  2324   New features:
  2325     * Mail notifications contain a link to the diff action so the user
  2326       can see the coloured difference more easily. Thanks to Tobias Polzin.
  2327     * FeatureRequests/MoveAttachments - you can move attachments from one
  2328       page to another (and also rename the attachment at the same time).
  2329       Thanks to Reimar Bauer.
  2330     * Added support for linking to attachment: and inline: URLs with ImageLink.
  2331     * Added UNIX socket support for FastCGI, just set the port to some (socket)
  2332       filename. Details see: MoinMoin:FeatureRequests/FastCgiUnixSocket
  2333     * [[Attachlist(pagename,mimetype)]] lists attachments of pagename (default:
  2334       current page) with optional mimetype restriction (default: all).
  2335       Thanks to Reimar Bauer.
  2336 
  2337   Other changes:
  2338     * Minor performance improvements (might be noticeable if you have many
  2339       custom navi_bar entries and high server load).
  2340     * Avoid usage of no-cache because it breaks attachment download on IE6.
  2341       This is a IE bug, not a moin bug.
  2342     * Added XHTML to the unsafe list.
  2343     * Changed the rst parser to be compatible to the new docutils interface
  2344       for directives.
  2345     * Updated EmbedObject macro.
  2346 
  2347 
  2348 Version 1.5.5a:
  2349   Bugfixes:
  2350     * fixed ticket creation to only use constant values
  2351 
  2352 Version 1.5.5:
  2353   HINT: read docs/README.migration.
  2354   HINT: there was NO change in the underlay/ pages since 1.5.4.
  2355   HINT: If you experience problems with the reStructured Text (rst) parser,
  2356         please downgrade docutils to "0.4" because there were major interface
  2357         breaking API refactorings on the docutils trunk.
  2358 
  2359   Bugfixes:
  2360     * GUI editor fixes:
  2361       * Fixed MoinMoinBugs/GuiEditorModifiesInterwikiPreferred.
  2362       * Fixed MoinMoinBugs/TableAlignmentProbsWithGUI.
  2363     * Not a moin bug, but it severely annoyed IE users and also was less
  2364       comfortable for users of other browser: since about 1.5.4, we served
  2365       attachments with Content-Disposition: attachment - so that the user has
  2366       to save them to disk. This was to fix a possible XSS attack using attached
  2367       HTML files with Javascript inside for stealing your moin cookie or doing
  2368       other nasty things. We improved this by using different behaviour depending
  2369       on the potential danger the attached file has when served inline:
  2370       mimetypes_xss_protect = ['text/html', 'application/x-shockwave-flash', ]
  2371       This is the default value. If you know more dangerous stuff, please just
  2372       add the mimetypes there to protect your users and file a bug report
  2373       telling us what we missed.
  2374     * Fixed MoinMoinBugs/ReStructuredTextRelativeLinksBroken, thanks to Stefan
  2375       Merten.
  2376     * Make tickets used for some actions more safe.
  2377 
  2378   New features:
  2379     * edit_ticketing [True] - we protect page save by a ticket (same stuff we
  2380       already use for DeletePage and RenamePage action).
  2381       NOTE: If you don't use your browser for editing, but some tool like
  2382             "editmoin" or "MoinMoin plugin for jEdit", you'll need an update
  2383             of them supporting the ticket.
  2384             Alternatively, you can use edit_ticketing = False setting - this
  2385             is not recommended for internet wikis as it will make spamming them
  2386             easier.
  2387     * If we detect some spammer, we kick him out by triggering surge protection
  2388       (if surge protection is not disabled).
  2389 
  2390 Version 1.5.5rc1:
  2391   Bugfixes:
  2392     * Fixed MoinMoinBugs/XmlRpcBrokenForFastCgi - thanks to Johannes Berg.
  2393     * Fixed gui editor converter confusing of `` and {{{}}} markup.
  2394     * Fixed emission of HTTP headers (esp. Vary: Cache-Control:).
  2395     * Fixed a bad crash that happens (on ANY page!) when you put a *Dict
  2396       page's name as a member into a *Group page.
  2397     * Fix MyPages action title to use an unformatted string.
  2398     * Fix double quoted-printable encoding in generated emails (note: this is
  2399       not a moin bug - this just works around bugs in python stdlib).
  2400     * Fix mode of drawing files (use config.umask).
  2401     * Fix trouble with /?action= urls by dropping getPageNameFromQueryString
  2402       code. 
  2403     * Fixed sre unpickle issues seen on some machines by avoiding to pickle
  2404       the regex.
  2405     * Fix Clock code, add more timers.
  2406     * Worked around FastCGI problem on Lighttpd: empty lines in the error log.
  2407     * Fix (add) locking for caching's .remove() call, small fixes to lock code.
  2408     * Print error message when --target-dir=path is missing from moin export
  2409       dump command.
  2410 
  2411   New features:
  2412     * Added support for "304 not modified" response header for AttachFile get
  2413       and rss_rc actions - faster, less traffic, less load.
  2414     * Limit rss with full diffs to 5 items.
  2415     * Allow surge_action_limits = None to disable surge protection.
  2416     * moin.fcg improved - if you use FastCGI, you must use the new file:
  2417       * can self-terminate after some number of requests (default: -1, this
  2418         means "unlimited lifetime")
  2419       * the count of created threads is limited now (default: 5), you can use
  2420         1 to use non-threaded operation.
  2421       * configurable socket.listen() backlog (default: 5)
  2422     * Added indonesian i18n (id).
  2423     * Some measures against spammers trying to brute force their spam into moin.
  2424     * EmbedObject macro: added mov, mpg and midi support
  2425     * moin ... export dump --target-dir=PATH --page=PAGENAME_REGEX
  2426       You must specify --target-dir (where dump will write the html files to)
  2427       and you may specify --page and either a page name or a regex used to
  2428       match all pages you want to export. Default is to export all pages.
  2429 
  2430   Other changes:
  2431     * Tuning:
  2432       * more efficient locking code on POSIX platforms, we do much less I/O
  2433         for locking now
  2434       * removed most chmod calls in favour of a single os.umask call
  2435     * Improved Python 2.5 compatibility. Note: if you think that MoinMoin
  2436       is using too much RAM, you might want to look at Python 2.5 because
  2437       of its improved memory management.
  2438     * Throw away SAVE comments longer than 200 chars (you can't enter those by
  2439       the user interface, so only spammer using automatic POSTs do them).
  2440     * Updated spider user agent list.
  2441     * BadContent and LocalBadContent now get noindex,nofollow robots header,
  2442       same as POSTs.
  2443     * Standalone opens it logfile unbuffered from now on, thanks to
  2444       Carsten Grohmann.
  2445     * Avoid trouble when request.write() data contains None, just skip it -
  2446       thanks to Juergen Hermann.
  2447     * Instead of showing a ConfigurationError, moin now emits "404 Not found"
  2448       http headers and a hint about what could be wrong. This won't fill up
  2449       your logs just because of typos and spiders still trying old URLs.
  2450 
  2451  
  2452 Version 1.5.4:
  2453     HINT: read docs/README.migration.
  2454 Version 1.5.4-current:
  2455     * increased maxlength of some input fields from 80 to 200
  2456 
  2457 Version 1.5.current:
  2458   Developer notes:
  2459     * We switched to Mercurial SCM, see here for more infos:
  2460       http://moinmoin.wikiwikiweb.de/MoinDev/MercurialGuide
  2461 
  2462   Bugfixes:
  2463     * fix MonthCalendar macro for non-ASCII pagenames (thanks to Jonas Smedegaard)
  2464     * remove 'search' and 'google' from bot user agent list and add some more
  2465       specific terms
  2466     * Fix the forgotten password email login URL and also properly encode the
  2467       email body. Thanks to Robin Dunn for the patch.
  2468     * Applied a patch by Matthew Gilbert for increased compatiblity with
  2469       latest docutils.
  2470 
  2471 
  2472 Version 1.5.3:
  2473   New Features:
  2474     * Added CSS classes for TableOfContents macro.
  2475 
  2476   Bug Fixes:
  2477     * GUI editor / GUI editor converter:
  2478       * Fixed missing GUI editor link in edit bar.
  2479       * Fixed table/row/cell style spaces.
  2480       * Changed <p> generation for macros.
  2481       * Fixed handling of subpages.
  2482       * Fixed processing of complex list elements (thanks to Craig Markwardt).
  2483       * Fixed processing of html \n (thanks to Craig Markwardt).
  2484       * Fixed joining of comment lines with text below them.
  2485       * Fixed table height attribute crash.
  2486     * Fixed sslclientcert auth.
  2487     * Added some missing files to i18n processing, translatable strings more
  2488       complete now.
  2489     * Change <p> generation from self-closing (<p />) to auto-closing (only
  2490       emit <p>, let browser find place for </p>).
  2491     * Fix eating of newline before tables.
  2492     * Fixed incorrect login hint for not logged-in users trying a disallowed
  2493       action.
  2494     * Fixed nasty missing or double </a> formatter bug (mostly happening when
  2495       user has enabled questionmarks for nonexisting pages).
  2496 
  2497   Other Changes:
  2498     * We catch and ignore html to wiki conversion errors in case of hitting
  2499       the cancel button, so you can get out of the error screen.
  2500 
  2501 Version 1.5.3-rc2:
  2502   New Features:
  2503     * Modified SystemInfo macro to give human readable units and disk usage
  2504     * cfg.editor_quickhelp makes the quick help below the editor configurable
  2505       (at least as far as the default_markup is concerned). If set to None,
  2506       it doesn't display any quickhelp. Thanks to Seth Falcon for the patch.
  2507 
  2508   Bugfixes:
  2509     * Fixed double class attribute for nonexistent links
  2510     * Fixed double </a> with qm_noexist option
  2511     * Fixed table xxx="yyy" style attribute parsing
  2512     * If not (editor_force and editor_default == 'text') then display GUI mode
  2513       switch button (this is only a partial fix, but enough to deny the GUI
  2514       mode to your users completely)
  2515     * Fixed XSS issue which could lead to cookie theft etc.
  2516     * Fixed definition list "same level" indenting.
  2517     * Fixed pagename in log for PackagePages action.
  2518     * Made <p> self-closing and line-anchors more well-behaved, thanks to
  2519       Martin Wilck for the patch. I didn't apply the <ol> patch, because this
  2520       is no real problem, just a problem of a bad standard.
  2521     * Fixed gui editor *bgcolor crash.
  2522     * Support/Fix tableclass attr with gui editor.
  2523 
  2524   Other changes:
  2525     * Moved back UserPreferences action link from menu to top of page (renaming
  2526       it to "Preferences"), added "Cancel" button to make it possible to return
  2527       to the previous page without saving preferences.
  2528     * Removed formatter.url "attrs" keyword arg that took premade html, we use
  2529       separate kw args per attribute now.
  2530     * Moved broken tests to MoinMoin/_tests/broken (= disabling them).
  2531       All "active" tests run ok now.
  2532       If you want to compare, I included the output of this test run:
  2533       $ make test >tests/make_test.out
  2534 
  2535  
  2536 Version 1.5.3-rc1:
  2537 
  2538   New features:
  2539     * HINT: please read README.migration
  2540     * Login and Logout are actions now, therefore you stay on the page where
  2541       you were before.
  2542     * UserPreferences is also an action now and moved from top border (in
  2543       modern theme) to the "more actions" dropdown menu. You also stay on the
  2544       same page.
  2545     * There is also a [[Login]] macro now. You can put it on any page you want
  2546       and if the user is not logged in, it renders the login form. If the user
  2547       is logged in, it doesn't render anything.
  2548     * We check cfg.superuser to be a list of user names (as documented) and
  2549       deny superuser access if it is not. This avoids security issues by
  2550       wrong configuration.
  2551     * auth methods changed:
  2552       HINT: if you wrote own auth methods, please change them as you see in
  2553             MoinMoin/auth.py and test them again before relying on them.
  2554       * now get a user_obj kw argument that is either a user object returned
  2555         from a previous auth method or None (if no user has been made up yet).
  2556         The auth method should either return a user object (if it has
  2557         determined one) or what it got as user_obj (being "passive") or None
  2558         (if it wants to "veto" some user even if a previous method already has
  2559         made up some user object).
  2560       * return value of continue_flag is now True in most cases (except if
  2561         it wants to "veto" and abort).
  2562       * moin_cookie auth method now logs out a user by deleting the cookie and
  2563         setting user_obj.valid = 0. This makes it possible to still get the
  2564         user's name in subsequent auth method calls within the same request.
  2565       * added ldap_login and smb_mount auth methods, see MoinMoin/auth.py and
  2566         wiki/config/more_samples/ldap_smb_farmconfig.py
  2567     * MonthCalendar now takes an additional argument for specifying a template
  2568       to use to directly invoke the page editor when clicking on non-existing
  2569       day pages.
  2570     * Added ImageLink macro. Thanks to Jeff Kunce, Marcin Zalewski, Reimar
  2571       Bauer and Chong-Dae Park for working on it.
  2572     * Lupy stuff (still experimental, partly broken and disabled by default):
  2573       * Attachment search using lupy (lupy_search = 1 in your config)
  2574         Title search will also search attachment filenames.
  2575         Full text search will also search attachment contents.
  2576       * Indexing filter plugins, see MoinMoin:FiltersForIndexing
  2577         Some filters depend on external converters that might not be available
  2578         for any platform (see Depends: line in filter plugin).
  2579         Feel free to contribute more filter plugins, especially if you wrote
  2580         some nice platform independant filter in Python for some popular file
  2581         format! Filters implemented so far (depending on):
  2582         MS Word, RTF, MS Excel (antiword, catdoc)
  2583         PDF (pdftotext)
  2584         OpenOffice.org XML based data formats (-)
  2585         XML, HTML (-)
  2586         text/* (-)
  2587         JPEG's EXIF data (-)
  2588         Binary generic (-)
  2589       * As you might know, Lupy is "retired" (that means it isn't developped
  2590         by its authors any more). We are currently evaluating Xapian as new
  2591         indexing search engine in moin.
  2592         If we succeed, we will replace Lupy stuff by some Xapian interface
  2593         code in moin.
  2594         But: the filters will likely stay, as we also need them with Xapian.
  2595     
  2596     * A new MoinMoin script interface was introduced:
  2597       
  2598       Syntax: moin [options] <cmdmodule> <cmdname> [options]
  2599       
  2600       For example:
  2601       moin --config-dir=/my/cfgdir --wiki-url=wiki.example.org/ \
  2602            export dump --page=WikiSandBox
  2603       
  2604       This will call the "moin" script, which will use the --config-dir and
  2605       --wiki-url options to initialize, then it will go to MoinMoin.script
  2606       module, import the export.dump module from there and run it, providing
  2607       the additional --page value to it.
  2608 
  2609       The old scripts that have not been migrated to this new interface can
  2610       still be found in MoinMoin/script/old/ - including the old migration
  2611       scripts.
  2612     * moin ... account create --name=JoeDoe --email=joe@doe.org
  2613     * moin ... account disable --name=JoeDoe
  2614     * moin ... acount check     <-- this is what usercheck script was before
  2615     * moin ... maint cleancache <-- this is what cachecleaner script was
  2616     * moin ... maint cleanpage  <-- this is what pagescleaner script was
  2617 
  2618   Bugfixes:
  2619     * cookie_lifetime didn't work comfortable for low values. The cookie was
  2620       created once on login and never updated afterwards. So you got logged
  2621       out cookie_lifetime hours later, no matter whether you were active at
  2622       that time or not. This has been changed, we update the cookie expiry now
  2623       on every request, so it will expire cookie_lifetime after your last
  2624       request (not after login).
  2625     * Fixed logout problems when using cfg.cookie_path.
  2626     * Fixed cookie_path for root url wikis.
  2627     * Lupy search now behaves a bit less funky. Still no guarantees...
  2628     * We lowered the twisted server timeout to 2 minutes now (was: 10) because
  2629       it just used up too many files (open TCP connections until it timeouts)
  2630       on our farm.
  2631     * The algorithm used for processing the farmconfig.wikis list was changed
  2632       to work for big farms (>= 50 wikis), too. This works around the python
  2633       "re" module limitation of having a maximum of 100 named groups in a RE.
  2634     * Fixed a TypeError which occurred for formatters that dislike None values.
  2635       (cf. http://moinmoin.wikiwikiweb.de/MoinMoinBugs/PythonErrorEditingFrontPage)
  2636     * Fixed GUI editor converter error for https:... image URLs.
  2637     * ThemeBase (use by modern/rightsidebar): removed duplicate AttachFile from
  2638       actions menu (we already have it in editbar).
  2639     * Speedup group/dicts scanning for persistent servers.
  2640     * Implemented HEAD requests for standalone server, this should fix some of
  2641       the strange effects happening when using "Save as" on attachments.
  2642     * Not a moin bug, but rather a workaround for non-standard non-ASCII DNS
  2643       hostnames: we just use the IP instead of crashing now.
  2644     * Spurious cyclic usage error in i18n fixed.
  2645     * Fixed antispam for python 2.5a xmlrpclib.
  2646     * I18n for linenumber toggle in listings.
  2647     * All action menu entries are translatable now.
  2648 
  2649   Other:
  2650     * Added css classes for the rst admonitions. Thanks to TiagoMacambira!
  2651 
  2652 Version 1.5.2:
  2653 
  2654   New features:
  2655     * Added FullSearchCached macro which is statically cached.
  2656       Use it if you do not depend on fresh search results but prefer raw speed.
  2657     * Added surge protection, see HelpOnConfiguration/SurgeProtection.
  2658     * Allow hex and symbolic entities.
  2659     * If there is a user with empty password, we just generate a random one
  2660       when he requests it getting sent by mail. Thanks to Reimar Bauer.
  2661     * The superuser now can switch to another user using UserPreferences -
  2662       nice to help your users when they forgot their password or need other
  2663       help. You need to logout/relogin to use your own userid afterwards.
  2664       This function only works correctly if you use moin_cookie authentication.
  2665       Thanks to Reimar Bauer.
  2666     * Add new markup for bulletless lists: just use a "." instead of "*".
  2667 
  2668   Other changes:
  2669     * Added "voyager" to bot useragent list.
  2670     * Added locking for caching subsystem.
  2671     * Deron Meranda's formatter API cleanup.
  2672     * Added div and span to formatter API.
  2673     * Removed old unfinished form and export code.
  2674     * updated i18n
  2675 
  2676   Fixes:
  2677    * Fixed table attribute parsing.
  2678    * Fixed cookie handling wrt properties adherance.
  2679    * The new "." list markup makes it possible to have a bulletless list with
  2680      elements on the same level. Before this change and only using indentation
  2681      with blanks, that would get merged into a single paragraph.
  2682    * It is possible now to have multiple paragraphs in the same list element,
  2683      just leave an empty line in between the paragraphs.
  2684    * Fixed GAP processing for ordered lists.
  2685    * Fix text_gedit formatter's invalid list nesting.
  2686    * Fixed hr crash in blockquote (but needs more work).
  2687    * Fixed FootNote's formatter usage.
  2688    * Fixed rst's headline levels.
  2689    * Fixed MoinMoinBugs/WikiParserThinksItIsInsidePreWhenItIsNot
  2690    * Fixed MoinMoinBugs/ListItemGeneratedOutsideList
  2691    * Fixed that macros were followed by a wrong <p>.
  2692    * Added <blockquote> to the block elements in the text_html formatter,
  2693      so it does not close it erratically when you close a inner <p>.
  2694    * GUI editor converter now also accept http: urls without // (relative or
  2695      same server urls).
  2696    * Fixed the DocBook parser in cases where the pagename was non-ascii.
  2697    * Fixed MoinMoinBugs/ProcessInlineDontSupportUlElement
  2698 
  2699 
  2700 Version 1.5.1:
  2701 
  2702   Fixes:
  2703     * Fixed rst parser docutils version check
  2704     * Repaired attachment unzipping feature.
  2705     * Fixed the AddRevision command of the PackageInstaller.
  2706     * improved the migration scripts (used to migrate pre-1.3 wikis to 1.3+):
  2707       * do not crash on empty lines in event log
  2708       * fix edit log format for very old moin data (like 0.11)
  2709       * workaround for an ugly win32 operating system bug leading to wiki text
  2710         file mtime not matching edit logs timestamp values if there was some
  2711         timezone change since last edit (e.g. a daylight saving tz switch),
  2712         but differing 3600s.
  2713         This affected pre-1.3 moin wiki servers running on win32 OS only.
  2714         We now try to correct those inconsistencies in mig05 by fuzzy matching.
  2715     * fixed bracketed link scheme icon (css class)
  2716     * we included a modified copy of Python 2.4.2's copy.py as some previous
  2717       python versions seem to have problems (2.3.x, x < 5 and also 2.4[.0]),
  2718       see: http://moinmoin.wikiwikiweb.de/MoinMoinBugs/DeepCopyError
  2719       Our own copy.py was slightly modified to run on 2.3.x and 2.4.x.
  2720     * Fixed the problem of not being able to change the date/time format back
  2721       to "Default" (UserPreferences).
  2722     * We generate the GUI editor footer now the same way as the text editor
  2723       footer.
  2724     * Include a CSS workaround for yet another IE bug, see:
  2725       MoinMoinBugs:InternetExplorerPeekABooBugInRightSideBar
  2726     * classic theme: added GUI editor link
  2727     * classic theme: added pagename header to editor screen
  2728     * the "mail enabled" check now also checks whether mail_from is set
  2729 
  2730   Other changes:
  2731     * Updated FCKeditor to current CVS (2006-01-08 == 2.2+)
  2732     * Split up show_hosts into show_hosts and show_names
  2733     * attachment:file%20with%20spaces.txt in attachment list
  2734     * added support for file:// in GUI editor link dialogue, see also:
  2735       MoinMoin:FileLinks
  2736     * cfg.mail_smarthost now supports "server:port" syntax, the default port
  2737       is 25, of course.
  2738     * removed unused kwargs showpage/editable/form from wikiutil.send_footer
  2739     * updated i18n (translation texts, additional languages)
  2740     * removed interwiki:pagename from print view's top of page, added it to
  2741       the "lasted edited" line at bottom right.
  2742 
  2743 
  2744 Version 1.5.0:
  2745   HINT: 1.5.0 uses the same data/pages format as 1.3.x. The only thing you want
  2746         to check is whether the 1.5.x version you are upgrading to has NEW mig
  2747         scripts compared to the version you are running now (e.g. in 1.3.5 we
  2748         added some scripts that fixed some small problems).
  2749         See the MoinMoin/scripts/migration/ directory.
  2750         You must run every mig script in sequence and only ONCE ever.
  2751   Fixes:
  2752     * Fix <x=y> table attributes parsing. Thanks to Reimar Bauer.
  2753     * Fixed a few bugs in the reStructured text parser. Note that you
  2754       need to install docutils 0.3.10 or newer (snapshot from December 2005
  2755       or newer) to make reStructuring parsing work:
  2756      * Case preservation for anonymous links
  2757      * MoinMoin links get the appropriate CSS class
  2758      * Images do not get special CSS markup anymore
  2759      Thanks to Matthew Gilbert.
  2760     * Fixed a bug in the WSGI code which led to incorrect exception handling.
  2761     * Removed all nationality flags. They used to be used for indicating some
  2762       specific language (NOT nationality) and this was simply wrong and a bad
  2763       idea.
  2764     * Fixed some header rendering issues (CSS).
  2765     * SystemAdmin macro now checks against cfg.superuser list.
  2766 
  2767   Other changes:
  2768     * Added turkish i18n. To be considered as alpha as it got in last minute.
  2769 
  2770 
  2771 Version 1.5.0rc1:
  2772   This is the first release candidate of MoinMoin 1.5.0.
  2773   
  2774   Fixes:
  2775     * fixed broken logs when a DeletePage (maybe also RenamePage) comment
  2776       contained CR/LF characters (could happen when using copy&paste)
  2777     * fixed GUI editor MoinEditorBackup page containing HTML instead of wiki
  2778       markup
  2779     * fixed invalid HTML in FootNotes
  2780     * fixed HTML source in EditorBackup after canceling GUI editor
  2781     * Footnotes of included pages are not shown at the bottom of the including page.
  2782     * Bug in Dict handling that often breaks first entry
  2783 
  2784 Version 1.5.0beta6:
  2785   Authentication:
  2786     * Added SSO module for PHP based apps. Currently supported: eGroupware 1.2.
  2787       No need to login in two systems anymore - MoinMoin will read the PHP session
  2788       files.
  2789 
  2790   Fixes:
  2791     * Improved rendering of bullet lists and external links in Restructured text.
  2792       Thanks to Matthew Gilbert.
  2793     * Fixed modern theme rendering, including some fixes and workarounds for
  2794       broken MS IE.
  2795     * When checking for email uniqueness, do not compare with disabled user
  2796       profiles.
  2797     * Fix sending of HTTP headers for Despam action.
  2798     * Add some margin left and right of the link icons.
  2799 
  2800   Other changes:
  2801     * Made it easier for auth methods needing a user interface (like ldap or
  2802       mysql stuff). Unlike http auth, they usually need some "login form".
  2803       We made UserPreferences login form values (name, password, login, logout)
  2804       available as kw args of the auth method, so it is easy and obvious now.
  2805     * Make login and logout show at the same place. Is only shown when
  2806       show_login is True (default).
  2807     * Disabled login using &uid=12345.67.8910 method. Please use name/password.
  2808     * Made builtin moin_cookie authentication more modular: the cookie is now
  2809       touched by MoinMoin.auth.moin_cookie only, with one minor discomfort:
  2810       When creating a user, you are not automatically logged in any more.
  2811     * We now use the packager for additional help and system pages in all other
  2812       languages except English. The packages are attached to SystemPagesSetup
  2813       page and can be installed from there after getting "superuser" powers.
  2814       The "extra" package contains a collection of orphan pages not listed on
  2815       some SystemPagesIn<Language>Group page.
  2816 
  2817 
  2818 Version 1.5.0beta5:
  2819   Fixes:
  2820     * Fixed a minor user interface bug: it showed RenamePage and DeletePage
  2821       actions in the menu if you only had write rights and then complained
  2822       when you really tried when you had no delete rights additionally.
  2823     * We don't remove RenamePage and DeletePage from menu any more if user is
  2824       unknown. This stuff is only driven by ACLs now.
  2825     * Some fixes to Despam action.
  2826     * Fixed moin_dump (broken by some recent theme init change).
  2827     * Fixed a few tests by moving the theme init from moin_dump to RequestCLI.
  2828     * removed old_onload reference from infobox.js
  2829     * Fixed MoinMoin logo for IE.
  2830     * search: fixed whitespace handling in linkto: search terms
  2831     * Increased stability of the tests system by outputting results to sys.stdout
  2832       instead of request. Note that this changes the semantics for e.g. mod_py or
  2833       mod_fcgi.
  2834     * Fixed packaging system in the case of AddRevision that does not alter the page.
  2835     * Fixed a few bugs in the XML formatters (dom_xml, text_xml, xml_docbook).
  2836     * Fixed link icons. We now just use a.xxx.before where xxx is the link scheme,
  2837       e.g. a.http.before. See theme's common.css.
  2838     * Hopefully fixed some issue with non-ASCII attachment filenames.
  2839     * Workaround for Opera 8.5 making silly "No addition" categories.
  2840     * Do not show GUI editor for non-wiki format pages, because we only have a
  2841       converter from html to wiki right now.
  2842     * Fix the modern CSS issues for editbar, when it shifted content far right.
  2843       Also removed the absolute height value that never was right.
  2844     * Fix mod_python adaptor bugs failing to handle Location correctly.
  2845       See: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=339543
  2846 
  2847   Other changes:
  2848     * Added irc:// to the builtin supported link schemas. You can remove it
  2849       from config.url_schemas in case you have patched it in there.
  2850     * Added cfg.user_autocreate (default: False). Use True to enable user
  2851       profile autocreation, e.g. when you use http authentication, so your
  2852       externally authenticated users don't need to create their moin profile
  2853       manually. The auth method (see cfg.auth list) must check this setting
  2854       if it supports auto creation.
  2855     * Added user_autocreate support for auth.http and auth.sslclientcert.
  2856     * Added "." and "@" to allowed characters in usernames. This is needed
  2857       e.g. when using mod_pubcookie for authentication. mod_pubcookie returns
  2858       userids like "geek@ANDREW.CMU.EDU" (e.g. the Kerberos domain is part of
  2859       the id). Thanks to Brian E. Gallew for his patch, which we used for
  2860       inspiration for user autocreation changes.
  2861     * Changed auth method to return a tuple (user_obj, continue_flag), see
  2862       comments in auth.py.
  2863     * auth methods now create user objects with kw args auth_method and
  2864       auth_attribs, so that moin knows later how the user was authenticated
  2865       and which user object attributes were determined by the auth method.
  2866     * Added MoinMoin/scripts/import/IrcLogImporter.py to import supybot's
  2867       IRC logs into a moin wiki. We use MonthCalendar compatible page names,
  2868       so you can use the calendar for showing / navigating the logs.
  2869     * Removed packager binary from FCKeditor (fixing a Debian policy problem).
  2870     * Worked around .png transparency bugs of IE with the new logo. We ship
  2871       two logos: moinmoin.png without an alpha channel (IE compatible) and
  2872       moinmoin_alpha.png which has an alpha channel and looks better on
  2873       browsers with full .png support.
  2874     * Allow a .zip file to have a directory in it if it is the only one.
  2875 
  2876 Version 1.5.0beta4:
  2877   Fixes:
  2878     * use <span class="anchor"> instead of <a> for line-xxx anchors, this
  2879       fixes some rendering problems on IE
  2880     * Fixed the ReStructured text parser when it was used with non-HTML
  2881       formatters. Increased compatiblity with new docutils code.
  2882       (Thanks to Matt Gilbert.)
  2883   Other changes:
  2884     * cfg.stylesheets = [] (default). You can use this on wiki or farm level
  2885       to emit stylesheets after the theme css and before the user prefs css.
  2886       The list entries must be ('screen', '/where/ever/is/my.css') style.
  2887     * Added sample code for auth using an external cookie made by some other
  2888       program. See contrib/auth_externalcookie/*. You need to edit it to
  2889       fit whatever cookie you want to use.
  2890 
  2891 Version 1.5.0beta3:
  2892   Fixes:
  2893     * fixed editor preview throwing away page content for new pages
  2894     * require POST for userform save and create* action
  2895     * use request.normalizePagename() while collecting pagelinks
  2896     * do not offer gui editor for safari
  2897   Other changes:
  2898     * tell user if account is disabled
  2899     * added support for linking to .ico and .bmp
  2900     * attachment methods for the text_xml and xml_docbook formatters
  2901     * new favicon
  2902     * updated i18n (fixed nl, did nobody notice this?) and underlay
  2903     * changed show_interwiki default to 0
  2904 
  2905 Version 1.5.0beta2:
  2906   Fixes:
  2907     * fix wrong _ in title links (MoinMoinBugs/AddSpaceWikiNameAtHead)
  2908     * fix gui editor (converter) crash on save
  2909     * MoinMoinBugs/PageHitsFails
  2910     * MoinMoinBugs/PackagePagesFailsBecauseAllowedActionsMissing
  2911     * Avoid destroying existing page content if editor is called with
  2912       template parameter for an existing page.
  2913     * fix countdown javascript for browser status line in editor
  2914     * added page title display for editor
  2915     * added header div for classic theme
  2916 
  2917   Authentication and related:
  2918     * Added a WhoAmI.py wiki xmlrpc plugin to check whether auth works
  2919       correctly for xmlrpc. There is a counterpart script WhoAmI.py that
  2920       uses http auth when calling the xmlrpc plugin, so you can use it to
  2921       check http auth.
  2922 
  2923 Version 1.5.0beta1:
  2924     * Requirements changed to require Python >= 2.3. We recommend that
  2925       you use the latest Python release you can get. The reason we
  2926       dropped 2.2.2 support is because no developer or tester uses this
  2927       old version any more, so incompatibilities crept in the code
  2928       without anybody noticing. Using some recent Python usually is no
  2929       real problem, see there for some hints in case you still run an
  2930       old python: http://moinmoin.wikiwikiweb.de/NewPythonOnOldLinux
  2931       The hint also does apply to other POSIX style operating systems,
  2932       not only Linux.
  2933     * We recommend you use MoinMoin/scripts/cachecleaner.py to clean the
  2934       wiki's cache (see comments at top of the script).
  2935       The cache will automatically be rebuilt (some operations may take
  2936       some time when first being used, e.g. linkto: search, so be patient!).
  2937 
  2938   Config Changes:
  2939      * there is a file CHANGES.config with just the recently changed stuff
  2940        from multiconfig.py
  2941      * new defaults:
  2942        * page_front_page old: u"FrontPage" new: u"HelpOnLanguages"
  2943          please just read the help page in case you see it :)
  2944        * bang_meta old: 0 new: 1
  2945        * show_section_numbers old: 1 new: 0
  2946        * some regexes that used to be [a-z]Uxxxx$ are now [a-z0-9]Uxxxx$
  2947        * navi_bar has no page_front_page as first element any more
  2948      * removed settings and code [new behaviour]:
  2949        * acl_enabled [1]
  2950        * allow_extended_names [1]
  2951        * allow_numeric_entities [1]
  2952        * backtick_meta [1]
  2953        * allow_subpages [1]
  2954      * new settings:
  2955       * cfg.mail_sendmail = "/usr/sbin/sendmail -t -i" can be used if sending
  2956         via SMTP doesn't work on your server. Default is None and that means
  2957         using SMTP.
  2958       * language_default replaces the old default_lang setting (just renamed).
  2959       * language_ignore_browser = True can be used to let moin ignore the
  2960         user's browser settings (e.g. if you run a local-language only wiki
  2961         and your users use misconfigured or buggy browsers often). Default is
  2962         False. Don't forget to set language_default when using this.
  2963  
  2964     * Wiki Editor changes / new WYSIWYG editor
  2965      * fully imported the javascript based LGPLed FCKeditor (many thanks
  2966       to Fred CK for his great work). See http://fckeditor.net/ for details.
  2967      * config for FCKeditor is at wiki/htdocs/applets/moinfckeditor.js
  2968      * added cfg.interwiki_preferred (default = []) to set a list of wikis to
  2969        show at the top of the wiki selection list when inserting an
  2970        interwiki link (just use the same wiki name as in interwiki
  2971        map). If the last list item is None, then the preferred wikis
  2972        will not be followed by the entries of the interwiki map.
  2973     * moved save/preview/... buttons to the top so that they can be
  2974       easily reached
  2975     * reduced edit_rows default to 20 lines
  2976     * Added support for edit by doubleclick in the diff view
  2977 
  2978     * Improved wiki farm support
  2979      * make user files sharable between several wikis in a farm
  2980       * allow/use interwiki subscriptions
  2981       * use interwiki links in page trail
  2982       * save bookmark per wiki name
  2983      * cfg.cookie_domain can be used to set a cookie valid for a complete
  2984        domain (default: None == only for this host). If you use '.domain.tld',
  2985        the cookie will be valid for all hosts *.domain.tld - good for host
  2986        based wiki farms.
  2987      * cfg.cookie_path can be used to set a cookie valid for a wiki farm under
  2988        some base path (default: None == only for this wiki's path). If you use
  2989        '/wikifarm',  the cookie will be valid for all wikis
  2990        server.tld/wikifarm/* - good for path based wiki farms.
  2991      * Interwiki user homepage (if you have MANY users)
  2992        Generated links for usernames are interwiki now, use cfg.user_homewiki
  2993        (default: 'Self') to specify in which wiki the user home pages are
  2994        located. Note: when pointing this to another wiki, the /MoinEditorBackup
  2995        functionality will be disabled.
  2996        @SIG@ also uses interwiki when needed.
  2997 
  2998     * Authentication, ACLs and related
  2999      * Modular authentication: cfg.auth is a list of functions that return a
  3000        valid user or None, use it like this:
  3001            from MoinMoin.auth import http, moin_cookie
  3002            auth = [http, moin_cookie]
  3003      * cfg.auth_http_enabled was removed, please use cfg.auth instead.
  3004      * http auth now supports "Negotiate" scheme, too
  3005      * Added sslclientcert auth method (Apache: untested, Twisted: not
  3006        implemented, IIS: no idea). See MoinMoin/auth.py for details.
  3007        Submit a patch if you have improvements.
  3008      * cfg.superuser is a list of unicode usernames. It is used by some
  3009        critical operations like despam action or PackageInstaller.
  3010      * removed allowed_actions, we now use actions_excluded only and it
  3011        defaults to [], that means, no action is excluded, everything is
  3012        allowed (limited by ACLs). In case of RenamePage and DeletePage,
  3013        this shouldn't be a problem as both can be reverted. In case you
  3014        did not allow attachments, you now have to use:
  3015        actions_excluded = ['AttachFile']
  3016      * special users (All, Known, Trusted) in Groups are now supported
  3017      * MoinMoin.security.autoadmin SecurityPolicy added
  3018        When using this security policy, a user will get admin rights on his
  3019        homepage (where pagename == username) and its sub pages. This is needed
  3020        for the MyPages action, but can also get used for manual ACL changes.
  3021        It can also be used for Project page auto admin functionality, see the
  3022        comments in the script for details.
  3023        Further it can automatically create the user's group pages when the
  3024        user saves his homepage.
  3025      * there is a UpdateGroup xmlrpc call, see MoinMoin/xmlrpc/UpdateGroup.py -
  3026        you can use this to update your *Group pages e.g. when generating them
  3027        from an external group database.
  3028 
  3029     * UserPreferences changes
  3030      * Alias name: is used for display purposes, when "name" is cryptic. It is
  3031        shown e.g. in the title attribute of userid links (displayed when
  3032        moving the mouse over it).
  3033      * "Publish my email (not my wiki homepage) in author info" - use this
  3034        if you don't have a wiki homepage, but if you want to be contactable
  3035        by email. When you edit a page, your email address will be published
  3036        as mailto: link on RecentChanges, at bottom of page (last editor) and
  3037        in page info. If the wiki runs publically on the internet, be careful
  3038        using this or your email address might be collected by spammers.
  3039      * Preferred Editor: whether you want to use the text editor (as in
  3040        previous moin versions), the gui editor (new!) or both (you will get
  3041        2 edit links in that case).
  3042      * a user can add/remove the current page to/from his quicklinks with an
  3043        appropriate action now
  3044      * if cfg.user_email_unique = False, we don't require user's email
  3045        addresses to be unique
  3046      * removed show_fancy_links user preferences setting to simplify code and
  3047        caching. Displaying those icons is now done by CSS styles (see
  3048        common.css). Maybe needs fixing for non-standard themes and RTL langs.
  3049 
  3050     * Markup
  3051      * added strikethrough markup: --(striked through text here)--
  3052      * @ME@ expands to just the plain username (no markup added) on save
  3053     
  3054     * User homepages
  3055      * when a user accesses his own non-existing homepage (pagename ==
  3056        username), the wiki will present the MissingHomePage system page
  3057        content, explaining what a user homepage is good for and offer
  3058        one-click editing it with content loaded from HomepageTemplate
  3059      * creation of homepage subpages is assisted by the MyPages action, which
  3060        offers rw, ro page creation (and a related group) or creation of private
  3061        pages. If you are not in the user_homewiki, you will get redirected
  3062        there first.
  3063 
  3064   Other changes/new features:
  3065     * Added PackageInstaller and unzipping support (see wiki page
  3066       HelpOnActions/AttachFile for further details).  PackageInstaller requires
  3067       the user to be in cfg.superuser list.
  3068      * Added an PackagePages action to simplify the package creation.
  3069     * Added location breadcrumbs - when you are on some subpage, the page
  3070       title parts link to the corresponding parent pages, the last part does
  3071       the usual reverse linking.
  3072     * added WSGI server support, thanks to Anakim Border, see:
  3073       wiki/server/moinwsgi.py (moin as WSGI app, uses the flup WSGI server,
  3074                                see http://www.saddi.com/software/flup/)
  3075       MoinMoin/server/wsgi.py (adaptor code)
  3076     * added a "Despam" action to make de-spamming a wiki easy (mass revert
  3077       bad changes done by a single author or bot). You need to be in
  3078       cfg.superuser to use it.
  3079     * Better diffs with links to anchors to the changed places
  3080     * Enhanced table support in the DocBook formatter.
  3081     * Added 'moin' daemon script, that let you run moin standalone
  3082       server as daemon and control the server with simple command line
  3083       intreface: moin start | stop | restart | kill
  3084     * Add 'restart' option to mointwisted script
  3085     * Add properties option to standalone server config. Allow
  3086       overriding any request property like in other server types.
  3087     * Add support for running behind proxy out of the box with out
  3088       manual url mapping.
  3089       See HelpOnConfiguration/IntegratingWithApache
  3090     * added a WikiBackup action, configure it similar to this:
  3091       data_dir = "/path/to/data"
  3092       backup_include = [data_dir, ] # you can add other dirs here
  3093       backup_users = ["BackupUserName", ] # only TRUSTED users!
  3094       You usually don't need to change the default backup_exclude setting.
  3095       The default backup_include list is EMPTY and so will be your
  3096       backup in case you don't configure it correctly.
  3097       If you put your data_dir there, the backup will contain private
  3098       user data like email addresses and encrypted passwords.
  3099     * Added a SubscribeUser action which allows the administrator to subscribe users to the
  3100       current page.
  3101     * Added thread count to SystemInfo macro.
  3102     * Added Petr's newest patch against the DocBook code. It allows you to use macros (esp. the include macro) in DocBook pages in order to build larger documents.
  3103     * Added a RenderAsDocbook action which redirects to the DocBook formatter.
  3104     * Added searching for wiki-local words lists under <data_dir>/dict/.
  3105       They are used additionally to the global lists in MoinMoin/dict/.
  3106     * moin_dump now also dumps attachments referenced from the page.
  3107       It doesn't dump stuff that is just attached, but not referenced!
  3108     * On RecentChanges we now force the comment to be breakable, this improves
  3109       rendering of over-long words or on narrow browser windows - especially
  3110       for themes with limited content width like rightsidebar.
  3111     * We now have the "new" icon on RecentChanges clickable, just links to the
  3112       page.
  3113     * Print view now shows "interwikiname: pagename" (for show_interwiki = 1).
  3114 
  3115   International support:    
  3116     * mail_from can be now a unicode name-address 
  3117       e.g u'Jürgen wiki <noreply@jhwiki.org>'
  3118 
  3119   Theme changes:
  3120     * logo_string is now should be really only the logo (img).
  3121       If you included your wiki's name in logo_string you maybe want to remove
  3122       it now as it is shown as part of the location display now anyway (if
  3123       you set show_interwiki = 1).
  3124     * You maybe want to remove page_front_page from your navi_bar - we link to
  3125       that page now from the logo and (new, if you set show_interwiki = 1) from
  3126       the interwiki name displayed in location display, so you maybe don't need
  3127       it in navi_bar, too.
  3128     * If you have a custom theme, you should / may:
  3129      * sync modern/css/screen.css #pagelocation #pagetrail stuff to your
  3130        screen.css or pagelocation display (title()) will look strange (like a
  3131        list).
  3132      * remove "#title h1 ..." CSS (or any other CSS assuming h1 is a page
  3133        title and not just a first level heading), it is not used any more.
  3134      * we now render = heading = as <h1> (was <h2> before 1.5),
  3135        == heading == as <h2> (was <h3>), etc.
  3136      * maybe move both title() and trail() to header area, like the builtin
  3137        themes do it.
  3138      * there is a new interwiki() base theme method that optionally (if
  3139        show_interwiki = 1) shows the interwiki name of this wiki and links to
  3140        page_front_page. The css for it is #interwiki.
  3141 
  3142   Developer notes:    
  3143     * Plugin API was improved. When plugin module is missing,
  3144       wikiutil.PluginMissingError is raised. When trying to import a
  3145       missing name from a plugin module, wikiutil.PluginMissingError is
  3146       raised. You must update any code that use wikiutil.importPlugin.
  3147       Errors in your plugin should raise now correct tracebacks. See
  3148       http://moinmoin.wikiwikiweb.de/ErrorHandlingInPlugins
  3149     * pysupport.importName was changed, it does not check for any
  3150       errors when trying to import a name from a module. The calling
  3151       code should check for ImportError or AttributeError. Previous
  3152       code used to hide all errors behind None.
  3153     * Its easier now to customize the editbar by overriding
  3154       editbarItems() in your theme, and returning a list of items to
  3155       display in the editbar. To change a single editbar link, override
  3156       one of the xxxLink methods in your theme.
  3157 
  3158   Internal Changes:
  3159     * request.formatter (html) is available for actions now
  3160     * theme API's d['page_home_page'] is gone (sorry) and replaced by
  3161       d['home_page'] which is either None or tuple (wikiname,pagename).
  3162       It is better to use the base classes function for username/prefs anyway.
  3163     * introduced cfg.hacks for internal use by development, see comment in
  3164       multiconfig.py and file HACKS.
  3165     * added IE7 (v0.9) from Dean Edwards (see http://dean.edwards.name/IE7/) -
  3166       that should fix quite some IE bugs and annoyances (on Win32).
  3167       * for enabling IE7, use cfg.hacks = { 'ie7': True }
  3168     * reducewiki now also copies all attachments (we use that to make underlay
  3169       directory from moinmaster wiki's data_dir)
  3170 
  3171   Fixes:  
  3172     * Fixed a typo in xslt.py which led to a traceback instead of an
  3173       error message in case of disabled XSLT support.
  3174     * Fixed crash in twisted server if twisted.internet.ssl is not
  3175       available.
  3176     * Fixed wrong decoding of query string, enable wiki/?page_name urls
  3177       with non ascii page names.
  3178     * Fixed wrong display of non ascii attachments names in
  3179       RecentChanges and page revision history.
  3180     * Fixed a crash when trying to run standalone server on non posix os.
  3181     * Fixed highlight of misspelled words in Check Spelling action.
  3182     * Fixed case insensitivity problems on darwin (Mac OS X). See
  3183       MoinMoinBugs/MacHfsPlusCaseInsensitive
  3184     * Added RecentChanges (only the english one) to the pages getting
  3185       html_head_index headers
  3186     * text_html cache files written with this code will invalidate themselves
  3187       if they detect to be older than the wikiconfig. Note: you should remove
  3188       all old text_html cache files once after upgrading, they will then be
  3189       rebuilt automatically with the new code.
  3190     * Fixed MoinMoinBugs/12_to_13_mig10_Walk
  3191     * Fixed the word_rule: a word like AAAbbAbb isn't teared into two parts
  3192       any more (was: AA<link>AbbAbb</link>)
  3193     * Fixed false positive InterWiki markup for languages like Finnish.
  3194       InterWiki links are only rendered if the left side has an appropriate
  3195       entry in the interwiki map, otherwise it is rendered as simple text.
  3196     * Fixed unicode error when uploding non-ascii file name using mod
  3197       python.
  3198     * Fixed error handling of wikirpc requests, should give more
  3199       correct errors and prevent no error output and blocking the
  3200       client in some cases.
  3201     * Fixed the "lost password" mail processing. If a user entered some email
  3202       address unknown to the system, he was not notified of this, but just got
  3203       a useless mail with no account data in it. Now the system directly tells
  3204       the user that he entered an unknown email address.
  3205     * Fixed SystemInfo, it now also lists parsers in data/plugin/parser dir.
  3206     * Fix error handling on failure, improved error display
  3207     * Fix error handling when importing plugins or importing modules
  3208       dynamically. The fix is not backward compatible with older plugins.
  3209     * Fix chart action, returns a page with error message when chart
  3210       can not be created.
  3211     * Fixed formatter usage in the ShowSmileys macro.
  3212     * Fixed updating pagelinks cache for [:page:text] or [wiki:Self:page text],
  3213       fixes display of LocalSiteMap and rendering of such links.
  3214     * Hopefully fixed urllib problems (esp. with py 2.4.2, but also before) by
  3215       using our own urllib wrapper that handles encoding/decoding to/from
  3216       unicode, see wikiutil.py. Also made a similar fix for making and parsing
  3217       query strings.
  3218     * Fixed MonthCalendar tooltips when containing special chars like quotes.
  3219     * Added html escaping for diff text for RSS feed with diff=1.
  3220     * The distance between page content beginning and the first = heading =
  3221       was much too much. Fixed.
  3222     
  3223 Version 1.4:
  3224 
  3225     We used that version number for an internal and early development version
  3226     for what will be called moin 2.0 at some time in the future.
  3227     There will never be a 1.4.x release.
  3228 
  3229 
  3230 Version 1.3.5 (2005-08-04, Revision moin--main--1.3--patch-883)
  3231 
  3232 Fixes:
  3233     * small CSS fix for rightsidebar theme
  3234     * applied some Debian patches (thanks to Jonas!):
  3235       * de i18n spelling fixes
  3236       * AttachFile fix, we strip CR in .draw files now
  3237       * when loading spellcheck dictionaries, we want utf-8, but we make
  3238         a 2nd try with iso-8859-1 encoding.
  3239 
  3240 New Features:
  3241 
  3242     * enabled using https with the Twisted server:
  3243       You need to use port 443, have PyOpenSSL (+ ssl libs it depends on)
  3244       installed and have some site key and certificate PEM files configured in
  3245       your twistedmoin.py file:
  3246       sslcert = ('/whereever/cert/sitekey.pem', '/whereever/cert/sitecert.pem')
  3247 
  3248 
  3249 Version 1.3.5rc1 (2005-07-31, Revision moin--main--1.3--patch-865)
  3250 
  3251 Fixes:
  3252 
  3253     * Fixed security bug when acl of deleted page was ignored. See:
  3254       http://moinmoin.wikiwikiweb.de/MoinMoinBugs/ACLIgnoredAfterDelete
  3255     * AttachFile did not display the original filename plus there
  3256       was a confusion in input field labelling ('Rename to').
  3257     * Fixed shortcut link non-existent page detection.
  3258     * Fixed non-working bookmark function on python 2.2.x.
  3259     * Fixed wikirpc getPageInfo call on python 2.2.x.
  3260     * Fixed the failing import of plugins from the data/plugin/
  3261       directories if run in zipimport environments.
  3262     * Fixed traceback which occurred on negated searches.
  3263     * Fixed crash when trying to render error message on twisted, fast
  3264       cgi and modpy.
  3265     * Fixed error message with modpy, used to show wrong errors below
  3266       the real message.
  3267     * Fixed search and goto text fields for better compatibility with
  3268       dark themes and better control through css.
  3269     * Show an edit link if MissingPage is missing and a warning in the
  3270       server log.
  3271     * Fixed missing footer in the editor.
  3272     * Fixed indented (invalid) headings with broken links in table of
  3273       contents.
  3274     * Fixed crash when file name is too long, show standard error message.
  3275     * Save trail file in a safe way, should be enough for normal use.
  3276     * Fixed remember_last_visit user preferences option when show_trail
  3277       is not selected.
  3278     * Fixed the tests for Standalone, Twisted, FastCGI and Mod_Python.
  3279       Run with ?action=test from any page.
  3280     * Fixed rare bug when wrong search type was performed when pasting
  3281       search term in Safari.
  3282     * Fixed crash for custom formatters and dom_xml (which occurred if
  3283       smileys were in the page).
  3284     * Editor opens on double click in pages with single quote in the
  3285       name, like "Ben's Wiki".
  3286     * '/.' in page names are not replaced any more by '/(2e)'
  3287     * Fixed the long delays while saving pages using RequestCLI.
  3288     * Fixed variable expanding for users with non WikiName.
  3289     * Fixed MonthCalendar's calculation of "today" to use the user's
  3290       time zone setting.
  3291     * Fixed moin_dump script, use same configuration options as other
  3292       scripts.
  3293     * Fixed url_mappings to work in proxied setups and sent mails
  3294       again. Also fixed for image links. Thanks to JohannesBerg.
  3295     * Fixed page shown after saving a drawing (esp. when saved from a
  3296       sub page). Fixed help link for drawings.
  3297     * Fixed mig10 script to run on Python < 2.3.
  3298     * The twisted server defaulted to a socket timeout of 12 hours!
  3299       We reduced that to a more sane 10 minutes, that should still be more
  3300       than enough. This fixed the "too many open files" problem we
  3301       encountered quite often recently. Thanks to Helmut Grohne!
  3302 
  3303 Other Changes:
  3304 
  3305     * Added {hu} flag.
  3306     * Added cz, pt and pt-br i18n.
  3307     * We send a 404 http status code for nonexisting wiki pages now,
  3308       maybe this will repell some search engines from requesting gone
  3309       pages again and again. The wiki user still sees the MissingPage
  3310       wiki stuff, so a user usually won't notice this change.
  3311     * Return 500 error code on failure and exceptions.
  3312     * Added some more bot / leech tool user agent strings.
  3313     * Prevent page floating elements from floating out of the page over
  3314       the footer, in modern, rightsidebar and classic themes.
  3315     * Encode URLs in a safer way
  3316     * We allow usernames with ' character in them now (like Tim O'Brian).
  3317     * Added support for the new security flags in docutils 0.3.9.
  3318     * @MAILTO@ expands now to safer [[MailTo()]] macro.
  3319     * Clarified and i18ned lost password mails.
  3320     * Added 'TitleIndex' and 'SiteNavigation' (+ translation) to the
  3321       list of pages that use html_head_index (so that robots
  3322       "index,follow").  Please make sure to have either FindPage,
  3323       TitleIndex or SiteNavigation in your navi_bar or in your
  3324       page_front_page content if you want search engines to find all
  3325       your pages.
  3326     * Make it possible to send account data when being logged in (for
  3327       future reference or whatever purpose).
  3328     * Speed up when running with persistent servers, the wiki config
  3329       does only get loaded once and misc. stuff is being cached between
  3330       requests now.
  3331     * The unit tests are disabled when using multi threading, because
  3332       the wiki configuration is shared between diffrent threads.
  3333     * The main code path (using standalone server) of MoinMoin runs on
  3334       PyPy now.
  3335     * Formatters do automatically transform HTML to plain text if they are
  3336       called with raw HTML code.
  3337     * Using larger socket backlog on Standalone and FastCGI servers
  3338       should be more reliable on high load.
  3339     * We now strip leading path from attachments uploaded by IE (this is
  3340       a bug in IE, not in MoinMoin). Better use a sane browser, like Firefox.
  3341     * added "teleport" to the user agent blacklist
  3342 
  3343 New Features:
  3344 
  3345     * Integrated Lupy indexer for better search performance. It is disabled
  3346       by default as of 1.3.5 as it still has known issues.
  3347       See multiconfig.py if you want to test it.
  3348     * Integrated MonthCalendar 2.1, with some new features:
  3349       * a mouseover bubble that shows first level headlines of the linked
  3350         day page
  3351       * all calendars with same pagename move when using cal navigation,
  3352         thanks to Oliver Graf
  3353       * included AnnualMonthlyCalendar patch of Jonathan Dietrich
  3354         (use [[MonthCalendar(Yearly,,,+1,,6,1)]] syntax for birthdays and
  3355         other annually repeating stuff)
  3356       Make sure you remove old MonthCalendar.* from data/plugin/macro so that
  3357       moin will use the new code in MoinMoin/macro/MonthCalendar.py.
  3358       Maybe also clear the text_html cache.
  3359     * Added the new XSLT parser and the DocBook parser. This should increase
  3360       the 4suite compatiblity. See HelpOnXmlPages for details.
  3361       It now should run on 4suite 1.0a4 and 1.0b1. Thanks to Henry Ho!
  3362     * Added the DocBook formatter. This will let you generate DocBook markup
  3363       by writing simple wiki pages. It needs PyXML.
  3364     * It is now possible to customize parts of the UserPreferences page in
  3365       your wikiconfig (changing defaults, disabling fields, removing fields):
  3366       * Use user_checkbox_* for the checkboxes.
  3367       * Use user_form_* for other fields.
  3368       * See MoinMoin/multiconfig.py for the built-in defaults.
  3369     * New standalone server classes: ThreadPoolServer using pool of
  3370       threads, ThreadingServer with thread limit and ForkingServer.
  3371     * New standalone server configuration options: serverClass,
  3372       threadLimit, requestQueueSize.
  3373     * Use "PythonOption Location" in mod_python setup to solve script_name
  3374       problems.
  3375 
  3376 Developer notes:
  3377     
  3378     * Theme can now override maxPagenameLength() method to control page
  3379       name shortening.
  3380     * A search Match now provides access to the full re match via
  3381       the re_match attribute (use to access groups of the match)
  3382     * Underlay is not managed by arch any more. The tree contains an
  3383       underlay tarball, and you should untar after you update from main.
  3384     * "make update-underlay" will untar underlay
  3385     * "make merge" will star-merge main into your tree
  3386     * "make test" will now create and run in a fresh testwiki instace
  3387     * "make clean" options added
  3388     * _tests module does not have a global request any more. To refer to
  3389       the current request in a test, use self.request.
  3390     * _tests.TestConfig class require a request in the constructor.
  3391     * "python tests/runtests.py test_module" will run only test_module
  3392     * request.cfg stays between requests (for persistent servers).
  3393 
  3394 
  3395 Version 1.3.4 (2005-03-13, Revision moin--main--1.3--patch-666)
  3396 
  3397 Fixes:
  3398 
  3399     * Fixed ACL check in LikePages macro that caused links to unreadable 
  3400       pages to show.
  3401     * Fixed ACL check in newpage action.
  3402     * Fixed a security problem when admin policy defined in a custom
  3403       SecurityPolicy class was ignored.
  3404     * Fixed ACL check in action=show so that a user who may not read a page
  3405       also can't find out WHEN the protected page was updated.
  3406     * Workaround on Windows 95, 98, ME in order to clear the dircache.
  3407       This fixes some bugs related to an outdated page list and newly created
  3408       pages that did not appear immediately.
  3409     * Fixed decoding issues of page names on Windows, finally.
  3410       http://moinmoin.wikiwikiweb.de/MoinMoinBugs/BrokenUmlautsInLinksIn131
  3411     * Fixed traceback on IIS.
  3412       http://moinmoin.wikiwikiweb.de/MoinMoinBugs/request%2epy_broken_on_IIS
  3413     * Fixed wikirpc for standalone server.
  3414     * Other fixes (encoding and str/unicode data type related) to wikirpc
  3415       server, fixing some non-ascii issues hopefully.
  3416     * Fixed broken query strings for Standalone installations.
  3417     * Fixed backlinks - the result did not always show all links, often it 
  3418       showed too many irrelevant matches (MoinMoinBugs/BacklinksAreBroken).
  3419     * Fixed the acceptance of the show_hosts setting. Now you should be able
  3420       to hide any IP or host name from being published by MoinMoin by enabling
  3421       this option.
  3422     * Fixed wrong line endings on email messages.
  3423     * Fixed MoinMoinBugs/StandaloneUnquotesTooMuch.
  3424     * Fixed crash when trail file is missing.
  3425     * Fixed a traceback when searching for single ( or ).
  3426     * Added mig10 script to fix crashes with uncoverted edit-locks and file
  3427       attachments. Just use it as you did with mig1..mig9 before.
  3428     * Added mig11 script to add __init__.py files to data/plugin (and below).
  3429     * added some fixes for the xslt parser (thanks to fanbanlo), it might be
  3430       still broken, but someone with deeper knowledge about xslt should fix it.
  3431     * Replaced image link with W3C's "html 4.01 compliance" icon by a simple
  3432       text link to avoid https: or config trouble.
  3433     * Catch OverflowError backtrace when illegal date strings (e.g. <1970 or
  3434       >2038) are fed to moinmoin's time routines. It will just output current
  3435       date / time in those cases.
  3436     * UserPreferences now also set a date_fmt preference and Date macro
  3437       honours it. You may have to reset your UserPreferences value for that.
  3438     * Fixed free parent and subpage links in interwiki notation.
  3439       http://moinmoin.wikiwikiweb.de/MoinMoinBugs/FreeParentLinksAreBroken
  3440     * Fixed a traceback for invalid ReST markup.
  3441     * Fixed UnicodeError in SystemAdmin's Attachment Browser.
  3442 
  3443 Other Changes:
  3444 
  3445     * Optimized the IRC parser.
  3446     * Support for zipimport of the MoinMoin package. This allows you to use
  3447       py2exe and similar programs.
  3448     * Show the editor's name in the mail subject.
  3449     * Added the pragmas description and keywords. They will add <meta> headers
  3450       if used.
  3451     * Added MoinMoin/scripts/xmlrpc-tools/putPageTest.py example script, useful
  3452       as a starting point for importing data using wiki xmlrpc.
  3453     * Optimised display on Opera browser.
  3454 
  3455 New features:
  3456 
  3457     * The search modifier "linkto:" was introduced. You can use it to search
  3458       for links.
  3459     * The NewPage macro now can take a PageTemplate parameter, see HelpOnMacros.
  3460     * New config settings (so you don't need to edit wikirpc.py any more):
  3461       xmlrpc_putpage_enabled = 0 (if 1, enables writing to arbitrary page names)
  3462       xmlrpc_putpage_trusted_only = 1 (if 0, doesn't require users to be
  3463        authenticated by http auth - DANGEROUS, DO NOT SET TO 0!!!)
  3464     * Added support for Digest and NTLM authentication with CGI (e.g. if you
  3465       use those Apache modules)
  3466     * The datetime string accepted by Date and DateTime macros was extended to
  3467       accept a timezone specification, so now +/-HHMM is also valid, e.g.:
  3468       2005-03-06T15:15:57Z (UTC, same as +0000)
  3469       2005-03-06T15:15:57+0000 (UTC)
  3470       2005-03-06T16:15:57+0100 (same time given as local time for time zone
  3471                                 with offset +0100, that is CET, e.g. Germany)
  3472       2005-03-06T10:15:57-0500 (same time given as local time for time zone
  3473                                 with offset -0500, EST, US Eastern Std. Time)
  3474       The values given as macro argument will be transformed to UTC internally
  3475       and then adapted again according to viewing user's UserPreferences, so
  3476       the user will see the same moment in time but shown in his local time
  3477       zone's time (at least if he set his UserPreferences correctly and didn't
  3478       forget changing them twice a year for DST and non-DST).
  3479     * Readded (now optional) editlink footer to Include macro. Add
  3480       ',editlink' to call to enable this.
  3481     * star "smileys" e.g. {*}{*}{*}{o}{o}
  3482 
  3483 
  3484 Version 1.3.3 (2005-01-24, Revision moin--main--1.3--patch-595)
  3485 
  3486 Fixes:
  3487 
  3488     * fixed ACL security problem in search
  3489     * fix for IIS with CGI allowing page names that contain chars
  3490       that are not in the system code page
  3491     * fixed MoinEditorBackup revisions to start with 1 now
  3492     * improved page locking ('current' file)
  3493     * Unittests (normally shown at end of action=test output) are currently
  3494       disabled for everything except CGI, because they only work reliably with
  3495       CGI, giving wrong results for other request methods.
  3496 
  3497 
  3498 Version 1.3.2 (2005-01-23, Revision moin--main--1.3--patch-587)
  3499 
  3500 Fixes:
  3501 
  3502     * ACL bugfix for deleted pages with ACL protection.
  3503     * ACL bugfix for "Default" acl.
  3504     * Fixed updating of groups and dicts
  3505     * Python 2.2.x related fixes (worked on 2.3+)
  3506       * Fixed traceback in RecentChanges.
  3507       * Fixed traceback with links browser.
  3508     * Fixed 0 revision display in 'Show changes'.
  3509     * Fixed traceback in Antispam which occurred when it could not connect
  3510       to MoinMaster. Log the errors to stderr or error.log.
  3511     * Fixed bug in Page init (no date, use rev). Fixes problem with
  3512       #deprecated PI.
  3513     * Fixed empty lists in empty search results.
  3514     * Cosmetic fix for modern theme (when viewed with Internet Explorer).
  3515     * Fixed migration 9 script, do not drop newline, do not drop error.log, 
  3516       note about missing error.log.
  3517     * Fixed repair_language.py script, keep ending newline on revisions.
  3518     * Show headings and macro content in correct direction when mixing content 
  3519       in several directions in the same page and using caching.
  3520     * Fixed bug in standalone re farmconfig.
  3521     * Fixed DOS condition in antispam code.
  3522     * Use smaller margin in print mode to get better results with 
  3523       Mozilla/Firefox.
  3524     * Fixed some user input escaping issues.
  3525     * Fixed a problem when one wiki plugin override other wikis plugins in 
  3526       same farm.
  3527     * Fixed some broken tests.
  3528     * Fixed recursive include in pstats.
  3529     * Fixed bug in standalone - HTTP result code was 200 even when the access
  3530       was forbidden.
  3531     * Fixed traceback when trying to login with non-ascii password.
  3532     * Fixed traceback when xml is not available, reported on Python 2.2.?
  3533     * Fixed slideshow to show slides in sorted order again.
  3534     * Fixed serving multiple wikis on same IP/different ports with twisted and
  3535       farmconfig.
  3536     * It is possible to run with data_underlay_dir = None for special
  3537       application, but be aware that the wiki won't be usable unless you have
  3538       at least some of the system pages from underlay/ available.
  3539     * Files with Unicode characters in their filename are possible now.
  3540     * Bugfix for broken [:page#anchor:text] links.
  3541     * Workaround an instability of the gdchart module leading to
  3542       stalled servers etc.
  3543     * Fixed some event-log decoding issues that affect charts rendering.
  3544 
  3545 Other changes:
  3546 
  3547     * Major speed improvement over 1.3.1. Many times faster title search,
  3548       creating new page, opening page editor and any operation that list pages.
  3549       See http://moinmoin.wikiwikiweb.de/MoinBenchmarks
  3550     * Improved README.migration.
  3551     * Cleaner design for login/register interface, login is always the default
  3552       button when the user click Enter.
  3553     * If there are problems found in the configuration, log the error
  3554       and display helpful error messages in the browser.
  3555     * More forgiving unicode configuration policy, you must use the u'string' 
  3556       format only for unicode values.
  3557     * Added profiling to CGI.
  3558     * The content of farmconfig.py is similar to wikiconfig.py now.
  3559     * Unexpected errors while loading cache files are logged.
  3560     * i18n for icon ALT tags.
  3561     * Include request initialization code in the profile in standalone server.
  3562     * When creating new theme, style sheets are inherited correctly, no need
  3563       to override style sheets just to get them working.
  3564     * Many times faster plugin system. Typical pages are about 35% faster, 
  3565       pages with many plugins can be many times faster. 
  3566     * Spiders are allowed to fetch attachments.
  3567     * Old user files containing password hash encoded in pre 1.3 charset
  3568       are auto repaired on first login.
  3569     * data_dir defaults to './data', underlay_data_dir to './underlay' now.
  3570       It is a good idea to replace those by absolute pathes in wikiconfig.py.
  3571     * Renamed "Refresh" to "Delete Cache" - it was misused by users. The action 
  3572       was also moved into the action menu in the modern and rightsidebar themes.
  3573     * Added a workaround for TableOfContents missing some links by making it
  3574       uncacheable via a "time" dependency.
  3575     * Removed interwiki icon and title attribute for wiki:Self:... links.
  3576     * Unittests (normally shown at end of action=test output) are currently
  3577       disabled because they worked unreliably, giving wrong results sometimes.
  3578 
  3579 New features:
  3580 
  3581     * Create new pages easily using configurable interface and page templates 
  3582       with the new NewPage macro.
  3583     * ReStructuredText (rst) support is built-in now. See HelpOnParsers.
  3584     * New experimental feature in mointwisted.py - each interface may 
  3585       specify a port: '12.34.56.78:80'. Without a port, the port option
  3586       is used.
  3587 
  3588 API changes:
  3589 
  3590     * For a complete list of changes, see MoinMoin:ApiChanges.
  3591     * wikiutil.importPlugin's first argument is now a wiki config instance 
  3592       (request.cfg) and there is no path keyword.
  3593     * Wiki plugins always override MoinMoin plugins. wikiutil.importPlugin
  3594       implements this override.
  3595     * util.pysupport.importName does not accept path - you should call 
  3596       it with correct module name, e.g 'wikiconfig.plugin.parser.wiki' for 
  3597       wiki plugins, or 'MoinMoin.parser.wiki'. 
  3598     * wikiutil.extensionPlugin was renamed to wikiPlugins and it gets config 
  3599       instance instead of path.
  3600     * New function wikiutil.importWikiPlugin used to import wiki plugins 
  3601       using a cache in a thread safe way.
  3602     * New config option config.use_threads is used to activate thread 
  3603       safe code.
  3604     * New keyword arguments for getPageList, enable 10X faster operation
  3605       for common cases by controlling page filtering.
  3606     * New up to 100X times faster getPageCount
  3607 
  3608 
  3609 Version 1.3.1 (2004-12-13, Revision moin--main--1.3--patch-434)
  3610 
  3611 Fixes:
  3612 
  3613     * Fixed "Error Cyclic usage" crash when user had Italian (it), Korean
  3614       (ko), Serbian (sr) or Vietnamese (vi) as user interface language.
  3615     * Fall back to en (instead of crashing) when user uses a language moin
  3616       does not support / does not support any more (like pt,sv,fi,sr).
  3617     * In 1.3.0, people accidentally put iso-8859-1 chars into wiki configs,
  3618       but those where expected to be pure utf-8 and thus it crashed.
  3619       Fixed by using unicode strings (varname = u'whatever'), a matching
  3620       encoding setting (see top of script comment) and, when decoding strings,
  3621       using decode to ASCII with replace mode (this replaces non-ASCII chars,
  3622       but at least it won't crash - and you get a warning to better use
  3623       Unicode strings).
  3624     * Fixed long time broken table formatting. ||<style="see css spec" a||b||
  3625       Now even generates valid HTML! The old markup for align, valign, width,
  3626       bgcolor still works, but synthesizes style attribute data.
  3627     * SystemAdmin macro shows attachments of ALL pages now.
  3628     * Users without write acl rights will be able to see attachments again and
  3629       also have AttachFile action in menu.
  3630     * Fixed wrong match count in search results, find all matches in page 
  3631       titles, show all matches in contents in some rare cases.
  3632     * Run about 200% faster with long running processes (standalone, Twisted), 
  3633       about 20% faster with cgi, by better internal data handling in wikidicts.
  3634     * On SF, the dict files use utf-8 encoding now. We included them also in
  3635       distribution, see contrib/dict/.
  3636     * Fixed permissions to shared template stuff.
  3637     * Speeded up search, fixed wrong match counts.
  3638     * Speeded up internal data handling (wikidicts).
  3639     * Fixed rare unicode error after deleting a page (reported only on SuSE
  3640       Linux 9.0 / Python 2.3.0).
  3641     * Fixed file permissions of files in the data dir.  
  3642     * Fixed some cosmetic problems in migration scripts and use sys.path.insert
  3643       to get latest moin code when executing them.
  3644 
  3645 Other Changes:
  3646 
  3647     * Improved docs, system and help pages.
  3648     * Updated translation files.
  3649 
  3650 Known Bugs:
  3651 
  3652     * Internet Explorer renders our HTML/CSS in a suboptimal way.
  3653       (MoinMoin: href="http://moinmo.in/MoinMoinBugs/InternetExplorer)">MoinMoinBugs/InternetExplorer)
  3654       Workaround: use a non-broken browser like FireFox / Mozilla.
  3655       Fixed in MoinMoin 1.3.2.
  3656     * Passwords using non-ascii do not work.
  3657       (MoinMoin: href="http://moinmo.in/MoinMoinBugs/NonAsciiPasswordsBroken)">MoinMoinBugs/NonAsciiPasswordsBroken)
  3658     * The TOC macro is broken partly.
  3659       (MoinMoinBugs/TableOfContentsBrokenForIncludedPages,
  3660        MoinMoinBugs/TableOfContentsLacksLinks)
  3661     * See also: http://moinmoin.wikiwikiweb.de/MoinMoinBugs
  3662       
  3663 
  3664 Version 1.3.0 (2004-12-06, Revision moin--main--1.3--patch-400)
  3665 
  3666     As you see from the length of the 1.3 changes below, 1.3 is a major(!)
  3667     upgrade. We could have also named it "2.0", but we decided against.
  3668     So take the time for reading the informations thoroughly and do the
  3669     migration exactly as we tell you - this is no 5 minutes upgrade!
  3670 
  3671     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  3672     !!! We heavily changed configuration, data encoding, dir layout:    !!!
  3673     !!!  * the default encoding changed to utf-8.                       !!!
  3674     !!!  * also, we changed the escaping for special chars to %XX%YY in !!!
  3675     !!!    URL and (xxyy) in file system.                               !!!
  3676     !!!  * layout of data dir changed completely                        !!!
  3677     !!! If you upgrade an existing wiki, you must run the migration     !!!
  3678     !!! scripts or you will get data corruption or other problems.      !!!
  3679     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  3680 
  3681     HINT: Upgrading your wiki - critical information
  3682 
  3683       If you are NOT starting from scratch, you MUST convert your existing
  3684       data - see README.migration for details.
  3685 
  3686       If you use ##language: xx comments on your OWN pages, you should also run
  3687       repair_language script. Not needed for help/system pages as we already
  3688       have done that for you.
  3689 
  3690       MoinMoin uses Unicode internally now (UCS-2 with 16 bits or UCS-4 with
  3691       32 bits, depending on your Python installation). The encoding used
  3692       for page files and html output is set by config.charset.
  3693 
  3694       Moin 1.3 uses utf-8 encoding only, there is NO SUPPORT for using a
  3695       charset different from utf-8 with 1.3. If you try, you are on your own.
  3696 
  3697     Directory layout
  3698 
  3699       Directory layout was heavily changed. Each page now is a directory,
  3700       containing page revisions, attachments, cache files and edit-log.
  3701       
  3702       You can delete a page or move a page from one wiki to another
  3703       easily. Look at the wiki/data directory to see.
  3704       
  3705       Example:
  3706         old: data/text/FrontPage
  3707         new: data/pages/FrontPage/revisions/00000042
  3708              data/pages/FrontPage/current (contains: 00000042)
  3709         old: data/backup/FrontPage.xxxxxxxx
  3710         new: data/pages/FrontPage/revisions/00000023
  3711 
  3712       For cleaning up cache files, use MoinMoin/scripts/cachecleaner.py 
  3713       (see comments in script).
  3714 
  3715    Python / Libs
  3716       
  3717       * For using RSS, you need to have PyXML installed:
  3718         Python 2.4*   -> PyXML 0.8.4 (cvs version)
  3719         Python 2.3.x  -> PyXML 0.8.3
  3720         Python 2.2.2+ -> ???
  3721         This will also make "Live Bookmarks" of Mozilla Firefox working.
  3722         New: if you don't have PyXML installed, the RSS icon on RecentChanges
  3723         will not be displayed any more. Python with no PyXML installed
  3724         generates invalid RSS XML.
  3725 
  3726    Page names handling
  3727 
  3728       * Handling of special characters in file names changed from _xx format
  3729         to (xx...) format.
  3730       * In URLs, moin now uses %xx%yy quoting, (because this is supported by 
  3731         browsers), and sub pages use "/" instead of the ugly "_2f".
  3732       * Underscore character "_" is used now as a space character " " both 
  3733         in file names and URLs. " " and "_" will be handled equivalent at most
  3734         places in the future (represented as "_", rendered as " ").
  3735       * To prevent wiki abuse and user typing errors, page names are normalized 
  3736         in URLs, query strings, the "go" box and when renaming pages. This 
  3737         include leading, trailing and multiple slashes and white space. Certain 
  3738         invisible unicode characters are removed from page names.
  3739       * Group page names are restricted even more, any non unicode alpha-numeric
  3740         character is removed. This is done to enable changing acl syntax in 
  3741         the future. The restriction might be loosen on future versions.
  3742       * You can edit config.page_invalid_chars_regex to control which characters
  3743         are allowed in page names (Changing it is not supported).
  3744       * When you enter page name, it is normalized and you are redirected to
  3745         the normalized page, or if nothing left (e.g '/////'), to FrontPage.
  3746       * When renaming a page to a name that can be normalized to an empty string,
  3747         the new page name will be "EmptyName" and the user will not get an
  3748         error message.
  3749        
  3750    Underlay directory
  3751 
  3752      * Pages (especially system and help pages) are now located in an underlay
  3753        directory (data_underlay_dir). You will see the pages there if they are
  3754        NOT covered (overlayed) by a page in the normal pages directory
  3755        (as set using data_dir).
  3756        MAKE SURE THAT data_underlay_dir IS CORRECT OR YOU WILL SEE MANY EMPTY
  3757        PAGES ONLY IN A NEW WIKI.
  3758      * If you edit a page that is shown from underlay directory, it will be
  3759        copied to the normal page directory on save (copy-on-write).
  3760      * You can use one copy of the underlay directory shared by many
  3761        wiki instances. Each wiki will then have only your local, self-made
  3762        wiki pages in its data directory, and only system and help pages in the
  3763        single, shared underlay directory - this simplifies upgrades a lot.
  3764      * It is recommended to keep your underlay system and help pages immutable
  3765        using acl, so you can upgrade your wiki easily. The default help and
  3766        system pages already have those ACLs (using MoinPagesEditorGroup).
  3767      * Do not forget to remove your old help and system pages after migrating
  3768        your wiki. We don't provide a script for that as that would be
  3769        dangerous for edited pages. Just use some file manager (e.g. mc) to
  3770        clean the data/pages/ directory. As soon as you have removed the
  3771        system pages there, you will see the new pages in the underlay dir.
  3772        See the EditedSystemPages page for a list of pages that exist in both
  3773        data and underlay directory (use this page as admin!).
  3774 
  3775        When updating from 1.2 or lower to 1.3 or higher, you will want to
  3776        clean out the copies of the system pages in your {{{wiki/data}}}
  3777        directory. All of these pages will now reside in the underlay
  3778        directory. If you have system pages from 1.2 or lower in your
  3779        wiki/data/ directory, they will overshadow the more up-to-date
  3780        documentation. This can be done using the following manual procedure:
  3781        1. You have just converted from 1.2 or lower to post-1.3.
  3782        2. Go to your wiki's EditedSystemPages.
  3783        3. Find all the pages that are MoinMoin system or help pages. You will
  3784           know if it is one of those pages because it is not your page.
  3785        4. Check if it is okay to delete by either:
  3786           1. Using the this page "info" link and check the Revision History to
  3787              see if it is greater than 1. If so, there are modifications, so do
  3788              not delete the page and evaluate the modifications to see if they
  3789              are necessary.
  3790           2. Using your file browser (Windows Explorer, etc) to go to your
  3791              wiki/data/<<systemPage>>/revisions/ directory and to see if there
  3792              are no modifications. If there are, do not delete the page and
  3793              evaluate the modifications to see if they are necessary.
  3794        5. Delete that wiki/data/<<systemPage>> using your file browser.
  3795 
  3796     Multiple languages
  3797 
  3798       * New file name quoting method allow 50% longer page names in languages
  3799         that use more than one byte per character, like Hebrew, Korean etc.
  3800       * Configuration file uses 'utf-8' encoding now. Certain values that are
  3801         marked with [Unicode] can use any character in your language. Examples 
  3802         are page names in navi_bar, page types regular expressions and site name.
  3803       * For configuration examples adopted to your language, check ConfigMarket 
  3804         in the MoinMoin wiki.
  3805       * The system and help pages that come with moin are now in utf-8.
  3806       * MissingPage system page localized, should display in your language.
  3807       * We did many i18n (translation) updates.
  3808       * CSS file use utf-8 encoding. User css is also expected to be utf-8.
  3809         This is relevant only if you use non-ASCII values in the CSS file.
  3810       * config.upperletters and config.lowerletters were removed.
  3811         We now use a pre-made ucs-2 spanning set and you usually don't have to
  3812         change it. See MoinMoin/util/chartypes.py if you're interested.
  3813       * ACL works with any user name or group name in any language, even names 
  3814         with spaces.
  3815       * Now you can use any charset in config.charset. Note: only utf-8 is 
  3816         a supported configuration!
  3817       * Improved url handling, now creating pages directly from the browser 
  3818         url box with non-ascii names works in most cases, even when 
  3819         config.charset is not utf-8.
  3820       * When using non-utf-8 config.charset, characters in URLs that does
  3821         fit in the charsets are replaced with "?" (instead of crashing).
  3822       * All themes and most macros and actions are Right to Left friendly.
  3823         Full RTL support planned for 1.3 release.
  3824       * If page language is specified with #language processing instruction
  3825         the page is displayed in the correct direction. Pages without
  3826         language are displayed using the wiki default_lang.
  3827 
  3828     Multiple configurations
  3829 
  3830       * You can run multiple wikis from the same wiki directory or server. 
  3831         For example, you can run one Twisted server that serve multiple wikis, 
  3832         instead of running multiple servers. Samples of the new configuration
  3833         are supplied in wiki/config/*.
  3834       * You can't just use your old moin_config.py file. It is now called
  3835         wikiconfig.py and the config variables now have to be in a class
  3836         "Config" and that class must inherit from
  3837         MoinMoin.multiconfig.DefaultConfig - see the provided wikiconfig.py
  3838         sample for details.
  3839         This is very useful, e.g. you could derive a GermanConfig from
  3840         DefaultConfig. After that, you can derive configs for wikiA and wikiB
  3841         from that GermanConfig.
  3842       * farmconfig.py contains a mapping attribute called "wikis" with pairs of
  3843         wikiconfig module name and regular expression. The regular expression
  3844         is matched against the URL of the request and the first matching entry
  3845         determines the config module to be imported by MoinMoin.
  3846       * If you use farmconfig.py's "wikis" mapping, then any wiki has a private
  3847         config module, named after the wiki - e.g. wiki named moinmoin would
  3848         use moinmoin.py.
  3849       * If you only have a single wiki, you do not need farmconfig.py. just make 
  3850         a wikiconfig.py and it will be used no matter what URL is requested. 
  3851       * There is one common global "config" that holds sitewide settings (like
  3852         umask or charset) - you do not need to change settings there.
  3853         This file is located in the MoinMoin code: MoinMoin/config.py.
  3854       
  3855     General configuration
  3856 
  3857       * SecurityPolicy now uses "write" instead of "edit" (so it is may.write
  3858         now). This is to get it in sync with ACLs.
  3859       * SecurityPolicy now automatically can use everything in acl_rights_valid.
  3860       * There is a new config option "config_check_enabled". It will warn about
  3861         any unknown variable name (probably typo) to stderr or error.log. 
  3862         If something doesn't work at all and changing the config does no 
  3863         difference, switch it on and look at the error message. 
  3864       * The sample config file comes with config_check_enabled = 1. If you 
  3865         introduce additional variables yourself, you definitely want to switch 
  3866         that check off or it will fill your log.
  3867       * If you define "page_front_page" variable, this name will show in the 
  3868         navigation bar now, instead of the default "FrontPage".
  3869 
  3870     New search engine
  3871 
  3872      * Full text and title search do support multiple search terms now - 
  3873        see HelpOnSearching for details.
  3874      * Regular expressions are still supported but have to be turned on per
  3875        search term. Search terms in macros using regular expressions will have
  3876        to be fixed.
  3877      * The URL interface of the search engine has also changed. Links that 
  3878        point directly to search actions may be broken.
  3879 
  3880     User names
  3881 
  3882       * User names can not use group names, even if ACLs are not enabled.
  3883         This will prevent error later, if you start to use acl in the future
  3884         (acl is going to be mandatory in 1.5).
  3885       * User names are not restricted any more to only CamelCase. 
  3886       * To prevent imposing as other users, leading, trailing and multiple 
  3887         whitespace in user names is not allowed. Only Unicode alpha numeric 
  3888         characters are allowed, with optional one space character between 
  3889         words.
  3890       * When a user name with a group name or "bad" name is trying to 
  3891         access the wiki, he is redirected to the UserPreferences page and 
  3892         asked to create a new account.
  3893       * When trying to login or create a new account with a bad name, 
  3894         correct error message is displayed in all cases.   
  3895 
  3896     CGI
  3897 
  3898       * You can not use your old moin.cgi file, as we removed cgimain.py 
  3899         (was deprecated since 1.2). Copy the new file from the server dir.     
  3900 
  3901     Moin servers - Twisted and standalone
  3902 
  3903       * Configuration self checking on startup. Will raise an error in case
  3904         of bad configuration or non-accessible directories.
  3905       * Both use shorter and identical configuration options.
  3906       * Server scripts contain detailed comments and examples.
  3907       * Configuration defaults changed to fit most users.
  3908       * There is memory profiler option for debugging, switched off by default.
  3909       * If you perform a standard install, server scripts should run out
  3910         of the box or with minimal change.
  3911 
  3912     Twisted server
  3913 
  3914       * All code moved into the new server package, the server script
  3915         contains only configuration options.
  3916       * Listen to more than one interface with "interfaces" list.
  3917       * Code updated to new Twisted API.
  3918       * Use mointwisted script to start and stop the server, using 
  3919         "mointwisted start" and "mointwisted stop".
  3920       * The Twisted server runs as daemon by default.
  3921       * All moin Twisted files are called now mointwisted instead of 
  3922         moin_twisted.
  3923       * Fixed getting username from Twisted request (http auth)
  3924 
  3925     Standalone server
  3926 
  3927       * Configuration moved from moin_config.py to moin.py.
  3928       * If run as root, you can set both user and group for the server.
  3929       * Can use logfile instead of logging to stderr.
  3930       * Fixed missing unquoting of query string (caused problems in rare cases).
  3931 
  3932     mod_python server
  3933 
  3934      * moin_modpy server files renamed to moinmodpy.
  3935 
  3936     Wiki Markup
  3937 
  3938      * '''strong''', ''em'' and __underline__ have now paragraph scope. You can
  3939        set these attributes on words level. For multiple paragraphs, wrap each 
  3940        with needed markup.
  3941      * If you leave unclosed ''', '' and __  markup, its is closed when the 
  3942        paragraph ends.
  3943 
  3944     User interface
  3945 
  3946      * Due to many changes in CSS files, the wiki may look "broken" until
  3947        your reload once or twice, or empty your browser cache.
  3948      * The "Send mail notification" checkbox is replaced by "Trivial change"
  3949        checkbox. The default behavior did not change - regular edit is not
  3950        a trivial change, and mail will be sent to subscribes. If you check
  3951        trivial change, mail will be sent only to users who selected to 
  3952        get trivial changes in their user preferences.
  3953      * New theme "modern" has been added, and used as default theme. 
  3954      * classic and rightsidebar improved.
  3955      * viewonly theme removed, as any theme can be use now as viewonly
  3956        by using #acl All:read in the wikiconfig.
  3957      * All themes use new navibar, displaying both wiki links, user links
  3958        and the current page.
  3959      * navibar and pagetrail use now shortened page names, so very long
  3960        names does not break the interface visually.
  3961      * All themes have improved search interface at the top of the window.
  3962      * Only avaiable actions are displayed, so most situations when a user
  3963        try to do something he can't do are prevented.
  3964      * When creating a new page, no action is available until the page 
  3965        is created. You can't attach files to non-existing page any more.
  3966      * Non registered users get a "login" link. Registered uses get
  3967        "username" link to their home page, and "user preferences" link.
  3968      * Messages more clear using bold type, designed by css.
  3969      * Few useless messages removed (but there are many more)
  3970      * Default wiki logo uses the wiki name instead of the MoinMoin troll 
  3971        logo.
  3972 
  3973     Other fixes and changes
  3974     
  3975      * Most generated html code is valid "html 4 strict". There are still
  3976        some problems that still have to be fixed, mainly macros, table
  3977        attributes, and inline markup crossing (<a><b></a></b>).
  3978      * WantedPages can include and exclude system pages, which makes it 
  3979        much more useful.
  3980      * Fixed a bug in TitleIndex where not all system pages are excluded.    
  3981      * RenamePage action now renames everything, including backups, page
  3982        history, attachments. It does not change toplevel editlog, though.
  3983        After you rename a page, you are redirected to the new page.
  3984      * Syntax colorization supports more languages (Java, C++, Pascal)
  3985      * Inline: display of attachments was extended. A Parser now knows which
  3986        extensions it can handle.
  3987      * TableOfContents and Include macros now cooperate a bit better. There
  3988        are still problems with multiple Includes of the same page.
  3989      * Excluded actions at bottom of page are not displayed any more.   
  3990      * Editor: removed the columns size setting, just using 100% of browser
  3991        window width (it didn't work because of that anyway). Also removed that
  3992        "reduce editor size" link at top of editor as you would lose your
  3993        changes when using it.
  3994      * Removed the option to choose text smileys instead of images, this made
  3995        more trouble than it was worth. The text version is still given in ALT
  3996        attribute.
  3997      * Moved stuff from contribution/ to MacroMarket page on MoinMoin wiki
  3998      * Some nasty people try to use a running moin as a proxy (at least they
  3999        did on moinmaster.wikiwikiweb.de:8000, maybe due to the magic port
  4000        number). We changed the code to check for that and just return 403
  4001        in that case. Moin can not be used as a proxy anyway.
  4002      * moin.cgi?test was removed in favor of a new buildin test
  4003        action. It works for all deployments, just use ?action=test.
  4004      * Sending mail does use tls if server supports it.
  4005 
  4006     3rd party developer notes
  4007 
  4008      * Themes should be now sub class of MoinMoin.theme.ThemeBase. Sub
  4009        classes will get automatically all new improved user interface
  4010        elements for free.
  4011      * Theme authors should update their theme for 1.3. Some keys removed
  4012        from them dict. See ThemeBase class in MoinMoin/theme/__init__.py. 
  4013      * Actions writers should call request.setContentLangauge with the 
  4014        correct language used by the action. This enable themes and other
  4015        code to use correct direction.
  4016      * The Formatter interface was changed. Formatters and parsers using 
  4017        the formatter interface have to be adjusted.
  4018      * started deprecation of Processors: they are still recognized, but
  4019        implementors should start to rewrite their Processors as Parsers.
  4020        A processor with the same name as a parser in a pre #! section is
  4021        currently preferred. This will change in the next release.
  4022 
  4023     Deprecation notes
  4024 
  4025      * Processors are deprecated, see section above.
  4026 
  4027      * Using the cookie (or the login url with ID) only and not setting (or
  4028        setting and not remembering) your email/password in UserPreferences
  4029        is DEPRECATED. Those quite unsecure methods will likely be dropped
  4030        in next moin version.
  4031 
  4032      * Operating with acl_enabled = 0 is also DEPRECATED. Due to some other
  4033        improvements planned, we will have to operate with ACLs enabled ONLY
  4034        in a future moin version, so this setting will likely be dropped.
  4035        So clean up your user accounts (see moin_usercheck.py) and switch ACLs
  4036        on NOW.
  4037        There are no drawbacks, so you will like it. Having ACLs enabled
  4038        doesn't mean you really have to USE them on wiki pages...
  4039 
  4040      * allow_extended_names = 0 is deprecated (default was/is 1).
  4041        Future versions will be able to use extended names (aka free links) in
  4042        any case and the config setting will be removed.
  4043 
  4044      * allow_subpages = 0 is deprecated (default was/is 1).
  4045        Future versions will be able to use subpages in any case and the config
  4046        setting will be removed.
  4047 
  4048      * attachments = {...} - we would like to remove that setting because of
  4049        several reasons:
  4050        * when not being extremely careful, this can easily lead to security
  4051          problems (like when uploading a .php exploit and then executing it
  4052          by accessing it directly via web server)
  4053        * makes code more complicated - code that we want to change completely
  4054          in next version
  4055        If you need that feature, speak up now and tell us your reasons WHY you
  4056        need it.
  4057 
  4058 
  4059 Version 1.2.4 (2004-10-23, Revision 1.187)
  4060 
  4061 This will probably be the last 1.2.x release as we are soon doing release
  4062 candidates for 1.3 release (with big internal changes) and are expecting
  4063 release 1.3 in december 2004.
  4064 
  4065 Fixes:
  4066     * fixed "None" pagename bug in fullsearch/titlesearch
  4067     * fixed projection CSS usage
  4068     * the compiled page is removed when a page is deleted, so no ghost page
  4069       appears after deletion
  4070     * fixed AbandonedPages day-break problem
  4071     * fixed [[GetVal(WikiDict,key)]]
  4072     * the msg box is now outside content div on PageEditor, too
  4073     * privacy fix for email notifications: you don't see other email addresses
  4074       in To: any more. mail_from is now also used for To: header field, but
  4075       we don't really send email to that address.
  4076     * privacy fix for /MoinEditorBackup pages that were made on previews of
  4077       pages that were not saved in the end
  4078     * fix double content div on PageEditor preview
  4079 
  4080 Other changes:
  4081     * workaround for broken Microsoft Internet Explorer, the page editor now
  4082       stops expanding to the right (e.g. with rightsidebar theme).
  4083       Nevertheless it is a very good idea to use a non-broken and more secure
  4084       browser like Mozilla, Firefox or Opera!
  4085 
  4086     * from MoinMoin.security.antispam import SecurityPolicy in your
  4087       moin_config.py will protect your wiki from at least the known spammers.
  4088       See MoinMoin:AntiSpamGlobalSolution for details.
  4089 
  4090     * xmlrpc plugin for usage logging, currently used for antispam accesses
  4091 
  4092     * (re-)added configurable meta tags:
  4093         * html_head_queries = '''<meta name="robots" content="noindex,nofollow">\n'''
  4094         * html_head_posts   = '''<meta name="robots" content="noindex,nofollow">\n'''
  4095         * html_head_index   = '''<meta name="robots" content="index,follow">\n'''
  4096         * html_head_normal  = '''<meta name="robots" content="index,nofollow">\n'''
  4097 
  4098     * i18n updates/fixes
  4099 
  4100     * New UserPreferences switch:
  4101       you may subscribe to trivial changes (when you want to be notified about ALL
  4102       changes to pages, even if the author deselected to send notifications).
  4103 
  4104     * New AttachList and AttachInfo macros - thanks to Nigel Metheringham and
  4105       Jacob Cohen.
  4106 
  4107 Version 1.2.3 (2004-07-21, Revision 1.186)
  4108 
  4109 Fixes:
  4110     * fixed NameError "UnpicklingError" in user.py
  4111     * fixed version number in moin.spec
  4112     * reverts done by bots or leechers
  4113       There was a bad, old bug that triggered if you did not use ACLs. In that
  4114       case, moin used some simple (but wrong and incomplete) function to
  4115       determine what a user (or bot) may do or may not do. The function is now
  4116       fixed to allow only read and write to anon users, and only delete and
  4117       revert to known users additionally - and disallow everything else.
  4118     * avoid creation of unneccessary pages/* directories
  4119     * removed double content divs in general info and history info pages
  4120     * fixed wiki xmlrpc getPageHTML
  4121     * fixed rightsidebar logout URL, also fixed top banner to link to FrontPage
  4122     * use config.page_front_page and .page_title_index for robots meta tag
  4123       (whether it uses index,follow or index,nofollow), not hardcoded english
  4124       page names
  4125     * ACL security fix for PageEditor, thanks to Dr. Pleger for reporting
  4126     * default options for new users are same as for anon users
  4127 
  4128 Version 1.2.2 (2004-06-06, Revision 1.185)
  4129 
  4130 Fixes:
  4131     * python related:
  4132      * own copy of difflib removed
  4133        Until moin 1.2.1 we had our own copy of python 2.2.3's difflib coming
  4134        with moin. This was to work around some problems with broken older 2.2
  4135        python installations. We removed this now because if you have py 2.3,
  4136        there is even a better difflib coming with python (and that fixes an
  4137        extremely slow diff calculation happening in some rare cases).
  4138        So the good news is that when you run python 2.3, you don't need to do
  4139        anything and it will run great. If you run python 2.2.3, it will mostly
  4140        work good and you also don't need to do anything. The bad news is that
  4141        if you run an old and broken 2.2 installation (2.2.1, maybe 2.2.2) you
  4142        will have to fix it on your own (just copy difflib.py from python 2.2.3
  4143        over to your python 2.2.x installation).
  4144        But better upgrade to python 2.3 (for debian woody, there's a backport),
  4145        as 2.3 generally runs better and faster than 2.2.
  4146      * scripts changed to use #!/usr/bin/env python (not /usr/bin/python2.2)
  4147 
  4148     * user accounts and ACLs:
  4149      * we now require the user to specify a password for a new account (you
  4150        were not able to login without a password anyway)
  4151      * it is not allowed any more to create user accounts with user names
  4152        matching config.page_group_regex - please check manually that you do
  4153        not already have such users existing (like a user named "AdminGroup"):
  4154        cd data/user ; grep name=.*Group *  # there should be no output!
  4155      * subscription email sending now honours ACLs correctly
  4156 
  4157     * markup / rendering / user interface fixes:
  4158      * fixed merging multiple lines indented by the same amount of blanks
  4159      * ## comments don't break tables in two parts
  4160      * added a "remove bookmark" link to RecentChanges
  4161      * fixed action=titleindex (added \n after each entry)
  4162 
  4163     * RSS fixes:
  4164      * non-ASCII characters should work now
  4165      * RSS feed (Recentchanges?action=rss_rc) gives UTC timestamps now
  4166      * removed attribute breaking RSS feed on RecentChanges
  4167 
  4168     * better email generation:
  4169      * if you use python >=2.2.2, we add a Message-ID header to emails
  4170      * if you use python 2.2.1, there is no email.Header. Instead of crashing
  4171        (like previous moin 1.2.x releases), we just use the subject "as is" in
  4172        that case. If it is not ASCII, this is not standards compliant.
  4173      * If you have >=2.2.2 it will use email.Header to make standards compliant
  4174        subject lines.
  4175      * use config.mail_from as sender address when sending "lost my password"
  4176        emails
  4177 
  4178     * file attachments:
  4179      * fixed for standalone server
  4180      * attachment URLs (when handled by moin) don't include server name
  4181      * fixed some wrong &amp;amp; in html src
  4182     
  4183     * better themeability:
  4184      * some entries in dict "d" where only present in header theme calls, some
  4185        only in footer theme calls. Now almost all is present in both calls.
  4186      * added some missing "content" divs so sidebar themes look better
  4187 
  4188     * fixed some crashes producing backtraces:
  4189      * no IOError when diffing against deleted page
  4190      * no backtrace in xml footnote generation
  4191      * no SystemInfo crash when no editlog exists in new wikis
  4192      * xmlrpc.getRecentChanges fixed
  4193 
  4194     * MoinMoin.util.filesys.rename is now a wrapper around os.rename that
  4195       fixes os.rename on broken win32 api semantics
  4196 
  4197 Other Changes:
  4198     * saving traffic and load by improved robot meta tag generation:
  4199      * "noindex,nofollow" on queries and POSTs
  4200      * "index,follow" on FrontPage and TitleIndex (give robots a chance ;))
  4201      * "index,nofollow" on all other pages (hopefully saving lots of senseless
  4202        requests for page?action=...) 
  4203      * removed config.html_head_queries (was used for same stuff)
  4204     * added russian i18n (utf-8)
  4205     * misc. other translation updates / fixes
  4206     * added rightsidebar theme
  4207     * TitleIndex now folds case, so "APage" and "anotherPage" are both under
  4208       letter "A".
  4209     * added macro/PageHits.py - it calculates the hits each page gets since
  4210       beginning of logging
  4211 
  4212 
  4213     * Full text and title search do now support multiple search terms - 
  4214       see HelpOnSearching for details
  4215  
  4216     * The Formatter interface was changed. Formatter and parser using 
  4217       the formatter interface have to be adjusted.
  4218 
  4219 Version 1.2.1 (2004-03-08, Revision 1.184)
  4220 
  4221 Fixes:
  4222     * minimum requirement to run moin 1.2/1.2.1 is python 2.2.2
  4223      * not: 2.2(.0), as this does not have True/False
  4224      * not: 2.2.1, as this does not have email.Header. You maybe can work
  4225        around that one by:
  4226       * getting the python 2.2.x (x>=2) /usr/lib/python2.2/email directory
  4227       * putting it into directory 'x' (whereever you like)
  4228       * doing a sys.path[0:0] = ['x'] in moin.cgi [or other appropriate place]
  4229       No guarantee, this is untested.
  4230     * Twisted: the http headers missed the charset data, fixed
  4231     * mod_python: fixes for mod_python 2.7
  4232     * wiki/data/plugin/__init__.py added - fixes not working plugin modules
  4233     * plugin processors work now, too
  4234     * fixed displaying non-existent translations of SiteNavigation in footer
  4235     * fixed zh-tw iso name (wrong zh_tw -> correct zh-tw)
  4236     * fixed reversed diffs in RecentChanges RSS
  4237     * fixed "last change" info in footer (wasn't updated)
  4238     * fixed event.log missing pagename (and other) information
  4239     * fixed horizontal line thickness >1
  4240     * fixed setup.py running from CVS workdir
  4241     * fixed crash when doing action=info on first revision of a page
  4242     * fixed hostname truncation in footer
  4243     * minor css fixes
  4244     * fixed clear msg links (they missed quoting, leading to strange page
  4245       names when you click on some of them)
  4246     * fixed python colorizer processor
  4247     * fixed quoting of stats cache filenames
  4248     * catched "bad marshal data" error when switching python versions
  4249 
  4250 Other changes:
  4251     * updated danish (da) i18n
  4252     * updated japanese (ja) i18n
  4253     * added serbian (sr) i18n
  4254     * added chinese (zh) i18n
  4255     * added a simple "viewonly" theme based on classic theme - you can use
  4256       this as default theme, so anonymous users won't get the usual wiki stuff,
  4257       but a far simpler (and less powerful) user interface.
  4258       It also displays the navibar at the left side.
  4259     * added moin.spec for building RPMs
  4260     * included MoinMoin/i18n/* into distribution archive (nice for translators)
  4261     * included some stuff under MoinMoin/scripts - xmlrpc-tools and account
  4262       checking stuff. removed some version control clutter from the dist
  4263       archive, too.
  4264 
  4265     * code colorization was refactored and some new languages (Java, C++,
  4266       Pascal) where added.
  4267     * inline: display of attachments was extended. A Parser now knows which
  4268       extensions it can handle.
  4269 
  4270 Version 1.2 (2004-02-20, Revision 1.183)
  4271 
  4272 New features:
  4273     * MoinMoin now requires Python >=2.2.2., we recommend to use Python >=2.3.2
  4274       (with 2.3.x, MoinMoin runs about 20-30% faster).
  4275     * by refactoring request processing, we made it possible to run moin under
  4276       persistent environments:
  4277         * twisted-web (http://twistedmatrix.com)
  4278         * httpdmain.py (use moin.py for starting this mini server)
  4279         * mod_python
  4280         * FastCGI
  4281       Of course, CGI is still possible.
  4282     * wiki pages will be compiled to bytecode now (by default), so no need for
  4283       slow parsing/formatting on every view ("WASP", see caching_formats)
  4284     * when using a persistent environment (like twisted) and WASP, you get up
  4285       to 20x speed - compared to CGI and moin 1.1
  4286     * added support for diffs between arbitrary revisions.
  4287     * removed requirement of the external diff utility
  4288     * config.auth_http_enabled (defaults to 0) - use this to enable moin
  4289       getting your authenticated user name from apache (http basic auth,
  4290       htpasswd) - if you enable this, your basic auth username has to be the
  4291       same as your wiki username.
  4292       Should work with CGI, FCGI and maybe even with mod_python.
  4293       Does not change behaviour of moin under twisted or standalone server.
  4294     * config.tz_offset = 0.0 sets a default timezone offset (in hours
  4295       from UTC)
  4296     * config.cookie_lifetime (int, in hours, default 12) sets the lifetime of
  4297       the MOIN_ID cookie:
  4298         == 0  --> cookie will live forever (no matter what user has configured!)
  4299         > 0   --> cookie will live for n hours (or forever when "remember_me")
  4300         < 0   --> cookie will live for -n hours (forced, ignore "remember_me"!)
  4301     * added themeing and some themes (if you improve the existing themes or
  4302       make nice new ones, please contribute your stuff!). The default theme is
  4303       set by config.theme_default (and defaults to 'classic').
  4304     * now supporting plugin directory for parsers, processors, themes, xmlrpc.
  4305     * action=info now defaults to showing page revision history again
  4306     * all actions accessing the logfile (as RecentChanges or history) are now
  4307       much faster
  4308     * #refresh processing instruction, config.refresh
  4309         * config.refresh = (minimum_delay, target_allowed)
  4310             * minimum delay is the minimum waiting time (in seconds) allowed
  4311             * target_allowed is either 'internal' or 'external', depending on
  4312               whether you want to allow only internal redirects or also
  4313               external ones. For internal redirects, just use the Wiki pagename,
  4314               for external, use http://... url.
  4315         * #refresh 3                    == refresh this page every 3 seconds
  4316         * #refresh 5 FrontPage          == internal redirect to FrontPage in 5s
  4317         * #refresh 5 http://google.com/ == redirect to google in 5s
  4318       Use very carefully! Allowing a low minimum_delay and putting a #refresh
  4319       on RecentChanges might slow down your wiki significantly, when some
  4320       people just let their browser refresh and refresh again. Also, it does
  4321       cause quite some traffic long-term. So better do not use this without
  4322       good reason! Default is None (switched off).
  4323     * hide most UserPreferences options before user has logged in, less
  4324       confusing for new users
  4325     * "config.page_dict_regex" defines what pages are dictionary definitions
  4326       Currently dictionaries are used for UserHomePage/MyDict where you can
  4327       define key:: value pairs that get processed like @DATE@ expansion when
  4328       saving a page. The 2 "@" will be added to your keys automatically.
  4329       Please do not use @xxx@ strings on the right side (value), results may
  4330       vary if you do.
  4331       You can also access wiki dictionaries by using the internal macro
  4332       [[GetVal(page,key)]]" - that will go to page "page" and return the
  4333       value (right side) corresponding to "key".
  4334       Implementation note: groups are a subset of the dictionary functionality.
  4335     * standalone server should work now (see server/moin.py), so you don't
  4336       need to setup apache or twisted for a local personal wiki, you only need
  4337       python and moin for that now, no additional stuff any more!
  4338     * if you run your wiki with charset = "utf-8" (the default is still
  4339       iso8859-1), you might want to have a look at contributions/utf8-pages/
  4340       to see if there are already translated system pages for your language.
  4341 
  4342 Fixes:
  4343     * new importPlugin routine (the old one didn't work correctly)
  4344     * removed 0xA0 characters breaking utf-8
  4345     * system page recognition now uses wiki groups (see AllSystemPagesGroup),
  4346       fixing the long-time broken system page exclusion on TitleIndex.
  4347     * mostly HTML 4.01 Strict compliant HTML
  4348     * design is done by CSS now, HTML is semantic markup only 
  4349     * removed target attribute from links, also [^NewWindow] markup - this
  4350       is a HTML 3.2 feature and not valid in HTML 4.01
  4351     * updated TWikiDrawPlugin to 20021003 version, with further modifications
  4352       including source. It can draw imagemaps now and saves PNG. On display a
  4353       GIF will be searched if no PNG is found. We recommend changing all GIFs
  4354       to indexed PNGs cause this fallback might disappear in later versions.
  4355 
  4356       Sample code using bash and ImageMagick (be sure you know what you do):
  4357       for draw in `find /path/to/wiki/data -name \*.draw`; do
  4358         file=`dirname $draw`/`basename $draw .draw`
  4359         if [ -e "${file}.gif" ]; then
  4360           echo "Converting ${file}.gif to ${file}.png"
  4361           convert "${file}.gif" "${file}.png"
  4362         fi
  4363       done
  4364 
  4365     * fixed email headers and encoding
  4366     * Changed moin-usercheck to adhere to scripting standards; no
  4367       proprietary config changes needed any more (added --config);
  4368       --wikinames is now part of the usage message.
  4369     * config.umask now defaults to 0770 - if you give world r/w access, ACLs
  4370       could be rather pointless...
  4371 
  4372 Removed config variables:
  4373     * external_diff (not needed any more, we have internal diff now)
  4374     * shared_metadb (wasn't implemented for long - we will re-add it, when it is)
  4375     * title1/2 (please use page_header1/2)
  4376     * page_icons_up
  4377 
  4378 Changed config variables:
  4379     * changed_time_fmt (removed some html and brackets around time from default)
  4380     * html_head (default is empty string now)
  4381     * page_footer1/2 (default is empty string now)
  4382     * page_icons (is now a list of icon names, not html any more)
  4383     * umask (default is 0770 now, not world r/w any more == more secure)
  4384 
  4385 New config variables (see MoinMaster:HelpOnConfiguration):
  4386     * cookie_lifetime
  4387     * mail_login
  4388     * page_credits
  4389     * page_dict_regex
  4390     * page_group_regex
  4391     * page_header1/2
  4392     * page_iconbar 
  4393     * page_icons_table
  4394     * page_license_enabled
  4395     * page_license_page
  4396     * theme_default
  4397     * theme_force
  4398     * tz_offset 
  4399 
  4400 Other:
  4401     * lots of internal code refactoring and optimization
  4402     * began moving src code documentation to epydoc, see "make epydoc"
  4403     * the URL for the RecentChanges RSS feed changed. It now only works with
  4404       ...?action=rss_rc.
  4405 
  4406 Known problems:
  4407     * theme support is neither complete (although covering most important
  4408       stuff) nor perfect - work on that will continue...
  4409     * we removed some html from system messages (the boxes at top of page you
  4410       get after some actions), so it currently looks less nice than before.
  4411     * html is not completely validating and it is not xhtml - this will be
  4412       fixed as soon as we have the infrastructure for that (other parser, DOM)
  4413     * problems with rtl (right-to-left) languages, will be fixed in 1.3
  4414     * if you change moin_config or switch themes, moin will still use already
  4415       cached page content. For the config this can be fixed by touching
  4416       MoinMoin/version.py (or simply deleting everything in
  4417       data/cache/Page.py). If you get more annoyed by this than pleased by
  4418       caching speedup, you can also switch off caching (see docs on
  4419       caching_formats).
  4420 
  4421 Themeing and HTML/CSS cleanup:
  4422     * Browsers with completely broken CSS support (like e.g. Netscape 4.x) are
  4423       no longer supported. If you still need to support them, do not upgrade to
  4424       moin 1.2. If you still use these browsers, we recommend that you upgrade
  4425       your browser first (Mozilla 1.5 has nice and standards compliant HTML and
  4426       CSS support and is available as Free Software for Windows, Linux and Mac).
  4427     * If you changed any html in code or by config you will have to check if it
  4428       still works. For the usual stuff, look into `MoinMoin/theme/classic.py`
  4429       and `classic/css/screen.css`. For config defaults of the html fragments,
  4430       read `MoinMoin/config.py`. If you want to modify a theme, don't simply
  4431       change classic, but copy or subclass it under a new theme name.
  4432     * because of the new theme support the layout of the `htdocs` directory
  4433       changed:
  4434       * Instead of using icons under `img/` and css under `css/`, there will
  4435         be an additional `themename/` directory in between, e.g. `classic/img/`
  4436         and `classic/css/`. If you added own icons, you may have to copy them
  4437         to the themes directory.
  4438       * The filename of the CSS file has changed to the media type, so the
  4439         normal one used for screen output has changed name from `moinmoin.css`
  4440         to `screen.css`. There also were quite some changes and enhancements to
  4441         the CSS files, so better use the new ones.
  4442     * config.css_url was removed
  4443 
  4444 Plugins:
  4445   * we use a new plugin loader that requires a correct `__init__.py` file in
  4446     the plugin directories. See the directory `wiki/data/plugin/` in the
  4447     distribution archive and just copy it over to your wiki's plugin directory.
  4448 
  4449 
  4450 Version 1.1 (2003-11-29, Revision 1.178)
  4451 
  4452 Version 1.1 requires Python 2.0 or higher, we recommend to use Python 2.2
  4453 (version 2.2.2 if that is available on your host) or even better >= 2.3.2
  4454 (with 2.3.x, MoinMoin runs about 20-30% faster).
  4455 
  4456 New features:
  4457   Configuration:
  4458     * config.default_lang lets you set a default language for users not
  4459       having specified language in their browser or UserPreferences
  4460     * "config.page_category_regex" defines what pages are categories
  4461     * replaced `config.page_template_ending` by a more flexible setting
  4462       named `config.page_template_regex`
  4463     * the same with config.page_form_regex (was: page_form_ending)
  4464     * "config.page_group_regex" defines what pages are group definitions
  4465       Currently groups are used for "user groups" (see ACLs) and "page
  4466       groups" (see AllSystemPagesGroup).
  4467     * robot exclusion from all pages except the standard view action,
  4468       via the config.ua_spiders regex (reduces server load)
  4469     * "maxdepth" argument for the TableOfContents macro
  4470     * config.title1, config.title2, config.page_footer1,
  4471       config.page_footer2 can now be callables and will be called with
  4472       the "request" object as a single argument (note that you should
  4473       accept any keyword arguments in order to be compatible to future
  4474       changes)
  4475     * "config.html_pagetitle" allows you to set a specific HTML page
  4476       title (if not set, it defaults to "config.sitename")
  4477     * navi_bar / quicklinks can now contain free-form links, i.e.
  4478       entries of the form "[url linktext]" just like in wiki pages
  4479     * if a quick link starts with '^', it opens in a new window; help
  4480       now opens in a new window also
  4481     * `config.smileys` for user-defined smileys (default: `{}`) - a dict
  4482       with the markup as the key and a tuple of width, height, border, image
  4483       name as the value).
  4484     * `config.hosts_deny` to forbid access based on IP address
  4485     * `config.mail_login` can be set to username and password separated by
  4486       a space, e.g. "username userpass", if you need to use SMTP AUTH
  4487     * `config.edit_locking` can be set to None (old behaviour, no
  4488       locking), 'warn <timeout mins>' (warn about concurrent edits, but
  4489       do not enforce anything), or 'lock <timeout mins>' (strict locking)
  4490     * optionally showing a license text on editor page, use:
  4491       config.page_license_enabled = 1
  4492       Optionally use these to customize what is shown there:
  4493       config.page_license_text = "... your text ..."
  4494       config.page_license_page = "MyLicensePage"
  4495       See the default values in MoinMoin/config.py for details and
  4496       override them in moin_config.py, if needed.
  4497     * `config.shared_intermap` can be a list of filenames (instead of a
  4498       single string)
  4499     * If you have added your own `SecurityPolicy`, the class interface for
  4500       that has changed (see `security.py`).
  4501 
  4502   Authenticaton / Authorization:
  4503     * added ACL support, written by Gustavo Niemeyer of Conectiva and
  4504       Thomas Waldmann. See HelpOnAccessControlLists for more infos.
  4505       You should use MoinMoin/scripts/moin_usercheck.py before activating
  4506       ACLs or some users with bad or duplicate accounts might get into
  4507       trouble.
  4508     * A user account can be disabled using moin_usercheck.py or
  4509       UserPreferences page. Disabling, but keeping it is good for edit
  4510       history.
  4511     * changed security default: deletion only available to known users
  4512     * support for Basic authentication (Apache style: AUTH_TYPE="Basic",
  4513       REMOTE_USER="WikiUserName"). If authentication is there, user
  4514       will be in ACL class "Trusted".
  4515     * support for username / password login
  4516       The username / password login will ONLY work, if you define a
  4517       password. With an empty password, username / password login is not
  4518       allowed due to security reasons. Passwords are stored encrypted
  4519       (format similar to Apache SHA) and can also be entered in the
  4520       UserPreferences form in this format. When requesting login
  4521       information by email, the password is also sent in this encrypted
  4522       format (use copy&paste to fill it in the form).
  4523       ...?action=userform?uid=<userid> is still possible, so if you have
  4524       bookmarks, they will still work). The input field for the ID was
  4525       dropped.
  4526       NOTE: using the userid for login purposes is DEPRECATED and might
  4527             be removed for better security soon.
  4528     * after logging in, you will get a cookie valid until midnight.
  4529       The next day, the cookie will expire and you will have to login
  4530       again. If you don't want this, you can check the "remember me
  4531       forever" option in UserPreferences.
  4532     * if the page file is read-only, you get a message (i.e. you can now
  4533       protect pages against changes if you're the wiki admin).
  4534       Note: you can do that easier using ACLs.
  4535 
  4536   Markup / Macros / Actions:
  4537     * RandomQuote macro (and even parses Wiki markup now)
  4538     * `[[Navigation]]` macro for slides and subpage navigation
  4539     * [[ShowSmileys]] displays ALL smileys, including user-defined ones
  4540     * the Include macro has new parameters (from, to, sort, items) and
  4541       is able to include more than one page (via a regex pattern)
  4542     * `MailTo` macro for adding spam-safe email links to a page
  4543     * if a fancy link starts with '^' (i.e. if it has the form
  4544       "[^http:... ...]"), it's opened in a new window
  4545      * because of that, the NewWindow macro was removed from contrib
  4546     * "#pragma section-numbers 2" only displays section numbers for
  4547       headings of level 2 and up (similarly for 3 to 6)
  4548     * ../SubPageOfParent links
  4549 
  4550   User interface:
  4551     * new fancy diffs
  4552     * Page creation shows LikePages that already exist
  4553     * editor shows the current size of the page
  4554     * editor returns to including page when editing an included page
  4555     * Visual indication we're on the editor page (new CSS style)
  4556     * selection to add categories to a page in the editor (use preview
  4557       button to add more than one category)
  4558     * if user has a homepage, a backup of save/preview text is saved as
  4559       a subpage UsersHomePage/MoinEditorBackup
  4560     * added "revert" link to PageInfo view (which makes DeletePage more
  4561       safe in public wikis, since you can easily revive deleted pages
  4562       via revert)
  4563     * Selection for logged in users (i.e. no bots) to extend the listing
  4564       of recent changes beyond the default limits
  4565     * Activated display of context for backlinks search
  4566     * Subscriber list shown on page info
  4567     * LikePages shows similar pages (using difflib.get_close_matches)
  4568     * last edit action is stored into "last-edited" file, and
  4569       displayed in the page footer
  4570     * reciprocal footnote linking (definition refers back to reference)
  4571     * "Ex-/Include system pages" link for title index
  4572       Note: system/help pages algorithm is still mostly broken.
  4573     * list items set apart by empty lines are now also set apart
  4574       visually (by adding the CSS class "gap" to <li>)
  4575     * "save" check for security.Permissions
  4576     * Added Spanish, Croatian and Danish system texts
  4577     * Added flag icons for the languages supported in "i18n"
  4578     * updated help and system pages, more translations, see also
  4579       AllSystemPagesGroup
  4580     * there was quite some work done on wiki xmlrpc v1 and v2 - it
  4581       basically works now.
  4582 
  4583   Tools and other changes:
  4584     * moin-dump: New option "--page"
  4585     * there are some scripts MoinMoin/scripts/* using wiki xmlrpc for
  4586       backup and wiki page copying applications
  4587     * Updated the XSLT parser to work with 4Suite 1.0a1
  4588     * more infos in cgi tracebacks
  4589     * UPDATE.html is a HTML version of MoinMaster:HelpOnUpdating
  4590 
  4591 Unfinished or experimental features:
  4592     * user defined forms
  4593     * XML export of all data in the wiki
  4594     * RST parser (you need to install docutils to use this)
  4595     * SystemAdmin macro
  4596 
  4597 Privacy fixes:
  4598     * do not use / display user's email address in public places
  4599 
  4600 SECURITY FIXES:
  4601     * Removed two cross-site scripting vulnerabilities reported by "office"
  4602 
  4603 Bugfixes:
  4604     * Bugfix for PageList when no arguments are given
  4605     * Disallow full-text searches with too short search terms
  4606     * [ 566094 ] TitleIndex now supports grouping by Hangul Syllables
  4607      * fix for multibyte first char in TitleIndex
  4608     * Footnotes were not HTML escaped
  4609     * Numbered code displays are now in a table so that you can cut the
  4610       code w/o the numbers
  4611     * Bugfix for wrong mail notifications
  4612     * Create unique anchors for repeated titles
  4613     * [ 522246 ] Transparently recode localized messages
  4614     * [ 685003 ] Using "preview" button when editing can lose data
  4615     * use gmtime() for time handling
  4616     * fixed negative gmtime() arguments
  4617     * [[Include]] accepts relative page names
  4618     * fixed ||NotInterWiki:||...||
  4619 
  4620 -----------------------------------------------------------------------------
  4621 Version 1.0 (2002-05-10, Revision 1.159)
  4622 
  4623 THIS IS THE LAST RELEASE WITH PYTHON 1.5.2 SUPPORT! If severe bugs
  4624 should occur, a maintenance release will fix them.
  4625 
  4626 Some optional features (like statistics) already require Python 2.0.
  4627 
  4628 New features:
  4629     * security fix: "allow_xslt" has to be set to 1 in order to enable
  4630       XSLT processing; note that this defaults to 0 because XSLT is able
  4631       to insert arbitrary HTML into a wiki
  4632     * "action=content" for transclusion into static web pages; emits the
  4633       pure page content, without any <html>, <head>, or <body> tags
  4634     * "?action=links&mimetype=text/plain" works like MeatBall:LinkDatabase
  4635     * "Preferred language" and "Quick links" user settings
  4636     * Added "processor" concept, processors work on the data in "code
  4637       displays" and are called by a bangpath in the first line of data
  4638     * Processors: Colorize, CSV (see HelpOnProcessors)
  4639     * New icons: "{OK}", "(./)", "{X}", "{i}", "{1}", "{2}" and "{}"
  4640       (see HelpOnSmileys)
  4641     * FullSearch now displays context information for search hits
  4642     * DeletePage offers a textentry field for an optional comment
  4643     * Email notifications are sent in the user's language, if known from
  4644       the preferences
  4645     * @PAGE@ is substituted by the name of the current page (useful
  4646       for template pages)
  4647 
  4648 Unfinished features:
  4649     * user defined forms
  4650     * XML export of all data in the wiki
  4651     * RST parser (you need to install docutils to use this)
  4652     * XMLRPC interface
  4653 
  4654 Bugfixes:
  4655     * Syntax warning with Python 2.2 fixed
  4656     * Macro-generated pagelinks are no longer added to the list of links
  4657     * error codes returned by "diff" are reported
  4658     * fix for attachments on pages with non-USASCII names
  4659     * correct handling of spaces in attachment filenames and URLs
  4660 
  4661 -----------------------------------------------------------------------------
  4662 Version 0.11 (2002-03-11, Revision 1.151)
  4663 
  4664 Most important new features: file attachments, definition list markup
  4665 (glossaries), change notification via email, variable substitution when
  4666 saving pages, edit preview, and improved documentation.
  4667 
  4668 Note that the RSS features require a recent PyXML (CVS or 0.7) due to
  4669 bugs in the namespace handling of xml.sax.saxutils in earlier versions.
  4670 This is (hopefully) automatically detected on every installation.
  4671 
  4672 Statistical features are NOT designed to work with Python 1.5.2 and
  4673 require Python 2.0 or higher. Overall, MoinMoin 0.11 is not explicitely
  4674 tested for 1.5.2 compatibility.
  4675 
  4676 New features:
  4677     * XML formatting now (most often) produces well-formed, and, depending
  4678       on proper layout of the wiki page, valid StyleBook XML
  4679     * Headers are now automatically numbered, unless you set the config
  4680       item 'show_section_numbers' to 0
  4681     * "#pragma section-numbers off" (or "0") switches that off explicitely,
  4682       and "on" or "1" enables numbering 
  4683     * Added a "contributions" directory for 3rd party extensions
  4684     * AttachFile action, contributed by Ken Sugino; note that you have
  4685       to enable this action because of the possibility of DoS attacks
  4686       (malicious uploads), by adding this to your moin_config:
  4687             allowed_actions = ['AttachFile']
  4688     * "attachment:" URL scheme allows access to attachments, to get files
  4689        from other pages use "attachment:WikiName/filename.ext".
  4690     * New macros: Date(unixtimestamp) and DateTime(unixtimestamp) to
  4691       display a timestamp according to system/user settings
  4692     * Variable substitution when a page is saved, note that saving
  4693       template pages does NOT expand variables. Supported are:
  4694         @DATE@      Current date in the system's format
  4695         @TIME@      Current date and time in the user's format
  4696         @USERNAME@  Just the user's name (or his domain/IP)
  4697         @USER@      Signature "-- loginname"
  4698         @SIG@       Dated Signature "-- loginname date time"
  4699         @MAILTO@    A fancy mailto: link with the user's data  
  4700     * Copied some new emoticons from PikiePikie
  4701         || {{{ :-? }}} || :-? || tongue.gif ||
  4702         || {{{ :\  }}} || :\  || ohwell.gif ||
  4703         || {{{ >:> }}} || >:> || devil.gif  ||
  4704         || {{{ %)  }}} || %)  || eyes.gif   ||
  4705         || {{{ @)  }}} || @)  || eek.gif    ||
  4706         || {{{ |)  }}} || |)  || tired.gif  ||
  4707         || {{{ ;)) }}} || ;)) || lol.gif    ||
  4708     * AbandonedPages macro
  4709     * Added definition list markup: {{{<whitespace>term:: definition}}}
  4710     * Added email notification features contributed by Daniel Sa�    * SystemInfo: show "Entries in edit log"
  4711     * Added "RSS" icon to RecentChanges macro and code to generate a
  4712       RecentChanges RSS channel, see
  4713           http://www.usemod.com/cgi-bin/mb.pl?UnifiedRecentChanges
  4714       for details
  4715     * Added config.sitename and config.interwikiname parameter
  4716     * Better WikiFarm support:
  4717       * <datadir>/plugin/macro and <datadir>/plugin/action can be used
  4718         to store macros and actions local to a specific wiki instance
  4719       * config.shared_intermap can contain a pathname to a shared
  4720         "intermap.txt" file (i.e. one stored outside the datadir)
  4721     * added `backtick` shortcut for {{{inline literal}}} (has to be
  4722       enabled by "backtick_meta=1" in the config file); note that ``
  4723       is then a shorter replacement for '''''' escaping
  4724     * added inline search fields (at the bottom of each page)
  4725     * Added preview to the editor, including spell checking
  4726     * New languages: Chinese (Changzhe Han) and Portuguese (Jorge
  4727       Godoy), updated French (Lucas Bruand), added Korean (Hye-Shik
  4728       Chang) and Italian (Lele Gaifax)
  4729     * New SystemAdmin macro
  4730     * `[[Anchor(anchorname)]]` macro to insert anchors into a page,
  4731       and [#anchorname Anchor Links].
  4732     * User option to open editor view via a double-click
  4733     * Added commentary field to editor, recent changes and page info
  4734     * Page trails (user option)
  4735     * UserPreferences: checkboxes for double-click edit, page trail,
  4736       fancy links, emoticons, jump to last page visited, and some
  4737       other yes/no options
  4738     * "config.nonexist_qm" is now the default for a user setting
  4739     * `[[GetText(text)]]` macro loads I18N texts (mainly intended
  4740       for use on Help pages)
  4741     * table attributes via "||<attrlist> ... ||", more details on
  4742       http://purl.net/wiki/moin/HelpOnTables
  4743     * PythonFaq interwiki tag and support for $PAGE placeholder
  4744     * event logging, as the basis for future statistics
  4745     * "moin-dump" command line tool to create a static copy of
  4746       the wiki content
  4747     * "config.external_diff" allows to set an exact path to the
  4748       command, or change the name to for example "gdiff" if GNU
  4749       diff is not a native command in your UNIX flavour
  4750     * `[[PageSize]]` macro
  4751     * the interwiki name "Self" now always points to the own wiki
  4752     * config.title1 and config.title2 are inserted into the output
  4753       right before and after the system title html code (title1
  4754       is right after the <body> tag and normally undefined, title2
  4755       defaults to the "<hr>" above the page contents)
  4756     * Additional link on diff pages to ignore whitespace changes
  4757     * Subpages (config.allow_subpages, config.page_icons_up)
  4758     * super^script^, sub,,script,, and __underline__ markup
  4759     * `[[FootNote]]` macro
  4760     * many other new config options, see HelpOnConfiguration for
  4761       a complete list
  4762     * [[StatsChart(type)]] shows statistical charts (currently
  4763       defined types: hitcounts, pagesize, useragents)
  4764     * 'inline:' scheme works like 'attachment:', but tries to
  4765       inline the content of the attachment into the page;
  4766       currently knows about "*.py" sources and colorizes them
  4767     * support for Java applet "TWikiDrawPlugin" via
  4768       drawing:<drawingname> URL scheme (you need to activate
  4769       the AttachFile action if you want drawings)
  4770     * numeric entities (&#nnnnn;) are now optionally NOT escaped,
  4771       which allows you to insert more characters into a Latin-1
  4772       page, especially the Euro symbol
  4773     * navi_bar is now a list of page names which should be linked
  4774       on every page
  4775     * test.cgi is now rolled into moin.cgi, and can be called
  4776       by adding "?test" to the wiki base URL. Also, as a security
  4777       feature, the server's environment is only shown for requests
  4778       local to the web server.
  4779 
  4780 Unfinished features:
  4781     * user defined forms
  4782     * XML export of all data in the wiki
  4783 
  4784 Documentation:
  4785     * extended the online help ("Help*" pages)
  4786     * German help pages (thanks to Thomas Waldmann)
  4787 
  4788 Bugfixes:
  4789     * #425857: python Parser bug on the second call
  4790     * #424917: Caching control
  4791     * #465499: Two HTTPS problems
  4792     * #491155: FrontPage hardcoded
  4793     * Handling of inbound UTF-8 encoded URIs (only with Python >= 2.0)
  4794     * Fix for subtle changes in "re" of Python 2.2
  4795     * User-provided URLs are now never URL-escaped, which allows appending
  4796       #anchors and using %20 for spaces in InterWiki links
  4797 
  4798 -----------------------------------------------------------------------------
  4799 Version 0.10 (2001-10-28, Revision 1.134)
  4800 
  4801 This version is still Python 1.5.2 compatible, but it's not extensively
  4802 tested for that version and some parts of the system might not work
  4803 there, especially seldom used macros and actions. Bug reports welcome!
  4804 
  4805 New features:
  4806     * "#deprecated" processing instruction
  4807     * config entry "SecurityPolicy" to allow for customized permissions
  4808       (see "security.py" for more)
  4809     * added distutils support
  4810     * though not extensively tested, the standalone server now does POST
  4811       requests, i.e. you can save pages; there are still problems with
  4812       persistent global variables! It only works for Python >= 2.0.
  4813     * "bang_meta" config variable and "!NotWikiWord" markup
  4814     * "url_mappings" config variable to dynamically change URL prefixes
  4815       (especially useful in intranets, when whole trees of externally
  4816       hosted documents move around)
  4817     * setting "mail_smarthost" and "mail_from" activates mailing
  4818       features (sending login data on the UserPreferences page)
  4819     * very useful for intranet developer wikis, a means to view pydoc
  4820       documentation, formatted via a XSLT stylesheet, for details see
  4821       http://purl.net/wiki/python/TeudViewer?module=MoinMoin.macro.TeudView
  4822       or MoinMoin/macro/TeudView.py
  4823     * "LocalSiteMap" action by Steve Howell <showell@zipcon.com>
  4824     * Added FOLDOC to intermap.txt
  4825 
  4826 Bugfixes:
  4827     * Full config defaults, import MoinMoin now works w/o moin_config.py
  4828     * Better control over permissions with config.umask
  4829     * Bugfix for a UNIX time billenium bug (affecting RecentChanges
  4830       sorting and page diffs)
  4831     * data paths with directory names containing dots caused problems
  4832 
  4833 -----------------------------------------------------------------------------
  4834 Version 0.9 (2001-05-07)
  4835 
  4836 New features:
  4837     * XML page input (pages that start with "<?xml") and XSLT formatting
  4838     * Page caching, for now limited to XSLT processing (where it's
  4839       absolutely needed); new code & API to add the "RefreshCache" link
  4840     * Selection of common date/time formats in UserPreferences
  4841     * New action "titleindex" to support wiki introspection (MetaWiki);
  4842       see the new links below the index bar in "TitleIndex"
  4843     * UserPreferences: editable CSS URL for personal styles
  4844     * PageInfo: the editor's name or IP is shown for each change
  4845     * WantedPages: a new macro that lists links to non-existent pages
  4846     * OrphanedPages: a new macro that lists pages no other page links to
  4847     * Extensions to the FullSearch macro (see HelpOnMacros)
  4848     * Python syntax highlighting
  4849     * "DeletePage" action (has to be activated, see MoinMoinFaq)
  4850     * "Remove trailing whitespace from each line" option in the editor
  4851     * I18N (currently German and Swedish)
  4852     * Config option "url_schemas" to extend the supported URL types
  4853     * Improved tracebacks by using Ka-Ping's "cgitb"
  4854 
  4855 Bugfixes:
  4856     * The editor now sends a "no-cache" HTTP header
  4857     * "PageList" results are now sorted
  4858     * New config parameter "html_head_queries": send additional header
  4859       for all pages EXCEPT the "normal" view; main usage is to have
  4860       only the normal pages indexed by a spider, not the edit, print,
  4861       etc. views (which cause multiple hits on the same information)
  4862     * Store the modification time of the page file in the editlog, not
  4863       the current time when the log entry is created
  4864 
  4865 -----------------------------------------------------------------------------
  4866 Version 0.8 (2001-01-23)
  4867 
  4868 New features:
  4869     * Page templates (create a new page using a template page, by Richard)
  4870     * Pluggable actions (by Richard)
  4871     * Added "diff since bookmark"
  4872     * Only "normal" URLs (outside of brackets) are converted to inline images
  4873     * Show number of backups in SystemInfo macro
  4874     * Show info on installed extension macros and actions
  4875     * New macro: [[BR]] for line breaks
  4876     * New action "LikePages" (again, Richard)
  4877     * Highlighting of search results, and of bad words when spellchecking
  4878     * Support for "file:" URLS
  4879     * "SpellCheck" action (Richard, me, and Christian)
  4880     * [[Include]] macro (you guessed it, Richard)
  4881 
  4882 Bugfixes:
  4883     * Update bookmark with load time, not click time
  4884     * Changed CSS styles to better suit Netscape's broken handling of CSS
  4885 
  4886 -----------------------------------------------------------------------------
  4887 Version 0.7 (2000-12-06)
  4888 
  4889 New features:
  4890     * RecentChanges bookmarking
  4891 
  4892 Bugfixes:
  4893     * SECURITY FIX
  4894     * Non-greedy extended WikiNames
  4895 
  4896 -----------------------------------------------------------------------------
  4897 Version 0.6 (2000-12-04)
  4898 
  4899 New features:
  4900     * [[UserPreferences]] macro and associated functions
  4901     * [[TableOfContents]] macro
  4902     * Mechanism for external macros (user extensions)
  4903     * Numbered list types and start offsets
  4904 
  4905 Bugfixes:
  4906     * Search dialogs did not work on the FrontPage
  4907     * Add newline to text if last line has none (better diffs)
  4908 
  4909 -----------------------------------------------------------------------------
  4910 Version 0.5 (2000-11-17)
  4911 
  4912 New features:
  4913     * Major refactoring: code is now broken up into modules within the
  4914       "MoinMoin" package
  4915     * Diagnosis of installation via a "test.cgi" script
  4916     * Smileys
  4917     * "#format" processing instruction
  4918     * "##comment"
  4919     * [[RandomPage]] and [[RandomPage(number)]] macro
  4920     * configurable footer ("page_footer1" and "page_footer2")
  4921     * "#redirect" processing instruction
  4922 
  4923 Bugfixes:
  4924     * Bugfix for broken CGI environment of IIS/4.0
  4925     * URLs and InterWiki links are now less greedy (punctuation at the end
  4926       is excluded, and "<" ends them, too)
  4927 
  4928 -----------------------------------------------------------------------------
  4929 Version 0.4 (2000-11-01)
  4930 
  4931 New features:
  4932     * Table markup "||a||b||c||"
  4933     * Headlines "= H1 =", "== H2 ==", and so on up to H5
  4934     * [[PageCount]] macro
  4935     * Added [[Icon(image)]] macro and macro arguments
  4936     * [[PageList(title-regex)]] macro
  4937     * New help system (set of help pages describing all features)
  4938 
  4939 Bugfixes:
  4940     * Create complete URL for "Clear message" link
  4941     * Inline code spans needed cgi.escape
  4942     * Better fix for Python 1.6 "re" problems
  4943     * Fix for uppercase extensions in inline images ("foo.JPG")
  4944     * Fixed colspan in RecentChanges
  4945     * HR size is now limited to 8
  4946     * "}" ends an URL pattern (fixes URLs right at the end of code displays)
  4947 
  4948 -----------------------------------------------------------------------------
  4949 Version 0.3 (2000-10-25)
  4950 
  4951 New features:
  4952     * Check for inline images with InterWiki links (Spam:eggs.gif)
  4953     * New config variable "allow_extended_names", which enables markup for
  4954       wiki names containing ANY character like this: ["any chars"] 
  4955     * New config variable "html_head"
  4956     * New macro [[SystemInfo]]
  4957     * Added inline code ("{{{" and "}}}" on the same line)
  4958     * Support for new config variable "max_macro_size"
  4959 
  4960 Bugfixes:
  4961     * Don't treat sequences with a double colon (CPP::Namespace) as an
  4962       InterWiki link
  4963     * The local part of InterWiki links is now correctly URL-escaped
  4964     * Quickfix for a bug in 1.6's regular expressions
  4965     * Fixed "SpamSpamSpam" bug (multiple entries in word list)
  4966     * Anchor names get quoted in WordIndex and TitleIndex
  4967     * Filtering of filenames in page_list() corrected
  4968     * Escape &, <, > when sending the editor
  4969     * Final(?) fix for japanese wiki names
  4970 
  4971 -----------------------------------------------------------------------------
  4972 Version 0.2 (2000-08-26)
  4973 
  4974 New features:
  4975     * When saving, a datestamp saved in the form and that of the file are
  4976       compared now; so, accidently saving over changes of other people is
  4977       not possible anymore (saving still needs file locking though, for
  4978       race conditions)
  4979     * if the directory "backup" exists in the data dir, pages are saved
  4980       there before a new version is written to disk
  4981     * Removed the "Reset" button from EditPage
  4982     * Added "Reduce editor size" link
  4983     * Added Latin-1 WikiNames (JürgenHermann ;)
  4984     * Speeded up RecentChanges by looking up hostnames ONCE while saving
  4985     * Show at most 14 (distinct) days in RecentChanges
  4986     * Added icons for common functions, at the top of the page
  4987     * Added a printing preview (no icons, etc.)
  4988     * Added bracketed (external) URLs
  4989     * Added support for quoted URLs ("http://...")
  4990     * Added styles for :visited links to CSS
  4991     * Embed image if an URL ends in .gif/.jpg/.png
  4992     * No markup detection in code sections
  4993     * Grey background for code sections
  4994     * Added handling for numbered lists
  4995     * the edit textarea now grows in width with the browser window
  4996       (thanks to Sebastian Dau�for that idea)
  4997     * Added page info (revision history) and viewing of old revisions
  4998     * Added page diff, and diff links on page info
  4999     * Added InterWiki support (use "wiki:WikiServer/theirlocalname"; the list
  5000       of WikiServers is read from "data/intermap.txt")
  5001     * Added "normal" InterWiki links
  5002     * Added "action=raw" to send the raw wiki markup as text/plain (e.g. for
  5003       backup purposes via wget) 
  5004 
  5005 Bugfixes:
  5006     * Removed an exception when saving empty pages
  5007     * Fixed bold nested into emphasis ('''''Bold''' Italic'')
  5008 
  5009 -----------------------------------------------------------------------------
  5010 Version 0.1 (2000-07-29)
  5011 
  5012 Improvements over PikiPiki 1.62:
  5013     * Moved configuration to "moin_config.py"
  5014     * Added "edit_rows" setting
  5015     * Added navigation bar
  5016     * Improved HTML formatting
  5017     * Added timing comment (page created in xx secs)
  5018     * ISO date and time formats by default
  5019     * Formatted RecentChanges with HTML tables
  5020     * Uppercase letters for the index pages
  5021     * Added PythonPowered logo
  5022 
  5023 Bugfixes:
  5024     * Javadoc comments now get formatted properly in {{{ }}} sections
  5025     * Remove \r from submitted pages (so we get PORTABLE wiki files)
  5026     * chmod(0666) eases manual changes to the data dir
  5027 
  5028 -----------------------------------------------------------------------------