forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r366040 - in /forrest/trunk: main/webapp/WEB-INF/cli.xconf site-author/content/xdocs/docs_0_80/faq.xml
Date Thu, 05 Jan 2006 01:04:20 GMT
Author: crossley
Date: Wed Jan  4 17:04:15 2006
New Revision: 366040

Reduce the "checksums" FAQ to point to existing discussion about cli.xconf
Add explanation to the core cli.xconf about relative/absolute path.


Modified: forrest/trunk/main/webapp/WEB-INF/cli.xconf
--- forrest/trunk/main/webapp/WEB-INF/cli.xconf (original)
+++ forrest/trunk/main/webapp/WEB-INF/cli.xconf Wed Jan  4 17:04:15 2006
@@ -82,6 +82,9 @@
        |  files will not be written if their checksum has not changed.
        |  This means that it will be easier to detect which files
        |  need to be uploaded to a server, using the timestamp.
+       |
+       |  The default path is relative to the core webapp directory.
+       |  An asolute path can be used.
    <!--   <checksums-uri>build/work/checksums</checksums-uri>-->

Modified: forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml
--- forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml Wed Jan  4 17:04:15 2006
@@ -766,31 +766,25 @@
         to a big savings for a site with thousands of files.
+          Another reason could be if you are not using the forrestbot to
+          deploy the generated site. Some tools depend on the "date-last-modified"
+          timestamp of the generated files.
+        </p>
+        <p>
         There was some discussion about this on the Forrest developer mailing
-        list.  An archive of these discussions can be found here:
+        list:
         <link href=";s=cocoon+checksum">Cocoon
         Specifically note that this feature only stops Cocoon from writing to 
-        disk that which is the same as the existing file.  Cocoon still spends
+        disk if the new file is the same as the existing file.  Cocoon still spends
         the same amount of time generating the content as it would if checksums
         were not enabled.
-        There are two steps required to enable checksums within Cocoon and 
-        Forrest.  The first is to add this line to your
-        file: 
-        <code>project.configfile=${project.home}/src/documentation/conf/cli.xconf</code>
-        </p>
-        <p>
-        The second is to copy a template of this file from the Forrest
-        tree under <code>main/site-author/conf/cli.xconf</code> to the
-        <code>src/documentation/conf</code> directory.
-        </p>
-        <p>
-        An optional last step is to edit the cli.xconf file to specify
-        the directory where the checksums file will be stored.  By default this
-        file is stored in the forrest tree and not in your site's tree. 
         Locate the <code>checksums-uri</code> tag within cli.xconf and replace
         the contents with an absolute path and filename for the checksums file.
+        Projects can supply their own (see FAQ:
+        <link href="#cli-xconf">Cocoon cli.xconf</link>) or use the default
+        installation-wide cli.xconf file.

View raw message