forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r526942 - in /forrest/trunk/etc: RELEASE-NOTES-0.7.txt RELEASE-NOTES-0.8.txt
Date Mon, 09 Apr 2007 22:47:18 GMT
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.



Mime
View raw message