Mailing List Archive

Author: crossley
Date: Wed Dec 11 14:06:32 2013
New Revision: 1550142

URL: http://svn.apache.org/r1550142
Log:
Publish from forrestbot

Modified:
forrest/site/abs-linkmap
forrest/site/abs-menulinks
forrest/site/docs_0_100/changes.html
forrest/site/docs_0_100/changes.rss
forrest/site/docs_0_100/changes.xml
forrest/site/docs_0_100/faq.html
forrest/site/docs_0_100/faq.xml
forrest/site/dtdx/document-v13.pdf
forrest/site/dtdx/document-v20.pdf

Modified: forrest/site/abs-linkmap
URL: http://svn.apache.org/viewvc/forrest/site/abs-linkmap?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
--- forrest/site/abs-linkmap (original)
+++ forrest/site/abs-linkmap Wed Dec 11 14:06:32 2013
@@ -301,6 +301,7 @@
<run_port href="docs_0_100/faq.html#run_port"/>
<single-document href="docs_0_100/faq.html#single-document"/>
<sitemap-entities href="docs_0_100/faq.html#sitemap-entities"/>
+ <handle-errors href="docs_0_100/faq.html#handle-errors"/>
<svn-eol-style href="docs_0_100/faq.html#svn-eol-style"/>
<tab-index href="docs_0_100/faq.html#tab-index"/>
<cli-xconf href="docs_0_100/faq.html#cli-xconf"/>

Modified: forrest/site/abs-menulinks
URL: http://svn.apache.org/viewvc/forrest/site/abs-menulinks?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
--- forrest/site/abs-menulinks (original)
+++ forrest/site/abs-menulinks Wed Dec 11 14:06:32 2013
@@ -301,6 +301,7 @@
<run_port tab="v0_100" href="docs_0_100/faq.html#run_port"/>
<single-document tab="v0_100" href="docs_0_100/faq.html#single-document"/>
<sitemap-entities tab="v0_100" href="docs_0_100/faq.html#sitemap-entities"/>
+ <handle-errors tab="v0_100" href="docs_0_100/faq.html#handle-errors"/>
<svn-eol-style tab="v0_100" href="docs_0_100/faq.html#svn-eol-style"/>
<tab-index tab="v0_100" href="docs_0_100/faq.html#tab-index"/>
<cli-xconf tab="v0_100" href="docs_0_100/faq.html#cli-xconf"/>

