leosimons    2003/02/03 07:43:39

  Modified:    src/documentation/content/history index.xml
               src/documentation/content/xdocs book.xml case-studies.xml
                        code-standards.xml cvs.xml features.xml
                        getting-started.xml index.xml mailing-lists.xml
                        news.xml
               src/documentation/content/xdocs/components index.xml
               src/documentation/content/xdocs/history index.xml
               src/documentation/content/xdocs/project book.xml patches.xml
                        pmc.xml releases.xml roadmap.xml
               src/documentation/content/xdocs/seca index.xml
  Log:
  Applying patch from bug 16620 
(http://nagoya.apache.org/bugzilla/show_bug.cgi?id=16620), fixing lots of typos. 
Submitted by [EMAIL PROTECTED] (Ulrich Mayring). Thanks Ulrich!
  
  Revision  Changes    Path
  1.2       +3 -3      jakarta-avalon-site/src/documentation/content/history/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/src/documentation/content/history/index.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- index.xml 29 Jan 2003 13:31:20 -0000      1.1
  +++ index.xml 3 Feb 2003 15:43:38 -0000       1.2
  @@ -30,12 +30,12 @@
   
   <p>
       Over time the Java Apache Server Framework project was renamed Avalon. This was 
in 
  -    recognition that the original ideas have evolved over time. Avalon became a 
  +    recognition that the original ideas had evolved over time. Avalon became a 
       repository of general utility code, a design and testing ground for component 
based 
  -    solutions, a micro kernel and set of generalized server oriented services. This 
combined 
  +    solutions, a micro kernel and set of generalized server oriented services. 
This, combined 
       with a move from the Java Apache project to the Jakarta project prompted the 
revision.
       At this time the kernel code was repackaged under the name Phoenix, core 
services 
  -    under the name Cornerstone and the general components was packaged under name 
Excalibur.
  +    under the name Cornerstone and the general components were packaged under the 
name Excalibur.
   </p>
   <p>
     You may check the historical changes from before splitting Avalon into separate 
projects <link href="changes.html">here</link>.
  
  
  
  1.6       +4 -4      jakarta-avalon-site/src/documentation/content/xdocs/book.xml
  
  Index: book.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/book.xml,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- book.xml  29 Jan 2003 13:33:05 -0000      1.5
  +++ book.xml  3 Feb 2003 15:43:38 -0000       1.6
  @@ -11,10 +11,10 @@
       <menu-item label="Mission" href="mission.html"/>
       <menu-item label="News and Status" href="news.html"/>
       <menu-item label="Features" href="features.html"/>
  -    <menu-item label="Download binaries" href="bindownload.cgi"/>
  -    <menu-item label="Download sources" href="srcdownload.cgi"/>
  +    <menu-item label="Download Binaries" href="bindownload.cgi"/>
  +    <menu-item label="Download Sources" href="srcdownload.cgi"/>
       <menu-item label="License" href="license.html"/>
  -    <menu-item label="Who we are" href="whoweare/index.html"/>
  +    <menu-item label="Who we Are" href="whoweare/index.html"/>
     </menu>
     
     <menu label="Subprojects">
  @@ -40,7 +40,7 @@
     </menu>
     
     <menu label="Development">
  -    <menu-item label="Coding standards" href="code-standards.html"/>
  +    <menu-item label="Coding Standards" href="code-standards.html"/>
       <menu-item label="Get Involved" href="http://james.apache.org/contribute.html"/>
       <menu-item label="Project Guidelines" href="project/index.html"/>
       <menu-item label="Project History" href="history/index.html"/>
  
  
  
  1.2       +1 -1      
jakarta-avalon-site/src/documentation/content/xdocs/case-studies.xml
  
  Index: case-studies.xml
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/case-studies.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- case-studies.xml  24 Jan 2003 19:39:40 -0000      1.1
  +++ case-studies.xml  3 Feb 2003 15:43:38 -0000       1.2
  @@ -43,7 +43,7 @@
   <title>eQ!(tm)</title>
       <p>A commercial product from Browsersoft, Inc., eQ!(tm) is a business object 
foundation
        which has recently been refactored and built upon Avalon and utilizes several 
of 
  -     Excalibur's components for it's persistence engine, XML-based scripting 
engine, 
  +     Excalibur's components for its persistence engine, XML-based scripting engine, 
        Struts adapters and other internal usages.</p>
        
        <p>eQ!(tm)'s goal is to provide a foundation upon which to build delivery 
technology
  
  
  
  1.3       +8 -9      
jakarta-avalon-site/src/documentation/content/xdocs/code-standards.xml
  
  Index: code-standards.xml
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/code-standards.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- code-standards.xml        25 Jan 2003 17:19:00 -0000      1.2
  +++ code-standards.xml        3 Feb 2003 15:43:38 -0000       1.3
  @@ -14,10 +14,10 @@
   <title>Coding Standards</title>
    <p>This document describes a list of coding conventions that are required
    for code submissions to the project. By default, the coding conventions
  - for most Open Source Projects should follow the existing coding conventions
  + for most Open Source projects should follow the existing coding conventions
    in the code that you are working on. For example, if the bracket is on
    the same line as the if statement, then you should write all your code
  - to have that convention.</p>
  + to follow that convention.</p>
   
   <p><strong>Please follow these conventions closely. It makes life so much
   easier.</strong></p>
  @@ -87,14 +87,14 @@
   of each and every file.</p>
   
   <p>If you contribute to a file (code or documentation), add yourself to the
  -top of the file. For java files the preferred Javadoc format is:</p>
  +top of the file. For .java files the preferred Javadoc format is:</p>
   
   <source>
   @author &lt;a href="mailto:[EMAIL PROTECTED]"&gt;John Doe&lt;/a&gt;
   </source>
   
    <p>Indent comments on an 80 column basis and the code on a
  - 100 column, using a two more indents when a line must be wrapped.</p>
  + 100 column basis, using two more indents when a line must be wrapped.</p>
   
   <p>We focus on readability over performance, at least initially. Source code
   optimization is the last thing to be done to increase performance.
  @@ -116,10 +116,10 @@
   }
   </source>
   
  -<p>Variable should be descriptive and ideally English words. The exceptions
  -being; loop counters (usually use i, j and k), exceptions (use concatenation
  -of word separating characters - ie SocketException is abbreviated as se) and
  -other commonly used abbreviations (ie sb for StringBuffer).</p>
  +<p>Variables should be descriptive and ideally English words. The exceptions
  +being loop counters (usually use i, j and k), exceptions (use concatenation
  +of word separating characters - i.e. SocketException is abbreviated as se) and
  +other commonly used abbreviations (i.e. sb for StringBuffer).</p>
   <source>
   try
   {
  @@ -187,7 +187,6 @@
   <source>
   final MySomething something = myObject.doSomething();
   final MyElse somethingElse = something.doSomethingElse();
  -
   Thing thing = somethingElse.getMyThing();
   </source>
   <p>The extra typing will help keep the code bug-free.</p>
  
  
  
  1.3       +34 -34    jakarta-avalon-site/src/documentation/content/xdocs/cvs.xml
  
  Index: cvs.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/cvs.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- cvs.xml   25 Jan 2003 17:12:52 -0000      1.2
  +++ cvs.xml   3 Feb 2003 15:43:38 -0000       1.3
  @@ -13,15 +13,15 @@
   
   <section>
        <title>Bleeding-edge only</title>
  -     <p>If you are looking to download the source code for stable versions of the 
avalon
  +     <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
  -     <link href="srcdownload.cgi">the source download page</link></p>
  +     <link href="srcdownload.cgi">the source download page</link>.</p>
   </section>
   <section>
        <title>About CVS</title>
        <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 <link href="http://www.cvshome.org/";>The CVS Homepage</link> for
  +     Apache. See <link href="http://www.cvshome.org/";>The CVS Homepage</link> for
        more about CVS.</p>
   </section>
   <section>
  @@ -42,22 +42,22 @@
        </source>
   </section>
   <section>
  -     <title>Getting the sources from CVS under windows</title>
  +     <title>Getting the sources from CVS under Windows</title>
        <p>There's a few options for you:</p>
        
        <section>
                <title>Use cygwin</title>
                
                <p><link href="http://www.cygwin.com/";>Cygwin</link> 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
  +             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>
        </section>
        <section>
  -             <title>Use the commandline tools</title>
  +             <title>Use the command-line tools</title>
                
  -             <p>The CVS utilities are available as native windows binaries. Get 
them from
  -             <link href="http://www.cvshome.org/";>The CVS Homepage</link>. To use 
these
  +             <p>The CVS utilities are available as native Windows binaries. Get 
them from
  +             <link href="http://www.cvshome.org/";>the CVS homepage</link>. To use 
these
                tools, open a command window (click Start > Run..., then type 'cmd'), 
then
                enter the following commands:</p>
                
  @@ -68,7 +68,7 @@
   mkdir C:\cvs
   cd C:\cvs
   $CVSUTILS\cvs.exe -d :pserver:[EMAIL PROTECTED] login
  -rem enter anoncvs when promted for a password, then hit enter
  +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] checkout jakarta-avalon
         jakarta-avalon-excalibur jakarta-avalon-cornerstone
  @@ -77,7 +77,7 @@
                </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
  +             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 <link href="http://ant.apache.org/";>Apache Ant</link>, which you 
