ReleaseNotes

 
     JSPWiki - a JSP-based WikiWiki clone.
 
     Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file
     distributed with this work for additional information
     regarding copyright ownership.  The ASF licenses this file
     to you under the Apache License, Version 2.0 (the
     "License"); you may not use this file except in compliance
     with the License.  You may obtain a copy of the License at

        http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing,
     software distributed under the License is distributed on an
     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
     KIND, either express or implied.  See the License for the
     specific language governing permissions and limitations
     under the License.  

----------------------------------------------------------------------------

Welcome to the testing version of JSPWiki 3.0!

This is the first version of JSPWiki which is released completely under
the Apache License.  This is done as a part of the transition to the
Apache Incubation.

Please report any issues you can find at http://issues.apache.org/JIRA/


NEW FEATURES
============

* JSPWiki now requires at least JDK 1.5 to run.

* Simplified Chinese, Dutch, Russian and Italian localizations added!

* Logging by JSPWiki is now done with slf4j, see http://www.slf4j.org for details.
  You can now decide at runtime which logging implementation you want, just pick
  the right slf4j implementation and drop it in WEB-INF/lib
  The default implementation is log4j, so you don't have to switch to anything else unless 
  you have a good reason.
  The log4j configuration statements have been moved to a separate file log4j.properties, 
  this file should be on your CLASSPATH, by default it is placed in WEB-INF/classes
  
* Plugins
	
	New plugins were added:
	- The PluginIndexPlugin shows you all plugins that are available.
	- The InterWikiLinksPlugin shows you all defined InterWikiLinks in a customizable manner.
	
	The IndexPlugin has a new parameter (showAttachments=true/false), use false if you don't
	want attachments to show up on the PageIndex page.
	
	The IndexPlugin, RecentChangesPlugin and ReferredPagesPlugin are now subclasses of AbstractFilteredPlugin
	and therefore inheret the parameters exclude and include, so you can now use these filters. 

The full log of any issues fixed can be found at:

https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310732&styleName=Html&version=12312864
			  ==> how to get this to 3.0 ?

Please also see http://www.jspwiki.org/wiki/NewIn3.0

UPGRADE NOTES
=============

Please see the UPGRADING document in this same directory.


EXPERIMENTAL FEATURES
=====================

* Session attribute 'templates' (a map) can now be used with any JSP markup
for lookup of template-specific resources. For example, the EL
expression ${templates['FindContent.jsp']} returns 
/templates/*/FindContent.jsp, where * is the current configured template
or the default template, depending on which one actually returns
the resource.

KNOWN PROBLEMS
==============

* URLs for Stripes actions currently use the default .action URLs, rather than URLs
that conform to ShortURL/ShortView/JSP formats. This will be fixed later in the 3.0
development cycle, when we create our own ActionResolver implementation. This will
read URL patterns from a configuration file, instead of being hard-coded.

* When WikiPages are parsed, ACL entries are extracted and removed from the page markup,
and persisted as JCR attributes. This occurs when the page is loaded and parsed by
JSPWikiMarkupParser, and when the page is saved. The intent is to begin moving ACL
information out of the page entirely, and into separate storage. However, we do not
yet have a GUI for manipulating the ACL once it has been extracted. This will come
later in the 3.0 development cycle. 

* JCRPage implements the Attachment interface, in addition to WikiPage. This means that
code snippets like "p instanceof Attachment" will NOT work reliably. You should instead
use the WikiPage.isAttachment() method to test for this condition instead.

* Dummy page names like "__PAGEHERE__" and "#$%" in JavaScript and JSPs have
been replaced with "Main". They were throwing PageNotFoundExceptions. It's
probable that Stripes will eliminate the need to do this, anyway.

* Running with a security manager isn't yet supported (see JSPWIKI-129).