You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@myfaces.apache.org by sc...@apache.org on 2005/04/15 15:53:48 UTC

cvs commit: incubator-myfaces/src/documentation/content binary.cgi source.cgi

schof       2005/04/15 06:53:48

  Modified:    src/documentation/content/xdocs index.xml site.xml
  Added:       src/documentation/content/xdocs binary.ihtml source.ihtml
               src/documentation/conf cli.xconf
               src/documentation/content binary.cgi source.cgi
  Log:
  added mirror pages
  
  Revision  Changes    Path
  1.11      +6 -2      incubator-myfaces/src/documentation/content/xdocs/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/incubator-myfaces/src/documentation/content/xdocs/index.xml,v
  retrieving revision 1.10
  retrieving revision 1.11
  diff -u -r1.10 -r1.11
  --- index.xml	15 Apr 2005 13:01:17 -0000	1.10
  +++ index.xml	15 Apr 2005 13:53:48 -0000	1.11
  @@ -20,11 +20,15 @@
       </section>
   
       <section>
  -        <title>April 15, 2005 - MyFaces 1.0.9 has been released</title>
  +        <title>April 18, 2005 - MyFaces 1.0.9(m9) has been released</title>
           <p>
  -            MyFaces 1.0 milestone 9 (aka MyFaces 1.0.9) is now available <link href="downloads.html">here</link>.
  +            MyFaces 1.0.9(m9) is now available.  The (m9) stands for milestone 9.  The license agreement covering JSF and all other JCP based
  +            specifications require that we use this terminology and avoid the word "final."  Once MyFaces passes the TCK we will be able to
  +            refer to our releases as final.  This is one of the reasons why we initially pulled the release announcement from the website a
  +            few days ago.  But the release is official now and is available through your nearest Apache mirror.  Enjoy!
           </p>
       </section>
  +
       <section>
           <title>April 5, 2005 - MyFaces 1.0.9 RC3 now available</title>
           <p>
  
  
  
  1.16      +43 -37    incubator-myfaces/src/documentation/content/xdocs/site.xml
  
  Index: site.xml
  ===================================================================
  RCS file: /home/cvs/incubator-myfaces/src/documentation/content/xdocs/site.xml,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -r1.15 -r1.16
  --- site.xml	6 Apr 2005 22:52:02 -0000	1.15
  +++ site.xml	15 Apr 2005 13:53:48 -0000	1.16
  @@ -4,47 +4,53 @@
       <project-information href="" label="Project" tab="project">
           <index_pm href="index.html" label="Welcome"/>
   	    <license label="License" href="license.html" />
  -	    <downloads label="Downloads" href="downloads.html" />
  +
               <!--
               Commented out by schof. I think we should move this link to a different tab later.
   	    <livesites label="Web apps using MyFaces" href="livesites.html"/>
               -->
        </project-information>
  -	<components href="components/" label="Components" tab="components">
  -		<overview label="Overview" href="overview.html"/>
  -		<jscookmenu label="JSCook Menu" href="jscookmenu.html"/>
  -                <tree label="Tiles Support" href="tiles.html"/>
  -		<tree label="Tree2" href="tree2.html"/>
  -		<validateCreditCard label="validateCreditCard" href="validateCreditCard.html"/>
  -		<validateISBN label="validateISBN" href="validateISBN.html"/>
  -		<validateRegExpr label="validateRegExpr" href="validateRegExpr.html"/>
  -		<validateEmail label="validateEmail" href="validateEmail.html"/>
  -		<validateEqual label="validateEqual" href="validateEqual.html"/>
  -	</components>
  -	<docu href="docs/" label="Documentation" tab="documentation">
  -		<gettingstarted label="Getting Started" href="gettingstarted.html"/>
  -		<ri label="MyFaces and RI" href="risamples.html"/>
  -		<tomcat55 label="MyFaces and Tomcat5.5" href="tomcat55.html"/>
  -		<portlet label="MyFaces' Portlet Support" href="portlet.html"/>
  -		<extensionsFilter label="MyFaces' Extensions Filter" href="extensionsFilter.html"/>
  -		<compatibility label="Compatibility" href="compatibility.html"/>
  -		<faq label="FAQ" href="faq.html" />
  -		<jars label="JARs" href="jars.html" />
  -		<javadoc label="Java Doc" href="http://myfaces.apache.org/javadoc/" />
  -		<tlddoc label="Taglibs" href="http://myfaces.apache.org/tlddoc/" />
  -                <bootstrap label="Bootstrap" href="bootstrap.html" />
  -		<controlprogramming label="Homepage" href="sf.html" />
  -	</docu>
  -        <community href="community/" label="Community" tab="community">
  -            <mailinglists label="Mailing Lists" href="mailinglists.html" />
  -            <contributors label="Contributors" href="contributors.html" />
  -            <status label="Status" href="status.html" />
  -            <bylaws label="Project Bylaws" href="bylaws.html"/>
  -            <issue label="Bug Reporting" href="issue.html"/>
  -            <powered label="Powered by MyFaces" href="poweredbymyfaces.html"/>
  -            <cvs label="CVS" href="versioning.html"/>
  -            <wiki label="Wiki" href="http://wiki.apache.org/myfaces"/>
  -            <getinvolved label="Get Involved" href="http://jakarta.apache.org/site/getinvolved.html"/>
  -        </community>
  +     <downloads label="Downloads" tab="project">
  +         <bindownload label="Binary" href="http://myfaces.apache.org/binary.cgi"/>
  +         <bindownload_html href="binary.html"/><!-- so the page is part of a tab -->
  +         <srcdownload label="Source" href="http://myfaces.apache.org/src.cgi"/>
  +         <srcdownload_html href="source.html"/><!-- so the page is part of a tab -->
  +     </downloads>
  +     <components href="components/" label="Components" tab="components">
  +         <overview label="Overview" href="overview.html"/>
  +         <jscookmenu label="JSCook Menu" href="jscookmenu.html"/>
  +         <tree label="Tiles Support" href="tiles.html"/>
  +         <tree label="Tree2" href="tree2.html"/>
  +         <validateCreditCard label="validateCreditCard" href="validateCreditCard.html"/>
  +         <validateISBN label="validateISBN" href="validateISBN.html"/>
  +         <validateRegExpr label="validateRegExpr" href="validateRegExpr.html"/>
  +         <validateEmail label="validateEmail" href="validateEmail.html"/>
  +         <validateEqual label="validateEqual" href="validateEqual.html"/>
  +     </components>
  +     <docu href="docs/" label="Documentation" tab="documentation">
  +         <gettingstarted label="Getting Started" href="gettingstarted.html"/>
  +         <ri label="MyFaces and RI" href="risamples.html"/>
  +         <tomcat55 label="MyFaces and Tomcat5.5" href="tomcat55.html"/>
  +         <portlet label="MyFaces' Portlet Support" href="portlet.html"/>
  +         <extensionsFilter label="MyFaces' Extensions Filter" href="extensionsFilter.html"/>
  +         <compatibility label="Compatibility" href="compatibility.html"/>
  +         <faq label="FAQ" href="faq.html" />
  +         <jars label="JARs" href="jars.html" />
  +         <javadoc label="Java Doc" href="http://myfaces.apache.org/javadoc/" />
  +         <tlddoc label="Taglibs" href="http://myfaces.apache.org/tlddoc/" />
  +         <bootstrap label="Bootstrap" href="bootstrap.html" />
  +         <controlprogramming label="Homepage" href="sf.html" />
  +     </docu>
  +    <community href="community/" label="Community" tab="community">
  +        <mailinglists label="Mailing Lists" href="mailinglists.html" />
  +        <contributors label="Contributors" href="contributors.html" />
  +        <status label="Status" href="status.html" />
  +        <bylaws label="Project Bylaws" href="bylaws.html"/>
  +        <issue label="Bug Reporting" href="issue.html"/>
  +        <powered label="Powered by MyFaces" href="poweredbymyfaces.html"/>
  +        <cvs label="CVS" href="versioning.html"/>
  +        <wiki label="Wiki" href="http://wiki.apache.org/myfaces"/>
  +        <getinvolved label="Get Involved" href="http://jakarta.apache.org/site/getinvolved.html"/>
  +    </community>
   
   </site>
  
  
  
  1.1                  incubator-myfaces/src/documentation/content/xdocs/binary.ihtml
  
  Index: binary.ihtml
  ===================================================================
  <!--
    Copyright 2005 The Apache Software Foundation or its licensors,
    as applicable.
  
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at
  
        http://www.apache.org/licenses/LICENSE-2.0
  
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
  -->
  <!-- Note: To understand how this template is used, see the documentation
    at http://forrest.apache.org/howto/howto-asf-mirror.html
  -->
  <html>
    <head>
      <title>Obtain the Apache MyFaces distribution</title>
    </head>
    <body>
  <h1><a name="how" />How to download</h1>
  <p>Use the links below to download a distribution of Apache Forrest from
  one of our mirrors. It is good practice to
  <a href="[location]#verify">verify the integrity</a>
  of the distribution files.</p>
  
  <p>Apache MyFaces is distributed as a <code>zip</code> archive (for Windows) and
  as a <code>tar.gz</code> archive (for UNIX). The contents are the same. Please note
  that the tar.gz archives contain file names longer than 100 characters and have been
  created using GNU tar extensions. Thus they must be untarred with a GNU compatible
  version of tar.
  </p>
  
  <h1><a name="closest" />Current official release (closest mirror site selected automatically)</h1>
  
  <p>You are currently using <b>[preferred]</b>. If you encounter a
  problem with this mirror, then please select another.  If all
  mirrors are failing, there are backup mirrors at the end of the list.
  See <a href="http://www.apache.org/mirrors/">status</a> of mirrors.
  </p>
  
  <form action="[location]" method="get" id="SelectMirror">
  Other mirrors: <select name="Preferred">
  <!--[if-any http] [for http]-->
  <option value="[http]">[http]</option>
  <!--[end] [end]-->
  <!--[if-any ftp] [for ftp]-->
  <option value="[ftp]">[ftp]</option>
  <!--[end] [end]-->
  <!--[if-any backup] [for backup]-->
  <option value="[backup]">[backup] (backup)</option>
  <!--[end] [end]-->
  </select>
  <input type="submit" value="Change" />
  </form>
  
  <p>The current release is Apache MyFaces 1.0.9 (see the
  <a href="[preferred]/forrest/RELEASE-NOTES-0.6.txt">release notes</a>).</p>
  
  <ul>
      <li>For UNIX operating systems:</li>
      <ul>
          <li><a href="[preferred]/myfaces/myfaces-1.0.9.tgz">apache-forrest-0.6.tar.gz</a></li>
          <li>[<a href="http://www.apache.org/dist/myfaces/myfaces-1.0.9.tgz.asc">PGP</a>]</li>
          <li>[<a href="http://www.apache.org/dist/myfaces/myfaces-1.0.9.tgz.md5">MD5</a>]</li>
      </ul>
      <li>For Windows operating systems:</li>
      <ul>
          <li><a href="[preferred]/myfaces/myfaces-1.0.9.zip">myfaces-1.0.9.zip</a></li>
          <li>[<a href="http://www.apache.org/dist/myfaces/myfaces-1.0.9.zip.asc">PGP</a>]</li>
          <li>[<a href="http://www.apache.org/dist/myfaces/myfaces-1.0.9.zip.md5">MD5</a>]</li>
      </ul>
  </ul>
  
  <h1><a name="svn" />Snapshots of current development and head SVN repository</h1>
  
  <p>If you want to use the latest Apache MyFaces features, the source code is under
  version control with CVS (read how to
  <a href="build.html">obtain</a> your working copy). There are
  also
  <a href="http://svn.apache.org/snapshots/forrest/">nightly</a> builds available
  every 24 hours.
  </p>
  
  <h1><a name="archive" />Archive of old releases</h1>
  
  <p>Older releases are available in the <a
  href="http://archive.apache.org/dist/myfaces/">archive</a>.  Those
  releases are only provided as historical artefacts. We strongly
  recommend to not use those releases, but upgrade to the most recent release.
  </p>
  
  <h1><a name="verify" />Verify releases</h1>
  
  <p>It is essential that you verify the integrity of the downloaded
  files using the PGP and MD5 signatures.  MD5 verification ensures the
  file was not corrupted during the download process.  PGP verification
  ensures that the file came from a certain person.</p>
  
  <p>The PGP signatures can be verified using
  <a href="http://www.pgpi.org/">PGP</a> or
  <a href="http://www.gnupg.org/">GPG</a>.
  First download the Apache MyFaces
  <a href="http://cvs.apache.org/repos/asf/myfaces/KEYS">KEYS</a>
  as well as the <code>asc</code> signature file for the particular
  distribution. It is important that you get these files from the ultimate
  trusted source - the main ASF distribution site, rather than from a mirror.
  Then verify the signatures using ...</p>
  
  <pre>
  % pgpk -a KEYS
  % pgpv myfaces-X.Y.tgz.asc
  
  <em>or</em>
  
  % pgp -ka KEYS
  % pgp myfaces-X.Y.tgz.asc
  
  <em>or</em>
  
  % gpg --import KEYS
  % gpg --verify myfaces-X.Y.tgz.asc
  </pre>
  
  <p>To verify the MD5 signature on the files, you need to use a program
  called <code>md5</code> or <code>md5sum</code>, which is
  included in many unix distributions.  It is also available as part of
  <a href="http://www.gnu.org/software/textutils/textutils.html">GNU
  Textutils</a>.  Windows users can get binary md5 programs from <a
  href="http://www.fourmilab.ch/md5/">here</a>, <a
  href="http://www.pc-tools.net/win32/freeware/console/">here</a>, or
  <a href="http://www.slavasoft.com/fsum/">here</a>.</p>
  
  <p>We strongly recommend you verify your downloads with both PGP and MD5.</p>
  
  </body>
  </html>
  
  
  
  1.1                  incubator-myfaces/src/documentation/content/xdocs/source.ihtml
  
  Index: source.ihtml
  ===================================================================
  <!--
    Copyright 2005 The Apache Software Foundation or its licensors,
    as applicable.
  
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at
  
        http://www.apache.org/licenses/LICENSE-2.0
  
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
  -->
  <!-- Note: To understand how this template is used, see the documentation
    at http://forrest.apache.org/howto/howto-asf-mirror.html
  -->
  <html>
    <head>
      <title>Obtain the Apache MyFaces distribution</title>
    </head>
    <body>
  <h1><a name="how" />How to download</h1>
  <p>Use the links below to download a distribution of Apache Forrest from
  one of our mirrors. It is good practice to
  <a href="[location]#verify">verify the integrity</a>
  of the distribution files.</p>
  
  <p>Apache MyFaces is distributed as a <code>zip</code> archive (for Windows) and
  as a <code>tar.gz</code> archive (for UNIX). The contents are the same. Please note
  that the tar.gz archives contain file names longer than 100 characters and have been
  created using GNU tar extensions. Thus they must be untarred with a GNU compatible
  version of tar.
  </p>
  
  <h1><a name="closest" />Current official release (closest mirror site selected automatically)</h1>
  
  <p>You are currently using <b>[preferred]</b>. If you encounter a
  problem with this mirror, then please select another.  If all
  mirrors are failing, there are backup mirrors at the end of the list.
  See <a href="http://www.apache.org/mirrors/">status</a> of mirrors.
  </p>
  
  <form action="[location]" method="get" id="SelectMirror">
  Other mirrors: <select name="Preferred">
  <!--[if-any http] [for http]-->
  <option value="[http]">[http]</option>
  <!--[end] [end]-->
  <!--[if-any ftp] [for ftp]-->
  <option value="[ftp]">[ftp]</option>
  <!--[end] [end]-->
  <!--[if-any backup] [for backup]-->
  <option value="[backup]">[backup] (backup)</option>
  <!--[end] [end]-->
  </select>
  <input type="submit" value="Change" />
  </form>
  
  <p>The current release is Apache MyFaces 1.0.9 (see the
  <a href="[preferred]/forrest/RELEASE-NOTES-0.6.txt">release notes</a>).</p>
  
  <ul>
  <li>For UNIX operating systems:
  <a href="[preferred]/myfaces/myfaces-1.0.9.tgz">apache-forrest-0.6.tar.gz</a>
  [<a href="http://www.apache.org/dist/myfaces/myfaces-1.0.9.tgz.asc">PGP</a>]
  [<a href="http://www.apache.org/dist/myfaces/myfaces-1.0.9.tgz.md5">MD5</a>]</li>
  
  <li>For Windows operating systems:
  <a href="[preferred]/myfaces/myfaces-1.0.9.zip">myfaces-1.0.9.zip</a>
  [<a href="http://www.apache.org/dist/myfaces/myfaces-1.0.9.zip.asc">PGP</a>]
  [<a href="http://www.apache.org/dist/myfaces/myfaces-1.0.9.zip.md5">MD5</a>]</li>
  </ul>
  
  <h1><a name="svn" />Snapshots of current development and head SVN repository</h1>
  
  <p>If you want to use the latest Apache MyFaces features, the source code is under
  version control with CVS (read how to
  <a href="build.html">obtain</a> your working copy). There are
  also
  <a href="http://svn.apache.org/snapshots/forrest/">nightly</a> builds available
  every 24 hours.
  </p>
  
  <h1><a name="archive" />Archive of old releases</h1>
  
  <p>Older releases are available in the <a
  href="http://archive.apache.org/dist/myfaces/">archive</a>.  Those
  releases are only provided as historical artefacts. We strongly
  recommend to not use those releases, but upgrade to the most recent release.
  </p>
  
  <h1><a name="verify" />Verify releases</h1>
  
  <p>It is essential that you verify the integrity of the downloaded
  files using the PGP and MD5 signatures.  MD5 verification ensures the
  file was not corrupted during the download process.  PGP verification
  ensures that the file came from a certain person.</p>
  
  <p>The PGP signatures can be verified using
  <a href="http://www.pgpi.org/">PGP</a> or
  <a href="http://www.gnupg.org/">GPG</a>.
  First download the Apache MyFaces
  <a href="http://cvs.apache.org/repos/asf/myfaces/KEYS">KEYS</a>
  as well as the <code>asc</code> signature file for the particular
  distribution. It is important that you get these files from the ultimate
  trusted source - the main ASF distribution site, rather than from a mirror.
  Then verify the signatures using ...</p>
  
  <pre>
  % pgpk -a KEYS
  % pgpv myfaces-X.Y.tgz.asc
  
  <em>or</em>
  
  % pgp -ka KEYS
  % pgp myfaces-X.Y.tgz.asc
  
  <em>or</em>
  
  % gpg --import KEYS
  % gpg --verify myfaces-X.Y.tgz.asc
  </pre>
  
  <p>To verify the MD5 signature on the files, you need to use a program
  called <code>md5</code> or <code>md5sum</code>, which is
  included in many unix distributions.  It is also available as part of
  <a href="http://www.gnu.org/software/textutils/textutils.html">GNU
  Textutils</a>.  Windows users can get binary md5 programs from <a
  href="http://www.fourmilab.ch/md5/">here</a>, <a
  href="http://www.pc-tools.net/win32/freeware/console/">here</a>, or
  <a href="http://www.slavasoft.com/fsum/">here</a>.</p>
  
  <p>We strongly recommend you verify your downloads with both PGP and MD5.</p>
  
  </body>
  </html>
  
  
  
  1.1                  incubator-myfaces/src/documentation/conf/cli.xconf
  
  Index: cli.xconf
  ===================================================================
  <?xml version="1.0"?>
  <!--
    Copyright 2002-2004 The Apache Software Foundation
  
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at
  
        http://www.apache.org/licenses/LICENSE-2.0
  
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
  -->
  <!--+
      |  This is the Apache Cocoon command line configuration file. 
      |  Here you give the command line interface details of where
      |  to find various aspects of your Cocoon installation.
      |
      |  If you wish, you can also use this file to specify the URIs
      |  that you wish to generate.
      |
      |  The current configuration information in this file is for
      |  building the Cocoon documentation. Therefore, all links here 
      |  are relative to the build context dir, which, in the build.xml 
      |  file, is set to ${build.context} 
      |
      |  Options:
      |    verbose:            increase amount of information presented
      |                        to standard output (default: false)
      |    follow-links:       whether linked pages should also be 
      |                        generated (default: true)
      |    precompile-only:    precompile sitemaps and XSP pages, but 
      |                        do not generate any pages (default: false)
      |    confirm-extensions: check the mime type for the generated page
      |                        and adjust filename and links extensions
      |                        to match the mime type 
      |                        (e.g. text/html->.html)
      |
      |  Note: Whilst using an xconf file to configure the Cocoon 
      |        Command Line gives access to more features, the use of 
      |        command line parameters is more stable, as there are 
      |        currently plans to improve the xconf format to allow 
      |        greater flexibility. If you require a stable and
      |        consistent method for accessing the CLI, it is recommended 
      |        that you use the command line parameters to configure 
      |        the CLI. See documentation at:
      |        /userdocs/offline/index.html and Wiki:CommandLine
      |
      +-->
      
  <cocoon verbose="true"  
          follow-links="true" 
          precompile-only="false" 
          confirm-extensions="false">
  
     <!--+
         |  The context directory is usually the webapp directory
         |  containing the sitemap.xmap file.
         |
         |  The config file is the cocoon.xconf file.
         |
         |  The work directory is used by Cocoon to store temporary
         |  files and cache files.
         |
         |  The destination directory is where generated pages will
         |  be written (assuming the 'simple' mapper is used, see 
         |  below)
         +-->
     <context-dir>.</context-dir>
     <config-file>WEB-INF/cocoon.xconf</config-file>
     <work-dir>../tmp/cocoon-work</work-dir>
     <dest-dir>../site</dest-dir>
     
     <!--+
         |  A checksum file can be used to store checksums for pages
         |  as they are generated. When the site is next generated, 
         |  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.
         +-->
     <!--   <checksums-uri>build/work/checksums</checksums-uri>-->
  
     <!--+
         | Broken link reporting options:
         |   Report into a text file, one link per line:
         |     <broken-links type="text" report="filename"/>
         |   Report into an XML file:
         |     <broken-links type="xml" report="filename"/>
         |   Ignore broken links (default):
         |     <broken-links type="none"/>
         |
         |   Two attributes to this node specify whether a page should
         |   be generated when an error has occured. 'generate' specifies 
         |   whether a page should be generated (default: true) and
         |   extension specifies an extension that should be appended
         |   to the generated page's filename (default: none)
         |
         |   Using this, a quick scan through the destination directory
         |   will show broken links, by their filename extension.
         +-->
     <broken-links type="xml" 
                   file="../brokenlinks.xml"
                   generate="false"
                   extension=".error"/>
     
     <!--+
         |  Load classes at startup. This is necessary for generating
         |  from sites that use SQL databases and JDBC.
         |  The <load-class> element can be repeated if multiple classes
         |  are needed.
         +-->
     <!--
     <load-class>org.firebirdsql.jdbc.Driver</load-class>
     -->
  
     <!--+
         |  Configures logging. 
         |  The 'log-kit' parameter specifies the location of the log kit 
         |  configuration file (usually called logkit.xconf. 
         | 
         |  Logger specifies the logging category (for all logging prior 
         |  to other Cocoon logging categories taking over)
         |
         |  Available log levels are:
         |    DEBUG:        prints all level of log messages.
         |    INFO:         prints all level of log messages except DEBUG 
         |                  ones.
         |    WARN:         prints all level of log messages except DEBUG 
         |                  and INFO ones.
         |    ERROR:        prints all level of log messages except DEBUG, 
         |                  INFO and WARN ones.
         |    FATAL_ERROR:  prints only log messages of this level
         +-->
     <!-- <logging log-kit="WEB-INF/logkit.xconf" logger="cli" level="ERROR" /> -->
  
     <!--+
         |  Specifies the filename to be appended to URIs that
         |  refer to a directory (i.e. end with a forward slash).
         +-->
     <default-filename>index.html</default-filename>
  
     <!--+
         |  Specifies a user agent string to the sitemap when
         |  generating the site.
         |
         |  A generic term for a web browser is "user agent". Any 
         |  user agent, when connecting to a web server, will provide
         |  a string to identify itself (e.g. as Internet Explorer or
         |  Mozilla). It is possible to have Cocoon serve different
         |  content depending upon the user agent string provided by
         |  the browser. If your site does this, then you may want to
         |  use this <user-agent> entry to provide a 'fake' user agent
         |  to Cocoon, so that it generates the correct version of your
         |  site.
         | 
         |  For most sites, this can be ignored.
         +-->
     <!--
     <user-agent>Cocoon Command Line Environment 2.1</user-agent>
     -->
  
     <!--+
         |  Specifies an accept string to the sitemap when generating
         |  the site.
         |  User agents can specify to an HTTP server what types of content
         |  (by mime-type) they are able to receive. E.g. a browser may be 
         |  able to handle jpegs, but not pngs. The HTTP accept header 
         |  allows the server to take the browser's capabilities into account,
         |  and only send back content that it can handle.
         |
         |  For most sites, this can be ignored.
         +-->
  
     <accept>*/*</accept>
     
     <!--+
         | Specifies which URIs should be included or excluded, according
         | to wildcard patterns. 
         | 
         | These includes/excludes are only relevant when you are following
         | links. A link URI must match an include pattern (if one is given) 
         | and not match an exclude pattern, if it is to be followed by
         | Cocoon. It can be useful, for example, where there are links in
         | your site to pages that are not generated by Cocoon, such as 
         | references to api-documentation.
         | 
         | By default, all URIs are included. If both include and exclude
         | patterns are specified, a URI is first checked against the 
         | include patterns, and then against the exclude patterns.
         | 
         | Multiple patterns can be given, using muliple include or exclude
         | nodes. 
         | 
         | The order of the elements is not significant, as only the first 
         | successful match of each category is used.
         | 
         | Currently, only the complete source URI can be matched (including
         | any URI prefix). Future plans include destination URI matching 
         | and regexp matching. If you have requirements for these, contact
         | dev@cocoon.apache.org.
         +-->
  
     <exclude pattern="**/"/>
     <exclude pattern="**apidocs**"/>
     <exclude pattern="api/**"/>
     
     <exclude pattern="site:**"/>
     <exclude pattern="ext:**"/>
        
     <!-- Exclude tokens used in URLs to ASF mirrors (interpreted by a CGI) -->
     <exclude pattern="[preferred]/**"/>
     <exclude pattern="[location]"/>
     
     <!--   <include-links extension=".html"/>-->
     
     <!--+
         |  <uri> nodes specify the URIs that should be generated, and 
         |  where required, what should be done with the generated pages.
         |  They describe the way the URI of the generated file is created
         |  from the source page's URI. There are three ways that a generated
         |  file URI can be created: append, replace and insert.
         |
         |  The "type" attribute specifies one of (append|replace|insert):
         |
         |  append:
         |  Append the generated page's URI to the end of the source URI:
         |
         |   <uri type="append" src-prefix="documents/" src="index.html"
         |   dest="build/dest/"/>
         |
         |  This means that 
         |   (1) the "documents/index.html" page is generated
         |   (2) the file will be written to "build/dest/documents/index.html"
         |
         |  replace:
         |  Completely ignore the generated page's URI - just 
         |  use the destination URI:
         |
         |   <uri type="replace" src-prefix="documents/" src="index.html" 
         |   dest="build/dest/docs.html"/>
         |  
         |  This means that 
         |   (1) the "documents/index.html" page is generated
         |   (2) the result is written to "build/dest/docs.html"
         |   (3) this works only for "single" pages - and not when links
         |       are followed
         |
         |  insert:
         |  Insert generated page's URI into the destination 
         |  URI at the point marked with a * (example uses fictional 
         |  zip protocol)
         |
         |   <uri type="insert" src-prefix="documents/" src="index.html" 
         |   dest="zip://*.zip/page.html"/>
         |
         |  This means that 
         |   (1)
         |
         |  In any of these scenarios, if the dest attribute is omitted,
         |  the value provided globally using the <dest-dir> node will 
         |  be used instead.
         +-->
     <!--
     <uri type="replace" 
          src-prefix="samples/" 
          src="hello-world/hello.html"
          dest="build/dest/hello-world.html"/>
     -->
  
     <!--+
         | <uri> nodes can be grouped together in a <uris> node. This 
         | enables a group of URIs to share properties. The following
         | properties can be set for a group of URIs:
         |   * follow-links:       should pages be crawled for links
         |   * confirm-extensions: should file extensions be checked
         |                         for the correct mime type
         |   * src-prefix:         all source URIs should be 
         |                         pre-pended with this prefix before
         |                         generation. The prefix is not 
         |                         included when calculating the 
         |                         destination URI
         |   * dest:               the base destination URI to be
         |                         shared by all pages in this group
         |   * type:               the method to be used to calculate
         |                         the destination URI. See above 
         |                         section on <uri> node for details.
         | 
         | Each <uris> node can have a name attribute. When a name
         | attribute has been specified, the -n switch on the command
         | line can be used to tell Cocoon to only process the URIs
         | within this URI group. When no -n switch is given, all 
         | <uris> nodes are processed. Thus, one xconf file can be 
         | used to manage multiple sites.
         +-->
  
     <uris name="binary" follow-links="false">
       <uri type="append" src="binary.html"/>
     </uris>
     <uris name="source" follow-links="false">
       <uri type="append" src="source.html"/>
     </uris>
  
     <!--+
         |  File containing URIs (plain text, one per line).
         +-->
     <!--
     <uri-file>uris.txt</uri-file>
     -->
  </cocoon>
  
  
  
  1.1                  incubator-myfaces/src/documentation/content/binary.cgi
  
  Index: binary.cgi
  ===================================================================
  #!/bin/sh
  
  # Copyright 2002-2004 The Apache Software Foundation or its licensors,
  # as applicable.
  #
  # Licensed under the Apache License, Version 2.0 (the "License");
  # you may not use this file except in compliance with the License.
  # You may obtain a copy of the License at
  #
  #     http://www.apache.org/licenses/LICENSE-2.0
  #
  # Unless required by applicable law or agreed to in writing, software
  # distributed under the License is distributed on an "AS IS" BASIS,
  # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  # See the License for the specific language governing permissions and
  # limitations under the License.
  
  # Wrapper script around mirrors.cgi script
  # (we must change to that directory in order for python to pick up the
  #  python includes correctly)
  # Copied from Stefan's http://www.apache.org/~bodewig/mirror.html
  cd /www/www.apache.org/dyn/mirrors 
  /www/www.apache.org/dyn/mirrors/mirrors.cgi $*
  
  
  
  1.1                  incubator-myfaces/src/documentation/content/source.cgi
  
  Index: source.cgi
  ===================================================================
  #!/bin/sh
  
  # Copyright 2002-2004 The Apache Software Foundation or its licensors,
  # as applicable.
  #
  # Licensed under the Apache License, Version 2.0 (the "License");
  # you may not use this file except in compliance with the License.
  # You may obtain a copy of the License at
  #
  #     http://www.apache.org/licenses/LICENSE-2.0
  #
  # Unless required by applicable law or agreed to in writing, software
  # distributed under the License is distributed on an "AS IS" BASIS,
  # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  # See the License for the specific language governing permissions and
  # limitations under the License.
  
  # Wrapper script around mirrors.cgi script
  # (we must change to that directory in order for python to pick up the
  #  python includes correctly)
  # Copied from Stefan's http://www.apache.org/~bodewig/mirror.html
  cd /www/www.apache.org/dyn/mirrors 
  /www/www.apache.org/dyn/mirrors/mirrors.cgi $*