Author: mcconnell Date: Mon May 31 10:18:40 2004 New Revision: 20698 Added: avalon/trunk/central/site/src/xdocs/central/about/ avalon/trunk/central/site/src/xdocs/central/about/download.xml avalon/trunk/central/site/src/xdocs/central/about/index.xml avalon/trunk/central/site/src/xdocs/central/about/navigation.xml avalon/trunk/central/site/src/xdocs/central/about/resources/ avalon/trunk/central/site/src/xdocs/central/about/resources/cvs.xml avalon/trunk/central/site/src/xdocs/central/about/resources/index.xml avalon/trunk/central/site/src/xdocs/central/about/resources/navigation.xml avalon/trunk/central/site/src/xdocs/central/about/resources/subversion.xml Modified: avalon/trunk/central/site/src/xdocs/central/developers/navigation.xml avalon/trunk/central/site/src/xdocs/central/index.xml avalon/trunk/central/site/src/xdocs/central/navigation.xml Log:
Added: avalon/trunk/central/site/src/xdocs/central/about/download.xml ============================================================================== --- (empty file) +++ avalon/trunk/central/site/src/xdocs/central/about/download.xml Mon May 31 10:18:40 2004 @@ -0,0 +1,192 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + Copyright 2004 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. +--> + +<document> + <properties> + <author email="dev@avalon.apache.org">Avalon Documentation Team</author> + <title>Apache Avalon: Products</title> + </properties> + + <body> + <section name="Avalon Download Site"> + <p> + Use the links below to download a binary distribution of + Avalon from one of our mirrors. It's a good idea to + <a href="[location]#Verify Releases">verify the integrity</a> + of the downloaded files using signatures downloaded from our + main distribution directory. + </p> + + <p> + Avalon is distributed as <code>zip</code> and <code>tar.gz</code> + archives - the contents are the same. Please note that the <code>tar.gz</code> + archives contain file names longer than 100 characters and have been + created using GNU tar extensions. They must be untarred with a GNU + compatible version of <code>tar</code>. + </p> + + <p> + If you do not see the file you need in the links below, please + see the <a href="http://www.apache.org/dist/avalon/";>master + distribution directory</a> or, preferably, its + <a href="[preferred]/avalon/">mirror</a>. + </p> + + <a name="Mirror"></a> + <subsection name="Mirror" > + <p> + You are currently using the <strong>[preferred]</strong>. + If you encounter a problem with this mirror, please select another + mirror. If all mirrors are failing, there are <em>backup</em> + mirrors (at the end of the mirrors list) that should be available. + </p> + + <form action="[location]" method="get" id="SelectMirror"> +<p>Other mirrors: </p><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> + + </subsection> + + <a name="License"></a> + <subsection name="License" > + <p> + All avalon products are distributed under the terms of The Apache + Software License (version 2.0). See our + <a href="/license.html">License</a> page, or the LICENSE.txt + files included in each distribution. + </p> + </subsection> + + <a name="Downloads"></a> + <subsection name="Product Downloads" > + <p> + Here's a list of the most commonly requested distributions. You can + <a href="[preferred]/avalon/">browse</a> the repository for a full + range of our various distributions, including older versions. + </p> + <p> + Please note: we're still filling up this list; its incomplete + at the moment. + </p> + </subsection> + + <a name="Products"></a> + <subsection name="Products" > + <!-- lets maintain alphabetical order, peeps! --> + <table > + <tr> + <th>Product</th> + <th>Binary</th> + <th>Source</th> + <th>Jars</th> + </tr> + <tr> + <td><a href="/framework/">Avalon-Framework</a></td> + <td><a href="[preferred]/avalon/framework/binaries">binaries</a></td> + <td><a href="[preferred]/avalon/framework/source">source</a></td> + <td><a href="[preferred]/avalon/framework/jars">jars</a></td> + </tr> + <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">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">browse</a></td> + <td><a href="[preferred]/avalon/merlin/jars">jars</a></td> + </tr> + </table> + </subsection> + + <a name="Legacy"></a> + <subsection name="Legacy Material" > + <table border="1" width="100%" cellspacing="2" cellpadding="3"> + <tr> + <th>Product</th> + <th>Binary</th> + <th>Source</th> + <th>Jars</th> + </tr> + <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">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">browse</a></td> + <td><a href="[preferred]/avalon/phoenix/jars">jars</a></td> + </tr> + </table> + </subsection> + + <a name="Verify Releases"></a> + <subsection name="Verify Releases" > + <p> + It is essential that you verify the integrity of the downloaded + files using the PGP or MD5 signatures. + </p> + <p> + The PGP signatures can be verified using PGP or GPG. First + download the <a href="http://www.apache.org/dist/avalon/KEYS";>KEYS</a> + as well as the <code>asc</code> signature file for the particular + distribution. Make sure you get these files from the + <a href="http://www.apache.org/dist/avalon/";>main distribution + directory</a>, rather than from a mirror. Then verify the signatures + using + </p> + <source> +% pgpk -a KEYS +% pgpv name-of-distributed-file.tar.gz.asc +</source> + <p> + <strong><em>or</em></strong> + </p> + <source> +% pgp -ka KEYS +% pgp name-of-distributed-file.tar.gz.asc +</source> + <p> + <strong><em>or</em></strong> + </p> + <source> +% gpg --import KEYS<br /> +% gpg --verify name-of-distributed-file.tar.gz.asc +</source> + </subsection> + </section> + </body> +</document> + Added: avalon/trunk/central/site/src/xdocs/central/about/index.xml ============================================================================== --- (empty file) +++ avalon/trunk/central/site/src/xdocs/central/about/index.xml Mon May 31 10:18:40 2004 @@ -0,0 +1,21 @@ +<?xml version="1.0" encoding="UTF-8"?> +<document> + <properties> + <author email="dev@avalon.apache.org">Avalon Documentation Team</author> + <title>Avalon Central</title> + </properties> + + <body> + <section name="Welcome to Avalon Central"> + <p> + Avalon Central is the place you can find + <a href="download.cgi">downloads</a>, information + about the <a href="../community/people/index.html">people</a> + who make up this community, + together with the latest <a href="../news/index.html">news</a> and + events. + </p> + </section> + </body> +</document> + Added: avalon/trunk/central/site/src/xdocs/central/about/navigation.xml ============================================================================== --- (empty file) +++ avalon/trunk/central/site/src/xdocs/central/about/navigation.xml Mon May 31 10:18:40 2004 @@ -0,0 +1,31 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + Copyright 2004 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. +--> + +<project> + + <title>Apache Avalon Central</title> + + <body> + <menu> + <item name="Downloads" href="download.cgi"/> + <item name="Resources" href="resources/index.html"/> + </menu> + </body> + +</project> Added: avalon/trunk/central/site/src/xdocs/central/about/resources/cvs.xml ============================================================================== --- (empty file) +++ avalon/trunk/central/site/src/xdocs/central/about/resources/cvs.xml Mon May 31 10:18:40 2004 @@ -0,0 +1,200 @@ +<?xml version="1.0" encoding="UTF-8"?> +<document> + <properties> + <author email="dev@avalon.apache.org">Avalon Documentation Team</author> + <title>CVS</title> + </properties> + + +<body> + +<!-- +<section name="Bleeding-edge only"> + <p>If you are looking to download the source code for stable versions of the Avalon + projects, you're in the wrong place. You should download a source release from + <a href="http://avalon.apache.org/srcdownload.cgi";>the source download page</a>.</p> +</section> +--> +<section name="About CVS"> + <p>CVS, the Concurrent Versions System is a revision control system useful for + management of source code, and is the predominant version control system used at + Apache. See <a href="http://www.cvshome.org/";>The CVS Homepage</a> for + more about CVS.</p> +</section> +<section name="CVS data"> + <p>If you know what you're doing, all you need to know:</p> + <p>viewcvs: <a href="http://cvs.apache.org/viewcvs.cgi/";>http://cvs.apache.org/viewcvs.cgi/</a></p> + <source> +anonymous CVSROOT: :pserver:[EMAIL PROTECTED]:/home/cvspublic +modules: + avalon # framework, containers and documentation + avalon-components # component repository + avalon-excalibur # utility repository + avalon-logkit # cool logging toolkit + avalon-phoenix # the phoenix container and related libraries + avalon-sandbox # alpha & pre-alpha code + avalon-site # this website + </source> +</section> +<section name="Getting the sources from CVS under Windows"> + <p>There's a few options for you:</p> + + <subsection name="Use cygwin"> + + <p><a href="http://www.cygwin.com/";>Cygwin</a> is a free software suite + of ports of popular Linux tools and utilities to run natively under windows. + Among it is a port of the cvs application. If you use cygwin, follow the Linux + instructions.</p> + </subsection> + <subsection name="Use the command-line tools"> + + <p>The CVS utilities are available as native Windows binaries. Get them from + <a href="http://www.cvshome.org/";>the CVS homepage</a>. To use these + tools, open a command window (click Start > Run..., then type 'cmd'), then + enter the following commands:</p> + + <source> +rem you can use any directory in place of C:\cvs +rem replace $CVSUTILS with where you installed the cvs binary, or with +rem nothing if you added the utility to your PATH +mkdir C:\cvs +cd C:\cvs +$CVSUTILS\cvs.exe -d :pserver:[EMAIL PROTECTED] login +rem enter anoncvs when prompted for a password, then hit enter +rem the below command should be on one line +$CVSUTILS\cvs.exe -z3 -d ^ + :pserver:[EMAIL PROTECTED]:/home/cvspublic checkout ^ + avalon avalon-excalibur avalon-components ^ + avalon-phoenix avalon-logkit avalon-site ^ + avalon-sandbox xml-forrest ^ + </source> + + <p>This will take a while, depending on your connection. Go ahead and grab + yourself a coffee or ten. When done, you should have checked out all Avalon + sources and the most important utility libraries you need to build it (save + for <a href="http://maven.apache.org/";>Apache Maven</a>, which you should + go install right now if you haven't already). For further building instructions + run:</p> +<source> +maven avalon:info +</source> + </subsection> + <subsection name="Use TortoiseCVS"> + + <p><a href="http://www.tortoisecvs.org/";>TortoiseCVS</a> is a neat extension + for the Windows Explorer which integrates CVS. Using it is real simple:</p> + + <p>After you've created a folder where you want to check out the sources to, + right-click and select CVS Checkout...:<br/> + <img src="images/tortoisecvs-checkout.jpg" alt="screenshot of CVS settings"/></p> + + <p>Then, fill out the settings like in the screenshot below, and then click ok.<br/> + <img src="images/tortoisecvs-settings.jpg" alt="screenshot of CVS settings"/></p> + + <p>This checks out the avalon CVS module. Repeat this procedure for all + the modules you wish to check out. See above under "CVS data" for the list of Avalon modules, or use the + <a href="http://cvs.apache.org/viewcvs.cgi/";>ViewCVS Webpage</a> for a full + list of ASF-hosted CVS modules.</p> + </subsection> + <subsection name="Use WinCVS"> + + <p><a href="http://www.wincvs.org/";>WinCVS</a> is a standalone windows + application for working with CVS. It has more features than TortoiseCVS, and + hence more buttons a novice is not likely to use.</p> + + <p>After you've created a folder where you want to check out the sources to, + select the Checkout module... option from the Create menu:<br/> + <img src="images/wincvs-checkout.jpg" alt="screenshot of CVS settings"/></p> + + <p>Then, select the "general tab" and fill out the settings like in the + screenshot below:<br/> + <img src="images/wincvs-preferences.jpg" alt="screenshot of CVS settings"/>.</p> + + <p>Now, switch back to the first tab and fill out the settings like in the + screenshot below, and then click ok.<br/> + <img src="images/wincvs-checkout.jpg" alt="screenshot of CVS settings"/>.</p> + + <p>This checks out the avalon CVS module. Repeat this procedure for all + the modules you wish to check out. See above under "CVS data" for the list of Avalon modules, or use the + <a href="http://cvs.apache.org/viewcvs.cgi/";>ViewCVS webpage</a> for a full + list of ASF-hosted CVS modules.</p> + </subsection> +</section> +<section name="Getting the sources from CVS under Linux"> + + <subsection name="Use the command-line tools"> + + <p>The CVS utilities are available as native linux binaries. Chances are + you already have them installed. Try it by opening a console and typing 'cvs'. + If you get an error along the lines of "bash: cvs: command not found", then + you need to install them first. Under Debian, you can do so by opening a console + window and entering the commands:</p> + + <source> +su - +# enter the root password when prompted +apt-get update +apt-get install cvs +exit + </source> + + <p>Under Red Hat, the commands are a little different:</p> + + <source> +su - +# enter the root password when prompted +rpm -i ftp://ftp.redhat.com/pub/redhat/linux/8.0/en/os/i386/RedHat/RPMS/cvs-1.11.2-5.i386.rpm +exit + </source> + + <p>The procedure is similar for other Linux distributions. Once you have + these tools installed, open a command window, then enter the following + commands:</p> + + <source> +# you can use any directory in place of ~/cvs +mkdir ~/cvs +cd ~/cvs +cvs -d :pserver:[EMAIL PROTECTED] login +# enter anoncvs when prompted for a password, then hit enter +cvs -z3 -d :pserver:[EMAIL PROTECTED]:/home/cvspublic \ + checkout avalon \ + avalon-excalibur avalon-cornerstone \ + avalon-phoenix avalon-logkit avalon-site \ + avalon-sandbox jakarta-site xml-forrest + </source> + + <p>This will take a while, depending on your connection. Go ahead and grab + yourself a coffee or ten. When done, you should have checked out all avalon + sources and the most important utility libraries you need to build it (save + for <a href="http://ant.apache.org/";>Apache Ant</a>, which you should + go install right now if you haven't already).</p> + </subsection> + + <subsection name="Using Cervisia"> + + <p>KDE's Konqueror browser has CVS support built-in. I've never used it so I + can't comment on it. See + <a href="http://cervisia.sourceforge.net/";>the Cervisia website</a> for + more information.</p> + </subsection> +</section> +<section name="Platform-independent: jCVS"> + + <p><a href="http://www.jcvs.org/";>jCVS</a> is a 100% java CVS package that I've + never used.</p> +</section> +<section name="Using an IDE for CVS access"> + + <!-- + <p>Most decent IDEs these days provide CVS integration. Apache's Jakarta Project has + an excellent section on how to configure your IDE: + <a href="http://jakarta.apache.org/site/idedevelopers.html";>IDE Developer's Guide</a> + . It applies equally well to Avalon. + </p> --> + +</section> + +</body> + +</document> Added: avalon/trunk/central/site/src/xdocs/central/about/resources/index.xml ============================================================================== --- (empty file) +++ avalon/trunk/central/site/src/xdocs/central/about/resources/index.xml Mon May 31 10:18:40 2004 @@ -0,0 +1,15 @@ +<?xml version="1.0" encoding="UTF-8"?> +<document> + <properties> + <author email="dev@avalon.apache.org">Avalon Documentation Team</author> + <title>Developer's Resources</title> + </properties> + + <body> + <section name="Resources for Avalon Developers"> + <p> + </p> + </section> + </body> +</document> + Added: avalon/trunk/central/site/src/xdocs/central/about/resources/navigation.xml ============================================================================== --- (empty file) +++ avalon/trunk/central/site/src/xdocs/central/about/resources/navigation.xml Mon May 31 10:18:40 2004 @@ -0,0 +1,31 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- + Copyright 2004 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. +--> + +<project> + + <title>Apache Avalon Central</title> + + <body> + <menu> + <item name="Subversion" href="subversion.html"/> + <item name="CVS" href="cvs.html"/> + </menu> + </body> + +</project> Added: avalon/trunk/central/site/src/xdocs/central/about/resources/subversion.xml ============================================================================== --- (empty file) +++ avalon/trunk/central/site/src/xdocs/central/about/resources/subversion.xml Mon May 31 10:18:40 2004 @@ -0,0 +1,15 @@ +<?xml version="1.0" encoding="UTF-8"?> +<document> + <properties> + <author email="dev@avalon.apache.org">Avalon Documentation Team</author> + <title>Developer's Resources</title> + </properties> + + <body> + <section name="Resources for Avalon Developers"> + <p> + </p> + </section> + </body> +</document> + Modified: avalon/trunk/central/site/src/xdocs/central/developers/navigation.xml ============================================================================== --- avalon/trunk/central/site/src/xdocs/central/developers/navigation.xml (original) +++ avalon/trunk/central/site/src/xdocs/central/developers/navigation.xml Mon May 31 10:18:40 2004 @@ -23,7 +23,6 @@ <body> <menu> - <item name="Overview" href="index.html"/> <item name="Subversion" href="subversion.html"/> <item name="CVS" href="cvs.html"/> </menu> Modified: avalon/trunk/central/site/src/xdocs/central/index.xml ============================================================================== --- avalon/trunk/central/site/src/xdocs/central/index.xml (original) +++ avalon/trunk/central/site/src/xdocs/central/index.xml Mon May 31 10:18:40 2004 @@ -7,7 +7,13 @@ <body> <section name="Welcome to Avalon Central"> - <p> + <p> + Avalon Central is the place you can find + <a href="download.cgi">downloads</a>, information + about the <a href="community/people/index.html">people</a> + who make up this <a href="community/index.html">community</a>, + together with the latest <a href="news/index.html">news</a> and + events. </p> </section> </body> Modified: avalon/trunk/central/site/src/xdocs/central/navigation.xml ============================================================================== --- avalon/trunk/central/site/src/xdocs/central/navigation.xml (original) +++ avalon/trunk/central/site/src/xdocs/central/navigation.xml Mon May 31 10:18:40 2004 @@ -23,11 +23,10 @@ <body> <menu> - <item name="News" href="news/index.html"/> + <item name="Welcome" href="about/index.html"/> <item name="Community" href="community/index.html"/> - <item name="Downloads" href="download.cgi"/> + <item name="News" href="news/index.html"/> <item name="Tutorials" href="tutorials/index.html"/> - <item name="Resources" href="developers/index.html"/> <item name="Laboratory" href="laboratory/index.html"/> <item name="Legacy" href="legacy/index.html"/> <item name="DPML" href="dpml/index.html"/> --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
