You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@avalon.apache.org by mc...@apache.org on 2004/05/31 19:18:41 UTC
svn commit: rev 20698 - in avalon/trunk/central/site/src/xdocs/central: . about about/resources developers
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:anoncvs@cvs.apache.org:/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:anoncvs@cvs.apache.org 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:anoncvs@cvs.apache.org:/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:anoncvs@cvs.apache.org login
+# enter anoncvs when prompted for a password, then hit enter
+cvs -z3 -d :pserver:anoncvs@cvs.apache.org:/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: cvs-unsubscribe@avalon.apache.org
For additional commands, e-mail: cvs-help@avalon.apache.org