You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by cz...@apache.org on 2003/07/03 16:53:19 UTC
cvs commit: cocoon-site/site/community contrib.html mail-lists.html mail-archives.html members.html
cziegeler 2003/07/03 07:53:19
Modified: site/community members.html
Added: site/community contrib.html mail-lists.html
mail-archives.html
Log:
Updating website
Revision Changes Path
1.3 +12 -0 cocoon-site/site/community/members.html
Index: members.html
===================================================================
RCS file: /home/cvs/cocoon-site/site/community/members.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- members.html 24 Jun 2003 11:09:33 -0000 1.2
+++ members.html 3 Jul 2003 14:53:17 -0000 1.3
@@ -102,6 +102,18 @@
<li>
<span class="sel"><font color="#ffcc00">Members</font></span>
</li>
+
+<li>
+<a href="contrib.html">Contributing</a>
+</li>
+
+<li>
+<a href="mail-lists.html">Mail Lists</a>
+</li>
+
+<li>
+<a href="mail-archives.html">Mail Archives</a>
+</li>
</ul>
</li>
1.1 cocoon-site/site/community/contrib.html
Index: contrib.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Contribution to Apache Cocoon</title>
<link type="text/css" href="../skin/page.css" rel="stylesheet">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<!--================= start Navigation Path ==================-->
<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
</tr>
<tr>
<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
</table>
<!--================= end Navigation Path ==================-->
<!--================= start Banner ==================-->
<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<!--================= start Group Logo ==================-->
<td bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../images/cocoon-project-logo.png"></a></td>
<!--================= end Group Logo ==================-->
<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../images/cocoon-logo.gif"></a></td>
<!--================= end Project Logo ==================-->
<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
<form target="_blank" action="http://www.google.com/search" method="get">
<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
<tr>
<td colspan="3"><img height="10" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
<br>
<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
the Apache Cocoon site
</font></td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td><img alt="" border="0" height="10" width="9" src="../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../skin/images/search-right.gif"></td>
</tr>
</table>
</form>
</td>
<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td valign="bottom" bgcolor="#294563" colspan="2">
<!--================= start Tabs ==================-->
<div class="tab">
<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
<tr>
<td width="6"><img alt="" height="8" width="6" src="../skin/images/spacer.gif"></td><td valign="bottom">
<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
<tr>
<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../skin/images/tabSel-right.gif"></td>
</tr>
</table>
</td>
</tr>
</table>
</div>
<!--================= end Tabs ==================-->
</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
</table>
<!--================= end Banner ==================-->
<!--================= start Menu, NavBar, Content ==================-->
<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td valign="top">
<table summary="menu" border="0" cellspacing="0" cellpadding="0">
<tr>
<!--================= start left top NavBar ==================-->
<td rowspan="3" valign="top">
<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
<tr>
<td bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif"> </font></td>
</tr>
<tr>
<td bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
</table>
</td>
<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
<!--================= start Menu items ==================-->
<div class="menu">
<ul>
<li>
<font color="#CFDCED">Community</font>
<ul>
<li>
<a href="members.html">Members</a>
</li>
<li>
<span class="sel"><font color="#ffcc00">Contributing</font></span>
</li>
<li>
<a href="mail-lists.html">Mail Lists</a>
</li>
<li>
<a href="mail-archives.html">Mail Archives</a>
</li>
</ul>
</li>
</ul>
</div>
<!--================= end Menu items ==================-->
</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../skin/images/menu-right.gif"></td>
</tr>
<tr>
<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
</table>
</td><td valign="top" width="100%">
<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
<!--================= start middle NavBar ==================-->
<tr>
<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
</font><img width="10" height="8" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
</font><img width="10" height="8" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<!--================= end middle NavBar ==================-->
<!--================= start Content==================-->
<tr>
<td align="left" width="10"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
<div class="content">
<table class="title" summary="">
<tr>
<td valign="middle">
<h1>Contribution to Apache Cocoon</h1>
</td>
</tr>
</table>
<p>
<font size="-2">by Robin Green, Stefano Mazzocchi</font>
</p>
<ul class="minitoc">
<li>
<a href="#Introduction">Introduction</a>
</li>
<li>
<a href="#Help+Wanted+Here">Help Wanted Here</a>
</li>
<li>
<a href="#Contributions+of+Code+and+Documentation">Contributions of Code and Documentation</a>
<ul class="minitoc">
<li>
<a href="#Testing+Requirements+for+Cocoon+Contrib+and+Distribution">Testing Requirements for Cocoon Contrib and Distribution</a>
</li>
<li>
<a href="#Documentation+Requirements+for+Cocoon+Distribution">Documentation Requirements for Cocoon Distribution</a>
</li>
<li>
<a href="#Licensing+Requirements+for+the+Cocoon+Distribution">Licensing Requirements for the Cocoon Distribution</a>
</li>
</ul>
</li>
<li>
<a href="#CVS+Usage+Precis">CVS Usage Precis</a>
<ul class="minitoc">
<li>
<a href="#How+to+Establish+your+Local+Repository">How to Establish your Local Repository</a>
</li>
<li>
<a href="#How+to+Keep+it+Up-to-date">How to Keep it Up-to-date</a>
</li>
<li>
<a href="#How+to+Generate+Differences">How to Generate Differences</a>
</li>
<li>
<a href="#How+to+get+other+CVS+branches">How to get other CVS branches</a>
</li>
</ul>
</li>
<li>
<a href="#CVS+Committer+with+Secure+Shell+access">CVS Committer with Secure Shell access</a>
</li>
<li>
<a href="#Procedure+for+Raising+Development+Issues">Procedure for Raising Development Issues</a>
</li>
<li>
<a href="#Contribution+Notes+and+Tips">Contribution Notes and Tips</a>
</li>
</ul>
<a name="N10017"></a><a name="Introduction"></a>
<h3>Introduction</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
The Apache Cocoon Project is an <a href="http://www.opensource.org/">Open Source</a>
volunteer project under the auspices of the
<a href="http://www.apache.org/">Apache Software Foundation (ASF)</a>,
and, in harmony with the Apache webserver itself, it is released under
a very open license.
This means there are many ways to contribute to the project - either
with direct participation (coding, documenting, answering questions,
proposing ideas, reporting bugs, suggesting bug-fixes, etc..) or by resource
donations (money, time, publicity, hardware, software, conference
presentations, speeches, etc...).
</p>
<p>
To begin with, we suggest you to subscribe to the
<a href="mail-lists.html">Cocoon mailing lists</a>
(follow the link for information on how to subscribe and to access the mail
list archives). Listen-in for a while, to hear how others make contibutions.
</p>
<p>You can get your local working copy of the
<a href="http://cvs.apache.org/viewcvs.cgi/cocoon-2.1/">latest and
greatest code</a> (which you find in the cocoon-2.1 module in
the cvs.apache.org CVS code repository, or from the
<a href="http://xml.apache.org/cocoon/mirror.cgi#nightly">CVS snapshots</a>).
Review the <a href="http://cocoon.apache.org/2.1/todo.html">todo</a> list, choose a task
(or perhaps you have noticed something that needs patching). Make the
changes, do the testing, generate a patch, if you need then discuss it on
the cocoon-dev mailing list, and add the patch to Bugzilla.
(Do not worry - the process is easy and explained below.)
</p>
<p>
Document writers are usually the most wanted people so if
you like to help but you're not familiar with the innermost technical details, don't worry:
we have work for you!
</p>
</div>
<a name="N10041"></a><a name="Help+Wanted+Here"></a>
<h3>Help Wanted Here</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
The rest of this document is mainly about
contributing new or improved code and/or documentation, but we would also be glad to have
extra help in any of the following areas:
</p>
<ul>
<li>Answering questions on the <span class="codefrag">cocoon-users</span> mailing list - there is often a problem of
having too many questioners and not enough experts to respond to all the questions.</li>
<li>Testing Cocoon (especially its less-frequently-used features) on various configurations
and reporting back.</li>
<li>Debugging - producing reproduceable test cases and/or finding causes of bugs. Some known bugs are informally listed on
<a href="http://cocoon.apache.org/2.1/todo.html">To Do</a>, and some are recorded in Bugzilla
(see <a href="#procedure">explanation below</a>).</li>
<li>Specifying/analysing/designing new features for Cocoon - and beyond. (If you wish to get involved
with this, please join <span class="codefrag">dev@cocoon.apache.org</span>
(you may also want to join <span class="codefrag">xsp-dev@xml.apache.org</span>), install and try out Cocoon
and read some of the <a href="mail-lists.html">mail archives</a>.
You should have a strong "fluency" in XML technologies, Java and a basic understanding of
the Cocoon architecture - don't just say "it should have XYZ" without reading anything first -
because chances are, someone's already thought of that feature!)</li>
<li>Packaging easy-to-install packages (such as RPMs) for the myriad of possible configurations out
there. (The Cocoon project does not maintain anything but the basic <span class="codefrag">.zip</span> and
<span class="codefrag">.tar.gz</span> packages, but anyone is welcome to build their own specific packages and
announce them on <span class="codefrag">cocoon-users</span>)</li>
<li>... and there is just one other thing - don't forget to tell everyone who asks, how great Cocoon is! ;-)
The more people that know about and start to use Cocoon, the larger the pool of
potential contributors there will be
- so, please, help us by placing the Cocoon logo somewhere in your
site to indicate that you are using and supporting the Cocoon Project.
</li>
</ul>
<p>
Thank you very much.
</p>
</div>
<a name="N10080"></a><a name="Contributions+of+Code+and+Documentation"></a>
<h3>Contributions of Code and Documentation</h3>
<div style="margin-left: 0 ; border: 2px">
<p>We are starting to use an informal system for accepting contributions to Cocoon.
The process varies depending on whether the contribution is a modification (i.e. patch)
or a fairly standalone item, and whether you have commit access (committers have been
granted access by a vote of confidence, so they are assumed to be trustworthy enough
to make changes directly in CVS. If you submit many good patches, you may be
nominated as a committer yourself!)</p>
<p>If your contribution requires changing more than a few lines of Cocoon (code or
documentation), then it counts as a <strong>patch</strong>. If you have a patch and
would like to see it incorporated into the Cocoon distribution, take note of the Licensing
Requirements listed below, and then read the section
<a href="#procedure">Procedure for Raising Development Issues</a>
</p>
<p>A typical contribution (not a patch) may go through the following stages:</p>
<ol>
<li>Posted to cocoon-users with a URL to download it from.</li>
<!-- <li>Listed on 3rdparty.html by a maintainer. [No requirements, other than relevance (at the moment).]</li> -->
<li>Inclusion into the <span class="codefrag">contrib</span> directory,
which is for 3rd-party contributions that have been tested, but are not necessarily
mature enough or general enough for the main distribution. [Must be tested at least as
specified below. See also Licensing Requirements below.]</li>
<li>Inclusion into the main distribution. [Committers must be confident that it should work properly in
most/all environments, it must be documented as appropriate, and it must be considered sufficiently
useful and general to go into Cocoon. See also Licensing Requirements below].</li>
</ol>
<a name="N100A8"></a><a name="Testing+Requirements+for+Cocoon+Contrib+and+Distribution"></a>
<h4>Testing Requirements for Cocoon Contrib and Distribution</h4>
<div style="margin-left: 0 ; border: 2px">
<p>All new code should be tested under at least the following servlet engines:</p>
<ul>
<li>Apache Tomcat 3.2.2</li>
</ul>
<p>It should also be tested on the following platforms:</p>
<ul>
<li>A Windows operating system</li>
<li>A UNIX-type operating system</li>
<li>At least JDK version 1.3.x</li>
</ul>
<p>And obviously, it should be tested against the current CVS snapshot of Cocoon!</p>
<p>This testing is designed to iron out the most common kinds of incompatibility
problems (Servlet >2.2 requirements; platform-dependent assumptions; JDK >1.2 code).
These requirements are, of course, open to review and discussion. Note that
the contributor is not required to do the testing - indeed it is probably better
if someone else tests it, because the contributor might be tempted to do less
than thorough testing!</p>
</div>
<a name="N100CC"></a><a name="Documentation+Requirements+for+Cocoon+Distribution"></a>
<h4>Documentation Requirements for Cocoon Distribution</h4>
<div style="margin-left: 0 ; border: 2px">
<p>All new features (processor, logicsheets, config options etc.) should be documented
appropriately (in XML or in <span class="codefrag">cocoon.xconf</span> in the case of config options).</p>
<p>Use something like <span class="codefrag">xdocs/contrib.xml</span> as a rough guide, add
the new page(s) to <span class="codefrag">xdocs/book.xml</span> to create the menu-link
and type <span class="codefrag">build.sh docs</span> or <span class="codefrag">build.bat docs</span> to test the
documentation build.
</p>
</div>
<a name="N100E7"></a><a name="Licensing+Requirements+for+the+Cocoon+Distribution"></a>
<h4>Licensing Requirements for the Cocoon Distribution</h4>
<div style="margin-left: 0 ; border: 2px">
<p>To avoid legal problems, the Apache Project Management Committee (PMC) have agreed on
a policy for under what licensing code can be accepted into Apache projects:</p>
<ul>
<li>Source code files must be under the Apache license and must have copyright assigned to
the Apache Software Foundation.</li>
<li>Jar files need only be released under a license that permits free redistribution
and does not cover new files added to the jar/library (so the GPL and LGPL are not allowed,
but MPL and Apache licenses are, for example).</li>
</ul>
<p>
<strong>By submitting a patch, you signify your understanding and acceptance of these
conditions</strong> - like most open source projects,
we do not have the resources nor the inclination to obtain signed statements from all
contributors!</p>
<p>
<strong>Note:</strong> Since the <span class="codefrag">contrib/</span> directory of Cocoon CVS contains
third-party. completely optional extensions, one of the above requirements is relaxed.
Code in the contrib directory does not have to have its copyright assigned to the ASF
- but it must still be released under the Apache license.</p>
</div>
</div>
<a name="cvshowto"></a>
<a name="N1010A"></a><a name="CVS+Usage+Precis"></a>
<h3>CVS Usage Precis</h3>
<div style="margin-left: 0 ; border: 2px">
<p>An overview of how to use CVS to participate in Cocoon development.
Do not be afraid - you cannot accidently destroy the actual code repository,
because you are working with a local copy as an anonymous user. Therefore,
you do not have the system permissions to change anything. You can only
update your local repository and compare your revisions with the real
repository.
</p>
<p>
(Further general CVS usage information is at
<a href="http://www.cvshome.org/">www.cvshome.org</a> and your local
<span class="codefrag">info cvs</span> pages or <span class="codefrag">man cvs</span> pages or user
documentation.)
</p>
<p>
Let us lead by example. We will show you how to establish your local
repository, how to keep it up-to-date, and how to generate the differences
to create a patch. (The commands are for Linux.)
</p>
<a name="N10122"></a><a name="How+to+Establish+your+Local+Repository"></a>
<h4>How to Establish your Local Repository</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
This will checkout the current copy of the master cvs repository and
download it to your local disk. It will create a sub-directory called
<span class="codefrag">cocoon-2.1</span>
</p>
<ol>
<li>
<span class="codefrag">cd /usr/local/cvs</span>
</li>
<li>
<span class="codefrag">cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic login</span>
</li>
<li>... use this password: <span class="codefrag">anoncvs</span>
</li>
<li>
<span class="codefrag">cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic checkout cocoon-2.1</span>
</li>
<li>
<span class="codefrag">cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic logout</span>
</li>
<li>
<span class="codefrag">cd cocoon-2.1</span>
</li>
</ol>
<p>
You now have the HEAD branch of the current development cvs repository
for Cocoon on your local system. Go ahead and build and deploy as
usual. Make some changes, re-build, and see the effect.
</p>
</div>
<a name="N1014D"></a><a name="How+to+Keep+it+Up-to-date"></a>
<h4>How to Keep it Up-to-date</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
Every so often you should synchronise your local copy with the master
repository. Note that this definitely does not mean that your changes
will be applied to the master. Exactly the opposite will happen - updates
from the remote master version are merged into your local repository.
New items are automatically added to yours, and changed ones are refreshed.
If someone else happened to have submitted patches for the same files while
you were away, then changes will be merged with your copy and you will be
warned of any conflicts. Easy and automatic ...
</p>
<ol>
<li>
<span class="codefrag">cd /usr/local/cvs</span>
</li>
<li>
<span class="codefrag">cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic login</span>
</li>
<li>
<span class="codefrag">cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic update -d -P cocoon-2.1</span>
</li>
<li>
<strong>... pay attention to the update messages</strong>
</li>
<li>
<span class="codefrag">cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic logout</span>
</li>
</ol>
</div>
<a name="N1016D"></a><a name="How+to+Generate+Differences"></a>
<h4>How to Generate Differences</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
To contribute your modifications, you need to produce a plain-text file
containing the differences between the master copy and yours. You will
submit this to Bugzilla along with an explanation of why it is required,
and perhaps discuss it on the
<span class="codefrag">cocoon-dev</span> mailing list. One of the authorised
maintainers of the repository will review the patch and then apply it to the
relevant branch.
</p>
<p>
We will assume that you are adding some tips to this document
<span class="codefrag">xdocs/contrib.xml</span>
</p>
<ol>
<li>Make the desired changes in your local repository, build, test it
thoroughly</li>
<li>
<span class="codefrag">cd /usr/local/cvs/cocoon-2.1/xdocs</span>
</li>
<li>
<span class="codefrag">cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic login</span>
</li>
<li>
<span class="codefrag">cvs diff -u contrib.xml > $WORK/cocoon/contrib.xml.diff</span>
</li>
<li>
<span class="codefrag">cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic logout</span>
</li>
</ol>
</div>
<a name="N10195"></a><a name="How+to+get+other+CVS+branches"></a>
<h4>How to get other CVS branches</h4>
<div style="margin-left: 0 ; border: 2px">
<p>OK that got the HEAD branch of CVS into your local working copy.
If you want some other branch, then find the relevant branch name
from ViewCVS
<a href="http://cvs.apache.org/viewcvs.cgi/cocoon-2.1/">http://cvs.apache.org/viewcvs.cgi/cocoon-2.1/</a> (see the Tags list at the bottom).
Then follow the same checkout procedure described above, using this ...
</p>
<ul>
<li>
<span class="codefrag">cd /usr/local/cvs/cocoon_some_branch</span>
</li>
<li>
<span class="codefrag">cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic checkout cocoon-2.0</span>
</li>
</ul>
</div>
</div>
<a name="ssh"></a>
<a name="N101B1"></a><a name="CVS+Committer+with+Secure+Shell+access"></a>
<h3>CVS Committer with Secure Shell access</h3>
<div style="margin-left: 0 ; border: 2px">
<p>After a developer has consistently provided contributions (code,
documentation and discussion), then the rest of the cocoon-dev community
may vote to grant this developer commit access to CVS.
</p>
<p>You will need secure access to the repository to be able to commit
patches. Here are some resources that help to get your machine configured
to use the repository over SSH.
</p>
<ul>
<li>
<a href="http://cvsbook.red-bean.com/">The CVS Book</a>
</li>
<li>
<a href="http://www.cvshome.org/">www.cvshome.org</a>
</li>
<li>
<a href="http://jakarta.apache.org/site/cvsindex.html">Jakarta
Guide: CVS Repository</a>
- See the bottom of the page for links to tips for UNIX and Windows.
Even if you are on UNIX, the Windows page will also help.</li>
</ul>
</div>
<a name="procedure"></a>
<a name="N101D3"></a><a name="Procedure+for+Raising+Development+Issues"></a>
<h3>Procedure for Raising Development Issues</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
There are two methods for discussing development and submitting patches.
So that everyone can be productive, it is important to know which method
is appropriate for a certain situation and how to go about it without
confusion. This section explains when to use the
<span class="codefrag">cocoon-dev</span> <a href="mail-lists.html">mailing list</a>
and when to use
<a href="http://nagoya.apache.org/bugzilla/">Bugzilla</a>
(the Apache Bug Database).
</p>
<p>
Research your topic thoroughly before beginning to discuss a new
development issue. Search and browse through the email archives - your
issue may have been discussed before. Prepare your post clearly and
concisely.
</p>
<p>
Most issues will be discovered, resolved, and then patched quickly
via the <span class="codefrag">cocoon-dev</span> mailing list. Larger issues, and ones that
are not yet fully understood or are hard to solve, are destined for
Bugzilla.
</p>
<p>
Experienced developers use Bugzilla directly, as they are very sure
when they have found a bug and when not. However, less experienced users
should first discuss it on the user or developer mailing list (as
appropriate). Impatient people always enter everything into Bugzilla
without caring if it is a bug of Cocoon or their own
installation/configuration mistake - please do not do this.
</p>
<p>
As a rule-of-thumb, discuss an issue on the <span class="codefrag">cocoon-dev</span>
mailing list first to work out any details.
After it is confirmed to be worthwhile, and you are clear about it,
then submit the bug description via Bugzilla.
</p>
<p>
When you are sure about your proposed patch, then please submit it
via Bugzilla, rather than as email to <span class="codefrag">cocoon-dev</span>.
Be sure to add [PATCH] to the summary line, as this enables the automatic
patch alert system to keep track of it. If you do not follow this procedure,
then unfortunately your patch may be over-looked.
</p>
<p>
When posting discussion topics to the <span class="codefrag">cocoon-dev</span> list,
then please be patient.
Perhaps you do not get any answer on your first reply, so just post
it again until you get one. (But please not every hour - allow a few
days for the list to deal with it.) Do not be impatient - remember that
the whole world is busy, not just you. Bear in mind that other countries
will have holidays at different times to your country and that they are
in different time zones. You might also consider re-writing your initial
posting - perhaps it was not clear enough
and the readers' eyes glazed over.
</p>
</div>
<a name="tips"></a>
<a name="N10208"></a><a name="Contribution+Notes+and+Tips"></a>
<h3>Contribution Notes and Tips</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
This is a collection of tips for contributing to the project in a manner
that is productive for all parties.
</p>
<ul>
<li>
Every contribution is worthwhile. Even if the ensuing discussion
proves it to be off-beam, then it may jog ideas for other people.
</li>
<li>
Use sensible and concise email subject headings. Search engines, and
humans trying to browse a voluminous list, will respond favourably to a
descriptive title.
</li>
<li>
See <a href="mail-lists.html">Tips</a> for Cocoon mailing lists and
<a href="http://learn.to/edit_messages/">Message Editing and
Quoting Guide (with Examples)</a>.
</li>
<li>Start new threads with new Subject for new topics, rather than
re-using the previous Subject line.
</li>
<li>Keep each topic focussed. If some new topic arises then start a new
discussion. This leaves the original topic to continue un-cluttered.
</li>
<li>Whenever you decide to start a new topic, then start with a fresh
new email message window. Do not use the "Reply to" button,
because threaded mail-readers get confused (they utilise the
<span class="codefrag">In-reply-to</span> header). If so, then your new topic will get
lost in the previous thread and go un-answered.
</li>
<li>
Prepend your email subject line with a marker when that is appropriate,
e.g. <span class="codefrag">[Vote]</span>, <span class="codefrag">[Proposal]</span>,
<span class="codefrag">[RT]</span> (Random Thought which quickly blossom into research
topics :-), <span class="codefrag">[STATUS]</span> (development status of a certain
facility).
</li>
<li>
Please follow up with a final posting when your issue is solved. This
should summarise your problem and its solution. Add [SUMMARY] to the
subject line. This will ease the FAQ generation and searching of the list.
Note that some people tend to ignore questions from those that never
follow up.
</li>
<li>
When making changes to XML documentation, or any XML document for that
matter, use a
<a href="http://www.oasis-open.org/cover/">validating parser</a>
(one that is tried and true is
<a href="http://openjade.sourceforge.net/">OpenSP/onsgmls</a>).
This procedure will detect errors without having to go through the whole
<span class="codefrag">build docs</span> process to find them. Do not expect Cocoon
or the build system to detect the validation errors for you - they can
do it, but that is not their purpose. (Anyway, onsgmls validation error
messages are more informative.)
</li>
<li>
Remember that most people are participating in development on a
volunteer basis and in their "spare time". These enthusiasts will attempt
to respond to issues. It may take a little while to get your answers.
</li>
<li>
Research your topic thoroughly before beginning to discuss a new
development issue. Search and browse through the email archives - your
issue may have been discussed before. Do not just perceive a problem and
then rush out with a question - instead, delve.
</li>
<li>
Try to at least offer a partial solution and not just a problem statement.
</li>
<li>
Take the time to clearly explain your issue and write a concise email
message. Less confusion facilitates fast and complete resolution.
</li>
<li>
Do not bother to send an email reply that simply says "thanks".
When the issue is resolved, that is the finish - end of thread.
Reduce clutter.
</li>
<li>
You would usually do any development work against the HEAD branch of CVS.
</li>
<li>
When sending a patch, you usually do not need to worry about which CVS
branch it should be applied to. The maintainers of the repository will
decide.
</li>
<li>
If an issue starts to get bogged down in list discussion, then it may
be appropriate to go into private off-list discussion with a few interested
other people. Spare the list from the gory details. Report a summary back
to the list to finalise the thread.
</li>
<li>
Become familiar with the mailing lists. As you browse and search, you will
see the way other people do things. Follow the leading examples.
</li>
</ul>
</div>
</div>
</td><td width="10"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<!--================= end Content==================-->
</table>
</td>
</tr>
</table>
<!--================= end Menu, NavBar, Content ==================-->
<!--================= start Footer ==================-->
<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
<tr>
<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"><a href="../skin/images/label.gif"></a><a href="../skin/images/page.gif"></a><a href="../skin/images/chapter.gif"></a><a href="../skin/images/chapter_open.gif"></a><a href="../skin/images/current.gif"></a><a href="..//favicon.ico"></a></td>
</tr>
<tr>
<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
2003 The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
document.write(" - "+"Last Published: " + document.lastModified);
// --></script></font></td>
</tr>
<tr>
<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
</tr>
</table>
<!--================= end Footer ==================-->
</body>
</html>
1.1 cocoon-site/site/community/mail-lists.html
Index: mail-lists.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Mailing Lists</title>
<link type="text/css" href="../skin/page.css" rel="stylesheet">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<!--================= start Navigation Path ==================-->
<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
</tr>
<tr>
<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
</table>
<!--================= end Navigation Path ==================-->
<!--================= start Banner ==================-->
<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<!--================= start Group Logo ==================-->
<td bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../images/cocoon-project-logo.png"></a></td>
<!--================= end Group Logo ==================-->
<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../images/cocoon-logo.gif"></a></td>
<!--================= end Project Logo ==================-->
<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
<form target="_blank" action="http://www.google.com/search" method="get">
<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
<tr>
<td colspan="3"><img height="10" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
<br>
<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
the Apache Cocoon site
</font></td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td><img alt="" border="0" height="10" width="9" src="../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../skin/images/search-right.gif"></td>
</tr>
</table>
</form>
</td>
<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td valign="bottom" bgcolor="#294563" colspan="2">
<!--================= start Tabs ==================-->
<div class="tab">
<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
<tr>
<td width="6"><img alt="" height="8" width="6" src="../skin/images/spacer.gif"></td><td valign="bottom">
<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
<tr>
<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../skin/images/tabSel-right.gif"></td>
</tr>
</table>
</td>
</tr>
</table>
</div>
<!--================= end Tabs ==================-->
</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
</table>
<!--================= end Banner ==================-->
<!--================= start Menu, NavBar, Content ==================-->
<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td valign="top">
<table summary="menu" border="0" cellspacing="0" cellpadding="0">
<tr>
<!--================= start left top NavBar ==================-->
<td rowspan="3" valign="top">
<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
<tr>
<td bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif"> </font></td>
</tr>
<tr>
<td bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
</table>
</td>
<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
<!--================= start Menu items ==================-->
<div class="menu">
<ul>
<li>
<font color="#CFDCED">Community</font>
<ul>
<li>
<a href="members.html">Members</a>
</li>
<li>
<a href="contrib.html">Contributing</a>
</li>
<li>
<span class="sel"><font color="#ffcc00">Mail Lists</font></span>
</li>
<li>
<a href="mail-archives.html">Mail Archives</a>
</li>
</ul>
</li>
</ul>
</div>
<!--================= end Menu items ==================-->
</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../skin/images/menu-right.gif"></td>
</tr>
<tr>
<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
</table>
</td><td valign="top" width="100%">
<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
<!--================= start middle NavBar ==================-->
<tr>
<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
</font><img width="10" height="8" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
</font><img width="10" height="8" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<!--================= end middle NavBar ==================-->
<!--================= start Content==================-->
<tr>
<td align="left" width="10"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
<div class="content">
<table class="title" summary="">
<tr>
<td valign="middle">
<h1>Mailing Lists</h1>
</td>
</tr>
</table>
<ul class="minitoc">
<li>
<a href="#Important+Notice">Important Notice</a>
</li>
<li>
<a href="#Tips+%28keeping+focus+helps+your+points+come+across%21%29">Tips (keeping focus helps your points come across!)</a>
</li>
<li>
<a href="#Cocoon+Users">Cocoon Users</a>
</li>
<li>
<a href="#Cocoon+Dev">Cocoon Dev</a>
</li>
<li>
<a href="#Cocoon+Docs">Cocoon Docs</a>
</li>
<li>
<a href="#Cocoon+Cvs">Cocoon Cvs</a>
</li>
<li>
<a href="#XSP+Dev">XSP Dev</a>
</li>
<li>
<a href="#Related+Mailing+Lists">Related Mailing Lists</a>
</li>
</ul>
<a name="N1000C"></a><a name="Important+Notice"></a>
<h3>Important Notice</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
<strong>IMPORTANT: Before posting a question or problem to any mailing list,
</strong>please first look at the following resources:</p>
<ol>
<li>
<a href="http://cocoon.apache.org/2.1/faq/index.html">FAQs</a>
</li>
<li>
<a href="http://cocoon.apache.org/2.1/link/index.html">Cocoon Links</a>
</li>
<li>
<a href="mail-archives.html">Mailing list archives</a> -
a veritable goldmine of Cocoon-specific information - if you know where to look!</li>
</ol>
<p>
<strong>IMPORTANT:</strong> Careful postings please.
These are high-volume lists, so we all needs ways to help us all
work smarter.
See tips for <a href="contrib.html#tips">Contributing</a>
</p>
</div>
<a name="N10034"></a><a name="Tips+%28keeping+focus+helps+your+points+come+across%21%29"></a>
<h3>Tips (keeping focus helps your points come across!)</h3>
<div style="margin-left: 0 ; border: 2px">
<p>We use the mail list both as a media to transmit our thoughts and as a
virtual location to hang around and feel part of something.
</p>
<p>
In order for the second to happen, you just have to subscribe. That's
it, nothing fancy.
</p>
<p>
But in order for the first to happen (transmit your thoughts) it's an
entirely different matter.
</p>
<p>
Here are a few things that help a lot:
</p>
<p>
1) reduce noise, increase signal: your email client will quote the
message you are replying to automatically, but it's *your*
responsibility to remove those parts that aren't part of the signal of
your email. Sure, you might let this operation to the reader, but you
must understand that the reader is not supposed to do this. Or, at
least, it should be *you* to make the reader confortable.
</p>
<p>
2) be respectful, be aware of community dynamics: sending HTML in the
mail more than *doubles* the message size and interferes with text-based
mail clients. You want your point to come across, so make sure that
everybody can get to that point with the *easiest* possible effort, or,
otherwise, your signal might be wasted in the noise and the time you
think you are saving, you are, in fact, loosing it completely.
</p>
<p>
3) promote your signal: people on mail lists are used to read tons of
email a day. Without a good 'promotion' of your points, they might get
missed in the noise. (note: 'noise' is a subjective notion, what is
signal for you might be noise for others, it's up to you to make your
signal stand up). Things that help in this respect:
</p>
<p>
a) a simple yet effective email title. Geeks are ultimately curious
animals, tickle their curiosity!
</p>
<p>
b) be elegant and visually effective. Sure, you have to use ASCII,
but there is a lot that you can convey with ASCII
</p>
<pre class="code">
+---------------------------------+
| I'm sure nobody will miss this! |
+---------------------------------+
</pre>
<p>
c) structure your text. Whenever possible, use *strong* or
_underline_ or /italic/ or use bullet lists and so on. Consider textual
RFC, that's how you should write your emails. Sure, it takes a little
more time, but I guarantee you that it saves a lot of it later on.
</p>
<p>
d) keep paragraphs short! you can go on and on forever, I'm sure you
do, but keep your point focused, so that the signal/noise ratio is
increased.
</p>
<p>
4) be respectful of other's opinion: your email will be stored forever,
archived in several locations around the world, indexed by Google,
locked in magnetic tapes into the NSA caves and so on. Just keep this in
mind before you hit "send", this will keep your ego honest :)
</p>
<p>
5) admit your incapacity/ignorance/mistakes: there is nothing more
appreciated in a community that someone that can stand up and apologize
for something. Remember: if you don't make mistakes, you can't learn.
And if you don't admit you made it, nobody knows you are learning :)
</p>
<p>
Keep all these things in mind and you'll be impressed by how much fun
and knowledge you can get out of all this open development thing.
</p>
</div>
<a name="N1005C"></a><a name="Cocoon+Users"></a>
<h3>Cocoon Users</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
<a href="mailto:users-subscribe@cocoon.apache.org">Subscribe</a>
<a href="mailto:users-unsubscribe@cocoon.apache.org">Unsubscribe</a>
</p>
<p>The general Cocoon list, for problems, bug reports, asking for advice on how
best to implement a site, comparisons with other XML frameworks, etc.
But don't forget to look in the FAQ first, please!</p>
<p>
<strong>This is not an appropriate list for general XSL and XML questions.</strong>
Instead look at the various resources listed at the
<a href="http://cocoon.apache.org/2.1/link/index.html">Cocoon Links</a> pages,
or try the
<a href="http://www.mulberrytech.com/xsl/">Mulberrytech XSL list</a>.</p>
<p>
<strong>This is also not an appropriate list for general Java questions.</strong>
Instead try <a href="news:comp.lang.java.help">news:comp.lang.java.help</a>
or <a href="http://hotdispatch.com/">http://hotdispatch.com/</a>, for
example.</p>
<p>
<strong>IMPORTANT:</strong> If you are posting about a problem you are having
(as most people do), it will aid in finding a speedy resolution if you provide
full configuration details (especially the <strong>Cocoon version number</strong>,
but also your operating system, JDK version, and servlet engine), and full details
of any errors encountered (including full error messages and stack traces).</p>
<p>Please also have some consideration for the other users on the list - this is a
busy list and we do not appreciate getting the exact same message posted impatiently
several times a day/week! Doing so is only likely to make your question answered more
slowly, or not at all, not faster.</p>
<div class="frame note">
<div class="label">Note</div>
<div class="content">This list is moderated, so the first time you post, there will be a
delay before your post is reviewed and accepted. This is to prevent spam.</div>
</div>
</div>
<a name="N10098"></a><a name="Cocoon+Dev"></a>
<h3>Cocoon Dev</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
<a href="mailto:dev-subscribe@cocoon.apache.org">Subscribe</a>
<a href="mailto:dev-unsubscribe@cocoon.apache.org">Unsubscribe</a>
</p>
<p>This list is for developers <strong>working on</strong> or wanting to work on
Cocoon itself (not developers merely working <strong>with</strong> Cocoon),
for code patches to Cocoon to be posted (please use <span class="codefrag">diff -u</span> format),
and for general Cocoon questions.</p>
<p>Note this is <strong>NOT</strong> for general Cocoon questions like "Why
isn't Cocoon working on my machine?" -
please ask those sorts of questions on cocoon-users (after reading the
FAQ first, of course).</p>
<div class="frame note">
<div class="label">Note</div>
<div class="content">This list is moderated, so the first time you post, there will be a
delay before your post is reviewed and accepted. This is to prevent spam.</div>
</div>
</div>
<a name="N100BE"></a><a name="Cocoon+Docs"></a>
<h3>Cocoon Docs</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
<a href="mailto:docs-subscribe@cocoon.apache.org">Subscribe</a>
<a href="mailto:docs-unsubscribe@cocoon.apache.org">Unsubscribe</a>
</p>
<p>This list is for everyone (users and developers) to assist with building
the Cocoon documentation.
</p>
<p>
Please be careful to limit cross-posting between the Cocoon lists. You can
assume that all developers are also subscribed to cocoon-docs.
Any docs-related thread on -users or -dev should be moved to -docs (do not
Cc the original list, but send a short reply to indicate that the thread
has moved).
</p>
<div class="frame note">
<div class="label">Note</div>
<div class="content">This list is moderated, so the first time you post, there will be a
delay before your post is reviewed and accepted. This is to prevent spam.</div>
</div>
</div>
<a name="N100D8"></a><a name="Cocoon+Cvs"></a>
<h3>Cocoon Cvs</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
<a href="mailto:cvs-subscribe@cocoon.apache.org">Subscribe</a>
<a href="mailto:cvs-unsubscribe@cocoon.apache.org">Unsubscribe</a>
</p>
<p>This <strong>read-only</strong> list sends out notification messages detailing
any change made to the CVS repository where all the source code and libraries
are stored for development purposes. The average user probably doesn't need to
subscribe to this list.</p>
<div class="frame note">
<div class="label">Note</div>
<div class="content">You should never post to this list at all. Only the
CVS server should post to it.</div>
</div>
</div>
<a name="N100F2"></a><a name="XSP+Dev"></a>
<h3>XSP Dev</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
<a href="mailto:xsp-dev-subscribe@xml.apache.org">Subscribe</a>
<a href="mailto:xsp-dev-unsubscribe@xml.apache.org">Unsubscribe</a>
</p>
<p>This list began life on November 2000, and was created to discuss the
standardisation and implementation of the dynamic content language XSP,
which is used not only in Cocoon but in other software such as AxKit.
You are recommended to have a strong working knowledge of XSP before joining
this list.</p>
<p>Note this is <strong>NOT</strong> for general XSP questions like
"Why doesn't my XSP page work?" - please ask those sorts of questions on
the relevant list for your XSP software (e.g. cocoon-users if you're using
Cocoon) - after checking the FAQ first of course!
</p>
</div>
<a name="N1010C"></a><a name="Related+Mailing+Lists"></a>
<h3>Related Mailing Lists</h3>
<div style="margin-left: 0 ; border: 2px">
<p>(See also <a href="http://dmoz.org/Computers/Data_Formats/Markup_Languages/XML/">
ODP XML links</a> for related websites.)</p>
<ul>
<li>
<a href="http://www.mulberrytech.com/xsl/">Mulberrytech XSL list</a> -
more appropriate than Cocoon Users for general XSL questions.</li>
<li>
<a href="http://xml.apache.org/mail.html">XML Apache Projects</a> -
list of mailing lists for all the projects on xml.apache.org.</li>
<li>Some servlet engines have their own mailing lists for servlet-engine
configuration questions, such as
<a href="mailto:tomcat-user-subscribe@jakarta.apache.org">tomcat-user</a> (note it is "user"
and not "users").</li>
</ul>
</div>
</div>
</td><td width="10"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<!--================= end Content==================-->
</table>
</td>
</tr>
</table>
<!--================= end Menu, NavBar, Content ==================-->
<!--================= start Footer ==================-->
<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
<tr>
<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"><a href="../skin/images/label.gif"></a><a href="../skin/images/page.gif"></a><a href="../skin/images/chapter.gif"></a><a href="../skin/images/chapter_open.gif"></a><a href="../skin/images/current.gif"></a><a href="..//favicon.ico"></a></td>
</tr>
<tr>
<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
2003 The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
document.write(" - "+"Last Published: " + document.lastModified);
// --></script></font></td>
</tr>
<tr>
<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
</tr>
</table>
<!--================= end Footer ==================-->
</body>
</html>
1.1 cocoon-site/site/community/mail-archives.html
Index: mail-archives.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Mail Archives</title>
<link type="text/css" href="../skin/page.css" rel="stylesheet">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<!--================= start Navigation Path ==================-->
<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
</tr>
<tr>
<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
</table>
<!--================= end Navigation Path ==================-->
<!--================= start Banner ==================-->
<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<!--================= start Group Logo ==================-->
<td bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../images/cocoon-project-logo.png"></a></td>
<!--================= end Group Logo ==================-->
<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../images/cocoon-logo.gif"></a></td>
<!--================= end Project Logo ==================-->
<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
<form target="_blank" action="http://www.google.com/search" method="get">
<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
<tr>
<td colspan="3"><img height="10" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
<br>
<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
the Apache Cocoon site
</font></td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td><img alt="" border="0" height="10" width="9" src="../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../skin/images/search-right.gif"></td>
</tr>
</table>
</form>
</td>
<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td valign="bottom" bgcolor="#294563" colspan="2">
<!--================= start Tabs ==================-->
<div class="tab">
<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
<tr>
<td width="6"><img alt="" height="8" width="6" src="../skin/images/spacer.gif"></td><td valign="bottom">
<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
<tr>
<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../skin/images/tabSel-right.gif"></td>
</tr>
</table>
</td>
</tr>
</table>
</div>
<!--================= end Tabs ==================-->
</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
</table>
<!--================= end Banner ==================-->
<!--================= start Menu, NavBar, Content ==================-->
<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td valign="top">
<table summary="menu" border="0" cellspacing="0" cellpadding="0">
<tr>
<!--================= start left top NavBar ==================-->
<td rowspan="3" valign="top">
<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
<tr>
<td bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif"> </font></td>
</tr>
<tr>
<td bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
</table>
</td>
<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
<!--================= start Menu items ==================-->
<div class="menu">
<ul>
<li>
<font color="#CFDCED">Community</font>
<ul>
<li>
<a href="members.html">Members</a>
</li>
<li>
<a href="contrib.html">Contributing</a>
</li>
<li>
<a href="mail-lists.html">Mail Lists</a>
</li>
<li>
<span class="sel"><font color="#ffcc00">Mail Archives</font></span>
</li>
</ul>
</li>
</ul>
</div>
<!--================= end Menu items ==================-->
</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../skin/images/menu-right.gif"></td>
</tr>
<tr>
<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
</table>
</td><td valign="top" width="100%">
<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
<!--================= start middle NavBar ==================-->
<tr>
<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
</font><img width="10" height="8" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
</font><img width="10" height="8" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<!--================= end middle NavBar ==================-->
<!--================= start Content==================-->
<tr>
<td align="left" width="10"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
<div class="content">
<table class="title" summary="">
<tr>
<td valign="middle">
<h1>Mail Archives</h1>
</td>
</tr>
</table>
<ul class="minitoc">
<li>
<a href="#Mailing+List+Archives">Mailing List Archives</a>
</li>
</ul>
<a name="N1000C"></a><a name="Mailing+List+Archives"></a>
<h3>Mailing List Archives</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
There are a number of mailing list archives available. Email
<a href="mailto:users@cocoon.apache.org">users.at.cocoon.apache.org</a> if you
know of more.
</p>
<table class="ForrestTable" cellspacing="1" cellpadding="4">
<tr>
<th colspan="1" rowspan="1">Cocoon-users</th>
<th colspan="1" rowspan="1">Cocoon-dev</th>
<th colspan="1" rowspan="1">Cocoon-docs</th>
<th colspan="1" rowspan="1">Regularly updated?</th>
<th colspan="1" rowspan="1">Searchable?</th>
<th colspan="1" rowspan="1">Speed</th>
<th colspan="1" rowspan="1">Other features?</th>
</tr>
<!-- this has been broken for a while
we hid this entry on 2001-11-23 (bring it back when the server recovers)
<tr>
<td colspan="2"><link href="http://mail-archives.apache.org/">http://mail-archives.apache.org</link></td>
<td>No, at present</td>
<td>No</td>
<td>3/5</td>
<td></td>
</tr>
-->
<tr>
<td colspan="1" rowspan="1"><a href="http://marc.theaimsgroup.com/?l=xml-cocoon-users&r=1&w=2">
Aims Group - U</a></td>
<td colspan="1" rowspan="1"><a href="http://marc.theaimsgroup.com/?l=xml-cocoon-dev&r=1&w=2">
Aims Group - De</a></td>
<td colspan="1" rowspan="1"><a href="http://marc.theaimsgroup.com/?l=xml-cocoon-docs&r=1&w=2">
Aims Group - Do</a></td>
<td colspan="1" rowspan="1">Yes</td>
<td colspan="1" rowspan="1">Onsite, by subject/author/body</td>
<td colspan="1" rowspan="1">4/5</td>
<td colspan="1" rowspan="1">Chunked listings</td>
</tr>
<!-- real-time.com has been broken for a while
we hid this listing on 2001-11-23 (bring it back when they recover)
<tr>
<td><link href="http://mailman.real-time.com/pipermail/cocoon-users/">
RealTime - U</link></td>
<td><link href="http://mailman.real-time.com/pipermail/cocoon-devel/">
RealTime - D</link></td>
<td>No, at present</td>
<td>Yes</td>
<td>Yes - use www.google.com and prepend search with
<code>site:mailman.real-time.com cocoon-users</code></td>
<td>3/5</td>
<td>Sort by author/subject/date</td>
</tr>
-->
<tr>
<td colspan="1" rowspan="1"><a href="http://www.mail-archive.com/cocoon-users@xml.apache.org/">
Mail Archive - U</a></td>
<td colspan="1" rowspan="1"><a href="http://www.mail-archive.com/cocoon-dev@xml.apache.org/">
Mail Archive - De</a></td>
<td colspan="1" rowspan="1">No, at present</td>
<td colspan="1" rowspan="1">Yes</td>
<td colspan="1" rowspan="1">Onsite and can also use www.google.com and prepend search with
<span class="codefrag">site:www.mail-archive.com cocoon-users</span></td>
<td colspan="1" rowspan="1">4/5</td>
<td colspan="1" rowspan="1">Sort by thread/date</td>
</tr>
<tr>
<td colspan="1" rowspan="1"><a href="http://xml.apache.org/mail/cocoon-users/">
xml.apache.org - U</a></td>
<td colspan="1" rowspan="1"><a href="http://xml.apache.org/mail/cocoon-dev/">
xml.apache.org - De</a></td>
<td colspan="1" rowspan="1"><a href="http://xml.apache.org/mail/cocoon-docs/">
xml.apache.org - Do</a></td>
<td colspan="1" rowspan="1">Yes</td>
<td colspan="1" rowspan="1">No</td>
<td colspan="1" rowspan="1">2/5</td>
<td colspan="1" rowspan="1">Bulk retrieval (gzipped monthly)</td>
</tr>
<tr>
<td colspan="1" rowspan="1">Ezlm archives (email <a href="mailto:cocoon-users-help@xml.apache.org">
cocoon-users-help @ xml.apache.org</a> for automated instructions)</td>
<td colspan="1" rowspan="1">Ezlm archives (email <a href="mailto:cocoon-dev-help@xml.apache.org">
cocoon-dev-help @ xml.apache.org</a> for automated instructions)</td>
<td colspan="1" rowspan="1">??? (Does someone know?)</td>
<td colspan="1" rowspan="1">Yes</td>
<td colspan="1" rowspan="1">No</td>
<td colspan="1" rowspan="1">1/5</td>
<td colspan="1" rowspan="1">Bulk retrieval</td>
</tr>
</table>
</div>
</div>
</td><td width="10"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<!--================= end Content==================-->
</table>
</td>
</tr>
</table>
<!--================= end Menu, NavBar, Content ==================-->
<!--================= start Footer ==================-->
<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
<tr>
<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"><a href="../skin/images/label.gif"></a><a href="../skin/images/page.gif"></a><a href="../skin/images/chapter.gif"></a><a href="../skin/images/chapter_open.gif"></a><a href="../skin/images/current.gif"></a><a href="..//favicon.ico"></a></td>
</tr>
<tr>
<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
2003 The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
document.write(" - "+"Last Published: " + document.lastModified);
// --></script></font></td>
</tr>
<tr>
<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
</tr>
</table>
<!--================= end Footer ==================-->
</body>
</html>