should
                go install right now if you haven't already).</p>
  @@ -86,55 +86,55 @@
                <title>Use TortoiseCVS</title>
                
                <p><link href="http://www.tortoisecvs.org/";>TortoiseCVS</link> is a 
neat extension
  -             for the Windows Explorer which integrates cvs. Using it is real 
simple:</p>
  +             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>
  +             <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>
  +             <img src="images/tortoisecvs-settings.jpg" alt="screenshot of CVS 
settings"/></p>
                
  -             <p>This checks out the jakarta-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
  +             <p>This checks out the jakarta-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
                <link href="http://cvs.apache.org/viewcvs.cgi/";>ViewCVS Webpage</link> 
for a full
  -             list of ASF-hosted cvs modules.</p> 
  +             list of ASF-hosted CVS modules.</p> 
        </section>
        <section>
                <title>Use WinCVS</title>
                
                <p><link href="http://www.wincvs.org/";>WinCVS</link> is a standalone 
windows
  -             application for working with cvs. It has more features than 
TortoiseCVS, and
  +             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>
  +             <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>
  +             <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>
  +             <img src="images/wincvs-checkout.jpg" alt="screenshot of CVS 
settings"/>.</p>
                
  -             <p>This checks out the jakarta-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
  -             <link href="http://cvs.apache.org/viewcvs.cgi/";>ViewCVS Webpage</link> 