Modified: forrest/site/docs_0_100/changes.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_100/changes.html?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
--- forrest/site/docs_0_100/changes.html (original)
+++ forrest/site/docs_0_100/changes.html Wed Dec 11 14:06:32 2013
@@ -547,6 +547,11 @@ document.write("Last Published: " + docu
<ul>
<li>
<img class="icon" alt="add" src="../images/add.jpg">
+ Enable per-project configuration of Cocoon error handling.
+ Added an <a href="../docs_0_100/faq.html#handle-errors">FAQ</a>.
+ Committed by DC. See Issue <a href="http://issues.apache.org/jira/browse/FOR-1245">FOR-1245</a>.</li>
+<li>
+<img class="icon" alt="add" src="../images/add.jpg">
Add initial "logo" input plugin to Whiteboard.
Assist management of project logos and banner images.
For example, overlay a TM symbol using SVG to create a new image.

Modified: forrest/site/docs_0_100/changes.rss
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_100/changes.rss?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
--- forrest/site/docs_0_100/changes.rss (original)
+++ forrest/site/docs_0_100/changes.rss Wed Dec 11 14:06:32 2013
@@ -64,6 +64,19 @@
upgrading to v0.10-dev
</description></item>

+ <item><title>Apache Forrest code add
+ (bug FOR-1245)
+ </title><link>http://forrest.apache.org//changes.html</link><description>code add
+ by
+ DC
+ (fixes bug FOR-1245)
+
+ :
+
+ Enable per-project configuration of Cocoon error handling.
+ Added an FAQ.
+ </description></item>
+
<item><title>Apache Forrest code update</title><link>http://forrest.apache.org//changes.html</link><description>code update
by
DC
@@ -6822,6 +6835,17 @@

Added document to facilitate
upgrading to v0.10-dev
+ </description></item><item><title>Apache Forrest code add
+ (bug FOR-1245)
+ </title><link>http://forrest.apache.org//changes.html</link><description>code add
+ by
+ DC
+ (fixes bug FOR-1245)
+
+ :
+
+ Enable per-project configuration of Cocoon error handling.
+ Added an FAQ.
</description></item><item><title>Apache Forrest code update</title><link>http://forrest.apache.org//changes.html</link><description>code update
by
DC

Modified: forrest/site/docs_0_100/changes.xml
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_100/changes.xml?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
--- forrest/site/docs_0_100/changes.xml (original)
+++ forrest/site/docs_0_100/changes.xml Wed Dec 11 14:06:32 2013
@@ -6,6 +6,9 @@
detailed changes.
</p>
<section id="code_0.10-dev"><title>Changes to the Code Base</title><ul><li><icon alt="add" src="../images/add.jpg"/>
+ Enable per-project configuration of Cocoon error handling.
+ Added an <link href="site:faq/handle-errors">FAQ</link>.
+ Committed by DC. See Issue <link href="http://issues.apache.org/jira/browse/FOR-1245">FOR-1245</link>.</li><li><icon alt="add" src="../images/add.jpg"/>
Add initial "logo" input plugin to Whiteboard.
Assist management of project logos and banner images.
For example, overlay a TM symbol using SVG to create a new image.

Modified: forrest/site/docs_0_100/faq.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_100/faq.html?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
--- forrest/site/docs_0_100/faq.html (original)
+++ forrest/site/docs_0_100/faq.html Wed Dec 11 14:06:32 2013
@@ -526,7 +526,10 @@ document.write("Last Published: " + docu
<a href="#sitemap-entities">3.21. How to configure some Cocoon sitemap components, e.g. output html encoding or doctype?</a>
</li>
<li>
-<a href="#svn-eol-style">3.22. Why are there SVN diffs for some documents, even though they have not changed?</a>
+<a href="#handle-errors">3.22. How to enable Cocoon error handling?</a>
+</li>
+<li>
+<a href="#svn-eol-style">3.23. Why are there SVN diffs for some documents, even though they have not changed?</a>
</li>
</ul>
</li>
@@ -1767,8 +1770,49 @@ X [0] /docs_0_80/upgrading_08.ht
file into your project symbols file and edit the entity declaration.
Re-start Forrest.
</p>
+<a name="handle-errors"></a>
+<h3 class="underlined_5">3.22. How to enable Cocoon error handling?</h3>
+<p>
+ When Cocoon encounters an exception then it will present a default
+ page to explain the error. Better error handling can be configured
+ by adding a "map:handle-errors" section to each sitemap from which
+ such exceptions might arise.
+ </p>
+<p>
+ That is easily added directly to your project sitemap for any
+ special processing.
+ However for many cases it needs to be added to the main
+ webapp/sitemap.xmap file.
+ </p>
+<p>
+ Do this by adding a "handle-errors" xml entity to your project
+ "symbols" file (<a href="#sitemap-entities">explained above</a>).
+ For example:
+ </p>
+<pre class="code">
+&lt;!ENTITY handle-errors '
+ &lt;map:handle-errors&gt;
+ &lt;map:select type="exception"&gt;
+ &lt;map:when test="resourceNotFound"&gt;
+ &lt;map:generate type="exception"/&gt;
+ &lt;map:transform src="{lm:transform.exception.text}"&gt;
+ &lt;map:parameter name="type" value="404"/&gt;
+ &lt;/map:transform&gt;
+ &lt;map:serialize type="text" status-code="404"/&gt;
+ &lt;/map:when&gt;
+ &lt;/map:select&gt;
+ &lt;/map:handle-errors&gt;
+'&gt;</pre>
+<p>
+ Some exception selectors are configured in webapp/sitemap.xmap file
+ at the "map:selectors" section.
+ Please send patches for others if you need them to be added.
+ </p>
+<p>
+ See further <a href="http://s.apache.org/b8V">explanation</a>.
+ </p>
<a name="svn-eol-style"></a>
-<h3 class="underlined_5">3.22. Why are there SVN diffs for some documents, even though they have not changed?</h3>
+<h3 class="underlined_5">3.23. Why are there SVN diffs for some documents, even though they have not changed?</h3>
<p>
These un-necessary differences happen because the comitter who did 'svn add' for those files
did not have their Subversion client configured properly for the "svn:eol-style" setting.

Modified: forrest/site/docs_0_100/faq.xml
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_100/faq.xml?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
--- forrest/site/docs_0_100/faq.xml (original)
+++ forrest/site/docs_0_100/faq.xml Wed Dec 11 14:06:32 2013
@@ -1056,7 +1056,47 @@ X [0] /docs_0_80/upgrading_08.ht
file into your project symbols file and edit the entity declaration.
Re-start Forrest.
</p>
- </section><section id="svn-eol-style"><title>3.22. Why are there SVN diffs for some documents, even though they have not changed?</title>
+ </section><section id="handle-errors"><title>3.22. How to enable Cocoon error handling?</title>
+ <p>
+ When Cocoon encounters an exception then it will present a default
+ page to explain the error. Better error handling can be configured
+ by adding a "map:handle-errors" section to each sitemap from which
+ such exceptions might arise.
+ </p>
+ <p>
+ That is easily added directly to your project sitemap for any
+ special processing.
+ However for many cases it needs to be added to the main
+ webapp/sitemap.xmap file.
+ </p>
+ <p>
+ Do this by adding a "handle-errors" xml entity to your project
+ "symbols" file (<link href="#sitemap-entities">explained above</link>).
+ For example:
+ </p>
+ <source xml:space="preserve">
+&lt;!ENTITY handle-errors '
+ &lt;map:handle-errors&gt;
+ &lt;map:select type="exception"&gt;
+ &lt;map:when test="resourceNotFound"&gt;
+ &lt;map:generate type="exception"/&gt;
+ &lt;map:transform src="{lm:transform.exception.text}"&gt;
+ &lt;map:parameter name="type" value="404"/&gt;
+ &lt;/map:transform&gt;
+ &lt;map:serialize type="text" status-code="404"/&gt;
+ &lt;/map:when&gt;
+ &lt;/map:select&gt;
+ &lt;/map:handle-errors&gt;
+'&gt;</source>
+ <p>
+ Some exception selectors are configured in webapp/sitemap.xmap file
+ at the "map:selectors" section.
+ Please send patches for others if you need them to be added.
+ </p>
+ <p>
+ See further <link href="http://s.apache.org/b8V">explanation</link>.
+ </p>
+ </section><section id="svn-eol-style"><title>3.23. Why are there SVN diffs for some documents, even though they have not changed?</title>
<p>
These un-necessary differences happen because the comitter who did 'svn add' for those files
did not have their Subversion client configured properly for the "svn:eol-style" setting.

Modified: forrest/site/dtdx/document-v13.pdf
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/document-v13.pdf?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
Binary files - no diff available.

Modified: forrest/site/dtdx/document-v20.pdf
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/document-v20.pdf?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
Binary files - no diff available.