svn commit: r161015 - forrest/trunk/site-author/content/xdocs/docs/upgrading_07.xml

[cr...@apache.org]

Author: crossley
Date: Mon Apr 11 22:26:36 2005
New Revision: 161015

URL: http://svn.apache.org/viewcvs?view=rev&rev=161015
Log:
Explain the changes with "raw un-processed content" etc.

Modified:
    forrest/trunk/site-author/content/xdocs/docs/upgrading_07.xml

Modified: forrest/trunk/site-author/content/xdocs/docs/upgrading_07.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/site-author/content/xdocs/docs/upgrading_07.xml?view=diff&r1=161014&r2=161015
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs/upgrading_07.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs/upgrading_07.xml Mon Apr 11 22:26:36 2005
@@ -96,20 +96,33 @@
     </section>
 
     <section id="raw">
-      <title>Including raw content</title>
-      <p>The method for including "raw content" has changed.
+      <title>Including raw un-processed content</title>
+      <p>The method for including "raw un-processed content" has changed.
       </p>
       <p>
         In 0.6 version, the raw content was placed in the
-        src/documentation/content directory and potential sub-directories.
-        Any file with .html extension was not processed and not adorned with
-        Forrest skin and navigation menus.
+        src/documentation/content/ directory and potential sub-directories.
+        In the generated site, these links would automatically function.
+        Any linked file with .html extension was not processed and not
+        adorned with Forrest skin and navigation menus.
       </p>
       <p>
-        In 0.7 version, all content (whether processed or raw) goes in
-        src/documentation/content/xdocs directory.
-        Any file with .html extension is now processed and is adorned with
-        Forrest skin and navigation menus.
+        In 0.7 version, any file that is linked to, needs to be placed in
+        the content/xdocs/ directory structure.
+        Any linked file with .html extension is now processed and is
+        adorned with Forrest skin and navigation menus.
+      </p>
+      <p>
+        If you need to include files that are not linked to,
+        then place them in the src/documentation/content/ directories
+        as with the 0.6 version.
+      </p>
+      <p>
+        If you need to link to html files but want them to be un-processed,
+        then place them in the src/documentation/content/ directories and
+        add an entry to conf/cli.xconf to exclude them from processing.
+        An FAQ describes the use of Cocoon's
+        <a href="faq.html#ignoring_javadocs">cli.xconf</a>
       </p>
     </section>