forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: rev 55603 - forrest/site/docs
Date Tue, 26 Oct 2004 12:04:34 GMT
Author: crossley
Date: Tue Oct 26 05:04:33 2004
New Revision: 55603

Modified:
   forrest/site/docs/project-sitemap.html
   forrest/site/docs/project-sitemap.pdf
   forrest/site/docs/upgrading_06.html
   forrest/site/docs/upgrading_06.pdf
Log:
Clarify the notes about the project sitemap.


Modified: forrest/site/docs/project-sitemap.html
==============================================================================
--- forrest/site/docs/project-sitemap.html	(original)
+++ forrest/site/docs/project-sitemap.html	Tue Oct 26 05:04:33 2004
@@ -277,7 +277,7 @@
 <div class="section">
 <p>With Forrest 0.6 it is now possible for projects to "plugin" 
       to our sitemaps, without needing to copy the main sitemaps and keep
-      them them synchonised. This will enable hassle-free update to
+      them synchonised. This will enable hassle-free update to
       future Forrest versions.</p>
 <div class="frame note">
 <div class="label">Note</div>

Modified: forrest/site/docs/project-sitemap.pdf
==============================================================================
Binary files. No diff available.

Modified: forrest/site/docs/upgrading_06.html
==============================================================================
--- forrest/site/docs/upgrading_06.html	(original)
+++ forrest/site/docs/upgrading_06.html	Tue Oct 26 05:04:33 2004
@@ -274,7 +274,7 @@
 <a href="#copyless">Copyless</a>
 </li>
 <li>
-<a href="#sitemap">Sitemap</a>
+<a href="#sitemap">Project sitemaps take precedence.</a>
 </li>
 <li>
 <a href="#skin-config-1">Private skins might need changes to document2html.xsl</a>
@@ -420,8 +420,12 @@
 
     
 <a name="N1007D"></a><a name="sitemap"></a>
-<h2 class="underlined_10">Sitemap</h2>
+<h2 class="underlined_10">Project sitemaps take precedence.</h2>
 <div class="section">
+<p>With Forrest 0.6 it is now possible for projects to "plugin" 
+      to our sitemaps, without needing to copy the main sitemaps and keep
+      them synchonised. This will enable hassle-free update to
+      future Forrest versions.</p>
 <p>
         If your old project did not use any customised <span class="codefrag">*.xmap</span>

         files, then your upgrade process will be easy (you can safely skip this
@@ -431,9 +435,10 @@
         were handling) then you will need to be prepared to make some changes. 
         Hopefully with the new functionality of Forrest, you can do away with 
         your customisations altogether and just use the Forrest default 
-        sitemaps, if not read on...</p>
+        sitemaps. Try that first. If not, then read on...</p>
 <p>Prior to 0.6 it was possible to replace *any* of the xmaps by placing 
       your own versions in your project directory, these were then copied over 
+      to replace
       the Forrest ones at build time. However, with the move to 
       <a href="#copyless">copyless</a> this no longer happens, instead 
       there is now an extension mechanism for the sitemap (as opposed to 
@@ -446,16 +451,16 @@
       enhancements to these matchers in Forrest will automatically be included 
       in your project.</p>
 <p>The good news is that this process makes upgrading to future versions
-      of Forrest much simpler since your project <span class="codefrag">*.xmap</span>
files will 
-      only contain your customisations. As a result there will no longer be a
-      need to merge your custom xmaps with the updated ones in new versions of 
+      of Forrest much simpler, because your project <span class="codefrag">*.xmap</span>
files will 
+      contain only your customisations. As a result there will no longer be a
+      need to merge your custom xmaps with the updated ones in upcoming versions of 
       Forrest.</p>
 <p>See <a href="../docs/project-sitemap.html">Using project 
       sitemaps</a> for more details.</p>
 </div>
 
     
-<a name="N100B3"></a><a name="skin-config-1"></a>
+<a name="N100B6"></a><a name="skin-config-1"></a>
 <h2 class="underlined_10">Private skins might need changes to document2html.xsl</h2>
 <div class="section">
 <p>
@@ -469,7 +474,7 @@
 </div>
 
     
-<a name="N100C1"></a><a name="skin-config-2"></a>
+<a name="N100C4"></a><a name="skin-config-2"></a>
 <h2 class="underlined_10">Various additions to skin configuration and new external
DTD</h2>
 <div class="section">
 <p>
@@ -488,7 +493,7 @@
 </div>
     
     
-<a name="N100D7"></a><a name="antproxy"></a>
+<a name="N100DA"></a><a name="antproxy"></a>
 <h2 class="underlined_10">forrest.antproxy.xml is obsolete in favor of Ant's &lt;import&gt;
task</h2>
 <div class="section">
 <p>
@@ -502,7 +507,7 @@
 </div>
 
     
-<a name="N100E8"></a><a name="ehtml"></a>
+<a name="N100EB"></a><a name="ehtml"></a>
 <h2 class="underlined_10">Deprecation of .ehtml and .ihtml</h2>
 <div class="section">
 <p>
@@ -514,7 +519,7 @@
 </div>
 
     
-<a name="N100F5"></a><a name="jspwiki"></a>
+<a name="N100F8"></a><a name="jspwiki"></a>
 <h2 class="underlined_10">Deprecation of .cwiki filename extension to become .jspwiki</h2>
 <div class="section">
 <p>
@@ -524,7 +529,7 @@
 </div>
 
     
-<a name="N100FF"></a><a name="forrestbot"></a>
+<a name="N10102"></a><a name="forrestbot"></a>
 <h2 class="underlined_10">New forrestbot</h2>
 <div class="section">
 <p>
@@ -538,7 +543,7 @@
 </div>
     
     
-<a name="N1010D"></a><a name="dtd"></a>
+<a name="N10110"></a><a name="dtd"></a>
 <h2 class="underlined_10">New DTDs</h2>
 <div class="section">
 <p>
@@ -585,7 +590,7 @@
 </div>
 
     
-<a name="N1011E"></a><a name="catalog"></a>
+<a name="N10121"></a><a name="catalog"></a>
 <h2 class="underlined_10">SystemIdentifiers for DTDs changed to forrest.apache.org</h2>
 <div class="section">
 <p>
@@ -621,7 +626,7 @@
 </div>
 
     
-<a name="N1013E"></a><a name="local-catalog"></a>
+<a name="N10141"></a><a name="local-catalog"></a>
 <h2 class="underlined_10">Projects can use a local CatalogManager.properties</h2>
 <div class="section">
 <p>
@@ -636,7 +641,7 @@
 </div>
 
     
-<a name="N1014B"></a><a name="skin-names"></a>
+<a name="N1014E"></a><a name="skin-names"></a>
 <h2 class="underlined_10">Skins renamed and deleted</h2>
 <div class="section">
 <p>Skins now have a naming convention. The default skins are
@@ -680,7 +685,7 @@
 </div>
 
     
-<a name="N101A7"></a><a name="wholesite"></a>
+<a name="N101AA"></a><a name="wholesite"></a>
 <h2 class="underlined_10">Wholesite.html/pdf</h2>
 <div class="section">
 <p>Instead of using names "site.html/pdf" to create an aggregate page
@@ -690,7 +695,7 @@
 </div>
 
     
-<a name="N101B1"></a><a name="To+be+continued..."></a>
+<a name="N101B4"></a><a name="To+be+continued..."></a>
 <h2 class="underlined_10">To be continued...</h2>
 <div class="section">
 <p>...as more issues are discovered/remembered :)  Please send feedback

Modified: forrest/site/docs/upgrading_06.pdf
==============================================================================
Binary files. No diff available.

Mime
View raw message