Author: niclas
Date: Mon May 31 08:10:11 2004
New Revision: 20690

Modified:
   avalon/trunk/central/site/src/xdocs/central/download.xml
   
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/artifact/properties.xml
   
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/prepare/index.xml
   
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/prepare/methods.xml
   
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/prepare/properties.xml
   
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/xdoc/index.xml
   
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/xdoc/methods.xml
   
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/xdoc/properties.xml
Log:
download.cgi wasn't handled properly.

Modified: avalon/trunk/central/site/src/xdocs/central/download.xml
==============================================================================
--- avalon/trunk/central/site/src/xdocs/central/download.xml    (original)
+++ avalon/trunk/central/site/src/xdocs/central/download.xml    Mon May 31 
08:10:11 2004
@@ -116,13 +116,13 @@
           <tr>
             <td><a href="/logkit/">Avalon-Logkit</a></td>
             <td><a href="[preferred]/avalon/logkit/binaries">binaries</a></td>
-            <td><a href="[preferred]/avalon/logkit/source">broswe</a></td>
+            <td><a href="[preferred]/avalon/logkit/source">browse</a></td>
             <td><a href="[preferred]/avalon/logkit/jars">jars</a></td>
           </tr>
           <tr>
             <td><a href="/merlin/">Avalon-Merlin</a></td>
             <td><a href="[preferred]/avalon/merlin/binaries">binaries</a></td>
-            <td><a href="[preferred]/avalon/merlin/source">broswe</a></td>
+            <td><a href="[preferred]/avalon/merlin/source">browse</a></td>
             <td><a href="[preferred]/avalon/merlin/jars">jars</a></td>
           </tr>
         </table>
@@ -140,13 +140,13 @@
           <tr>
             <td><a href="/excalibur/fortress/">Avalon-Fortress</a></td>
             <td><a 
href="[preferred]/avalon/avalon-fortress/binaries">binaries</a></td>
-            <td><a 
href="[preferred]/avalon/avalon-fortress/source">broswe</a></td>
+            <td><a 
href="[preferred]/avalon/avalon-fortress/source">browse</a></td>
             <td><a href="[preferred]/avalon/avalon-fortress/jars">jars</a></td>
           </tr>
           <tr>
             <td><a href="/phoenix/">Avalon-Phoenix</a></td>
             <td><a href="[preferred]/avalon/phoenix/binaries">binaries</a></td>
-            <td><a href="[preferred]/avalon/phoenix/source">broswe</a></td>
+            <td><a href="[preferred]/avalon/phoenix/source">browse</a></td>
             <td><a href="[preferred]/avalon/phoenix/jars">jars</a></td>
           </tr>
         </table>

Modified: 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/artifact/properties.xml
==============================================================================
--- 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/artifact/properties.xml
        (original)
+++ 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/artifact/properties.xml
        Mon May 31 08:10:11 2004
@@ -45,6 +45,8 @@
             ${user.home}/.maven/repository
           </td>
           <td>
+            The local repository where artifacts will be downloaded to, and
+            included from in builds.
           </td>
         </tr>
         <tr>
@@ -55,6 +57,7 @@
             http://www.ibiblio.org/maven
           </td>
           <td>
+            The remote repository where the artifact will be downloaded from.
           </td>
         </tr>
       </table>

Modified: 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/prepare/index.xml
==============================================================================
--- 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/prepare/index.xml
      (original)
+++ 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/prepare/index.xml
      Mon May 31 08:10:11 2004
@@ -23,13 +23,17 @@
 
   <properties>
     <author email="[EMAIL PROTECTED]">Niclas Hedhman</author>
-    <title>Magic Prepare Plugin</title>
+    <title>Avalon Magic</title>
   </properties>
 
   <body>
 
     <section name="About Prepare Plugin">
       <p>
+        The Prepare Plugin is a plugin shared by most other plugins. It will
+        copy the sources, with and without filtering, from the source 
+        directories, to the build directories. The plugin also establishes
+        a couple of global properties that many other plugins utilizes.
       </p>
     </section>
   </body>

Modified: 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/prepare/methods.xml
==============================================================================
--- 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/prepare/methods.xml
    (original)
+++ 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/prepare/methods.xml
    Mon May 31 08:10:11 2004
@@ -23,12 +23,12 @@
 
   <properties>
     <author email="[EMAIL PROTECTED]">Niclas Hedhman</author>
-    <title>Magic Prepare Plugin</title>
+    <title>Avalon Magic</title>
   </properties>
 
   <body>
 
-    <section name="Magic Prepare Plugin - Methods">
+    <section name="Prepare Plugin - Methods">
       <p>
         It is not meant for humans to directly invoke the Prepare plugin,
         but for other plugins to request its service.

Modified: 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/prepare/properties.xml
==============================================================================
--- 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/prepare/properties.xml
 (original)
+++ 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/prepare/properties.xml
 Mon May 31 08:10:11 2004
@@ -23,7 +23,7 @@
 
   <properties>
     <author email="[EMAIL PROTECTED]">Niclas Hedhman</author>
