You are viewing a plain text version of this content. The canonical link for it is here.
Posted to svn@forrest.apache.org by cr...@apache.org on 2007/04/10 00:47:18 UTC
svn commit: r526942 - in /forrest/trunk/etc: RELEASE-NOTES-0.7.txt
RELEASE-NOTES-0.8.txt
Author: crossley
Date: Mon Apr 9 15:47:17 2007
New Revision: 526942
URL: http://svn.apache.org/viewvc?view=rev&rev=526942
Log:
Create new notes from localhost:8888/releaseNotes_*.txt
Added:
forrest/trunk/etc/RELEASE-NOTES-0.8.txt
- copied, changed from r526678, forrest/trunk/etc/RELEASE-NOTES-0.7.txt
Removed:
forrest/trunk/etc/RELEASE-NOTES-0.7.txt
Copied: forrest/trunk/etc/RELEASE-NOTES-0.8.txt (from r526678, forrest/trunk/etc/RELEASE-NOTES-0.7.txt)
URL: http://svn.apache.org/viewvc/forrest/trunk/etc/RELEASE-NOTES-0.8.txt?view=diff&rev=526942&p1=forrest/trunk/etc/RELEASE-NOTES-0.7.txt&r1=526678&p2=forrest/trunk/etc/RELEASE-NOTES-0.8.txt&r2=526942
==============================================================================
--- forrest/trunk/etc/RELEASE-NOTES-0.7.txt (original)
+++ forrest/trunk/etc/RELEASE-NOTES-0.8.txt Mon Apr 9 15:47:17 2007
@@ -1,142 +1,147 @@
-Apache Forrest 0.7 Release Notes ... http://forrest.apache.org/
+ Release Notes for Forrest 0.8
-Apache Forrest is a publishing framework that transforms
-input from various sources into a unified presentation
-in one or more output formats. The modular and extensible
-plugin architecture is based on Apache Cocoon and relevant
-standards, which separates presentation from content.
-Forrest can generate static documents, or be used as a
-dynamic server, or be deployed by its automated facility.
+Apache Forrest is pleased to release the new version: apache-forrest-0.8
+========================================================================
-Status
-------
+ It can be downloaded from one of the Apache Software Foundation mirror
+ sites [Link: http://forrest.apache.org/mirrors.cgi].
-New features in this version include:
+ Apache Forrest is a publishing framework that transforms input from
+ various sources into a unified presentation in one or more output
+ formats. The modular and extensible plugin architecture is based on
+ Apache Cocoon and relevant standards, which separates presentation from
+ content. Forrest can generate static documents, or be used as a dynamic
+ server, or be deployed by its automated facility.
-* An architecture for Plugins which enables a smaller Forrest
-core and the ability to add new features in a modular way.
+Requirements
+============
-See other notes about important changes below.
+ A Java Runtime Environment (1.4 or higher) installed.
-Full list of changes: http://forrest.apache.org/docs_0_70/changes.html
+ To build from source requires a Java Development Kit (1.4 or higher)
-Upgrade guide: http://forrest.apache.org/docs_0_70/upgrading_07.html
+ Apache Ant is not required: Forrest uses its own version of Ant in
+ tools/ant/
-Requirements
-------------
+ Apache Cocoon is not required: Forrest uses its own version.
-- A Java Runtime Environment (1.4 or higher) installed.
- This can be obtained from http://java.sun.com/j2se/downloads.html
- or other places.
+Installing Apache Forrest
+=========================
-- To build from source requires a Java Development Kit (1.4 or higher)
+ The distribution contains all Forrest resources (skins, XSLTs, images,
+ schemas), source code and Forrest's own website documentation.
-Apache Ant is not required: Forrest uses its own version of Ant in tools/ant/
-Apache Cocoon is not required: Forrest uses its own version.
+ Copy somewhere permanent, like /usr/local/forrest or c:\forrest
+ (Support for installation on Windows systems into directories
+ containing spaces is very new, please report back on your success or
+ failure.)
-Installing Apache Forrest
--------------------------
+ Set FORREST_HOME environment variable to point to that top-level
+ directory.
-The distribution contains all Forrest resources (skins, XSLTs, images,
-schemas), source code and Forrest's own website documentation.
-
-- Copy somewhere permanent, like /usr/local/forrest or c:\forrest
- Support for installation on Windows systems into directories containing
- spaces is very new, please report back on your success or failure.
-
-- Set FORREST_HOME environment variable to point to that top-level directory.
-- Add to the system PATH environment variable, i.e.
- $FORREST_HOME/bin (Unix) or %FORREST_HOME%\bin (Windows)
+ Add to the system PATH environment variable, i.e. $FORREST_HOME/bin
+ (Unix) or %FORREST_HOME%\bin (Windows)
Getting Started
----------------
+===============
-See the file index.html for the quick start tips.
+ See the file index.html for the quick start tips.
Issue tracking
---------------
-
-If you notice what appears to be a bug, please report it via the
-Forrest issue tracker: http://issues.apache.org/jira/secure/BrowseProject.jspa?id=12310000
+==============
-Known issues are summarized at:
-http://forrest.apache.org/forrest-issues.html
-(a nice example of RSS syndication).
+ If you notice what appears to be a bug or wish to make a contribution,
+ please report it via the Forrest issue tracker
+ [Link: http://forrest.apache.org/issues.html].
Feedback
---------
+========
+
+ Feedback, feature suggestions, contributions, bugs, and any other
+ issues can be discussed on our mailing lists
+ [Link: http://forrest.apache.org/mail-lists.html].
+
+Major Changes in Version 0.8
+============================
+
+ ** Note **
+ This is not a complete list of changes, just some of the more important
+ ones. A full list of changes in this release is available
+ [Link: http://forrest.apache.org/changes.html].
+ --------------------------------------------------------------------------
+
+ Changes to the Code Base
+ ------------------------
+
+ * [Icon: fix] Thanks to Gunther Sablon for reporting this issue. Plugins
+ were not being deployed to a Webapp WAR file correctly. Committed by
+ RDG. See Issue FOR-735 [Link:
+ http://issues.apache.org/jira/browse/FOR-735].
+ * [Icon: update] Rename webapp build target to run-webapp to distinguish
+ the resulting webapp from one suitable for deployment (use the war
+ target for that) and provide a new xconf that is used in the war to
+ ensure plugins can be found in war files Committed by RDG. See Issue
+ FOR-735 [Link: http://issues.apache.org/jira/browse/FOR-735].
+ * [Icon: fix] Fix caching problem that made a restart neccessary after
+ making a locationmap resource location change. Committed by TWW. See
+ Issue FOR-732 [Link: http://issues.apache.org/jira/browse/FOR-732].
+ * [Icon: fix] After doing 'forrest clean' then Forrest could not be run
+ without network access, due to not being able to retrieve plugin
+ descriptor files. Committed by DC. See Issue FOR-927 [Link:
+ http://issues.apache.org/jira/browse/FOR-927].
+ * [Icon: update] FOR-924 Readding the loading from
+ (default-)forrest.properties which got removed in r430588 when closing
+ FOR-916. Thanks Martin Stockhammer for pointing it out, providing us
+ with a patch and for your contribution. Committed by TS. Thanks to
+ Martin Stockhammer. See Issue FOR-924 [Link:
+ http://issues.apache.org/jira/browse/FOR-924].
+ * [Icon: update] FOR-920 Merging the defaults and project modules to the
+ new properties module. You can use it like {properties:forrest.home},
+ please refer to the update documentation [Link:
+ docs_0_80/upgrading_08.html] how to change your {defaults:*}
+ {project:*} and {forrest:*}. Committed by TS.
+ * [Icon: remove] Remove xconf support for plugins. Cocoon has moved away
+ from this XConfToolTask xpatch technique. Diff [Link:
+ http://svn.apache.org/viewvc?rev=354749&view=rev] Committed by RDG.
+ * [Icon: add] Added new "clean" targets. Doing 'forrest clean-site' will
+ remove the contents of the project's generated documents directory.
+ Doing 'forrest clean-work' will remove the project's work directories
+ (usually build/tmp and build/webapp which include the Cocoon cache and
+ the Cocoon logs). Doing 'forrest clean' will remove both sections.
+ Committed by DC.
+ * [Icon: add] The broken-links file is now copied into to the site root
+ as "broken-links.xml" so that when building with Forrestbot you can
+ easily view it. Committed by RDG.
+ * [Icon: add] Reviewed all sitemaps to use locationmap references (lm:).
+ At the same time we changed filenames of core stylesheets to follow a
+ filename convention (e.g. html2document.xsl => html-to-document.xsl)
+ which enables automated locationmap matches. Thanks to the many people
+ who were involved with addressing this issue. See the commit logs
+ associated with FOR-200. Committed by RDG. Thanks to Community. See
+ Issue FOR-200 [Link: http://issues.apache.org/jira/browse/FOR-200].
+ * [Icon: add] Add notes about naming convention for locationmap
+ references. Gathered from a ForrestFriday IRC session (thanks to Tim
+ Williams for writing them up). See locationmap docs [Link:
+ docs_0_80/locationmap.html]. Committed by RDG. Thanks to Community. See
+ Issue FOR-200 [Link: http://issues.apache.org/jira/browse/FOR-200].
+ * [Icon: add] Added support for Locationmaps. This enables content to be
+ retrieved from a location that is defined in a locationmap file. A
+ project-based file can be located at
+ PROJECT_HOME/src/documentation/content/locationmap.xml while core
+ locationmaps are at $FORREST_HOME/main/webapp/locationmap-*.xml
+ files.The advantage of this is that the URL seen by the user need bear
+ no relation to the location of the source document, thus Forrest can
+ separate the client URL space from the source document URL space. Thus,
+ using the locationmap it is possible to pull together documents from
+ many different locations into a single uniform site.In addition, since
+ the user URL space is now unconnected to the source URL space it is
+ possible to move source documents without breaking any existing user
+ links.See locationmap docs [Link: docs_0_80/locationmap.html] for more
+ information. Thanks to Unico Hommes for the original locationmap
+ implementation which was added to Forrest long ago. Committed by RDG.
-Feedback, feature suggestions, bugs and any other issues
-can be discussed on http://forrest.apache.org/mail-lists.html
+ Changes to Documentation
+ ------------------------
---------------------------------------------------------------------------
-Release Notes for Apache Forrest 0.7
-------------------------------------
-
-This is not a complete list of changes.
-Full list: http://forrest.apache.org/docs_0_70/changes.html
-
-Important Changes Code Base
----------------------------
-
-* Enable sitemap plugins. Plugins allow Forrest to have
- functionality added through the addition of small code blocks
- (plugins). Plugins are downloaded automatically when a site that
- requires them is built. See Extending Forrest with Plugins [Link:
- pluginDocs/plugins_0_70/usingPlugins.html]. (RDG)
-* Added org.apache.forrest.plugin.input.dtdx plugin by moving
- functionality out of the core. Generates DTD documentation using a
- custom Cocoon Generator. (DC) Fixes FOR-389 [Link:
- http://issues.apache.org/jira/browse/FOR-389].
-* Added a plugin to handle input documents from Microsoft
- Excel. (RDG) Thanks to Johannes Schaefer. Fixes FOR-373 [Link:
- http://issues.apache.org/jira/browse/FOR-373].
-* Moved POD output from the common skin to its own plugin. (RFT)
-* Added external plugin POD-input to allow Plain Old Documentation (POD)
- files to be included in a Forrest site. (RDG) Thanks to Ron Blaschke.
-* Added a text-output plugin. (RFT) Fixes FOR-125 [Link:
- http://issues.apache.org/jira/browse/FOR-125].
-* Added photoGallery plugin. (RDG) Thanks to Jörg Werne. Fixes FOR-387
- [Link: http://issues.apache.org/jira/browse/FOR-387].
-* The brokenlinks file now contains referer information.
- Upgraded lib/core/cocoon.jar and added attribute "show-referrers" to
- the Cocoon cli.xconf (DC) Thanks to Upayavira. Fixes FOR-204 [Link:
- http://issues.apache.org/jira/browse/FOR-204].
-* Merge xdocs and raw files in the same directory
- src/document/content/xdocs (JJP)
-* Enhanced the Message of the Day (MOTD) facility. See
- skinconf.xml from a "seed" site for configuration details. Append a
- small text string after html title. Add text to a panel on the page.
- Select different messages depending on the URI string pattern. To use
- it, declare skinconfig-v07-1.dtd in your skinconf.xml file. (DC)
-* Reinstate error reporting for broken "site:" and "ext:"
- links which are due to missing entries in site.xml or typos in site:
- links. The text "error:" is also prepended. This is a workaround for
- bug FOR-284 "link rewriting broken when linking to xml source views
- which contain site: links". This latter issue is handled by the core.
- However, if your project uses a Cocoon cli.xconf then you will need
- add the same "exclude" entries. (DC) Fixes FOR-284 [Link:
- http://issues.apache.org/jira/browse/FOR-284].
-* Moved status "changes" and "todo" page generation to the
- org.apache.forrest.plugin.input.projectInfo plugin. (RDG)
-* Java 1.4 is required starting with Forrest-0.7-dev (DC)
-
-Important Changes Documentation
--------------------------------
-
-* Added How to customize processing of html source. (DC) Thanks to
- Ferdinand Soethe. Fixes FOR-446 [Link:
- http://issues.apache.org/jira/browse/FOR-446].
-* Added How-To Run Forrest from Maven. (RDG) Thanks to Ian P. Springer.
- Fixes FOR-369 [Link: http://issues.apache.org/jira/browse/FOR-369].
-* Added How-To Build a plugin. (RDG)
-* Added HowTo about editing CSS in a WYSIWYG fashion using Mozilla
- Firefox and its Edit-CSS plugin. (RDG) Thanks to Ferdinand Soethe.
-* Rewrote example of raw content in fresh-site to correctly document
- the behaviour in 0.7. (RDG) Fixes FOR-470 [Link:
- http://issues.apache.org/jira/browse/FOR-470].
-* Removed ihtml example from fresh-site and replaced with
- an example of embedded HTML. The use of ihtml is now deprecated in
- favour of embedded HTML. (RDG)
-* Updated How-To: How to create a PDF document for each tab to create
- subject-specific aggregated documents. (TS)
+ * [Icon: add] Added document to facilitate upgrading to v0.8 [Link:
+ docs_0_80/upgrading_08.html] Committed by DC.