New in JSPWiki 2.11.0.M1 - yet to be released#

Apache JSPWiki 2.11.0.M1 is the first release towards 2.11.0.

This release features, among other things:

• Haddock as new default template
  • if you need to revert to the 2.10 default template, you should set the jspwiki.templateDir property to 210 on your jspwiki[-custom].properties file
  • added the following pages to the core pages' bundles, as they enable some more haddock functionality
    • CSSBackgroundGradients: see Background Gradients
    • CSSBackgroundPatterns: see Background Patterns
    • CSSInstagramFilters: see Instagram Filters
    • CSSPrettifyThemeTomorrowNightBlue: see Prettify Theme Tomorrow Night Blue
    • CSSPrettifyThemeTomorrowPrism: see Prettify Theme Prism
    • CSSRibbon: see Ribbon
    • CSSStripedText: see Striped Text
    • CSSThemeCleanBlue: see Clean Blue Theme
    • CSSThemeDark: see Dark Theme
• Fix for JSPWIKI-932: Failed to start managers. java.util.ConcurrentModificationException
• Third-party plugin jars are loaded as much as possible, instead of the all-or-nothing approach on 2.10
• New requirements
  • Java 8 needed to run JSPWiki
  • Servlet 3.1 / JSP 2.3 compliant JEE server
• Dev only:
  • New JSPWiki jar maven coordinates: org.apache.jspwiki:jspwiki-main
  • At least JDK 8 and Maven 3.5.0 needed to build JSPWiki
  • JUnit 5 is now used for testing
  • Backwards API incompatible changes: https://jspwiki.apache.org/japicmp/2.11.0.M1/

What does that M# mean anyway?#

JSPWiki follows a semantic version identifier naming convention. A minor release upgrade from (say) 2.10.0 to 2.10.3 ought to be be transparent. However, a major release upgrade from (say) 2.10.3 to 2.11.0 is very likely to break compatibility with the earlier release. This might be something like requiring a higher release of java to compile or execute the code. You should always refer to the appropriate "NewIn" page in this wiki to familiarise yourself with the change as part of planning for an upgrade to a new major release.

That said, while a new major release is under development, it might prove appropriate to break compatibility in some way without releasing a new major version. In such a case, this new milestone (intermediate) release will be given an M# identification such as 2.10.0.M1.

M# releases are as production-ready as any other JSPWiki release, so the label does not mean the release is incomplete, or only for the brave, or in beta, or something along those lines. Often an M# release will change an internal API, which will affect associated code such as plugins, or it might alter some configuration parameters. You should check the "NewIn" page before upgrading to an M# release, but not be concerned about its stability.