Author: bago
Date: Tue Apr 17 14:51:04 2007
New Revision: 529781
URL: http://svn.apache.org/viewvc?view=rev&rev=529781
Log:
Guidelines and FAQ for the dns issue.
Added:
james/site/trunk/www/guidelines.html
Modified:
james/site/trunk/www/code-standards.html
james/site/trunk/www/contribute.html
james/site/trunk/www/dependencies.html
james/site/trunk/www/dependency-convergence.html
james/site/trunk/www/download.html
james/site/trunk/www/index.html
james/site/trunk/www/integration.html
james/site/trunk/www/issue-tracking.html
james/site/trunk/www/license.html
james/site/trunk/www/mail-lists.html
james/site/trunk/www/mail.html
james/site/trunk/www/newsarchive.html
james/site/trunk/www/project-info.html
james/site/trunk/www/project-summary.html
james/site/trunk/www/server/FAQ.html
james/site/trunk/www/source-repository.html
james/site/trunk/www/team-list.html
james/site/trunk/www/weare.html
Modified: james/site/trunk/www/code-standards.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/code-standards.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/code-standards.html (original)
+++ james/site/trunk/www/code-standards.html Tue Apr 17 14:51:04 2007
@@ -48,7 +48,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -118,6 +118,10 @@
<li class="none">
<a href="mail.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
</li>
<li class="none">
Modified: james/site/trunk/www/contribute.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/contribute.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/contribute.html (original)
+++ james/site/trunk/www/contribute.html Tue Apr 17 14:51:04 2007
@@ -48,7 +48,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -118,6 +118,10 @@
<li class="none">
<a href="mail.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
</li>
<li class="none">
Modified: james/site/trunk/www/dependencies.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/dependencies.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/dependencies.html (original)
+++ james/site/trunk/www/dependencies.html Tue Apr 17 14:51:04 2007
@@ -45,7 +45,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -115,6 +115,10 @@
<li class="none">
<a href="mail.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
</li>
<li class="none">
Modified: james/site/trunk/www/dependency-convergence.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/dependency-convergence.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/dependency-convergence.html (original)
+++ james/site/trunk/www/dependency-convergence.html Tue Apr 17 14:51:04 2007
@@ -45,7 +45,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -115,6 +115,10 @@
<li class="none">
<a href="mail.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
</li>
<li class="none">
Modified: james/site/trunk/www/download.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/download.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/download.html (original)
+++ james/site/trunk/www/download.html Tue Apr 17 14:51:04 2007
@@ -48,7 +48,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -118,6 +118,10 @@
<li class="none">
<a href="mail.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
</li>
<li class="none">
Added: james/site/trunk/www/guidelines.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/guidelines.html?view=auto&rev=529781
==============================================================================
--- james/site/trunk/www/guidelines.html (added)
+++ james/site/trunk/www/guidelines.html Tue Apr 17 14:51:04 2007
@@ -0,0 +1,471 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+<html>
+ <head>
+ <title>James Project -
+ Apache JAMES Project Guidelines</title>
+ <style type="text/css" media="all">
+ @import url("./css/maven-base.css");
+ @import url("./css/maven-theme.css");
+ @import url("./css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css"
media="print" />
+ <meta name="author" content="
+ James Project Web Team" />
+ <meta http-equiv="Content-Type" content="text/html;
charset=ISO-8859-1" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="index.html" id="bannerLeft">
+
+ <img
src="images/james-project-logo.gif" alt="" />
+
+ </a>
+ <a href="http://www.apache.org/index.html"
id="bannerRight">
+
+ <img
src="images/asf-logo-reduced.gif" alt="" />
+
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+
+
+
+
+
+ <div class="xleft">
+ Last Published: 04/17/2007
+ </div>
+ <div class="xright"> <a href="index.html">JAMES Project</a>
+ |
+ <a href="server/index.html">Server</a>
+ |
+ <a href="jspf/index.html">jSPF</a>
+ |
+ <a href="mime4j/index.html">Mime4J</a>
+ |
+ <a href="jsieve/index.html">JSieve</a>
+ |
+ <a href="postage/index.html">Postage</a>
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+
+
+
+
+
+ <h5>Sub Projects</h5>
+ <ul>
+
+ <li class="none">
+ <a href="server/index.html">Server</a>
+ </li>
+
+ <li class="none">
+ <a href="jspf/index.html">jSPF</a>
+ </li>
+
+ <li class="none">
+ <a href="mime4j/index.html">Mime4J</a>
+ </li>
+
+ <li class="none">
+ <a href="jsieve/index.html">JSieve</a>
+ </li>
+
+ <li class="none">
+ <a href="postage/index.html">Postage</a>
+ </li>
+ </ul>
+ <h5>About</h5>
+ <ul>
+
+ <li class="none">
+ <a href="newsarchive.html">News</a>
+ </li>
+
+ <li class="none">
+ <a href="index.html">Overview</a>
+ </li>
+
+ <li class="none">
+ <a href="mail.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <strong>Project Guidelines</strong>
+ </li>
+
+ <li class="none">
+ <a href="http://wiki.apache.org/james">Wiki</a>
+ </li>
+
+ <li class="none">
+ <a href="weare.html">Who We Are</a>
+ </li>
+
+ <li class="none">
+ <a href="contribute.html">Contributing</a>
+ </li>
+
+ <li class="none">
+ <a href="code-standards.html">Standards</a>
+ </li>
+
+ <li class="none">
+ <a href="license.html">License</a>
+ </li>
+ </ul>
+ <h5>Downloads</h5>
+ <ul>
+
+ <li class="none">
+ <a href="download.cgi">Stable releases</a>
+ </li>
+
+ <li class="none">
+ <a href="http://people.apache.org/dist/james">Test builds</a>
+ </li>
+
+ <li class="none">
+ <a href="http://people.apache.org/builds/james/nightly/">Nightly
builds</a>
+ </li>
+ </ul>
+ <h5>Translated</h5>
+ <ul>
+
+ <li class="none">
+ <a href="http://james.terra-intl.com/">Japanese (web)</a>
+ </li>
+ </ul>
+ <h5>Related Projects</h5>
+ <ul>
+
+ <li class="none">
+ <a href="http://jakarta.apache.org/commons/index.html">Jakarta
Commons</a>
+ </li>
+
+ <li class="none">
+ <a href="http://ant.apache.org/index.html">Ant</a>
+ </li>
+
+ <li class="none">
+ <a href="http://maven.apache.org/index.html">Maven2</a>
+ </li>
+
+ <li class="none">
+ <a href="http://db.apache.org/derby/index.html">Derby</a>
+ </li>
+
+ <li class="none">
+ <a href="http://avalon.apache.org/index.html">Avalon</a>
+ </li>
+
+ <li class="none">
+ <a href="http://www.dnsjava.org/index.html">DNSJava</a>
+ </li>
+ </ul>
+ <h5>Useful Information</h5>
+ <ul>
+
+ <li class="none">
+ <a href="http://jakarta.apache.org/site/getinvolved.html">Get
Involved</a>
+ </li>
+
+ <li class="none">
+ <a href="http://jakarta.apache.org/site/library.html">Reference
Library</a>
+ </li>
+
+ <li class="none">
+ <a href="http://apache.org/foundation/faq.html">Apache</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/"
title="Built by Maven" id="poweredBy">
+ <img alt="Built by Maven"
src="./images/logos/maven-feather.png"></img>
+ </a>
+
+
+
+
+
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+
+
+
+ <a name="Apache JAMES Project Guidelines"></a><div
class="section"><h2>Apache JAMES Project Guidelines</h2>
+
+<p>
+ This document defines the guidelines for the Apache JAMES Project. It
includes definitions of how conflict is resolved by voting, who is able to
vote, and the procedures to follow for proposing and making changes to the
Apache JAMES products.
+
+</p>
+<p>
+ The objective here is to avoid unnecessary conflict over changes and
continue to produce a quality system in a timely manner. Not all conflict can
be avoided, but at least we can agree on the procedures for conflict to be
resolved.
+
+</p>
+ </div>
+ <a name="People, Places, and Things"></a><div class="section"><h2>People,
Places, and Things</h2>
+
+ <a name="Apache JAMES Project Management Committee"></a><div
class="section"><h3>Apache JAMES Project Management Committee</h3>
+<p>
+ The group of volunteers who are responsible for managing the Apache
JAMES Project. This includes deciding what is distributed as products of the
Apache JAMES Project, maintaining the Project's shared resources, speaking on
behalf of the Project, resolving license disputes regarding Apache JAMES
products, nominating new PMC members or committers, and establishing these
guidelines.
+
+</p>
+<p>
+ Membership in the Apache JAMES PMC is by invitation only and must be
approved by consensus of the active Apache JAMES PMC members. A PMC member is
considered inactive by their own declaration or by not contributing in any form
to the project for over six months. An inactive member can become active again
by reversing whichever condition made them inactive (i.e., by reversing their
earlier declaration or by once again contributing toward the project's work).
Membership can be revoked by a unanimous vote of all the active PMC members
other than the member in question.
+
+</p>
+ </div>
+ <a name="Apache JAMES Committers"></a><div class="section"><h3>Apache
JAMES Committers</h3>
+<p>
+ The group of volunteers who are responsible for the technical aspects
of the Apache JAMES Project. This group has write access to the appropriate
source repositories and these volunteers may cast non-binding votes on any
technical discussion.
+</p>
+<p>
+ Membership as a Committer is by invitation only and must be approved
by consensus of the active Apache JAMES PMC members. A Committer is considered
inactive by their own declaration or by not contributing in any form to the
project for over six months. An inactive member can become active again by
reversing whichever condition made them inactive (i.e., by reversing their
earlier declaration or by once again contributing toward the project's work).
Membership can be revoked by a unanimous vote of all the active PMC members
(except the member in question if they are a PMC member).
+
+</p>
+ </div>
+ <a name="mailing list"></a><div class="section"><h3>mailing list</h3>
+<p>
+ The Apache committers' primary mailing list for discussion of issues
and changes related to the project ([EMAIL PROTECTED]). Subscription to the
list is open, but only subscribers can post directly to the list.
+
+</p>
+ </div>
+ <a name="private list"></a><div class="section"><h3>private list</h3>
+<p>
+ The Apache JAMES Project's private mailing list for discussion of
issues that are inappropriate for public discussion, such as legal, personal,
or security issues prior to a published fix. Subscription to the list is only
open to Apache JAMES PMC members and Apache Software Foundation Members.
+
+</p>
+ </div>
+ <a name="SVN"></a><div class="section"><h3>SVN</h3>
+<p>
+ All of the Apache JAMES products are maintained in shared information
repositories using SVN on svn.apache.org. The Apache committers have write
access to these repositories; everyone has read access via anonymous SVN.
+
+</p>
+ </div>
+ </div>
+ <a name="STATUS"></a><div class="section"><h2>STATUS</h2>
+
+<p>
+ Each of the Apache Project's active source code repositories contain a
file called "STATUS" which is used to keep track of the agenda and
plans for work within that repository. The STATUS file includes information
about release plans, a summary of code changes committed since the last
release, a list of proposed changes that are under discussion, brief notes
about items that individual committers are working on or want discussion about,
and anything else that might be useful to help the group track progress. The
active STATUS files are automatically posted to the mailing list each week.
+
+</p>
+<p>
+ Many issues will be encountered by the project, each resulting in zero or
more proposed action items. Issues should be raised on the mailing list as soon
as they are identified. Action items must be raised on the mailing list and
added to the relevant STATUS file. All action items may be voted on, but not
all of them will require a formal vote.
+
+</p>
+ </div>
+ <a name="Voting"></a><div class="section"><h2>Voting</h2>
+
+<p>
+ Any of the Apache JAMES Committers may vote on any issue or action item.
However, the only binding votes are those cast by active members of the Apache
James PMC; if the vote is about a change to source code or documentation, the
primary author of what is being changed may also cast a binding vote on that
issue. All other votes are non-binding. All committers are encouraged to
participate in decisions, but the decision itself is made by those who have
been long-time contributors to the project. In other words, the Apache Project
is a minimum-threshold meritocracy.
+
+</p>
+<p>
+ The act of voting carries certain obligations -- voting members are not
only stating their opinion, they are agreeing to help do the work of the Apache
Project. Since we are all volunteers, members often become inactive for periods
of time in order to take care of their "real jobs" or devote more
time to other projects. It is therefore unlikely that the entire group
membership will vote on every issue. To account for this, all voting decisions
are based on a minimum quorum.
+
+</p>
+<p>
+ Each vote can be made in one of three flavors:
+</p>
+<p>
+ <strong>+1</strong><br></br>
+ Yes, agree, or the action should be performed. On some issues, this
vote is only binding if the voter has tested the action on their own system(s).
+</p>
+<p>
+ <strong>+-0</strong><br></br>
+ Abstain, no opinion, or I am happy to let the other group members
decide this issue. An abstention may have detrimental effects if too many
people abstain.
+</p>
+<p>
+ <strong>-1</strong><br></br>
+ No. On issues where consensus is required, this vote counts as a veto.
All vetos must include an explanation of why the veto is appropriate. A veto
with no explanation is void. No veto can be overruled. If you disagree with the
veto, you should lobby the person who cast the veto. Voters intending to veto
an action item should make their opinions known to the group immediately, so
that the problem can be remedied as early as possible.
+
+</p>
+<p>
+ An action item requiring consensus approval must receive at least 3
binding +1 votes and no vetos. An action item requiring majority approval must
receive at least 3 binding +1 votes and more +1 votes than -1 votes (i.e., a
majority with a minimum quorum of three positive votes). All other action items
are considered to have lazy approval until someone votes -1, after which point
they are decided by either consensus or a majority vote, depending upon the
type of action item.
+
+</p>
+<p>
+ Votes are tallied within the STATUS file, adjacent to the action item
under vote. All votes must be either sent to the mailing list or added directly
to the STATUS file entry for that action item.
+</p>
+
+<p>
+ Votes are to remain open for 72 hours after which the developer who put
forth the vote should tabulate the result and send this to the mailing list. A
developer should be sensitive to holidays that could dampen participation in
the vote.
+</p>
+
+ </div>
+ <a name="Types of Action Items"></a><div class="section"><h2>Types of
Action Items</h2>
+
+ <a name="Long Term Plans"></a><div class="section"><h3>Long Term Plans</h3>
+<p>
+ Long term plans are simply announcements that group members are
working on particular issues related to the Apache software. These are not
voted on, but group members who do not agree with a particular plan, or think
an alternate plan would be better, are obligated to inform the group of their
feelings. In general, it is always better to hear about alternate plans prior
to spending time on less adequate solutions.
+</p>
+ </div>
+ <a name="Short Term Plans"></a><div class="section"><h3>Short Term
Plans</h3>
+<p>
+ Short term plans are announcements that a developer is working on a
particular set of documentation or code files, with the implication that other
committers should avoid them or try to coordinate their changes. This is a good
way to proactively avoid conflict and possible duplication of work.
+</p>
+ </div>
+ <a name="Release Plan"></a><div class="section"><h3>Release Plan</h3>
+<p>
+ A release plan is used to keep all the committers aware of when a
release is desired, who will be the release manager, when the repository will
be frozen in order to create the release, and assorted other trivia to keep us
from tripping over ourselves during the final moments. Lazy majority decides
each issue in the release plan.
+</p>
+ </div>
+ <a name="Release Testing"></a><div class="section"><h3>Release Testing</h3>
+<p>
+ After a new release is built, colloquially termed a tarball, it must
be tested before being released to the public. Majority approval is required
before the tarball can be publically released.
+</p>
+ </div>
+ <a name="Showstoppers"></a><div class="section"><h3>Showstoppers</h3>
+<p>
+ Showstoppers are issues that require a fix be in place before the next
public release. They are listed in the STATUS file in order to focus special
attention on the problem. An issue becomes a showstopper when it is listed as
such in STATUS and remains so by lazy consensus.
+</p>
+ </div>
+ <a name="Product Changes"></a><div class="section"><h3>Product Changes</h3>
+<p>
+ Changes to the Apache JAMES products, including code and
documentation, will appear as action items under several categories
corresponding to the change status:
+
+</p>
+ </div>
+ <a name="Concept/Plan"></a><div class="section"><h3>Concept/Plan</h3>
+<p>
+ An idea or plan for a change. These are usually only listed in
STATUS when the change is substantial, significantly impacts the API, or is
likely to be controversial. Votes are being requested early so as to uncover
conflicts before too much work is done.
+</p>
+ </div>
+ <a name="Proposed Patch"></a><div class="section"><h3>Proposed Patch</h3>
+<p>
+ A specific set of changes to the current product in the form of
input to the patch command (a diff output).
+</p>
+ </div>
+ <a name="Committed Change"></a><div class="section"><h3>Committed
Change</h3>
+<p>
+ A one-line summary of a change that has been committed to the
repository since the last public release.
+</p>
+<p>
+
+ All product changes to the currently active repository are subject to
lazy consensus. All product changes to a prior-branch (old version) repository
require consensus before the change is committed.
+</p>
+
+ </div>
+ </div>
+ <a name="When to Commit a Change"></a><div class="section"><h2>When to
Commit a Change</h2>
+
+<p>
+ Ideas must be review-then-commit; patches can be commit-then-review. With
a commit-then-review process, we trust that the developer doing the commit has
a high degree of confidence in the change. Doubtful changes, new features, and
large-scale overhauls need to be discussed before being committed to a
repository. Any change that affects the semantics of arguments to configurable
directives, significantly adds to the runtime size of the program, or changes
the semantics of an existing API function must receive consensus approval on
the mailing list before being committed.
+
+</p>
+ <p>
+ Each developer is responsible for notifying the mailing list and adding
an action item to STATUS when they have an idea for a new feature or major
change to propose for the product. The distributed nature of the Apache project
requires an advance notice of 48 hours in order to properly review a major
change -- consensus approval of either the concept or a specific patch is
required before the change can be committed. Note that a member might veto the
concept (with an adequate explanation), but later rescind that veto if a
specific patch satisfies their objections. No advance notice is required to
commit singular bug fixes.
+
+</p>
+ <p>
+ Related changes should be committed as a group, or very closely together.
Half-completed projects should not be committed unless doing so is necessary to
pass the baton to another developer who has agreed to complete the project in
short order. All code changes must be successfully compiled on the developer's
platform before being committed.
+
+</p>
+ <p>
+ The current source code tree should be capable of complete compilation at
all times. However, it is sometimes impossible for a developer on one platform
to avoid breaking some other platform when a change is committed, particularly
when completing the change requires access to a special development tool on
that other platform. If it is anticipated that a given change will break some
other platform, the committer must indicate that in the commit log.
+
+</p>
+ <p>
+ The committer is responsible for the quality of any third-party code or
documentation they commit to the repository. All software committed to the
repository must be covered by the Apache LICENSE or contain a copyright and
license that allows redistribution under the same conditions as the Apache
LICENSE.
+
+</p>
+ <p>
+ A committed change must be reversed if it is vetoed by one of the voting
members and the veto conditions cannot be immediately satisfied by the
equivalent of a "bug fix" commit. The veto must be rescinded before
the change can be included in any public release.
+
+</p>
+ </div>
+ <a name="Patch Format"></a><div class="section"><h2>Patch Format</h2>
+
+ <p>
+ When a specific change to the software is proposed for discussion or
voting on the mailing list, it should be presented in the form of input to the
patch command. When sent to the mailing list, the message should contain a
Subject beginning with [PATCH] and a distinctive one-line summary corresponding
to the action item for that patch. Afterwords, the patch summary in the STATUS
file should be updated to point to the Message-ID of that message.
+
+</p>
+ <p>
+ The patch should be created by using the diff -u command from the
original software file(s) to the modified software file(s). E.g.,
+</p>
+<p>
+
+ diff -u James.java.orig James.java >> patchfile.txt
+
+</p>
+ <p>
+ All patches necessary to address an action item should be concatenated
within a single patch message. If later modification of the patch proves
necessary, the entire new patch should be posted and not just the difference
between two patches. The STATUS file entry should then be updated to point to
the new patch message.
+
+</p>
+ <p>
+ The completed patchfile should produce no errors or prompts when the
command,
+</p>
+<p>
+
+ patch -s < patchfile
+</p>
+<p>
+
+ is issued in the target repository.
+</p>
+ </div>
+
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2006-2007
+
+ The Apache Software Foundation
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <script src="http://www.google-analytics.com/urchin.js"
type="text/javascript">
+ </script>
+ <script type="text/javascript">
+ _uacct = "UA-1384591-1";
+ urchinTracker();
+ </script>
+ </body>
+</html>
Modified: james/site/trunk/www/index.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/index.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/index.html (original)
+++ james/site/trunk/www/index.html Tue Apr 17 14:51:04 2007
@@ -48,7 +48,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -121,6 +121,10 @@
</li>
<li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
+ </li>
+
+ <li class="none">
<a href="http://wiki.apache.org/james">Wiki</a>
</li>
@@ -237,6 +241,7 @@
<i>Read all the news in full in the <a href="newsarchive.html">News
Archive</a></i><br></br>
<i>Or click the titles to read the full story</i>
<a name="2007"></a><div class="section"><h3>2007</h3>
+ <a href="newsarchive.html#04162007"><strong>Apr/2007 - Apache JAMES
Project Guidelines published</strong></a><br></br>
<a href="newsarchive.html#02092007"><strong>Feb/2007 - jSPF-0.9b4
released</strong></a><br></br>
<a href="newsarchive.html#02012007"><strong>Feb/2007 - Feathercast
features JAMES</strong></a><br></br>
<a href="newsarchive.html#01012007"><strong>Jan/2007 - Mailet API to
become sub-project</strong></a><br></br>
Modified: james/site/trunk/www/integration.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/integration.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/integration.html (original)
+++ james/site/trunk/www/integration.html Tue Apr 17 14:51:04 2007
@@ -45,7 +45,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -115,6 +115,10 @@
<li class="none">
<a href="mail.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
</li>
<li class="none">
Modified: james/site/trunk/www/issue-tracking.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/issue-tracking.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/issue-tracking.html (original)
+++ james/site/trunk/www/issue-tracking.html Tue Apr 17 14:51:04 2007
@@ -45,7 +45,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -115,6 +115,10 @@
<li class="none">
<a href="mail.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
</li>
<li class="none">
Modified: james/site/trunk/www/license.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/license.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/license.html (original)
+++ james/site/trunk/www/license.html Tue Apr 17 14:51:04 2007
@@ -48,7 +48,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -118,6 +118,10 @@
<li class="none">
<a href="mail.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
</li>
<li class="none">
Modified: james/site/trunk/www/mail-lists.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/mail-lists.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/mail-lists.html (original)
+++ james/site/trunk/www/mail-lists.html Tue Apr 17 14:51:04 2007
@@ -45,7 +45,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -115,6 +115,10 @@
<li class="none">
<a href="mail.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
</li>
<li class="none">
Modified: james/site/trunk/www/mail.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/mail.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/mail.html (original)
+++ james/site/trunk/www/mail.html Tue Apr 17 14:51:04 2007
@@ -48,7 +48,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -118,6 +118,10 @@
<li class="none">
<strong>Mailing Lists</strong>
+ </li>
+
+ <li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
</li>
<li class="none">
Modified: james/site/trunk/www/newsarchive.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/newsarchive.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/newsarchive.html (original)
+++ james/site/trunk/www/newsarchive.html Tue Apr 17 14:51:04 2007
@@ -48,7 +48,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -121,6 +121,10 @@
</li>
<li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
+ </li>
+
+ <li class="none">
<a href="http://wiki.apache.org/james">Wiki</a>
</li>
@@ -228,6 +232,8 @@
</div>
</div>
<a name="2007"></a><div class="section"><h3>2007</h3>
+ <a name="04162007"><h4>Apr/2007 - Apache JAMES Project Guidelines
published</h4></a>
+ <p>The James PMC has approved - for the first time - a set of <a
href="guidelines.html">guidelines</a> for the project. These guidelines are
intended to reflect and summarize well-known practices in our community. They
include "... definitions of how conflict is resolved by voting, who is
able to vote, and the procedures to follow for proposing and making changes to
the Apache JAMES products." </p>
<a name="02092007"><h4>Feb/2007 - jSPF-0.9b4 released</h4></a>
<p>James PMC is proud to announce the <a
href="http://www.apache.org/dist/james/jspf/beta">availability</a> of the
fourth beta of jspf 0.9. This version pass all tests in the last official
release of the <a
href="http://www.openspf.org/svn/project/test-suite/rfc4408-tests-2007.01.yml">spf
testsuite</a>.</p>
<a name="02012007"><h4>Feb/2007 - Feathercast features James</h4></a>
Modified: james/site/trunk/www/project-info.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/project-info.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/project-info.html (original)
+++ james/site/trunk/www/project-info.html Tue Apr 17 14:51:04 2007
@@ -45,7 +45,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -118,6 +118,10 @@
</li>
<li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
+ </li>
+
+ <li class="none">
<a href="http://wiki.apache.org/james">Wiki</a>
</li>
@@ -215,7 +219,7 @@
</div>
<div id="bodyColumn">
<div id="contentBox">
- <div class="section"><h2>Project Information</h2><p>This document
provides an overview of the various documents and links that are part of this
project's general information. All of this content is automatically generated
by <a href="http://maven.apache.org">Maven</a> on behalf of the
project.</p><div class="section"><h3>Overview</h3><table class="bodyTable"><tr
class="a"><th>Document</th><th>Description</th></tr><tr class="b"><td><a
href="project-summary.html">Project Summary</a></td><td>This document lists
other related information of this project</td></tr><tr class="a"><td><a
href="dependencies.html">Dependencies</a></td><td>This document lists the
projects dependencies and provides information on each dependency.</td></tr><tr
class="b"><td><a href="integration.html">Continuous
Integration</a></td><td>This is a link to the definitions of all continuous
integration processes that builds and tests code on a frequent, regular
basis.</td></tr><tr class="a"><td><a href
="mail-lists.html">Mailing Lists</a></td><td>This document provides
subscription and archive information for this project's mailing
lists.</td></tr><tr class="b"><td><a href="team-list.html">Project
Team</a></td><td>This document provides information on the members of this
project. These are the individuals who have contributed to the project in one
form or another.</td></tr><tr class="a"><td><a
href="dependency-convergence.html">Dependency Convergence</a></td><td>This
document presents the convergence of dependency versions across the entire
project, and its sub modules.</td></tr><tr class="b"><td><a
href="issue-tracking.html">Issue Tracking</a></td><td>This is a link to the
issue management system for this project. Issues (bugs, features, change
requests) can be created and queried using this link.</td></tr><tr
class="a"><td><a href="source-repository.html">Source
Repository</a></td><td>This is a link to the online source repository that can
be viewed via a web browser.</t
d></tr></table></div></div>
+ <div class="section"><h2>Project Information</h2><p>This document
provides an overview of the various documents and links that are part of this
project's general information. All of this content is automatically generated
by <a href="http://maven.apache.org">Maven</a> on behalf of the
project.</p><div class="section"><h3>Overview</h3><table class="bodyTable"><tr
class="a"><th>Document</th><th>Description</th></tr><tr class="b"><td><a
href="dependencies.html">Dependencies</a></td><td>This document lists the
projects dependencies and provides information on each dependency.</td></tr><tr
class="a"><td><a href="team-list.html">Project Team</a></td><td>This document
provides information on the members of this project. These are the individuals
who have contributed to the project in one form or another.</td></tr><tr
class="b"><td><a href="mail-lists.html">Mailing Lists</a></td><td>This document
provides subscription and archive information for this project's mailing lists.
</td></tr><tr class="a"><td><a href="integration.html">Continuous
Integration</a></td><td>This is a link to the definitions of all continuous
integration processes that builds and tests code on a frequent, regular
basis.</td></tr><tr class="b"><td><a href="source-repository.html">Source
Repository</a></td><td>This is a link to the online source repository that can
be viewed via a web browser.</td></tr><tr class="a"><td><a
href="project-summary.html">Project Summary</a></td><td>This document lists
other related information of this project</td></tr><tr class="b"><td><a
href="issue-tracking.html">Issue Tracking</a></td><td>This is a link to the
issue management system for this project. Issues (bugs, features, change
requests) can be created and queried using this link.</td></tr><tr
class="a"><td><a href="dependency-convergence.html">Dependency
Convergence</a></td><td>This document presents the convergence of dependency
versions across the entire project, and its sub modules.</t
d></tr></table></div></div>
</div>
</div>
<div class="clear">
Modified: james/site/trunk/www/project-summary.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/project-summary.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/project-summary.html (original)
+++ james/site/trunk/www/project-summary.html Tue Apr 17 14:51:04 2007
@@ -45,7 +45,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -115,6 +115,10 @@
<li class="none">
<a href="mail.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
</li>
<li class="none">
Modified: james/site/trunk/www/server/FAQ.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/server/FAQ.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/server/FAQ.html (original)
+++ james/site/trunk/www/server/FAQ.html Tue Apr 17 14:51:04 2007
@@ -48,7 +48,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="../index.html">JAMES Project</a>
|
@@ -234,6 +234,9 @@
<li>
<a href="#17">How do I use Subversion to get James source code?</a>
</li>
+ <li>
+ <a href="#18">How can I control Sun's JVM DNS Lookup
Configuration.</a>
+ </li>
</ul>
</div>
@@ -308,7 +311,7 @@
<processor> spam </processor>
</mailet>
</pre></div>
- <p>This tells the processor that anything not in this address list
should go to the spam processor.</p>
+ This tells the processor that anything not in this address list should
go to the spam processor.
<p>Please note that if you wish to configure James to allow users to
send email from any domain or IP address you will need to disable this matcher.
In this situation you must use SMTP AUTH to ensure that your server does not
act as an open relay. For more on open relays, please see <a
href="http://www.ordb.org">the Open Relay Database</a>.</p>
</div>
<a name="4"></a>
@@ -466,6 +469,15 @@
<br></br>Now go to <a
href="http://subversion.tigris.org/">http://subversion.tigris.org/</a> and
download a subversion client.
<br></br>James subversion repository is at
<b>http://svn.apache.org/repos/asf/james/server</b>. Commiters use
"https".
<br></br>You may want to search the web, our <a
href="http://www.mail-archive.com/[EMAIL PROTECTED]/">dev</a> and <a
href="http://www.mail-archive.com/[EMAIL PROTECTED]/">user</a> mail archives or
our <a href="http://wiki.apache.org/james">wiki</a> for more information.</p>
+ </div>
+ <a name="18"></a>
+ <a name="How can I control Sun's JVM DNS Lookup
Configuration."></a><div class="section"><h3>How can I control Sun's JVM DNS
Lookup Configuration.</h3>
+<p>Sun's JVM Internet address lookup uses a cache which is unbounded and
doesn't time out.<br></br>
+This is obviously not great for a long running process like a mail server so
we have introduced a system property <strong>networkaddress.cache.ttl</strong>
that is used by the distributed phoenix start-up scripts, at startup, to
override the java 1.4
<strong>Security.setProperty("networkaddress.cache.ttl")</strong>.<br></br>
By default this is set to <strong>300</strong> seconds.</p>
+<p>This workaround will only be present if you use James as distributed. If
you use James in any other container, including different versions of Phoenix,
you will need to ensure that you make a similar configuration change to allow
the internet address cache to perform acceptably.</p>
+<p>James 2.3 has this workaround and it requires it to operate acceptably.
Future versions of James will continue to have the workaround in place but will
*not* require it. This will provide continued support for any mailets which you
may deploy from other sources which might continue to use Sun's InetAddress
class for DNS resolution.</p>
+<p>We are not currently aware of the behaviour of this cache in other JVM
implementations, nor of the effect, if any, which this change might have on
them</p>
+<p>For more on this read defect report <a
href="http://issues.apache.org/jira/browse/JAMES-592">JAMES-592</a> and related
defects.</p>
</div>
</div>
Modified: james/site/trunk/www/source-repository.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/source-repository.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/source-repository.html (original)
+++ james/site/trunk/www/source-repository.html Tue Apr 17 14:51:04 2007
@@ -45,7 +45,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -115,6 +115,10 @@
<li class="none">
<a href="mail.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
</li>
<li class="none">
Modified: james/site/trunk/www/team-list.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/team-list.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/team-list.html (original)
+++ james/site/trunk/www/team-list.html Tue Apr 17 14:51:04 2007
@@ -45,7 +45,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -115,6 +115,10 @@
<li class="none">
<a href="mail.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
</li>
<li class="none">
Modified: james/site/trunk/www/weare.html
URL:
http://svn.apache.org/viewvc/james/site/trunk/www/weare.html?view=diff&rev=529781&r1=529780&r2=529781
==============================================================================
--- james/site/trunk/www/weare.html (original)
+++ james/site/trunk/www/weare.html Tue Apr 17 14:51:04 2007
@@ -48,7 +48,7 @@
<div class="xleft">
- Last Published: 03/31/2007
+ Last Published: 04/17/2007
</div>
<div class="xright"> <a href="index.html">JAMES Project</a>
|
@@ -118,6 +118,10 @@
<li class="none">
<a href="mail.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="guidelines.html">Project Guidelines</a>
</li>
<li class="none">