add news item for ikiwiki 2.40

3 files changed, 77 insertions, 91 deletions

diff --git a/doc/news/version_2.20.mdwn b/doc/news/version_2.20.mdwn
deleted file mode 100644
index b36ef4b8b..000000000
--- a/doc/news/version_2.20.mdwn
+++ /dev/null
@@ -1,31 +0,0 @@
-News for ikiwiki 2.20:
-
-   The template plugin has begun to htmlize the variables passed to templates.
-   This is normally what you want, but to get the old behavior and get at the
-   raw value, you can use `<TMPL_VAR raw_variable>` in a template.
-
-ikiwiki 2.20 released with [[toggle text="these changes"]]
-[[toggleable text="""
-   * inline: Add copyright/license info on a per-post basis to atom
-     feeds if available. (rss doesn't allow such info on a per-post basis)
-   * Also include overall copyright/license and author info in atom feeds if
-     available.
-   * meta: Allow copyright/license metadata to contain arbitrary markup.
-   * Call preprocessor hooks in void context during the scan pass. This allows
-     the hook to determine if it's just scanning, and avoid expensive
-     operations.
-   * img: Detect scan mode and avoid generating and writing the image file
-     during it, for a 2x speedup.
-   * meta: Run in scan mode again (more intelligently) and re-add support for
-     meta link.
-   * Fix support for the case where metadata appears after an inline directive
-     that needs to use it. This was broken in version 2.16.
-   * template: Remove bogus htmlize pass added in 2.16.
-   * template: Htmlize template variables, but also provide a raw version
-     via `<TMPL_VAR raw_variable>`.
-   * When htmlizing text, if the input is a single line with no newline,
-     and the htmlizer (such as markdown and textile) generates a html
-     paragraph, remove it. This allows removing several hacks from other
-     plugins that htmlize fragements of pages.
-   * In preferences, allow the subscriptions and email fields to be cleared.
-   * teximg: Fix to support the same formula on multiple pages."""]]
diff --git a/doc/news/version_2.30.mdwn b/doc/news/version_2.30.mdwn
deleted file mode 100644
index 315a214d6..000000000
--- a/doc/news/version_2.30.mdwn
+++ /dev/null
@@ -1,60 +0,0 @@
-News for ikiwiki 2.30:
-
-   Ever feel that ikiwiki's handling of RecentChanges wasn't truely in the
-   spirit of a wiki compiler? Well, that's changed. The RecentChanges page is
-   now a static page, not a CGI. Users can subscribe to its rss/atom feeds.
-   Custom RecentChanges pages can be easily set up that display only changes
-   to a subset of pages, or only changes by a subset of users.
-   
-   All wikis need to be rebuilt on upgrade to this version. If you listed your
-   wiki in /etc/ikiwiki/wikilist this will be done automatically when the
-   Debian package is upgraded. Or use ikiwiki-mass-rebuild to force a rebuild.
-
-   With this excellent new RecentChanges support, the mail notification system
-   is showing its age (and known to be variously buggy and underimplemented for
-   various VCSes), and so ikiwiki's support for sending commit mails is REMOVED
-   from this version. If you were subscribed to commit mails, you should be
-   able to accomplish the same thing by subscribing to a RecentChanges feed.
-
-   The "svnrepo" and "notify" fields in setup files are no longer used, and
-   silently ignored. You may want to remove them from your setup file.
-
-ikiwiki 2.30 released with [[toggle text="these changes"]]
-[[toggleable text="""
- * [ Joey Hess ]
-   * Old versions of git-init don't support --git-dir or GIT\_DIR with
-     --bare. Change ikiwiki-makerepo to use a method that should work with
-     those older versions too.
-   * aggregate: Don't let feeds set creation times for pages in the future.
-   * Add full parser for git diff-tree output (Brian Downing)
-   * aggregate: Fork a child process to handle the aggregation. This simplifies
-     the code, since that process can change internal state as needed, and
-     it will automatically be cleaned up for the parent process, which proceeds
-     to render the changes.
- * [ Josh Triplett ]
-   * Add trailing comma to commented-out umask in sample ikiwiki.setup, so
-     that uncommenting it does not break the setup file.
- * [ Joey Hess ]
-   * inline: The template can check for FIRST and LAST, which will be
-     set for the first and last inlined page. Useful for templates that build
-     tables and the like.
-   * prettydate,ddate: Don't ignore time formats passed to displaytime
-     function.
-   * Pages with extensions starting with "\_" are internal-use, and will
-     not be rendered or web-edited, or matched by normal pagespecs.
-   * Add "internal()" pagespec that matches internal-use pages.
-   * RecentChanges is now a static html page, that's updated whenever a commit
-     is made to the wiki. It's built as a blog using inline, so it can have
-     an rss feed that users can subscribe to.
-   * Removed support for sending commit notification mails. Along with it went
-     the svnrepo and notify settings, though both will be ignored if left in
-     setup files. Also gone with it is the "user()" pagespec.
-   * Add refresh hook.
-   * meta: Add pagespec functions to match against title, author, authorurl,
-     license, and copyright. This can be used to create custom RecentChanges.
-   * meta: To support the pagespec functions, metadata about pages has to be
-     retained as pagestate.
-   * Fix encoding bug when pagestate values contained spaces.
-   * Add support for bzr, written by Jelmer Vernooij. Thanks also to bma for
-     his independent work on bzr support.
-   * Copyright file updates."""]]
diff --git a/doc/news/version_2.40.mdwn b/doc/news/version_2.40.mdwn
new file mode 100644
index 000000000..09acb369b
--- /dev/null
+++ b/doc/news/version_2.40.mdwn
@@ -0,0 +1,77 @@
+News for ikiwiki 2.40:
+
+   ikiwiki now has an new syntax for preprocessor directives, using the
+   prefix '!':
+ * [[!directive ...]]
+   This new syntax no longer relies on spaces to distinguish between
+   wikilinks and preprocessor directives.  Thus, wikilinks can use spaces
+   in their link text, and preprocessor directives without arguments (such
+   as "toc") need not use a trailing space.
+   To enable the new syntax, set prefix\_directives to true in your ikiwiki
+   config.  For backward compatibility with existing wikis,
+   prefix\_directives currently defaults to false.  In ikiwiki 3.0,
+   prefix\_directives will default to true, and wikis which have not yet
+   converted to the new syntax will need to set prefix\_directives to false
+   in their setup files.
+   To convert your wiki to the new syntax, ikiwiki provides a new script
+   ikiwiki-transition.  It will convert preprocessor directives in
+   all files given on the command line.  To convert an entire wiki:
+   find wikidir/ -type f -name '*.mdwn' -print0 | xargs -0 ikiwiki-transition prefix\_directives
+   Even with prefix\_directives disabled, ikiwiki now allows an optional '!'
+   prefix on preprocessor directives (but still requires a space).  Thus, a
+   directive which uses a '!' prefix and contains a space will work with
+   ikiwiki 2.40 and newer, regardless of the value of prefix\_directives.
+   This allows the underlay to work with all ikiwikis.
+
+ikiwiki 2.40 released with [[toggle text="these changes"]]
+[[toggleable text="""
+ * [ Josh Triplett ]
+   * Add new preprocessor directive syntax¸ using a '!' prefix.  Add a
+     prefix\_directives option to the setup file to turn this syntax on;
+     currently defaults to false, for backward compatibility.  Support
+     optional '!' prefix even with prefix\_directives off, and use that in
+     the underlay to support either setting of prefix\_directives.  Add NEWS
+     entry with migration information.
+ * [ Joey Hess ]
+   * Danish translation update from Jonas Smedegaard. Closes: #[465152](http://bugs.debian.org/465152)
+   * Generate XML RPC messages with the encoding set to utf-8 instead
+     of XML::RPC's default of us-ascii. Allows interoperation with
+     python's xmlrpc library, which threw invalid encoding exceptions and
+     caused the rst plugin to hang.
+   * Add the linkify and scan hooks. These hooks can be used to implement
+     custom, first-class types of wikilinks.
+   * Move standard wikilink implementation to a new link plugin, which
+     will of course be enabled by default.
+   * camelcase: Convert to use new linkify and scan hooks rather than the old
+     hack.
+   * Setting NOTAINT=1 had no effect when building ikiwiki itself, fix this.
+   * Depend on HTML::Scrubber, since the scrubber is enabled by default and
+     dies if its can't be loaded.
+   * The search plugin needs to override &lt;base&gt; to point to the directory
+     containing ikiwiki.cgi, but this should not change the urls to the style
+     sheets etc. Add a new forcebareurl parameter to misctemplate to allow
+     it to do that.
+   * Preview limits the page dropdown to what's selected previously
+     (as preserving the full list across preview would be tricky). Userdirs
+     were still being offered as an option there, remove them.
+   * Fix a bug where user A created a page concurrently with user B, and
+     when B previewed it would redirect B to A's new page, losing B's work.
+     Instead, don't redirect and let conflict handling resolve it.
+   * monotone: Add code to default mergerc file to run
+     \_MTN/ikiwiki-netsync-hook when a commit is merged in from the net.
+   * tla: Remove call to escapeHTML when constructing recentchanges message;
+     the html is escaped at a different level. Closes: #[466495](http://bugs.debian.org/466495)
+   * bzr, mercurial: Remove unused import of escapeHTML.
+   * Fix another preview will\_render bug. This one involved inline,
+     which forced a scan of the page to make available metadata that
+     appeared after the inline directive. Problem is that scan made it forget
+     about any other files rendered due to the page. The scan also turns out
+     to be unnecessary now, since meta persistently stores state and it's
+     always available. So it was just removed.
+   * Disable taint checking for all builds as people keep complaining about it,
+     and since all versions of perl seem to be hopelessly broken.
+   * Fix links generated by preprocessor directives when previewing.
+   * inline: When forcing urls absolute for rss feeds, skip mailto and other
+     such urls.
+   * ikiwiki-makerepo: Don't fail if the third argument ends in a slash.
+   * Allow colons in URLs after the first slash. (Adeodato Simó)"""]]
\ No newline at end of file