for a full
  -             list of ASF-hosted cvs modules.</p> 
  +             <p>This checks out the jakarta-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
  +             <link href="http://cvs.apache.org/viewcvs.cgi/";>ViewCVS webpage</link> 
for a full
  +             list of ASF-hosted CVS modules.</p> 
        </section>
   </section>
   <section>
  -     <title>Getting the sources from CVS under linux</title>
  +     <title>Getting the sources from CVS under Linux</title>
        
        <section>
  -             <title>Use the commandline tools</title>
  +             <title>Use the command-line tools</title>
                
                <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
  +             you need to install them first. Under Debian, you can do so by opening 
a console
                window and entering the commands:</p>
                
                <source>
  @@ -154,7 +154,7 @@
   exit
                </source>
   
  -             <p>The procedure is similar for other linux distributions. Once you 
have
  +             <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>
                
  @@ -163,7 +163,7 @@
   mkdir ~/cvs
   cd ~/cvs
   cvs -d :pserver:[EMAIL PROTECTED] login
  -# enter anoncvs when promted for a password, then hit enter
  +# enter anoncvs when prompted for a password, then hit enter
   cvs -z3 -d :pserver:[EMAIL PROTECTED] checkout jakarta-avalon \
         jakarta-avalon-excalibur jakarta-avalon-cornerstone \
         jakarta-avalon-phoenix jakarta-avalon-logkit jakarta-avalon-site \
  @@ -182,22 +182,22 @@
                
                <p>KDE's Konqueror browser has CVS support built-in. I've never used 
it so I
                can't comment on it. See
  -             <link href="http://cervisia.sourceforge.net/";>the cervisia 
website</link> for
  +             <link href="http://cervisia.sourceforge.net/";>the Cervisia 
website</link> for
                more information.</p>
        </section>
   </section>
   <section>
        <title>Platform-independent: jCVS</title>
        
  -     <p><link href="http://www.jcvs.org/";>jCVS</link> is a 100% java cvs package 
that I've
  +     <p><link href="http://www.jcvs.org/";>jCVS</link> is a 100% java CVS package 
that I've
        never used.</p>
   </section>
   <section>
        <title>Using an IDE for CVS access</title>
        
  -     <p>Most decent IDEs these days provide cvs integration. See the
  +     <p>Most decent IDEs these days provide CVS integration. See the
        <link href="http://jakarta.apache.org/site/idedevelopers.html";>IDE Developer's 
Guide</link>
  -     if you need information on how to configure your ide.</p>
  +     if you need information on how to configure your IDE.</p>
   </section>
   
   </body>
  
  
  
  1.2       +13 -13    jakarta-avalon-site/src/documentation/content/xdocs/features.xml
  
  Index: features.xml
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/features.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- features.xml      24 Jan 2003 19:39:40 -0000      1.1
  +++ features.xml      3 Feb 2003 15:43:38 -0000       1.2
  @@ -15,23 +15,23 @@
   <title>Introduction</title>
     <p>The Avalon project is so large and broad in scope that it is not easy
     to provide a simple list of features in the form of "Avalon provides
  -  Component X which will fulfill role Y in your project Z perfectly".</p>
  +  component X which will fulfill role Y in your project Z perfectly".</p>
   
     <p>Most of Avalon is oriented towards server development (though many parts
     can be, and are, used in other software domains). As such, it delivers all
  -  those features server applications require (stability, performance, etc),
  +  those features server applications require (stability, performance, etc.),
     and does so very well.</p>
   
     <section>
   <title>Avalon Framework</title>
  -    <p>At the very core of our project is the Avalon Framework subproject.
  +    <p>At the very core of our project is the Avalon Framework sub-project.
       This framework is very stable and in daily use in many applications, from
       straightforward desktop products to large scale enterprise applications.<br/>
       After an initial learning curve, this framework will help you
  -    create a better software architecture. In this way, it's role is as
  +    create a better software architecture. In this way, its role is as
       fundamental as, say Object-Oriented Programming or Design Patterns.</p>
   
  -    <p>All other avalon subprojects make use of the framework. This has allowed
  +    <p>All other Avalon sub-projects make use of the framework. This has allowed
       us to provide truly pluggable components which can be used in any
       programming environment without requiring gargantuan supporting 
applications.</p>
     </section>
  @@ -54,7 +54,7 @@
     <section>
   <title>Avalon LogKit</title>
       <p>Avalon LogKit is a feature-rich logging package. It can be used as an
  -    Alternative to other logging packages like Jakarta's
  +    alternative to other logging packages like Jakarta's
       <link href="http://jakarta.apache.org/log4j";>Log4J</link> or the (massively
       inferior)
       <link 
