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"> +<!ENTITY handle-errors ' + <map:handle-errors> + <map:select type="exception"> + <map:when test="resourceNotFound"> + <map:generate type="exception"/> + <map:transform src="{lm:transform.exception.text}"> + <map:parameter name="type" value="404"/> + </map:transform> + <map:serialize type="text" status-code="404"/> + </map:when> + </map:select> + </map:handle-errors> +'></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"> +<!ENTITY handle-errors ' + <map:handle-errors> + <map:select type="exception"> + <map:when test="resourceNotFound"> + <map:generate type="exception"/> + <map:transform src="{lm:transform.exception.text}"> + <map:parameter name="type" value="404"/> + </map:transform> + <map:serialize type="text" status-code="404"/> + </map:when> + </map:select> + </map:handle-errors> +'></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.