-    <title>Magic Prepare Plugin</title>
+    <title>Avalon Magic</title>
   </properties>
 
   <body>
@@ -45,6 +45,9 @@
             src/
           </td>
           <td>
+            The source directories. The <code>init</code> method will copy all
+            the content from these directories to the ${prepare.build.src.dir}
+            with and without filtering enabled, depending on file type.
           </td>
         </tr>
         <tr>
@@ -55,6 +58,7 @@
             target/
           </td>
           <td>
+            The top destination directory for all build outputs.
           </td>
         </tr>
         <tr>
@@ -65,6 +69,10 @@
             ${prepare.dest.dir}/src/
           </td>
           <td>
+            This is the directory where the sources will be copied to before
+            processed. The copy procedure allows for filtering, where the
+            content of the source files have 'tags' in them that will be
+            replaced by build-time information.
           </td>
         </tr>
         <tr>
@@ -75,6 +83,13 @@
             **/*.xml, **/*.java, **/*.html, **/*.sh, **/*.bat, **/*.prop*
           </td>
           <td>
+            A comma-separated list of files that will be filtered. All other
+            files copied will be copied without filtering enabled. All 
+            properties will be converted from their typical lower-case format
+            to an upper-case equivalent, and any properties surrounded by the @
+            character is a tag, that will be replaced by its build value. For
+            instance, @PREPARE.DEST.DIR@ will be replaced by the value of the
+            ${prepare.dest.dir} property, default "target/".
           </td>
         </tr>
       </table>

Modified: 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/xdoc/index.xml
==============================================================================
--- 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/xdoc/index.xml
 (original)
+++ 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/xdoc/index.xml
 Mon May 31 08:10:11 2004
@@ -23,22 +23,21 @@
 
   <properties>
     <author email="[EMAIL PROTECTED]">Niclas Hedhman</author>
-    <category>Merlin Magic - XDoc Plugin</category>
-    <title>Merlin Magic - XDoc Plugin</title>
+    <title>Avalon Magic</title>
   </properties>
 
   <body>
 
-    <section name="About Merlin Magic XDoc Plugin">
-      <p>
-Welcome to the Merlin Magic XDoc Plugin. 
-      </p>
+    <section name="About XDoc Plugin">
       <p>
         The XDoc Plugin allows you to create the project documentation using
         XML, in the so called Anakia format, and automatically generate the
         look from a <em>theme</em>. A <em>theme</em> is a predefined XSLT
         template that the XDoc Plugin will use to generate the HTML and PDF
-        (optional) outputs.
+        (future) outputs.
+      </p>
+      <p>
+        The theme must be located in the ${project.system}/theme directory.
       </p>
     </section>
   </body>

Modified: 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/xdoc/methods.xml
==============================================================================
--- 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/xdoc/methods.xml
       (original)
+++ 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/xdoc/methods.xml
       Mon May 31 08:10:11 2004
@@ -23,12 +23,12 @@
 
   <properties>
     <author email="[EMAIL PROTECTED]">Niclas Hedhman</author>
-    <title>Merlin Magic - XDoc Plugin</title>
+    <title>Avalon Magic</title>
   </properties>
 
   <body>
 
-    <section name="Merlin Magic XDoc Plugin - Methods">
+    <section name="XDoc Plugin - Methods">
       <p>
         The following methods has been defined in the XDoc Plugin.
       </p>
@@ -47,7 +47,7 @@
           </td>
           <td>
             The <strong>generate</strong> method generates the documentation
-            from residing in the xdoc.src.dir directory. 
+            from residing in the ${xdoc.src.dir} directory. 
           </td>
         </tr>
       </table>

Modified: 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/xdoc/properties.xml
==============================================================================
--- 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/xdoc/properties.xml
    (original)
+++ 
avalon/trunk/central/site/src/xdocs/central/laboratory/magic/plugins/xdoc/properties.xml
    Mon May 31 08:10:11 2004
@@ -23,11 +23,11 @@
 
   <properties>
     <author email="[EMAIL PROTECTED]">Niclas Hedhman</author>
-    <title>Merlin Magic - XDoc Plugin</title>
+    <title>Avalon Magic</title>
   </properties>
 
   <body>
-    <section name="Merlin Magic XDoc Plugin - Properties">
+    <section name="XDoc Plugin - Properties">
       <p>
         The following properties are used by the XDoc Plugin. 
       </p>
@@ -45,6 +45,22 @@
             src/xdocs
           </td>
           <td>
+            The source directory where the XDoc documents are expected to be
+            found.
+          </td>
+        </tr>
+        <tr>
+          <td>
+            xdoc.build.src.dir
+           </td>
+          <td>
+            target/src/xdocs
+          </td>
+          <td>
+            The directory where the source documents will be copied before
+            processed. This directory structure is also where the navigation
+            aggregation will occur, and the intermediary files can be found
+            here.
           </td>
         </tr>
         <tr>
@@ -55,6 +71,7 @@
             target/docs
           </td>
           <td>
