Author: crossley
Date: Fri Nov 13 03:13:31 2015
New Revision: 1714153

URL: http://svn.apache.org/viewvc?rev=1714153&view=rev
Log:
Improve the explanation of broken links.

Modified:
    
forrest/trunk/site-author/content/xdocs/docs_0_100/howto/howto-custom-html-source.xml
    forrest/trunk/site-author/content/xdocs/site.xml

Modified: 
forrest/trunk/site-author/content/xdocs/docs_0_100/howto/howto-custom-html-source.xml
URL: 
http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/docs_0_100/howto/howto-custom-html-source.xml?rev=1714153&r1=1714152&r2=1714153&view=diff
==============================================================================
--- 
forrest/trunk/site-author/content/xdocs/docs_0_100/howto/howto-custom-html-source.xml
 (original)
+++ 
forrest/trunk/site-author/content/xdocs/docs_0_100/howto/howto-custom-html-source.xml
 Fri Nov 13 03:13:31 2015
@@ -462,7 +462,8 @@
 <![CDATA[<map:transform src="{lm:transform.html.document}" />]]></code>
           <br/>
           Using the standard stylesheet 'html-to-document.xsl', this XHTML is 
-            transformed into Forrest's <a href="site:glossary">Standard 
Document Format</a>.  (refer to a detailed <a 
href="site:locationmap">explanation of locationsmaps</a> 
+          transformed into Forrest's <a href="site:glossary">Standard Document 
Format</a>.
+          (Refer to a detailed <a href="site:locationmap">explanation of 
locationmaps</a> 
           to understand exactly how and where that stylesheet is found!)
         </li>
         <li><code>&lt;map:serialize type="xml-document"/&gt;</code>
@@ -502,9 +503,12 @@
           directory structure. It also resolves any special Forrest links.
         </li>
         <li>
-            The final transformation, <code>
-<![CDATA[<map:transform src="{lm:transform.html.broken-links}" />]]></code> as 
the name suggests, will take
-          care of reporting broken site-links.
+          The final transformation,
+          <code><![CDATA[<map:transform src="{lm:transform.html.broken-links}" 
/>]]></code>
+          as the name suggests, will take care of reporting broken site-links.
+          (Note that this is for highlighting the broken links on each relevant
+           html output page, and not the list of broken links reported by 
Cocoon.
+           See <a href="site:forrest-dev/debug-links">explanation</a> of the 
latter.)
         </li>
         <li>
           The call to 'skinit' prepares the page body for presentation

Modified: forrest/trunk/site-author/content/xdocs/site.xml
URL: 
http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/site.xml?rev=1714153&r1=1714152&r2=1714153&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/site.xml (original)
+++ forrest/trunk/site-author/content/xdocs/site.xml Fri Nov 13 03:13:31 2015
@@ -103,6 +103,7 @@
       <sitemap href="#sitemap"/>
       <debug href="#debug"/>
       <debug-cocoon-profiler href="#debug-cocoon-profiler"/>
+      <debug-links href="#debug-links"/>
       <debug-sitemap-exec href="#debug-sitemap-exec"/>
       <debug-validation href="#debug-validation"/>
       <validate-intermediate href="#validate-intermediate"/>