href="http://java.sun.com/j2se/1.4/docs/guide/util/logging/index.html";>Logging 
API</link>
  @@ -68,12 +68,12 @@
     <section>
   <title>Avalon Phoenix</title>
       <p>Phoenix is a micro-kernel. It takes care of low level application details
  -    so you can focus on your unique requirments. While this may sound to you
  -    like a servlet or EJB container, phoenix has a very different scope. Where
  -    you can use EJBs to connect to a database, phoenix is the basis on which to
  +    so you can focus on your unique requirements. While this may sound to you
  +    like a servlet or EJB container, Phoenix has a very different scope. Where
  +    you can use EJBs to connect to a database, Phoenix is the basis on which to
       run that database.<br/>
  -    With that said, you may now start to see the phoenix edge: it provides all
  -    of the features that make you love Servlet Engines so much (and several
  +    With that said, you may now start to see the Phoenix edge: it provides all
  +    of the features that make you love servlet engines so much (and several
       more), without restricting you to the specific servlet use case. You can
       use Avalon Phoenix to run your servlet engine, database, and other server
       components, as well as your java-enabled desktop.</p>
  @@ -86,10 +86,10 @@
   
     <section>
   <title>Avalon Applications</title>
  -    <p>Avalon Applications is a repository for Phoenix-enabled Applications.
  +    <p>Avalon Applications is a repository for Phoenix-enabled applications.
       It contains a JDBC-compliant database, a Macromedia Flash-compatible XML socket
       server, and more. You'll also find a list of applications elsewhere on the
  -    web that run on phoenix. Go to the
  +    web that run on Phoenix. Go to the
       <link href="http://jakarta.apache.org/avalon/apps";>
         Applications project page
       </link> to find out all about them.</p>
  
  
  
  1.2       +16 -16    
jakarta-avalon-site/src/documentation/content/xdocs/getting-started.xml
  
  Index: getting-started.xml
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/getting-started.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- getting-started.xml       24 Jan 2003 19:39:40 -0000      1.1
  +++ getting-started.xml       3 Feb 2003 15:43:38 -0000       1.2
  @@ -11,14 +11,14 @@
                <section>
   <title>Introduction</title>
                        <p>We've worked hard to write complete documentation for all 
the
  -                     different parts of avalon. Unfortunately, this means there is 
quite
  +                     different parts of Avalon. Unfortunately, this means there is 
quite
                        a bit of documentation to sort through =)</p>
                </section>
   
                <section>
   <title>Avalon for Beginners</title>
                        <p>An effort is underway to write a concise, example-oriented 
guide
  -                     to avalon that will get you up and running in about 2 minutes. 
You
  +                     to Avalon that will get you up and running in about two 
minutes. You
                        can find the draft
                        <link 
href="excalibur/tweety/avalon-for-beginners.html">here</link>.</p>
                </section>
  @@ -28,19 +28,19 @@
                        <p>Another really neat document is our
                        <link href="developing/index.html">Developing with Avalon 
whitepaper</link>.
                        It's quite extensive, but very thorough and well-written. If 
you're an
  -                     experienced software engineer, you'll definately appreciate 
it.</p>
  +                     experienced software engineer, you'll definetely appreciate 
it.</p>
                </section>
   
                <section>
  -<title>Other documentation</title>
  -                     <p>All the various subproject contain quite a bit of 
documentation
  -                     as well. I'll point you in the direction of the getting started
  +<title>Other Documentation</title>
  +                     <p>All the various sub-projects contain quite a bit of 
documentation
  +                     as well. I'll point you in the direction of the 'Getting 
Started'
                        documentation for each of them.</p>
   
                        <section>
   <title>Avalon Framework</title>
                                <p>Both the Avalon for Beginners and the Developing 
with Avalon
  -                             paper introduce you to avalon framework. We suggest 
you start
  +                             paper introduce you to Avalon framework. We suggest 
you start
                                with one of these.</p>
                        </section>
   
  @@ -53,7 +53,7 @@
   
                        <section>
   <title>Avalon Cornerstone</title>
  -                             <p>Much the same is true for the cornerstone 
documentation. We
  +                             <p>Much the same is true for the Cornerstone 
documentation. We
                                suggest you read the
                                <link href="cornerstone/index.html">overview</link>, 
then
                                browse the
  @@ -64,26 +64,26 @@
                        <section>
   <title>Avalon Phoenix</title>
                                <p>The
  -                             <link href="phoenix/getting-started.html">Avalon 
Phoenix getting started document</link>
  -                             desribes the HelloWorld demo Service demo. Tt will 
take you
  +                             <link href="phoenix/getting-started.html">Avalon 
Phoenix Getting Started document</link>
  +                             describes the HelloWorld Service demo. It will take you
                                through downloading, installing and then running the 
demo step
  -                             by step so it is an easy place tp start</p>
  +                             by step so it is an easy place to start.</p>
                        </section>
   
                        <section>
   <title>Avalon Logkit</title>
  -                             <p>You will most likely not use logkit by itself, but
  +                             <p>You will most likely not use Logkit by itself, but
                                rather with Phoenix or another container, so you don't 
normally
  -                             need to learn much about logkit. If you are interested 
in learning
  +                             need to learn much about Logkit. If you are interested 
