The Apache Software Foundation

Introduction
------------

This is an alpha release of Apache Jackrabbit 2.0. This release implements
a pre-release version of the JCR 2.0 API, specified by the Java Specification
Request 283 (JSR 283, http://jcp.org/en/jsr/detail?id=283).

The purpose of this alpha release is to allow people to test and review
the new Jackrabbit and JCR 2.0 features before they are finalized. Feedback
to both the Jackrabbit project and the JSR 283 expert group is highly
appreciated. Note that an alpha release is not expected to be feature-complete
or otherwise suitable for production use.

Changes in this release
-----------------------

Jackrabbit 2.0 is a major upgrade from the earlier 1.x releases. The most
notable changes in this release are:

 * Upgrade to JCR 2.0. This Jackrabbit release implements and is based
   on a pre-release version of the JCR 2.0 API. All of the features
   required by the JSR 283 specification have been implemented.

 * Upgrade to Java 5. All of Jackrabbit (except the jcr-tests component)
   now requires Java 5 as the base platform. Java 1.4 environments are no
   longer supported.

 * Removal of deprecated classes and features. Jackrabbit 2.0 is not
   backwards compatible with client code that used any classes or features
   that had been deprecated during the 1.x release cycle.

 * Separate JCR Commons components. Many of the general-purpose JCR
   components like JCR-RMI and OCM are now developed and released
   separately from the Jackrabbit content repository. See the individual
   components for their most recent releases.

 * Data store feature enabled in the default repository configuration.

 * Full text indexing with Apache Tika. Jackrabbit can now extract and
   index the full text content of many new types of documents, including
   the Office Open XML files produced by Microsoft Office 2007 and higher.

For more detailed information about all the changes in this and other
Jackrabbit releases, please see the Jackrabbit issue tracker at

   https://issues.apache.org/jira/browse/JCR

Release Contents
----------------

This release consists of a single source archive packaged as a jar file.
The archive can be unpacked with the jar tool from your JDK installation.
See the README.txt file for instructions on how to build this release.

The source archive is accompanied by SHA1 and MD5 checksums and a PGP
signature that you can use to verify the authenticity of your download.
The public key used for the PGP signature can be found at
https://svn.apache.org/repos/asf/jackrabbit/dist/KEYS.

About Apache Jackrabbit
-----------------------

Apache Jackrabbit is a fully conforming implementation of the Content
Repository for Java Technology API (JCR). A content repository is a
hierarchical content store with support for structured and unstructured
content, full text search, versioning, transactions, observation, and
more.

For more information, visit http://jackrabbit.apache.org/

About The Apache Software Foundation
------------------------------------

Established in 1999, The Apache Software Foundation provides organizational,
legal, and financial support for more than 100 freely-available,
collaboratively-developed Open Source projects. The pragmatic Apache License
enables individual and commercial users to easily deploy Apache software;
the Foundation's intellectual property framework limits the legal exposure
of its 2,500+ contributors.

For more information, visit http://www.apache.org/

** Bug
   * [MRRESOURCES-11] - Resource filtering for overridden resources
   * [MRRESOURCES-35] - ClassCastException
   * [MRRESOURCES-37] - embedded error with maven-remote-resources-plugin; maven build order?
   * [MRRESOURCES-38] - Remove inadvertent dependency on MavenReportException in maven-reporting-api
   * [MRRESOURCES-39] - Unnecessary fondness for inceptionDate

** Improvement
   * [MRRESOURCES-31] - Add an "alternative" apache-jar-resource-bundle

** New Feature
   * [MRRESOURCES-36] - ${project.build.sourceEncoding} not honoured.
   * [MRRESOURCES-41] - add support for multi-module dependencies listing and other top-of-tree calculations on sub-modules
   * [MRRESOURCES-43] - Add ability to specify artifacts to search for supplementalModels

** Task
   * [MRRESOURCES-42] - Incorporate fix for PLXCOMP-145: problem with JarResourceLoader.initialize() never being called
   * [MRRESOURCES-44] - Document usage of runOnlyAtExecutionRoot and supplemental model features.
   * [MRRESOURCES-45] - Stage releases for dependencies that have changed

** Improvement
   * [MSHARED-127] - Consider all projects in the reactor AND projects
in the specified collection when dealing with
MultipleArtifactsNotFoundException

** New Feature
   * [MSHARED-126] - Create shared api to resolve project dependencies

** Bug
   * [MSHARED-73] - Verifier doesn't throw VerificationException upon non-zero exit code of mvn.bat on Windows
   * [MSHARED-76] - Verifier executeGoal method is OS-dependent in case of failure

** Improvement
   * [MSHARED-72] - Use current local repo for forked Maven invocations by default

** New Feature
   * [MSHARED-75] - Add convenience method to clean (target) directory

** Bug
   * [FELIX-938] - FileInstall starts a stopped bundles even if it is stopped transiently by user
   * [FELIX-1269] - MalformedURLException for bundle locations installed by FileInstall
   * [FELIX-1377] - fileinstall tries to process files which are not fully copied yet
   * [FELIX-1382] - FileInstall attempts to uninstall "System Bundle"
   * [FELIX-1481] - When performing variable substitution, fileinstall throws an exception if there is a start or stop delimiter without the other one
   * [FELIX-1540] - [FileInstall] When removing/re-adding a bundle, all the dependent bundles don't start anymore

** Improvement
   * [FELIX-1301] - Limit FileInstall configuration information to one line in the output
   * [FELIX-1387] - FileInstall unnenessarily computes length of files
   * [FELIX-1475] - Add a file filter for a given watched directory
   * [FELIX-1476] - Allow system property substitution while loading configurations from files
   * [FELIX-1553] - fileinstall bundle should have an optional import on org.osgi.service.log instead of exporting it
   * [FELIX-1554] - fileinstall should not export org.apache.felix.fileinstall and org.apache.felix.fileinstall.utils packages

** New Feature
   * [FELIX-922] - File Install bundle should be extensible to support new artifact type
   * [FELIX-1483] - Fileinstall should support exploded artifacts