+            The output directory where the generated files will be stored.
           </td>
         </tr>
         <tr>
@@ -62,12 +79,196 @@
             xdoc.theme.name
            </td>
           <td>
-            merlin
+            avalon2
+          </td>
+          <td>
+            Name of the theme to use. The themes must located in 
+            ${project.system}/themes.
+          </td>
+        </tr>
+        <tr>
+          <td>
+            xdoc.resources.dir
+           </td>
+          <td>
+            src/resources/
+          </td>
+          <td>
+            The directory where other resources are stored. These resources
+            will be copied into the destination directory ${xdoc.dest.dir}.
+          </td>
+        </tr>
+        <tr>
+          <td>
+            xdoc.output.format
+           </td>
+          <td>
+            html
+          </td>
+          <td>
+            The output format of the generated content. Only 'html' is 
supported
+            at the moment.
+          </td>
+        </tr>
+        <tr>
+          <td>
+            xdoc.fail.on.error
+          </td>
+          <td>
+            true 
+          </td>
+          <td>
+            If "true", the generation will halt when an error of any kind has
+            occurred. If not "true", then generation will continue.
+          </td>
+        </tr>
+        <tr>
+          <td>
+            xdoc.print.stack.trace
+          </td>
+          <td>
+            true
           </td>
           <td>
+            If "true" a stack trace will be printed out if an error occurs.
+            If not "true", then only the message of the exception will be 
+            printed.
+          </td>
+        </tr>
+        <tr>
+          <td>
+            xdoc.public.root.xdocs
+          </td>
+          <td>
+            
https://svn.apache.org/repos/asf/avalon/trunk/central/site/src/xdocs
+          </td>
+          <td>
+            This is the 'anchor' of the source documents root, which is used 
for
+            the source icon, where one can easily retrieve the xml source.
+          </td>
+        </tr>
+        <tr>
+          <td>
+            xdoc.footer.copyright.text
+          </td>
+          <td>
+            Copyright ${magic.year}, The Apache Software Foundation. All 
rights reserved.
+          </td>
+          <td>
+            Text of the footer to be generated on each page.
+          </td>
+        </tr>
+        <tr>
+          <td>
+            xdoc.footer.copyright.url
+          </td>
+          <td>
+            http://www.apache.org/
+          </td>
+          <td>
+            If this property is not an empty string a link will be created 
around
+            the copyright notice. I.e. &lt;a 
href="${xdoc.footer.copyright.url}"&gt;
+            ${xdoc.footer.copyright.text}&lt;/a&gt;.
+          </td>
+        </tr>
+        <tr>
+          <td>
+            xdoc.logo.left.file
+          </td>
+          <td>
+            images/feather.jpg
+          </td>
+          <td>
+            The image name of the logo that will be generated in the top-left 
+            corner of the page.
+          </td>
+        </tr>
+        <tr>
+          <td>
+            xdoc.logo.left.url
+          </td>
+          <td>
+            &lt;empty string&gt;
+          </td>
+          <td>
+            If this property is not an empty string, the top-left image will be
+            link to this URL. I.e.
+            &lt;a href="${xdoc.footer.copyright.url}"&gt;
+            &lt;img src="${xdoc.logo.left.file}" /&gt;
+            &lt;/a&gt;.
+          </td>
+        </tr>
+        <tr>
+          <td>
+            xdoc.logo.right.file = 
+          </td>
+          <td>
+           &lt;empty string&gt;
+          </td>
+            The image name of the logo that will be generated in the top-right 
+            corner of the page.
+          <td>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            xdoc.logo.right.url
+          </td>
+          <td>
+            &lt;empty string&gt;
+          </td>
+          <td>
+            If this property is not an empty string, the top-right image will 
be
+            link to this URL. I.e.
+            &lt;a href="${xdoc.footer.copyright.url}"&gt;
+            &lt;img src="${xdoc.logo.right.file}" /&gt;
+            &lt;/a&gt;.
+          </td>
+        </tr>
+        <tr>
+          <td>
+            xdoc.logo.middle.file = 
+          </td>
+          <td>
+            &lt;empty string&gt;
+          </td>
+          <td>
+            The image name of the logo that will be generated in the top-middle
+            corner of the page.
+          </td>
+        </tr>
+        <tr>
+          <td>
+            xdoc.logo.middle.url = 
+          </td>
+          <td>
+            &lt;empty string&gt;
+          </td>
+          <td>
+            If this property is not an empty string, the top-middle image will 
be
+            link to this URL. I.e.
+            &lt;a href="${xdoc.footer.copyright.url}"&gt;
+            &lt;img src="${xdoc.logo.middle.file}" /&gt;
+            &lt;/a&gt;.
+          </td>
+        </tr>
+        <tr>
+          <td>
+            xdoc.brand.name
+          </td>
+          <td>
+            Apache Avalon
+          </td>
+          <td>
+            This is the "brand name" to be generated in the middle section of
+            the top panel, above the document title.
           </td>
         </tr>
       </table>
     </section>
   </body>
 </document>
+
+ 
+
+

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to