in learning
                                more about it, there's a really good
                                <link href="logkit/whitepaper.html">whitepaper</link>
  -                             on it (it doesn't have a real 'getting started' 
document).</p>
  +                             on it (it doesn't have a real 'Getting Started' 
document).</p>
                        </section>
   
                        <section>
   <title>Avalon Applications</title>
                                <p>The Phoenix documentation takes you through setting 
up the
  -                             Demo application; for the others there is no getting 
started
  +                             Demo application; for the others there is no 'Getting 
Started'
                                documentation.</p>
                        </section>
                </section>
  @@ -91,7 +91,7 @@
                <section>
   <title>When you do get lost...</title>
                        <p>When you get stuck in sources, documentation, and the 
mailing list archive,
  -                     post your questions to the user mailing list (information on 
it is
  +                     post your questions to the users mailing list (information on 
it is
                        <link 
href="http://jakarta.apache.org/site/mail.html";>here</link>). For
                        many, Avalon poses a steep learning curve, and we'll try and 
help you
                        flatten it as much as we can.</p>
  
  
  
  1.3       +11 -11    jakarta-avalon-site/src/documentation/content/xdocs/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/index.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- index.xml 29 Jan 2003 15:11:36 -0000      1.2
  +++ index.xml 3 Feb 2003 15:43:38 -0000       1.3
  @@ -8,7 +8,7 @@
             <section>
               <title>Shaping up....</title>
               <p>This site is still shaping up. You need to go to
  -         <link href="http://jakarta.apache.org/avalon/";>the jakarta pages</link>
  +         <link href="http://jakarta.apache.org/avalon/";>the Jakarta pages</link>
            for now.</p>
             </section>
       <section>
  @@ -39,13 +39,13 @@
   <title>Project Goals</title>
         <p>
           As many people point out, software engineering is a very uncommon procedure
  -        in software development and even more uncommon in auto-organized open
  -        source projects. The main goal of this project is to design a way for
  +        in software development and even more uncommon in auto-organized Open
  +        Source projects. The main goal of this project is to design a way for
           different projects to share resources avoiding as much as possible efforts
           duplication.
         </p>
         <p>
  -        The Avalon Team are proud to announce a new whitepaper that covers how
  +        The Avalon Team is proud to announce a new whitepaper that covers how
           to develop with Avalon. It covers the Framework, and touches on the
           LogKit and Excalibur. You can find
           <link 
href="http://jakarta.apache.org/avalon/developing/index.html";>Developing with Apache 
Avalon</link>
  @@ -70,7 +70,7 @@
             a collection of code design patterns, rules, guidelines and suggestions 
on how to
             write software that "plugs" into the framework. The framework does not
             impose restrictions on the application that uses it, but rather precious 
guidelines to
  -          help the developers reuse as much work they can from other solutions.
  +          help the developers reuse as much work as they can from other solutions.
           </p>
         </section>
   
  @@ -87,8 +87,8 @@
   <title>Phoenix</title>
           <p>
             <link 
href="http://jakarta.apache.org/avalon/phoenix/index.html";>Phoenix</link> is a server 
oriented
  -          Application Server. Applications and Services that conform to the 
framework
  -          rules can be hosted in Phoenix. The Application server manages the 
applications
  +          application server. Applications and services that conform to the 
framework
  +          rules can be hosted in Phoenix. The application server manages the 
applications
             classloader, security and logging needs. It also provides a JMX-based 
management
             facility.
           </p>
  @@ -97,7 +97,7 @@
         <section>
   <title>Cornerstone</title>
           <p>
  -          <link 
href="http://jakarta.apache.org/avalon/cornerstone/index.html";>Cornerstone</link> is a 
repository.
  +          <link 
href="http://jakarta.apache.org/avalon/cornerstone/index.html";>Cornerstone</link> is a 
repository
             for what we call <link href="phoenix/what-is-a-block.html">blocks</link>,
             which provide services vital to server applications. The blocks include 
blocks for
             services such as scheduling and socket management.
  @@ -108,7 +108,7 @@
   <title>Applications</title>
           <p>
             <link 
href="http://jakarta.apache.org/avalon/apps/index.html";>Applications</link> is a 
repository of
  -          Phoenix blocks.  Some are simple self-contained demos of Phoenix 
applications,
  +          Phoenix blocks.  Some are simple, self-contained demos of Phoenix 
applications,
             others are complete standalone products, and a few are ambitious works in 
progress.
             If you are looking for a starting point for a Phoenix block or a complete 
server,
             then these applications could be good inspiration.
  @@ -119,9 +119,9 @@
   <title>LogKit</title>
           <p>
             <link 
href="http://jakarta.apache.org/avalon/logkit/index.html";>LogKit</link> is the 
preferred logging toolkit
  -          used by the Avalon subprojects.</p>
  +          used by the Avalon sub-projects.</p>
          <p>
  -       It is quite possible to use the other avalon subprojects without committing 
to logkit.
  +       It is quite possible to use the other avalon sub-projects without committing 
to logkit.
          We support log4j and JDK 1.4 logging as well.
          </p>
         </section>
  
  
  
  1.2       +5 -5      
jakarta-avalon-site/src/documentation/content/xdocs/mailing-lists.xml
  
  Index: mailing-lists.xml
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/mailing-lists.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- mailing-lists.xml 24 Jan 2003 19:39:40 -0000      1.1
  +++ mailing-lists.xml 3 Feb 2003 15:43:38 -0000       1.2
  @@ -24,7 +24,7 @@
     <section>
       <title>The lists</title>
       <section>
  -      <title>The Avalon User List</title>
  +      <title>The Avalon Users List</title>
         <p>
        <em>Light Traffic</em>
        <link href="mailto:[EMAIL PROTECTED]";>Subscribe</link>
  @@ -33,13 +33,13 @@
        <link href="nntp://news.gmane.org/gmane.comp.jakarta.avalon.user";>News 
gateway</link>
         </p>
         <p>
  -     This list is for users that are using Avalon in their own projects to ask
  +     This list is for users who are using Avalon in their own projects to ask
        questions, share knowledge, and discuss issues related to using the Avalon
        suite of software.
         </p>
       </section>
       <section>
  -      <title>The Avalon Developer List</title>
  +      <title>The Avalon Developers List</title>
         <p>
        <em>Medium Traffic</em>
        <link href="mailto:[EMAIL PROTECTED]";>Subscribe</link>  
  @@ -48,9 +48,9 @@
        <link href="nntp://news.gmane.org/gmane.comp.jakarta.avalon.devel";>News 
gateway</link>
         </p>
         <p>
  -     This list is for developers that are maintaining Avalon or wanting to influence
  +     This list is for developers who are maintaining Avalon or wanting to influence
        its design to ask questions, share knowledge, and discuss issues related to 
developing 
  -     and the Avalon framework.
  +     the Avalon framework.
         </p>
       </section>
       <section>
  
  
  
  1.2       +2 -2      jakarta-avalon-site/src/documentation/content/xdocs/news.xml
  
  Index: news.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/news.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- news.xml  24 Jan 2003 19:39:40 -0000      1.1
  +++ news.xml  3 Feb 2003 15:43:38 -0000       1.2
  @@ -16,9 +16,9 @@
            <title>Avalon is now a top-level project!</title>
            
            <p>The Apache board has passed a resolution to set up a "top-level" project
  -         for Avalon. This basically means avalon gets its own PMC made up of the 
avalon
  +         for Avalon. This basically means Avalon gets its own PMC made up of the 
Avalon
            committers, reporting directly to the board. The complete text of the 
resolution
  -         that passed on Monday 18 November 2002, which created this project is:</p>
  +         that passed on Monday, November 18, 2002, which created this project 
is:</p>
   <source>
     WHEREAS, the Board of Directors deems it to be in
     the best interests of the Foundation and consistent with
  
  
  
  1.3       +6 -6      
jakarta-avalon-site/src/documentation/content/xdocs/components/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/components/index.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- index.xml 29 Jan 2003 15:10:44 -0000      1.2
  +++ index.xml 3 Feb 2003 15:43:38 -0000       1.3
  @@ -8,13 +8,13 @@
             <section>
               <title>Shaping up....</title>
               <p>This site is still shaping up. You need to go to
  -         <link href="http://jakarta.apache.org/avalon/";>the jakarta pages</link>
  +         <link href="http://jakarta.apache.org/avalon/";>the Jakarta pages</link>
            for now.</p>
             </section>
          <section>
            <title>Cornerstone</title>
            <p>Cornerstone is a repository for reusable services/components/blocks
  -         for phoenix and other containers with similar features. The subproject
  +         for Phoenix and other containers with similar features. The sub-project
            website is at
            <link 
href="http://avalon.apache.org/cornerstone/";>http://avalon.apache.org/cornerstone/</link>.</p>
          </section>
  @@ -22,14 +22,14 @@
            <title>Excalibur</title>
            <p>Excalibur is a large repository containing lots of materials, including
            the ECM and Fortress containers and container-facilitating code, reusable
  -         avalon components, and some components not-so-closely coupled to avalon. 
The
  -         subproject website is at
  +         Avalon components, and some components not-so-closely coupled to Avalon. 
The
  +         sub-project website is at
            <link 
href="http://avalon.apache.org/excalibur/";>http://avalon.apache.org/excalibur/</link>.</p>
          </section>
          <section>
            <title>Logkit</title>
  -         <p>Logkt is our biggest "reusable component". It's a real cool logging 
toolkit.
  -         The subproject website is at
  +         <p>Logkit is our biggest "reusable component". It's a real cool logging 
toolkit.
  +         The sub-project website is at
            <link 
href="http://jakarta.apache.org/avalon/logkit/";>http://avalon.apache.org/avalon/logkit/</link>.</p>
          </section>
           </body>
  
  
  
  1.2       +4 -4      
jakarta-avalon-site/src/documentation/content/xdocs/history/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/history/index.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- index.xml 29 Jan 2003 15:57:47 -0000      1.1
  +++ index.xml 3 Feb 2003 15:43:38 -0000       1.2
  @@ -30,15 +30,15 @@
   
   <p>
       Over time the Java Apache Server Framework project was renamed Avalon. This was 
in 
  -    recognition that the original ideas have evolved over time. Avalon became a 
  +    recognition that the original ideas had evolved over time. Avalon became a 
       repository of general utility code, a design and testing ground for component 
based 
  -    solutions, a micro kernel and set of generalized server oriented services. This 
combined 
  +    solutions, a micro kernel and set of generalized server oriented services. 
This, combined 
       with a move from the Java Apache project to the Jakarta project prompted the 
revision.
       At this time the kernel code was repackaged under the name Phoenix, core 
services 
  -    under the name Cornerstone and the general components was packaged under name 
Excalibur.
  +    under the name Cornerstone and the general components were packaged under the 
name Excalibur.
   </p>
   <p>
  -  You may check the historical changes from before splitting Avalon into separate 
projects <link href="changes.html">here</link>.
  +  You may check the historical changes from before splitting Avalon into seperate 
projects <link href="changes.html">here</link>.
   </p>
   
   </section>
  
  
  
  1.3       +2 -2      
jakarta-avalon-site/src/documentation/content/xdocs/project/book.xml
  
  Index: book.xml
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/project/book.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- book.xml  27 Jan 2003 13:34:37 -0000      1.2
  +++ book.xml  3 Feb 2003 15:43:38 -0000       1.3
  @@ -11,7 +11,7 @@
       <menu-item label="Our Mission" href="../mission.html"/>
       <menu-item label="Project History" href="../history/index.html"/>
       <menu-item label="Meritocracy" 
href="http://jakarta.apache.org/site/decisions.html"/>
  -    <menu-item label="High esteem" 
href="http://dictionary.reference.com/search?q=esteem"/>
  +    <menu-item label="High Esteem" 
href="http://dictionary.reference.com/search?q=esteem"/>
       <menu-item label="The Apache Way" 
href="http://nagoya.apache.org/wiki/apachewiki.cgi?ApacheWay"/>
     </menu>
     
  @@ -26,6 +26,6 @@
     <menu label="Development Process">
       <menu-item label="Roadmap" href="roadmap.html"/>
       <menu-item label="Release Management" href="releases.html"/>
  -    <menu-item label="Patches and Bugreports" href="patches.html"/>
  +    <menu-item label="Patches and Bug Reports" href="patches.html"/>
     </menu>
   </book>
  
  
  
  1.3       +5 -5      
jakarta-avalon-site/src/documentation/content/xdocs/project/patches.xml
  
  Index: patches.xml
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/project/patches.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- patches.xml       29 Jan 2003 15:11:36 -0000      1.2
  +++ patches.xml       3 Feb 2003 15:43:38 -0000       1.3
  @@ -2,7 +2,7 @@
         <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" 
"document-v11.dtd">
         <document> 
           <header> 
  -          <title>Apache Avalon project: Patches and Bugrepors</title> 
  +          <title>Apache Avalon project: Patches and Bug Reports</title> 
           </header> 
           <body>
          <section>
  @@ -13,9 +13,9 @@
            <link 
href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&amp;version=unspecified&amp;rep_platform=all&amp;op_sys=all&amp;[EMAIL PROTECTED]";><strong>Enter
 a bug</strong></link><br/>
            <br/>
            but please make sure the bug you're reporting doesn't exist yet, you 
include
  -         all relevant information, etc etc. See
  +         all relevant information, etc. See
            <link 
href="http://nagoya.apache.org/wiki/apachewiki.cgi?HowDoISubmitUsefulBugReports";>this 
page</link>
  -         for more on how to submit bug reports, or try google.</p>
  +         for more on how to submit bug reports, or try Google.</p>
          </section>
          <section>
            <title>Submitting patches</title>
  @@ -25,12 +25,12 @@
            in a single patch file. Make sure the patch adheres to the coding 
standards,
            and includes appropriate javadoc.</p>
            
  -         <p>When you've built the patch, file a new bug report in bugzilla if one
  +         <p>When you've built the patch, file a new bug report in Bugzilla if one
            does not exist yet, explain the reason behind the patch, how the patch 
fixes
            the issues, and add the patch as an attachment.</p>
            
            <p>If your patch is not getting applied or there is no response, start 
nagging
  -         the developers (politely, please :D) on the development mailing list.</p>
  +         the developers (politely, please :D) on the developers mailing list.</p>
            
            <section>
              <title>Documentation patches</title>
  
  
  
  1.2       +9 -9      
jakarta-avalon-site/src/documentation/content/xdocs/project/pmc.xml
  
  Index: pmc.xml
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/project/pmc.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- pmc.xml   27 Jan 2003 13:34:37 -0000      1.1
  +++ pmc.xml   3 Feb 2003 15:43:38 -0000       1.2
  @@ -13,15 +13,15 @@
          </section>
             <section>
               <title>So what is this PMC thing?</title>
  -            <p>Apache is a legal entity, ie a real non-profit organisation,
  -         with a charter, members, a board, a president, etc etc. You can
  +            <p>Apache is a legal entity, i.e. a real non-profit organisation,
  +         with a charter, members, a board, a president, etc. You can
            read all about that
            <link href="http://www.apache.org/foundation/";>here</link></p>
            
            <p>A PMC, Project Management Committee, is a group of people
  -         appointed with the task of managing someting that fits with the
  -         apache software foundation goals. The Avalon PMC, for example,
  -         is tasked with managing avalon.</p>
  +         appointed with the task of managing something that fits with the
  +         Apache Software Foundation goals. The Avalon PMC, for example,
  +         is tasked with managing Avalon.</p>
          </section>
          <section>
            <title>What, management?! We've already got plenty of those at 
work!</title>
  @@ -31,7 +31,7 @@
            stuff which still requires management.</p>
            
            <p>For example, in order to protect ourselves and our users, all
  -         software hosted at apache must be properly copyrighted to the ASF,
  +         software hosted at Apache must be properly copyrighted to the ASF,
            and licensed under the ASF license. This is something the PMC is
            responsible for.</p>
            
  @@ -39,18 +39,18 @@
            the development work. There's no "bossing around" here. The PMC
            exists only to facilitate free software developers in "doing their
            thing", just like the ASF exists "to provide organizational, legal,
  -         and financial support for the Apache open-source software
  +         and financial support for the Apache Open Source software
            projects".</p>
          </section>
          <section>
            <title>The PMC Chair and Officer of the Foundation</title>
            <p>The position of Avalon PMC chair is an important one; the PMC
  -         chair has special responsibilities and priviledges as detailed in
  +         chair has special responsibilities and privileges as detailed in
            the ASF bylaws.</p>
          </section>
          <section>
            <title>So, who's on the PMC?</title>
  -         <p>This information is contained in the avalon STATUS file, and
  +         <p>This information is contained in the Avalon STATUS file, and
            also <link href="../whoweare.html">on this page</link>.</p>
          </section>
           </body>
  
  
  
  1.3       +2 -2      
jakarta-avalon-site/src/documentation/content/xdocs/project/releases.xml
  
  Index: releases.xml
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/project/releases.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- releases.xml      29 Jan 2003 15:11:36 -0000      1.2
  +++ releases.xml      3 Feb 2003 15:43:38 -0000       1.3
  @@ -15,7 +15,7 @@
   <li><link href="http://jakarta.apache.org/site/decisions.html";>Jakarta decision 
process</link></li>
   <li><link href="http://httpd.apache.org/dev/release.html";>HTTPD release 
policy</link></li>
   <li><link 
href="http://nagoya.apache.org/bugzilla/reports.cgi?product=Avalon&amp;output=most_doomed&amp;links=1&amp;banner=1&amp;quip=0";>Bug
 summary</link></li>
  -<li><link href="http://cvs.apache.org/~bodewig/mirror.html";>Distribution Mirroring 
howto</link></li>
  +<li><link href="http://cvs.apache.org/~bodewig/mirror.html";>Distribution Mirroring 
HOWTO</link></li>
   <li><link href="http://cvs.apache.org/builds/";>Nightly builds</link></li>
   <li><link href="http://gump.covalent.net/jars/latest/";>Nightly builds: 
jars@covalent</link></li>
   <li><link href="http://freshmeat.net/articles/view/392/";>Freshmeat on software 
builds</link></li>
  @@ -27,7 +27,7 @@
          </section>
          <section>
            <title>Noel's thoughts</title>
  -         <p>Noel J Bergman wrote to avalon-dev:</p>
  +         <p>Noel J. Bergman wrote to avalon-dev:</p>
            <source>
   Q: "Is the Avalon PMC able to define a coordinated Release of all the A4
   modules such that we know that they all work together?"
  
  
  
  1.2       +5 -5      
jakarta-avalon-site/src/documentation/content/xdocs/project/roadmap.xml
  
  Index: roadmap.xml
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/project/roadmap.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- roadmap.xml       27 Jan 2003 13:34:37 -0000      1.1
  +++ roadmap.xml       3 Feb 2003 15:43:38 -0000       1.2
  @@ -12,8 +12,8 @@
            
   <source>
          Avalon will be focussing container development into two efforts.
  -       The first one is the creation of Avalon ESCA. To this end, most 
  -       existing avalon container projects will refocus to be part of
  +       The first one is the creation of Avalon SECA. To this end, most 
  +       existing Avalon container projects will refocus to be part of
          that goal.
    
          The roadmap for this effort is roughly as follows:
  @@ -23,9 +23,9 @@
          - Milestone 3:  Phoenix Compatible (Codename: Phoenix5)
          - Milestone 4:  Profileable, pluggable container (Codename: Spearhead)
    
  -       The second container development effort is the maintainance of existing 
  -       released efforts with an existing userbase, ie phoenix. This will merge 
  -       into the ESCA effort when there is an ESCA release compatible with
  +       The second container development effort is the maintenance of existing 
  +       released efforts with an existing userbase, i.e. Phoenix. This will merge 
  +       into the SECA effort when there is an SECA release compatible with
          those existing efforts.
      
          ====================================================================
  
  
  
  1.2       +1 -1      
jakarta-avalon-site/src/documentation/content/xdocs/seca/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/seca/index.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- index.xml 24 Jan 2003 16:59:23 -0000      1.1
  +++ index.xml 3 Feb 2003 15:43:39 -0000       1.2
  @@ -8,7 +8,7 @@
             <section>
               <title>Shaping up....</title>
               <p>This site is still shaping up. You need to go to
  -         <link href="http://jakarta.apache.org/avalon/";>the jakarta pages</link>
  +         <link href="http://jakarta.apache.org/avalon/";>the Jakarta pages</link>
            for now.</p>
             </section>
           </body>
  
  
  

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

Reply via email to