james-server-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From da...@apache.org
Subject svn commit: r124203 - in james/server/trunk/src/xdocs: . stylesheets
Date Wed, 05 Jan 2005 14:10:37 GMT
Author: danny
Date: Wed Jan  5 06:10:29 2005
New Revision: 124203

URL: http://svn.apache.org/viewcvs?view=rev&rev=124203
Log:
Site updates to handle closure of Avalon, removal of James from Jakarta mail pages, migration to SVN, alumni-isation of inactive commiters, to even out font sizes, change copyright year, and finally acknowledge my employer.
Added:
   james/server/trunk/src/xdocs/mail.xml
Modified:
   james/server/trunk/src/xdocs/FAQ.xml
   james/server/trunk/src/xdocs/index.xml
   james/server/trunk/src/xdocs/stylesheet.css
   james/server/trunk/src/xdocs/stylesheets/project.xml
   james/server/trunk/src/xdocs/stylesheets/site.xsl
   james/server/trunk/src/xdocs/weare.xml

Modified: james/server/trunk/src/xdocs/FAQ.xml
Url: http://svn.apache.org/viewcvs/james/server/trunk/src/xdocs/FAQ.xml?view=diff&rev=124203&p1=james/server/trunk/src/xdocs/FAQ.xml&r1=124202&p2=james/server/trunk/src/xdocs/FAQ.xml&r2=124203
==============================================================================
--- james/server/trunk/src/xdocs/FAQ.xml	(original)
+++ james/server/trunk/src/xdocs/FAQ.xml	Wed Jan  5 06:10:29 2005
@@ -1,86 +1,89 @@
 <?xml version="1.0"?>
 <document>
-   <properties>
-      <title>Frequently Asked Questions</title>
-      <author email="site-dev@james.apache.org">James Project Web Team</author>
-   </properties>
-   <body>
-      <section name="This FAQ">
-         <P>This is a living document that provides answers to common questions about James, installation, configuration, admin and running not already answered in the documentation. Last Updated August 2002.</P>
-      </section>
-      <section name="Questions">
-         <p>
-            <ul>
-               <li>
-                  <a href="#1">How do I set up a mailing list</a>
-               </li>
-               <li>
-                  <a href="#2">Is James an Open Relay for Spam?</a>
-               </li>
-               <li>
-                  <a href="#3">I can send messages to James, but nobody is receiving them.  What do I do?</a>
-               </li>
-               <li>
-                  <a href="#4">I can send people messages via James, but nobody can send me messages.  What do I do?</a>
-               </li>
-               <li>
-                  <a href="#5">I'm trying to debug messages that James is trying to deliver.  Where should I look?</a>
-               </li>
-               <li>
-                  <a href="#6">What about IMAP support?</a>
-               </li>
-               <li>
-                  <a href="#7">What about support virtual hosting?</a>
-               </li>
-               <li>
-                  <a href="#8">Where do I stick classes and jars?</a>
-               </li>
-               <li>
-                  <a href="#9">How do I upgrade to a newer version of James?</a>
-               </li>
-               <li>
-                  <a href="#10">How do I run James as an NT/2k/XP service?</a>
-               </li>
-               <li>
-                  <a href="#11">Why isn't my mailet making changes to a MimeMessage?</a>
-               </li>
-                <li>
-                  <a href="#12">How to remove unneeded services like NNTP, POP3?</a>
-               </li>
-               <li>
-                  <a href="#13">How can I contribute to James?</a>
-               </li>
-               <li>
-                  <a href="#14">How can I make sendmail route local mail (or all mail) through James on the same machine?</a>
-               </li>
-               <li>
-                  <a href="#15">I am using Microsoft's SQL Type 4 JDBC Driver, why do I get a "Can't start manual transaction mode because there are cloned connections" exception?</a>
-               </li>
-               <li>
-                  <a href="#16">I am using James with a MySQL database and I keep getting a "Packet is larger than max_allowed_packet" when receiving large messages despite the fact that my max packet size is configured to be larger than my max message size.  What's going on?</a>
-               </li>
-            </ul>
-         </p>
-      </section>
-      <section name="Answers">
-         <a name="1"/>
-         <subsection name="Would you please teach me how to set up a mailing list">
-            <p>James currently (v2.1) includes only the most basic list functionality, users can subscribe and unsubscribe, but there is no moderation of messages or subscriptions</p>
-            <p>To enable a list you need the following in config.xml in the root processor block and above the final mailet block -</p>
-            <source>
+  <properties>
+    <title>Frequently Asked Questions</title>
+    <author email="site-dev@james.apache.org">James Project Web Team</author>
+  </properties>
+  <body>
+    <section name="This FAQ">
+      <P>This is a living document that provides answers to common questions about James, installation, configuration, admin and running not already answered in the documentation. Last Updated January 2005.</P>
+    </section>
+    <section name="Questions">
+      <p>
+        <ul>
+          <li>
+            <a href="#1">How do I set up a mailing list</a>
+          </li>
+          <li>
+            <a href="#2">Is James an Open Relay for Spam?</a>
+          </li>
+          <li>
+            <a href="#3">I can send messages to James, but nobody is receiving them.  What do I do?</a>
+          </li>
+          <li>
+            <a href="#4">I can send people messages via James, but nobody can send me messages.  What do I do?</a>
+          </li>
+          <li>
+            <a href="#5">I'm trying to debug messages that James is trying to deliver.  Where should I look?</a>
+          </li>
+          <li>
+            <a href="#6">What about IMAP support?</a>
+          </li>
+          <li>
+            <a href="#7">What about support virtual hosting?</a>
+          </li>
+          <li>
+            <a href="#8">Where do I stick classes and jars?</a>
+          </li>
+          <li>
+            <a href="#9">How do I upgrade to a newer version of James?</a>
+          </li>
+          <li>
+            <a href="#10">How do I run James as an NT/2k/XP service?</a>
+          </li>
+          <li>
+            <a href="#11">Why isn't my mailet making changes to a MimeMessage?</a>
+          </li>
+          <li>
+            <a href="#12">How to remove unneeded services like NNTP, POP3?</a>
+          </li>
+          <li>
+            <a href="#13">How can I contribute to James?</a>
+          </li>
+          <li>
+            <a href="#14">How can I make sendmail route local mail (or all mail) through James on the same machine?</a>
+          </li>
+          <li>
+            <a href="#15">I am using Microsoft's SQL Type 4 JDBC Driver, why do I get a "Can't start manual transaction mode because there are cloned connections" exception?</a>
+          </li>
+          <li>
+            <a href="#16">I am using James with a MySQL database and I keep getting a "Packet is larger than max_allowed_packet" when receiving large messages despite the fact that my max packet size is configured to be larger than my max message size.  What's going on?</a>
+          </li>
+          <li>
+            <a href="#17">How do I use Subversion to get James source code?</a>
+          </li>
+        </ul>
+      </p>
+    </section>
+    <section name="Answers">
+      <a name="1"/>
+      <subsection name="Would you please teach me how to set up a mailing list">
+        <p>James currently (v2.1) includes only the most basic list functionality, users can subscribe and unsubscribe, but there is no moderation of messages or subscriptions</p>
+        <p>To enable a list you need the following in config.xml in the root processor block and above the final mailet block -</p>
+        <source>
 &lt;mailet match="CommandForListserv=james@localhost"
     class="AvalonListservManager">
     &lt;repositoryName>list-james&lt;/repositoryName>
 &lt;/mailet>
 </source>
-            <p>that will intercept the command emails sent to
+        <p>that will intercept the command emails sent to
 <ul>
-                  <li>james-on@localhost to subscribe the sender</li>
-                  <li>james-off@localhost to unsubscribe the sender</li>
-               </ul>
-            </p>
-            <p>and-</p>
-            <source>
+            <li>james-on@localhost to subscribe the sender</li>
+            <li>james-off@localhost to unsubscribe the sender</li>
+          </ul>
+        </p>
+        <p>and-</p>
+        <source>
 &lt;mailet match="RecipientIs=james@localhost" class="AvalonListserv">
     &lt;membersonly> false &lt;/membersonly>
     &lt;attachmentsallowed> true &lt;/attachmentsallowed>
@@ -89,79 +92,78 @@
     &lt;subjectprefix>JamesList&lt;/subjectprefix>
 &lt;/mailet>
 </source>
-            <p>Which will distribute the mail to the current subscribers</p>
-            <p>in addition to the above you need to have a repository configured in the users-store block(usually near the bottom of config.xml) like so (database)-</p>
-            <source>
+        <p>Which will distribute the mail to the current subscribers</p>
+        <p>in addition to the above you need to have a repository configured in the users-store block(usually near the bottom of config.xml) like so (database)-</p>
+        <source>
 &lt;repository name="list-james"
     class="org.apache.james.userrepository.ListUsersJdbcRepository"
     destinationURL="db://maildb/lists/list-james">
     &lt;sqlFile>file://conf/sqlResources.xml&lt;/sqlFile>
 &lt;/repository>
 </source>
-            <p>Database users will also need to ensure that they have <a href="using_database_2_1.html">configured a data-source</a> named to match the destination URL</p>
-            <p>Using the filesystem:-</p>
-            <source>
+        <p>Database users will also need to ensure that they have <a href="using_database_2_1.html">configured a data-source</a> named to match the destination URL</p>
+        <p>Using the filesystem:-</p>
+        <source>
 &lt;repository name="list-james"
     class="org.apache.james.userrepository.UsersFileRepository">
     &lt;destination URL="file://var/lists/list-james/"/>
 &lt;/repository>
 </source>
-            <p>Restart James, send a mail to james-on@localhost and you should be subscribed.</p>
-            <p>The repository, be it a database table or directory in the filesystem will be created automatically.</p>
-            <p>Database users can manipulate the users repository using SQL, and hence any application capable of running SQL queries against it.</p>
-         </subsection>
-         <a name="2"/>
-         <subsection name="James seems to be an open relay for Spam, is it?">
-            <p>In some simple tests of mail relays James appears to be an open relay, properly configured it is not. </p>
-            <p>Because James is an email application platform it currently accepts all mail delivered to it via SMTP for processing. Only after the mail has been recieved does this processing begin.</p>
-            <p>This means that James accepts Spam. However the default configuration, and any sensible re-configuration has a number of anti-spam measures which will prevent the re-transmisson of spam from James. This makes it a blackhole for spam.</p>
-            <p>This also means that James will not verify addresses, but of course this means that valid addresses can't be harvested from James by spammers either.</p>
-         </subsection>
-         <a name="3"/>
-         <subsection name="I can send messages to James, but nobody is receiving them.  What do I do?">
-            <p>Check that you've added valid DNS servers to your James installation.  Email delivery requires the use of special mail related DNS information (MX records), so James needs to explicitly be given DNS servers.  Look at your config.xml file for a &lt;dnsserver&gt; section and add one or more DNS servers.</p>
-            <p>Additionally, check the RemoteAddrNotInNetwork matcher under&lt;processor name="transport"&gt;. By default it looks like this:</p>
-<source>
+        <p>Restart James, send a mail to james-on@localhost and you should be subscribed.</p>
+        <p>The repository, be it a database table or directory in the filesystem will be created automatically.</p>
+        <p>Database users can manipulate the users repository using SQL, and hence any application capable of running SQL queries against it.</p>
+      </subsection>
+      <a name="2"/>
+      <subsection name="James seems to be an open relay for Spam, is it?">
+        <p>In some simple tests of mail relays James appears to be an open relay, properly configured it is not. </p>
+        <p>Because James is an email application platform it currently accepts all mail delivered to it via SMTP for processing. Only after the mail has been recieved does this processing begin.</p>
+        <p>This means that James accepts Spam. However the default configuration, and any sensible re-configuration has a number of anti-spam measures which will prevent the re-transmisson of spam from James. This makes it a blackhole for spam.</p>
+        <p>This also means that James will not verify addresses, but of course this means that valid addresses can't be harvested from James by spammers either.</p>
+      </subsection>
+      <a name="3"/>
+      <subsection name="I can send messages to James, but nobody is receiving them.  What do I do?">
+        <p>Check that you've added valid DNS servers to your James installation.  Email delivery requires the use of special mail related DNS information (MX records), so James needs to explicitly be given DNS servers.  Look at your config.xml file for a &lt;dnsserver&gt; section and add one or more DNS servers.</p>
+        <p>Additionally, check the RemoteAddrNotInNetwork matcher under&lt;processor name="transport"&gt;. By default it looks like this:</p>
+        <source>
 &lt;mailet match="RemoteAddrNotInNetwork=127.0.0.1" class="ToProcessor"&gt;
     &lt;processor&gt; spam &lt;/processor&gt;
 &lt;/mailet&gt;
 </source>
-            <p>because most mail programs will use the external IP address (as opposed to 127.0.0.1) when processing mail, you need to add your internal network and/or your static IP address to this list.  You may also use a DNS domain name in this list.  The resulting entry would look something like this:</p>
-<source>
+        <p>because most mail programs will use the external IP address (as opposed to 127.0.0.1) when processing mail, you need to add your internal network and/or your static IP address to this list.  You may also use a DNS domain name in this list.  The resulting entry would look something like this:</p>
+        <source>
 &lt;mailet match="RemoteAddrNotInNetwork=127.0.0.1,192.168.1.*"
         class="ToProcessor"&gt;
     &lt;processor&gt; spam &lt;/processor&gt;
 &lt;/mailet&gt;
 </source>
-            <p>This tells the processor that anything not in this address list should go to the spam processor.</p>
-            <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>
-         </subsection>
-         <a name="4"/>
-         <subsection name="I can send people messages via James, but nobody can send me messages.  What do I do?">
-            <p>You need to do one of two things:
+        <p>This tells the processor that anything not in this address list should go to the spam processor.</p>
+        <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>
+      </subsection>
+      <a name="4"/>
+      <subsection name="I can send people messages via James, but nobody can send me messages.  What do I do?">
+        <p>You need to do one of two things:
                <ol>
-                  <li>Update your domain's DNS entries so there are MX records that point to the machine that is running James.  Note that it is illegal for MX records to point to IP addresses.  You need to point MX records to a valid CNAME or A name entry, and then map that eventually to an IP address.</li>
-                  <li>You could alternatively give people an email address with IP addresses.  Most people will think it's a very strange email address, but hello@[192.168.0.1] is a valid email address.  Note that you need to wrap the IP address in brackets.</li>
-               </ol></p>
-         </subsection>
-         <a name="5"/>
-         <subsection name="I'm trying to debug messages that James is trying to deliver.  Where should I look?">
-            <p>First step is to look in the log directory at the mailet.log file.  Look for entries that include the text "RemoteDelivery".  This should provide some high-level debug information of James' attempt to delivery mail remotely.</p>
-            <p>If you want to delve into the code, look at the RemoteDelivery mailet.  You may also want to review the mail repository source code for the repository type you are using (file, db, etc...).</p>
-         </subsection>
-         <a name="6"/>
-         <subsection name="What about IMAP support?">
-            <p>IMAP development had been stalled, but has recently attracted new activity.  IMAP support is scheduled for inclusion in James v3.  In the meantime, there is experimental code in the repository.  If you are interested in working on or trying the IMAP prototype code, join the james-dev mailing list and let us know.</p>
-         </subsection>
-         <a name="7"/>
-         <subsection name="What about support virtual hosting?">
-            <p>James v2.1 includes a new mailet for database users, <a href="javadocs/org/apache/james/transport/mailets/JDBCVirtualUserTable.html">JDBCVirtualUserTable</a>, that mimics some of the sendmail capabilities of the same name.</p>
-
-<p>JDBCVirtualUserTable does not provide any administation tools.
+            <li>Update your domain's DNS entries so there are MX records that point to the machine that is running James.  Note that it is illegal for MX records to point to IP addresses.  You need to point MX records to a valid CNAME or A name entry, and then map that eventually to an IP address.</li>
+            <li>You could alternatively give people an email address with IP addresses.  Most people will think it's a very strange email address, but hello@[192.168.0.1] is a valid email address.  Note that you need to wrap the IP address in brackets.</li>
+          </ol>
+        </p>
+      </subsection>
+      <a name="5"/>
+      <subsection name="I'm trying to debug messages that James is trying to deliver.  Where should I look?">
+        <p>First step is to look in the log directory at the mailet.log file.  Look for entries that include the text "RemoteDelivery".  This should provide some high-level debug information of James' attempt to delivery mail remotely.</p>
+        <p>If you want to delve into the code, look at the RemoteDelivery mailet.  You may also want to review the mail repository source code for the repository type you are using (file, db, etc...).</p>
+      </subsection>
+      <a name="6"/>
+      <subsection name="What about IMAP support?">
+        <p>IMAP development had been stalled, but has recently attracted new activity.  IMAP support is scheduled for inclusion in James v3.  In the meantime, there is experimental code in the repository.  If you are interested in working on or trying the IMAP prototype code, join the james-dev mailing list and let us know.</p>
+      </subsection>
+      <a name="7"/>
+      <subsection name="What about support virtual hosting?">
+        <p>James v2.1 includes a new mailet for database users, <a href="javadocs/org/apache/james/transport/mailets/JDBCVirtualUserTable.html">JDBCVirtualUserTable</a>, that mimics some of the sendmail capabilities of the same name.</p>
+        <p>JDBCVirtualUserTable does not provide any administation tools.
 You'll have to create and maintain the database table yourself.  The
 standard configuration is as follows:</p>
-
-<source>
+        <source>
 CREATE TABLE VirtualUserTable
 (
  user varchar(64) NOT NULL default '',
@@ -170,123 +172,129 @@
  PRIMARY KEY (user,domain)
 );
 </source>
-
-<p>The standard query used with VirtualUserTable is:</p>
-
-<source>
+        <p>The standard query used with VirtualUserTable is:</p>
+        <source>
 select VirtualUserTable.target_address from VirtualUserTable, VirtualUserTable as VUTDomains
 where (VirtualUserTable.user like ? or VirtualUserTable.user like "\%")
 and (VirtualUserTable.domain like ?
 or (VirtualUserTable.domain like "\%" and VUTDomains.domain like ?))
 order by concat(VirtualUserTable.user,'@',VirtualUserTable.domain) desc limit 1
 </source>
-
-<p>For a given [user, domain, domain] used with the query, this will
+        <p>For a given [user, domain, domain] used with the query, this will
 match as follows (in precedence order):
 <ol>
-<li>user@domain    - explicit mapping for user@domain</li>
-<li>user@%         - catchall mapping for user anywhere</li>
-<li>%@domain       - catchall mapping for anyone at domain</li>
-<li>null           - no valid mapping</li>
-</ol>
-</p>
-
-<p>A sample mailet looks like:</p>
-<source>
+            <li>user@domain    - explicit mapping for user@domain</li>
+            <li>user@%         - catchall mapping for user anywhere</li>
+            <li>%@domain       - catchall mapping for anyone at domain</li>
+            <li>null           - no valid mapping</li>
+          </ol>
+        </p>
+        <p>A sample mailet looks like:</p>
+        <source>
 &lt;mailet match="All" class="JDBCVirtualUserTable"&gt;
   &lt;table&gt;db://maildb/VirtualUserTable&lt;/table&gt;
 &lt;/mailet&gt;
 </source>
-
-            <p>More generalized viirtual hosting is something the developers are still discussing.  One issue is that POP3 does not support virtual hosting in that it does not have a command to indicate what domain the user is in.  What this means is the mail server needs to support a 'mapping' or 'translation' convention, e.g., 'user1@domaina.com' gets a username 'domaina.user1'.  This allows the mail server to have a single username namespace.  We have seen a few good proposals put forward, but nothing that seemed the clear solution, as ideally we could have this part solve the next issue.</p>
-            <p>Beyond that, James needs to refine virtual hosting for mailet processing.  With the current user model, the mailet API has a Mail.getUser() method that no longer would be useable as a reliable indicator of whether they were in the local username namespace.  To date we are unclear of the best way to bring this translation into the mailet processing.  Similarly, it would be nice to support different mailet processing based on the domain, although this is somewhat feasible using the limited processing flow offered with a HostIs matcher.</p>
-            <p>Virtual hosting is one of the most requested features, and additional work is scheduled for the 3.0 release.</p>
-         </subsection>
-         <a name="8"/>
-         <subsection name="Where do I stick classes and jars?">
-            <p>We are largely reliant on what Avalon is doing in terms of classloading, but here are a few tips and suggestions:
+        <p>More generalized viirtual hosting is something the developers are still discussing.  One issue is that POP3 does not support virtual hosting in that it does not have a command to indicate what domain the user is in.  What this means is the mail server needs to support a 'mapping' or 'translation' convention, e.g., 'user1@domaina.com' gets a username 'domaina.user1'.  This allows the mail server to have a single username namespace.  We have seen a few good proposals put forward, but nothing that seemed the clear solution, as ideally we could have this part solve the next issue.</p>
+        <p>Beyond that, James needs to refine virtual hosting for mailet processing.  With the current user model, the mailet API has a Mail.getUser() method that no longer would be useable as a reliable indicator of whether they were in the local username namespace.  To date we are unclear of the best way to bring this translation into the mailet processing.  Similarly, it would be nice to support different mailet processing based on the domain, although this is somewhat feasible using the limited processing flow offered with a HostIs matcher.</p>
+        <p>Virtual hosting is one of the most requested features, and additional work is scheduled for the 3.0 release.</p>
+      </subsection>
+      <a name="8"/>
+      <subsection name="Where do I stick classes and jars?">
+        <p>We are largely reliant on what Avalon is doing in terms of classloading, but here are a few tips and suggestions:
   <ul>
-                  <li>Stick jars in the james/lib directory and add them to the classpath in run.bat or run.sh.</li>
-                  <li>Instructions for including classes for custom mailets and matchers can be found <a href="custom_mailet_2_1.html">here</a> and <a href="custom_matcher_2_1.html">here</a> respectively..</li>
-               </ul>
+            <li>Stick jars in the james/lib directory and add them to the classpath in run.bat or run.sh.</li>
+            <li>Instructions for including classes for custom mailets and matchers can be found <a href="custom_mailet_2_1.html">here</a> and <a href="custom_matcher_2_1.html">here</a> respectively..</li>
+          </ul>
   Eventually we hope to support mailet reloading and a special lib and classes directory within the james directory that custom mailets can load from, but for now these are hopefully some useful tips.</p>
-         </subsection>
-         <a name="9"/>
-         <subsection name="How do I upgrade to a newer version of James?">
-            <p>
-               <ol>
-                  <li>Rename the previous james directory into a james.old</li>
-                  <li>Run phoenix to let the new james.sar be deployed.</li>
-                  <li>Edit the newly deployed config.xml to reflect your customizations from the previous config.xml.</li>
-                  <li>If using JDBC, see <a href="http://wiki.apache.org/james/UpgradingToAttributes">necessary table changes.</a></li>
-                  <li>Replace the var directory by the previous var directory.  This will copy over user accounts, inboxes, spools, and whatever else.</li>
-                  <li>Restart James.</li>
-               </ol>
-            </p>
-         </subsection>
-         <a name="10"/>
-         <subsection name="How do I run James as an NT/2k/XP service?">
-            <p>The version of Avalon Phoenix distributed with James v2.1 and later includes a <a href="http://avalon.apache.org/phoenix/guide-administrator.html">wrapper</a> that lets you run James as a service.  An alternative strategy is to install the <a href="http://www.alexandriasc.com/software/JavaService/index.html">JavaService</a> from Alexandia Software.</p>
-         </subsection>
-         <a name="11"/>
-         <subsection name="Why isn't my mailet making changes to a MimeMessage?">
-            <p>Check the JavaMail docs.  Per the API, when you call MimeMessage.setContent(blah), you have to call saveChanges() to apply your changes.  James tries to automatically call this method so you don't have to, but in certain cases you'll still have to call saveChanges().</p>
-         </subsection>
-          <a name="12"/>
-         <subsection name="How to remove unneeded services like NNTP, POP3?">
-           <p>The following information is based on James 2.0a3, but the
+      </subsection>
+      <a name="9"/>
+      <subsection name="How do I upgrade to a newer version of James?">
+        <p>
+          <ol>
+            <li>Rename the previous james directory into a james.old</li>
+            <li>Run phoenix to let the new james.sar be deployed.</li>
+            <li>Edit the newly deployed config.xml to reflect your customizations from the previous config.xml.</li>
+            <li>If using JDBC, see <a href="http://wiki.apache.org/james/UpgradingToAttributes">necessary table changes.</a>
+            </li>
+            <li>Replace the var directory by the previous var directory.  This will copy over user accounts, inboxes, spools, and whatever else.</li>
+            <li>Restart James.</li>
+          </ol>
+        </p>
+      </subsection>
+      <a name="10"/>
+      <subsection name="How do I run James as an NT/2k/XP service?">
+        <p>The version of Avalon Phoenix distributed with James v2.1 and later includes a <a href="http://avalon.apache.org/phoenix/guide-administrator.html">wrapper</a> that lets you run James as a service.  An alternative strategy is to install the <a href="http://www.alexandriasc.com/software/JavaService/index.html">JavaService</a> from Alexandia Software.</p>
+      </subsection>
+      <a name="11"/>
+      <subsection name="Why isn't my mailet making changes to a MimeMessage?">
+        <p>Check the JavaMail docs.  Per the API, when you call MimeMessage.setContent(blah), you have to call saveChanges() to apply your changes.  James tries to automatically call this method so you don't have to, but in certain cases you'll still have to call saveChanges().</p>
+      </subsection>
+      <a name="12"/>
+      <subsection name="How to remove unneeded services like NNTP, POP3?">
+        <p>The following information is based on James 2.0a3, but the
              upcoming 2.1 version should be similar.</p>
-           <p>NNTP and other underlying services are called "blocks" in the
+        <p>NNTP and other underlying services are called "blocks" in the
              Avalon Phoenix terminology. Blocks are specified in the
              assembly.xml file which is located in the apps/james/SAR-INF directory (2.1)
              or apps/james/conf directory (2.0a3). Note: this file is created
              during the first startup of James.</p>
-           <p>There are dependencies between the blocks, which you can read from
+        <p>There are dependencies between the blocks, which you can read from
              the file. For example the SMTP Server block depends on the
              users-store block, so if you want SMTP then you cannot remove the
              users-store block even if you only want to relay messages.</p>
-           <p>To remove the NNTP Server comment out the following blocks:
+        <p>To remove the NNTP Server comment out the following blocks:
              NNTP server, NNTP Authentication Service, NNTP repository.
              To remove the POP3 Server comment out the POP3 Server block.</p>
-           <p>If you remove a block it wont't be loaded next time you restart
+        <p>If you remove a block it wont't be loaded next time you restart
              James. You must also remove all sections related to the removed
              blocks from the James configuration file - config.xml - otherwise
              you will get error messages, saying that there is no corresponding
              block.</p>
-         </subsection>
-         <a name="13"/>
-         <subsection name="How can I contribute to James">
-            <p>Read the "Contributors How To" <a href="contribute.html">here</a></p>
-         </subsection>
-          <a name="14"/>
-<subsection name="How can I make sendmail route local mail (or all mail) through James on the same machine?">
-            <p>Read the "sendmail How To" <a href="james_and_sendmail.html">here</a></p>
-</subsection>
-          <a name="15"/>
-          <subsection name="I am using Microsoft's SQL Type 4 JDBC Driver, why do I get a &quot;Can't start manual transaction mode because there are cloned connections&quot; exception?">
-<p>I am using Microsoft's SQL Type 4 JDBC Driver, why do I get the following exception?<br/>java.sql.SQLException: [Microsoft][SQLServer 2000 Driver for JDBC]Can&apos;t start manual transaction mode because there are cloned connections.</p>
-<p>This seems to be a problem with the Microsoft Type 4 JDBC Driver and concurrent statements/transactions/resultsets on the same database conntection.</p>
-<p>To solve this you need to add <b>;SelectMethod=cursor</b> to the end of your dburl string. Your dburl string would then look something like this<br/>&lt;dburl&gt;jdbc:microsoft:sqlserver://dbserver.host.name:1433;SelectMethod=cursor&lt;/dburl&gt;</p>
-<p>NOTE: some people have complained about performance when using this option, the alternative is a 3rd party JDBC driver but these are often not free.</p>
-          </subsection>
-          <a name="16"/>
-          <subsection name="I am using James with a MySQL database and I keep getting a &quot;Packet is larger than max_allowed_packet&quot; when receiving large messages despite the fact that my max packet size is configured to be larger than my max message size.  What's going on?">
-            <p>When a user tries to send a large message that is close to but not quite at the max message limit the send fails and an exception similar to the following appears in the log:</p>
-            <p>Sent: 451 Error processing message:<br/>
+      </subsection>
+      <a name="13"/>
+      <subsection name="How can I contribute to James">
+        <p>Read the "Contributors How To" <a href="contribute.html">here</a>
+        </p>
+      </subsection>
+      <a name="14"/>
+      <subsection name="How can I make sendmail route local mail (or all mail) through James on the same machine?">
+        <p>Read the "sendmail How To" <a href="james_and_sendmail.html">here</a>
+        </p>
+      </subsection>
+      <a name="15"/>
+      <subsection name="I am using Microsoft's SQL Type 4 JDBC Driver, why do I get a &quot;Can't start manual transaction mode because there are cloned connections&quot; exception?">
+        <p>I am using Microsoft's SQL Type 4 JDBC Driver, why do I get the following exception?<br/>java.sql.SQLException: [Microsoft][SQLServer 2000 Driver for JDBC]Can&apos;t start manual transaction mode because there are cloned connections.</p>
+        <p>This seems to be a problem with the Microsoft Type 4 JDBC Driver and concurrent statements/transactions/resultsets on the same database conntection.</p>
+        <p>To solve this you need to add <b>;SelectMethod=cursor</b> to the end of your dburl string. Your dburl string would then look something like this<br/>&lt;dburl&gt;jdbc:microsoft:sqlserver://dbserver.host.name:1433;SelectMethod=cursor&lt;/dburl&gt;</p>
+        <p>NOTE: some people have complained about performance when using this option, the alternative is a 3rd party JDBC driver but these are often not free.</p>
+      </subsection>
+      <a name="16"/>
+      <subsection name="I am using James with a MySQL database and I keep getting a &quot;Packet is larger than max_allowed_packet&quot; when receiving large messages despite the fact that my max packet size is configured to be larger than my max message size.  What's going on?">
+        <p>When a user tries to send a large message that is close to but not quite at the max message limit the send fails and an exception similar to the following appears in the log:</p>
+        <p>Sent: 451 Error processing message:<br/>
             Exception spooling message: Exception caught while storing mail Container:<br/>
             java.lang.IllegalArgumentException: Packet is larger than max_allowed_packet<br/>
             from server configuration of 4193280 bytes;<br/>
               nested exception is:<br/>
                     java.lang.RuntimeException: Exception caught while storing mail<br/>
             Container: java.lang.IllegalArgumentException: Packet is larger than<br/>
-            max_allowed_packet from server configuration of 4193280 bytes<br/></p>
-            <p>Because of how the JDBC driver is written, a 25%
+            max_allowed_packet from server configuration of 4193280 bytes<br/>
+        </p>
+        <p>Because of how the JDBC driver is written, a 25%
             factor is necessary between the maximum message size and the max_packet_size
             to prevent the driver from throwing an exception.  So if you want a 4MB
             maximum message size, you need a 5MB max_packet size.  Or a 4MB
             max_packet_size allows only a 3.2MB max message.
             </p>
-          </subsection>
-      </section>
-   </body>
+      </subsection>
+      <a name="17"/>
+        <subsection name="How do I use Subversion to get James source code?">
+          <p>First of all read this: <a href="http://www.apache.org/dev/version-control.html">ASF Source Code</a>.
+          <br/>Now go to <a href="http://subversion.tigris.org/">http://subversion.tigris.org/</a> and download a subversion client.
+          <br/>James subversion repository is at <b>http://svn.apache.org/repos/asf/james/server</b>. Commiters use "https".
+          <br/>You may want to search the web, our <a href="http://www.mail-archive.com/server-dev@james.apache.org/">dev</a> and <a href="http://www.mail-archive.com/server-user@james.apache.org/">user</a> mail archives or our <a href="http://wiki.apache.org/james">wiki</a> for more information.</p>
+        </subsection>
+    </section>
+  </body>
 </document>

Modified: james/server/trunk/src/xdocs/index.xml
Url: http://svn.apache.org/viewcvs/james/server/trunk/src/xdocs/index.xml?view=diff&rev=124203&p1=james/server/trunk/src/xdocs/index.xml&r1=124202&p2=james/server/trunk/src/xdocs/index.xml&r2=124203
==============================================================================
--- james/server/trunk/src/xdocs/index.xml	(original)
+++ james/server/trunk/src/xdocs/index.xml	Wed Jan  5 06:10:29 2005
@@ -1,126 +1,155 @@
 <?xml version="1.0"?>
-
 <document>
-
- <properties>
-  <title>Overview</title>
-  <author email="site-dev@james.apache.org">James Project Web Team</author>
- </properties>
-
-<body>
-<section name="What is it?">
-<p>The Java Apache Mail Enterprise Server (a.k.a. Apache James) is a 100% pure <b>Java SMTP and POP3 Mail server and NNTP News server</b>.  We designed James to be a complete and portable enterprise mail engine solution based on currently available open protocols. </p>
-<p>James is also a <i>mail application platform</i>.  We have developed a Java API to let you write Java code to process emails that we call the mailet API.  A <b>mailet</b> can generate an automatic reply, update a database, prevent spam, build a message archive, or whatever you can imagine.  A <b>matcher</b> determines whether your mailet should process an email in the server.  The James project hosts the Mailet API, and James provides an implementation of this mail application platform API.</p>
-<p>James is based upon the Apache Avalon application framework. (For more information about Avalon, please go to <a href="http://avalon.apache.org/">http://avalon.apache.org/</a>)</p>
-<p>James requires Java 2 (either JRE 1.3 or 1.4 as of 2.0a3).</p>
-</section>
-<section name="news">
-<p><b>James v2.2.0</b><br/><a href="#releases">James v2.2.0</a> is released.</p>
-<h3>James featured on IBM developerWorks</h3>
-<p>
+  <properties>
+    <title>Overview</title>
+    <author email="site-dev@james.apache.org">James Project Web Team</author>
+  </properties>
+  <body>
+    <section name="What is it?">
+      <p>The Apache Java Enterprise Mail Server (a.k.a. Apache James) is a 100% pure <b>Java SMTP and POP3 Mail server and NNTP News server</b>.  We have designed James to be a complete and portable enterprise mail engine solution based on currently available open protocols. </p>
+      <p>James is also a <i>mail application platform</i>.  We have developed a Java API to let you write Java code to process emails that we call the mailet API.  A <b>mailet</b> can generate an automatic reply, update a database, prevent spam, build a message archive, or whatever you can imagine.  A <b>matcher</b> determines whether your mailet should process an email in the server.  The James project hosts the Mailet API, and James provides an implementation of this mail application platform API.</p>
+      <p>James is based upon the Apache Avalon application framework, formerly a product of the Apache Avalon project (see "news" below).</p>
+      <p>James requires Java 1.4 (For further information you may want to search the web, our <a href="http://www.mail-archive.com/server-dev@james.apache.org/">dev</a> and <a href="http://www.mail-archive.com/server-user@james.apache.org/">user</a> mail archives or our <a href="http://wiki.apache.org/james">wiki</a>).</p>
+    </section>
+    <section name="news">
+    <subsection name="2005">
+
+     <h3>James PMC react to the closure of Apache Avalon.</h3>
+      <p>James PMC would like to reassure all of our users that James is alive and well. All of the James team have kept abreast of the Avalon developments culminating in the closure of the Avalon project and dispersal of its codebase. We are are keen to stress that this has little impact on our ability support and develop James in both the short and long terms.<br/>Over the coming months we will be finalising and publishing a road map for James which will address all of the specific concerns raised by Avalon's closure, but rest assured James' future is safe, and we have enthusiasm and plans aplenty.<br/> In the meantime we would like to extend our best wishes to all our friends from Avalon, here's luck with your future projects guys!, and invite you to subscribe to our mailinglists and join in our discussions. - 05/Jan/2005</p>
+    
+      <h3>James source has moved to "Subversion"</h3>
+      <p>Subversion is a version control system like CVS, but it has advantages over CVS for Apache Software Foundation (ASF) projects.<br/> In common with all other ASF projects we have reviewed our use of CVS and migrated our code to Subversion.<br/>
+Have a look at this <a href="FAQ.html#17">FAQ</a> for further details. - 05/Jan/2005</p>
+      <p/>
+      </subsection>
+      <subsection name="2004">
+      <h3>James v2.2.0</h3>
+      <p>
+        <a href="#releases">James v2.2.0</a> is released.</p>
+      <h3>James featured on IBM developerWorks</h3>
+      <p>
 Claude Duguay has written two excellent articles on <a href="http://james.apache.org/">James</a> for
-<a href="http://www.ibm.com/developerworks/">IBM Developer works</a><br/>
+<a href="http://www.ibm.com/developerworks/">IBM Developer works</a>
+        <br/>
 [<a href="http://www-106.ibm.com/developerworks/java/library/j-james1.html">article1</a>]
 An introduction to Apache's James enterprise e-mail server.<br/>
 [<a href="http://www-106.ibm.com/developerworks/java/library/j-james2.html">article2</a>]
 Build e-mail based applications with Matchers and Mailets.
 </p>
-</section>
-<section name="releases">
-<p><b>Latest and Stable: James v2.2.0</b><br/>
+      <p>
+        <b>James v2.2.0</b>
+        <br/>
+        <a href="#releases">James v2.2.0</a> is released.</p>
+      <h3>James featured on IBM developerWorks</h3>
+      <p>
+Claude Duguay has written two excellent articles on <a href="http://james.apache.org/">James</a> for
+<a href="http://www.ibm.com/developerworks/">IBM Developer works</a>
+        <br/>
+[<a href="http://www-106.ibm.com/developerworks/java/library/j-james1.html">article1</a>]
+An introduction to Apache's James enterprise e-mail server.<br/>
+[<a href="http://www-106.ibm.com/developerworks/java/library/j-james2.html">article2</a>]
+Build e-mail based applications with Matchers and Mailets.
+</p>
+</subsection>
+    </section>
+    
+    <section name="releases">
+      <p>
+        <b>Latest and Stable: James v2.2.0</b>
+        <br/>
 James v2.2.0 is the current release, and the latest in the James v2 series.
 Both <a href="http://james.apache.org/download.cgi">binary and source</a> distributions are available.</p>
-
-<p>James v2.2.0 is a major update to the James platform, with many new features, functional improvements, and bug fixes.
+      <p>James v2.2.0 is a major update to the James platform, with many new features, functional improvements, and bug fixes.
 See the <a href="changelog.html">Change Log</a> for a detailed list of changes.  <b>All
 users are urged to upgrade to v2.2.0 as soon as possible</b>.</p>
-
-<p>Any bugs found in James are dealt with promptly.  Please provide feedback on the james-user and james-dev mailing lists.</p>
-<p><b>Get your hands on the latest versions..</b><br/>We put significant milestones, and potential release candidates in the <a href="http://cvs.apache.org/dist/james/">download area.</a><br/>Whilst the quality of these versions cannot be guaranteed they may contain important bug fixes and cool new features.<br/></p>
-</section>
-
-<section name="Feature Status">
-    <table>
-      <tr>
-        <th>Item</th>
-        <th>Status</th>
-        <th>Since</th>
-        <th>First released</th>
-      </tr>
-      <tr>
-        <td>SMTP server</td>
-        <td>Stable</td>
-        <td>1.0</td>
-        <td>0.95</td>
-      </tr>
-      <tr>
-        <td>Mailet Engine</td>
-        <td>Stable</td>
-        <td>1.2</td>
-        <td>0.95</td>
-      </tr>
-      <tr>
-        <td>FileSystem mailboxes/spool</td>
-        <td>Stable</td>
-        <td>1.2</td>
-        <td>1.0</td>
-      </tr>
-      <tr>
-        <td>RDBMS mailboxes/spool</td>
-        <td>Stable</td>
-        <td>1.2</td>
-        <td>1.2</td>
-      </tr>
-      <tr>
-        <td>POP3 server</td>
-        <td>Stable</td>
-        <td>1.1</td>
-        <td>1.0</td>
-      </tr>
-      <tr>
-        <td>RDBMS - Users</td>
-        <td>Stable</td>
-        <td>1.2.1</td>
-        <td>1.2.1</td>
-      </tr>
-      <tr>
-        <td>LDAP Support - Users</td>
-        <td>Experimental</td>
-        <td>1.2</td>
-        <td>1.2</td>
-      </tr>
-      <tr>
-        <td>TLS Support - POP3</td>
-        <td>Experimental</td>
-        <td>1.2</td>
-        <td>1.2</td>
-      </tr>
-      <tr>
-        <td>Remote Manager</td>
-        <td>Stable</td>
-        <td>1.0</td>
-        <td>1.0</td>
-      </tr>
-      <tr>
-        <td>TLS Support - Remote Manager</td>
-        <td>Stable</td>
-        <td>1.2</td>
-        <td>1.2</td>
-      </tr>
-      <tr>
-        <td>NNTP server</td>
-        <td>Experimental</td>
-        <td>1.2</td>
-        <td>1.2</td>
-      </tr>
-      <tr>
-        <td>FetchPOP</td>
-        <td>Experimental</td>
-        <td>2.1</td>
-        <td>2.1</td>
-      </tr>
-    </table>
-</section>
-
-</body>
+      <p>Any bugs found in James are dealt with promptly.  Please provide feedback on the james-user and james-dev mailing lists.</p>
+      <p>
+        <b>Get your hands on the latest versions..</b>
+        <br/>We put significant milestones, and potential release candidates in the <a href="http://cvs.apache.org/dist/james/">download area.</a>
+        <br/>Whilst the quality of these versions cannot be guaranteed they may contain important bug fixes and cool new features.<br/>
+      </p>
+    </section>
+    <section name="Feature Status">
+      <table>
+        <tr>
+          <th>Item</th>
+          <th>Status</th>
+          <th>Since</th>
+          <th>First released</th>
+        </tr>
+        <tr>
+          <td>SMTP server</td>
+          <td>Stable</td>
+          <td>1.0</td>
+          <td>0.95</td>
+        </tr>
+        <tr>
+          <td>Mailet Engine</td>
+          <td>Stable</td>
+          <td>1.2</td>
+          <td>0.95</td>
+        </tr>
+        <tr>
+          <td>FileSystem mailboxes/spool</td>
+          <td>Stable</td>
+          <td>1.2</td>
+          <td>1.0</td>
+        </tr>
+        <tr>
+          <td>RDBMS mailboxes/spool</td>
+          <td>Stable</td>
+          <td>1.2</td>
+          <td>1.2</td>
+        </tr>
+        <tr>
+          <td>POP3 server</td>
+          <td>Stable</td>
+          <td>1.1</td>
+          <td>1.0</td>
+        </tr>
+        <tr>
+          <td>RDBMS - Users</td>
+          <td>Stable</td>
+          <td>1.2.1</td>
+          <td>1.2.1</td>
+        </tr>
+        <tr>
+          <td>LDAP Support - Users</td>
+          <td>Experimental</td>
+          <td>1.2</td>
+          <td>1.2</td>
+        </tr>
+        <tr>
+          <td>TLS Support - POP3</td>
+          <td>Experimental</td>
+          <td>1.2</td>
+          <td>1.2</td>
+        </tr>
+        <tr>
+          <td>Remote Manager</td>
+          <td>Stable</td>
+          <td>1.0</td>
+          <td>1.0</td>
+        </tr>
+        <tr>
+          <td>TLS Support - Remote Manager</td>
+          <td>Stable</td>
+          <td>1.2</td>
+          <td>1.2</td>
+        </tr>
+        <tr>
+          <td>NNTP server</td>
+          <td>Experimental</td>
+          <td>1.2</td>
+          <td>1.2</td>
+        </tr>
+        <tr>
+          <td>FetchPOP</td>
+          <td>Experimental</td>
+          <td>2.1</td>
+          <td>2.1</td>
+        </tr>
+      </table>
+    </section>
+  </body>
 </document>

Added: james/server/trunk/src/xdocs/mail.xml
Url: http://svn.apache.org/viewcvs/james/server/trunk/src/xdocs/mail.xml?view=auto&rev=124203
==============================================================================
--- (empty file)
+++ james/server/trunk/src/xdocs/mail.xml	Wed Jan  5 06:10:29 2005
@@ -0,0 +1,229 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document>
+  <properties>
+    <title>Mailing lists</title>
+    <author email="site-dev@james.apache.org">James Project Web Team</author>
+  </properties>
+  <body>
+    <section name="This Document">
+      <P>This is a living document that provides details of mailing lists and guidelines for their use for the Apache James project. <br/>
+Please read the whole document and find a list of available mailinglists at the bottom of the page.<br/>
+Last Updated January 2005.</P>
+    </section>
+    <section name="Mailing Lists - Guidelines">
+      <p>A mailing list is an electronic discussion forum that anyone can
+subscribe to. When someone sends an email message to the mailing list,
+a copy of that message is broadcast to everyone who is subscribed to
+that mailing list. Mailing lists provide a simple and effective
+communication mechanism for discussion and decision making. 
+</p>
+      <p>
+The Apache Software Foundation has well established reasons for using email and not other types of forum.
+<br/>
+We are not interested in hearing proposals to use NNTP (news groups) or web forums or any other medium.<br/> 
+You may use a mail-news gateway, gmail or anything else you like but email will remain the official medium.
+</p>
+      <p>
+With potentially thousands of subscribers,
+there is a common set of etiquette guidelines that you should observe.
+Please keep on reading.
+</p>
+      <p>
+        <strong>
+      Respect the mailing list type
+</strong>
+      </p>
+      <p>
+        <ul>
+          <li>
+    The "User" list is a list where you can send questions and comments about
+    configuration, setup, usage and other "user" types of questions.
+    </li>
+          <li>
+    The "Developer" list is a list where you can send questions and
+    comments about the actual software source code and general
+    "development" types of questions.
+    </li>
+        </ul>
+      </p>
+      <p>Some questions are appropriate for posting on both the "user" and
+the "developer" lists. In this case, pick one and only one. Do not
+cross post.</p>
+      <p>Asking a configuration question on the developers list is frowned
+upon because developers' time is as precious as yours. By contacting
+them directly instead of the user base you are abusing resources. 
+It is unlikely that you will get a quicker answer, developers who have time to 
+devote to providing support are also subscribed to the users list, and you may get no answer at
+all.</p>
+      <p>
+        <strong>
+      Join the lists that are appropriate for your discussion.
+</strong>
+        <br/>
+Please make sure that you are joining the list that is appropriate for the 
+topic that you would like to discuss. The general list is for discussions about the project
+not for "general support".
+</p>
+      <p>
+        <strong>
+    Ask smart questions.  </strong>
+        <br/> 
+
+Every volunteer project obtains its strength from the people involved
+in it. You are welcome to join any of our mailing lists.  You can
+choose to lurk, or actively participate; it's up to you.  The level of
+community responsiveness to specific questions is generally directly
+proportional to the amount of effort you spend formulating your
+question. Eric Raymond and Rick Moen have even written an essay entitled <a href="http://www.catb.org/~esr/faqs/smart-questions.html">"<b>Asking
+Smart Questions</b>"</a> precisely on this topic.  Although somewhat
+militant, it is definitely worth reading.<br/>
+        <b>Note</b>: Please do NOT send your Java problems to the two authors. They welcome feedback on the FAQ's contents, but are simply not a Java help resource. Follow the essay's advice and <a href="http://www.catb.org/~esr/faqs/smart-questions.html#forum">choose your forum</a> carefully.
+</p>
+      <p>
+        <strong>
+    Keep your email short and to the point.
+</strong>
+        <br/>
+If your email is more than about a page of text, chances are that it
+won't get read by very many people. It is much better to try to pack a
+lot of informative information (see above about asking smart questions)
+into as small of an email as possible. If you are replying to a previous
+email, it is a good idea to only quote the parts that you are replying
+to and to remove the unnecessary bits. This makes it easier for people
+to follow a thread as well as making the email archives easier to search
+and read.
+</p>
+      <p>
+        <strong>
+    Do your best to ensure that you are not sending HTML or
+    "Stylelized" email to the list.
+</strong>
+        <br/>
+If you are using Outlook or Outlook Express or Eudora, chances are that
+you are sending HTML email by default. There is usually a setting that
+will allow you to send "Plain Text" email. If you are using Microsoft
+products to send email, there are several bugs in the software that
+prevent you from turning off the sending of HTML email. Please read this
+<a href="./micromail.html">page</a> as well...
+</p>
+      <p>
+        <strong>
+    Watch where you are sending email.
+</strong>
+        <br/>
+The majority of our mailing lists have set the Reply-To to go back to the 
+list. That means that when you Reply to a message, it will go to the list
+and not to the original author directly. The reason is because it helps
+facilitate discussion on the list for everyone to benefit from. Be careful 
+of this as sometimes you may intend to reply to a message directly to someone 
+instead of the entire list.
+<em>
+The appropriate contents of the Reply-To header is an age-old debate that
+should not be brought up on the mailing lists.  You can
+examine opposing points of view
+<a href="http://www.unicom.com/pw/reply-to-harmful.html">condemning</a>
+our convention and 
+<a href="http://www.metasystema.org/essays/reply-to-useful.mhtml">
+condoning</a> 
+it.  Bringing this up for debate on a mailing list will add nothing
+new and is considered off-topic.
+</em>
+      </p>
+      <p>
+        <strong>
+    Do not cross post messages.
+</strong>
+        <br/>
+In other words, pick a mailing list and send your messages to that mailing 
+list only. Do not send your messages to multiple mailing lists. The reason is 
+that people may be subscribed to one list and not to the other. Therefore, 
+some people will only see part of the conversation.
+</p>
+    </section>
+    <section name="Archives">
+      <p>
+There are several sites on the net that archive and provide searching for 
+our mailing lists in HTML readable format. If a list is not there, then
+feel free to take initiative and submit it for us via <a href="./mail2.html#general">jakarta-general</a> mailing list.
+</p>
+      <p>
+        <ul>
+          <li>Archives with many Jakarta lists:
+            <ul>
+              <li>
+                <a href="http://mail-archives.apache.org/eyebrowse/ViewLists">List Index on mail-archives.apache.org</a>
+              </li>
+              <li>
+                <a href="/mail/">Full mbox archives of all lists.</a>
+              </li>
+              <li>
+                <a href="http://www.mail-archive.com/">Mail-Archive</a>
+              </li>
+              <li>
+                <a href="http://geocrawler.com/">Geocrawler</a>
+              </li>
+              <li>
+                <a href="http://marc.theaimsgroup.com/">Mailing list Archives</a>
+              </li>
+              <li>
+                <a href="http://www.servlets.com/archive/">Servlets.com servlet and JSP list archives</a>
+              </li>
+            </ul>
+          </li>
+        </ul>
+      </p>
+    </section>
+    <section name="James Mailing lists">
+      <p>
+        <i>Now that you have read the guidelines above</i> please subscribe to our lists and join our community.
+</p>
+      <subsection name="Server User List">
+        <p>
+          <b>Low Traffic</b>
+          <a href="mailto:server-user-subscribe@james.apache.org">Subscribe</a>
+          <a href="mailto:server-user-unsubscribe@james.apache.org">Unsubscribe</a>
+          <a href="mail.html">Guidelines</a>
+          <a href="http://www.mail-archive.com/server-user@james.apache.org/">
+Archive</a>
+        </p>
+        <p>
+This is the list where users of the Apache James (Server) meet and discuss
+issues. Developers are also expected to be lurking on this list to
+offer support to users of the Apache James (Server).
+</p>
+      </subsection>
+      <subsection name="Server Developer List">
+        <p>
+          <b>Low Traffic</b>
+          <a href="mailto:server-dev-subscribe@james.apache.org">Subscribe</a>
+          <a href="mailto:server-dev-unsubscribe@james.apache.org">Unsubscribe</a>
+          <a href="mail.html">Guidelines</a>
+          <a href="http://www.mail-archive.com/server-dev@james.apache.org/">
+Archive</a>
+        </p>
+        <p>
+This is the list where participating developers of the the Apache James
+Package meet and discuss issues, code changes/additions,
+etc. Subscribers to this list get notices of each and every code
+change, build results, testing notices, etc. <b>Do not send mail to
+this list with usage questions or configuration problems</b> -- 
+that's what server-user@james is for.
+</p>
+      </subsection>
+      <subsection name="James General List">
+        <p>
+          <b>Low Traffic</b>
+          <a href="mailto:general-subscribe@james.apache.org">Subscribe</a>
+          <a href="mailto:general-unsubscribe@james.apache.org">Unsubscribe</a>
+          <a href="mail.html">Guidelines</a>
+          <!-- <a href="http://www.mail-archive.com/general@james.apache.org/">
+Archive</a> -->
+        </p>
+        <p>
+This is the list for general discussions relating to the project 
+(not code or user issues).
+</p>
+      </subsection>
+    </section>
+  </body>
+</document>

Modified: james/server/trunk/src/xdocs/stylesheet.css
Url: http://svn.apache.org/viewcvs/james/server/trunk/src/xdocs/stylesheet.css?view=diff&rev=124203&p1=james/server/trunk/src/xdocs/stylesheet.css&r1=124202&p2=james/server/trunk/src/xdocs/stylesheet.css&r2=124203
==============================================================================
--- james/server/trunk/src/xdocs/stylesheet.css	(original)
+++ james/server/trunk/src/xdocs/stylesheet.css	Wed Jan  5 06:10:29 2005
@@ -1,5 +1,10 @@
-body {  font-family: Verdana, Arial, Helvetica, sans-serif; font-size: 80% }
-td {  font-family: Verdana, Arial, Helvetica, sans-serif; font-size: 80% }
-strong {  font-weight: bold; font-size: larger}
+body {  font-family: Verdana, Arial, Helvetica, sans-serif;}
+td {  font-family: Verdana, Arial, Helvetica, sans-serif;font-size: 90%  }
+strong {  font-weight: bold;}
+p {  font-family: Verdana, Arial, Helvetica, sans-serif; font-size: 90% }
+a {  font-family: Verdana, Arial, Helvetica, sans-serif; font-size: 90% }
+h3 {  font-family: Verdana, Arial, Helvetica, sans-serif; font-size: 100% }
+li {  font-family: Verdana, Arial, Helvetica, sans-serif; font-size: 90% }
+
 table {  border-style: none}
 td {  border-style: none}

Modified: james/server/trunk/src/xdocs/stylesheets/project.xml
Url: http://svn.apache.org/viewcvs/james/server/trunk/src/xdocs/stylesheets/project.xml?view=diff&rev=124203&p1=james/server/trunk/src/xdocs/stylesheets/project.xml&r1=124202&p2=james/server/trunk/src/xdocs/stylesheets/project.xml&r2=124203
==============================================================================
--- james/server/trunk/src/xdocs/stylesheets/project.xml	(original)
+++ james/server/trunk/src/xdocs/stylesheets/project.xml	Wed Jan  5 06:10:29 2005
@@ -1,57 +1,47 @@
 <?xml version="1.0" encoding="ISO-8859-1"?>
-<project name="James"
-        href="http://james.apache.org">
-
-    <title>Java Mail and News server, SMTP POP3 NNTP</title>
-    <logo href="/images/james-logo.jpg">James - Java Apache Mail Enterprise Server</logo>
-
-    <body>
+<project name="James" href="http://james.apache.org">
+  <title>Java Mail and News server, SMTP POP3 NNTP</title>
+  <logo href="/images/james-logo.jpg">James - Java Apache Mail Enterprise Server</logo>
+  <body>
     <menu name="James">
-        <item name="Overview"          href="/index.html"/>
-        <item name="James FAQ"      href="/FAQ.html"/>
-        <item name="Mailing Lists"         href="http://jakarta.apache.org/site/mail.html"/>
-        <item name="Wiki"              href="http://wiki.apache.org/james"/>
+      <item name="Overview" href="/index.html"/>
+      <item name="James FAQ" href="/FAQ.html"/>
+      <item name="Mailing Lists" href="/mail.html"/>
+      <item name="Wiki" href="http://wiki.apache.org/james"/>
     </menu>
-
     <menu name="Downloads">
-        <item name="Current Release(s)"              href="http://james.apache.org/download.cgi"/>
+      <item name="Current Release(s)" href="http://james.apache.org/download.cgi"/>
     </menu>
-
     <menu name="Documentation">
-        <item name="James 2.x Documentation"           href="/documentation_2_1.html"/>
-        <item name="Design objectives"     href="/design_objectives.html"/>
-        <item name="James Javadocs"      href="/javadocs/index.html"/>
-        <item name="Mailet Javadocs"     href="/mailet/index.html"/>
-        <item name="Useful RFCs"   href="/rfclist.html"/>
-        <item name="Older Document Archive"      href="/document_archive.html"/>
+      <item name="James 2.x Documentation" href="/documentation_2_1.html"/>
+      <item name="Design objectives" href="/design_objectives.html"/>
+      <item name="James Javadocs" href="/javadocs/index.html"/>
+      <item name="Mailet Javadocs" href="/mailet/index.html"/>
+      <item name="Useful RFCs" href="/rfclist.html"/>
+      <item name="Older Document Archive" href="/document_archive.html"/>
     </menu>
-
     <menu name="Project">
-        <item name="Bug Database "     href="http://issues.apache.org/jira/browse/JAMES"/>
-        <item name="CVS Repositories"      href="http://jakarta.apache.org/site/cvsindex.html"/>
-        <item name="Who We Are"        href="/weare.html"/>
-        <item name="How Can I Contribute?" href="/contribute.html"/>
-        <item name="Coding Standards"  href="/code-standards.html"/>
-        <item name="License"           href="/license.html"/>
-        <item name="Changelog"         href="/changelog.html"/>
-        <item name="TODO"              href="/todo.html"/>
+      <item name="Bug Database " href="http://issues.apache.org/jira/browse/JAMES"/>
+      <item name="Subversion Repositories" href="http://svn.apache.org/"/>
+      <item name="Who We Are" href="/weare.html"/>
+      <item name="How Can I Contribute?" href="/contribute.html"/>
+      <item name="Coding Standards" href="/code-standards.html"/>
+      <item name="License" href="/license.html"/>
+      <item name="Changelog" href="/changelog.html"/>
+      <item name="TODO" href="/todo.html"/>
     </menu>
-
     <menu name="Translated">
-        <item name="Japanese (web)" href="http://james.terra-intl.com/"/>
+      <item name="Japanese (web)" href="http://james.terra-intl.com/"/>
     </menu>
-
     <menu name="Related Projects">
-        <item name="Jakarta"               href="http://jakarta.apache.org/index.html"/>
-        <item name="Ant"                   href="http://ant.apache.org/index.html"/>
-        <item name="Avalon"                href="http://avalon.apache.org/index.html"/>
+      <item name="Jakarta" href="http://jakarta.apache.org/index.html"/>
+      <item name="Ant" href="http://ant.apache.org/index.html"/>
+      <item name="Avalon" href="http://avalon.apache.org/index.html"/>
     </menu>
-
     <menu name="Useful Information">
-        <item name="Get Involved"          href="http://jakarta.apache.org/site/getinvolved.html"/>
-        <item name="Reference Library"     href="http://jakarta.apache.org/site/library.html"/>
-        <item name="Apache"                href="http://apache.org/foundation/faq.html"/>
+      <item name="Get Involved" href="http://jakarta.apache.org/site/getinvolved.html"/>
+      <item name="Reference Library" href="http://jakarta.apache.org/site/library.html"/>
+      <item name="Apache" href="http://apache.org/foundation/faq.html"/>
     </menu>
-
-    </body>
+  </body>
 </project>

Modified: james/server/trunk/src/xdocs/stylesheets/site.xsl
Url: http://svn.apache.org/viewcvs/james/server/trunk/src/xdocs/stylesheets/site.xsl?view=diff&rev=124203&p1=james/server/trunk/src/xdocs/stylesheets/site.xsl&r1=124202&p2=james/server/trunk/src/xdocs/stylesheets/site.xsl&r2=124203
==============================================================================
--- james/server/trunk/src/xdocs/stylesheets/site.xsl	(original)
+++ james/server/trunk/src/xdocs/stylesheets/site.xsl	Wed Jan  5 06:10:29 2005
@@ -13,7 +13,7 @@
 -->
 
 
-<!-- $Id: site.xsl,v 1.10 2004/10/29 16:06:36 noel Exp $ -->
+<!-- $Id$ -->
 
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
   version="1.0">
@@ -131,7 +131,7 @@
       <xsl:comment>PAGE FOOTER</xsl:comment>
       <tr><td colspan="2">
         <div align="center"><font color="{$body-link}" size="-1"><em>
-        Copyright &#169; 1999-2004, Apache Software Foundation
+        Copyright &#169; 1999-2005, Apache Software Foundation
         </em></font></div>
       </td></tr>
 

Modified: james/server/trunk/src/xdocs/weare.xml
Url: http://svn.apache.org/viewcvs/james/server/trunk/src/xdocs/weare.xml?view=diff&rev=124203&p1=james/server/trunk/src/xdocs/weare.xml&r1=124202&p2=james/server/trunk/src/xdocs/weare.xml&r2=124203
==============================================================================
--- james/server/trunk/src/xdocs/weare.xml	(original)
+++ james/server/trunk/src/xdocs/weare.xml	Wed Jan  5 06:10:29 2005
@@ -1,64 +1,143 @@
 <?xml version="1.0"?>
-
 <document>
-
- <properties>
-  <title>Who We Are</title>
-  <author email="site-dev@james.apache.org">James Project Web Team</author>
- </properties>
-
-<body>
-
-<section name="This list">
-<p>Special thanks go to the following people for their contributions to this project.  We also appreciate documentation, feedback, and bug reports.  This is a living document that describes the key contributors to James. Last Updated January 2004.</p>
-</section>
-
-<section name="Active Commiters">
-<p><b>Pete Donald (PD)</b></p>
-<p><b>Charles Benett (charles at benett1.demon.co.uk) (CB)</b></p>
-<p><b>Serge Knystautas (sergek at lokitech.com) (SK)</b><br /> Serge was the original donator of the James code, which has since been massively improved by people smarter than him.  He tries to answer questions on the listserv and make code contributions when he does get a rare bit of free time.</p>
-<p><b>Harmeet Bedi (harmeet at kodemuse.com) (HB)</b></p>
-<p><b>Darrell DeBoer (DD)</b></p>
-<p><b>Danny Angus (danny at autonomous.co.uk) (DA)</b><br/> Danny is CTO of <a href="http://www.autonomous.co.uk">Autonomous Software Ltd.</a> where I try not to get too distracted by open source projects.</p>
-<p><b>Peter M. Goldstein (farsight at alum.mit.edu) (PG)</b></p>
-<p><b>Noel J. Bergman (noel at devtech.com) (NjB)</b></p>
-<p><b>Stephen J. McConnell (mcconnell at apache.org) (SJM)</b></p>
-<p><b>Vincenzo Gianferrari Pini (vincenzo.gianferraripini at praxis.it) [VGP]</b></p>
-<p><b>Soeren Hilmer (soren.hilmer at tietoenator.com) [SH]</b></p>
-<p><b>Steve Brewin (sbrewin at synsys.com) [SB]</b></p>
-</section>
-
-<section name="Other Contributors">
-<p><b>Federico Barbieri, (scoobie at systemy.it) (FB)</b></p>
-<p><b>Stuart Roebuck, stuart.roebuck at adolos.co.uk (SR)</b></p>
-<p><b>Ivan Seskar, iseskar at upsideweb.com (IS)</b></p>
-<p><b>Prasanna Uppaladadium, prasanna at vayusphere.com (PU)</b></p>
-<p><b>Gabriel Bucher, gabriel.bucher at razor.ch (GB)</b></p>
-<p><b>Matthew Pangaro, mattp at lokitech.com (MP)</b></p>
-<p><b>Jason Borden, jborden at javasense.com (JB)</b></p>
-<p><b>Randy Stanard (rstanard at lokitech.com) (RS)</b><br /> Contributed the James logo.</p>
-<p><b>Samuel Sadek (Samuel.Sadek at kpmg.co.uk) (SS)</b></p>
-<p><b>Stephan Schiessling (s at rapi.com) (SS2)</b></p>
-<p><b>Eung-ju Park (colus at apache.org) (EP)</b></p>
-<p><b>Paul Hammant (Paul_Hammant at yahoo.com) (PH)</b></p>
-<p><b>Jeff Keyser (JKeyser at telocity.com) (JK)</b></p>
-<p><b>Andrei Ivanov (myfam at surfeu.fi) (AI)</b></p>
-<p><b>Brad Walker (bwalker at studentadvantage.com) (BW)</b></p>
-<p><b>Christian Buchegger (christian.buchegger at planet-interkom.de) (CB2)</b></p>
-<p><b>Shilpa Dalmia (shilpa at postx.com) (SD)</b></p>
-<p><b>Steve Short (sshort at postx.com) (SS3)</b></p>
-<p><b>Aaron Knauf (aknauf at xtra.co.nz) (AK)</b></p>
-<p><b>Serge "Sergei" Sozonoff (serge at globalbeach.com) (SS4)</b></p>
-<p><b>Kai Londenberg (kai.londenberg at my-vwclub.de) [KL]</b></p>
-<p><b>Jason Webb (jw at inovem.com) [JW]</b></p>
-<p><b>Mark Imel (james at imelshire.com) [MI]</b></p>
-<p><b>Kevin Schmidt (ktschmidt at earthlink.net) [KS]</b></p>
-<p><b>Hontvari Jozsef (hontvari2 at solware.com) [HJ]</b></p>
-<p><b>Cesar Bonadio (bonadio at picture.com.br) [CB3]</b></p>
-<p><b>Marco Tedone (mtedone at jemos.org) [MT]</b></p>
-<p><b>Tim Stephenson (tim at thestephensons.me.uk) [TS]</b></p>
-<p><b>Richard O. Hammer (rohammer at earthlink.net) [ROH]</b></p>
-</section>
-
-</body>
+  <properties>
+    <title>Who We Are</title>
+    <author email="site-dev@james.apache.org">James Project Web Team</author>
+  </properties>
+  <body>
+    <section name="This list">
+      <p>Special thanks go to the following people for their contributions to this project.  We also appreciate documentation, feedback, and bug reports.  This is a living document that describes the key contributors to James. Last Updated January 2004.</p>
+    </section>
+    <section name="Active Commiters">
+      
+      <p>
+        <b>Serge Knystautas (sergek at lokitech.com) (SK)</b>
+        <br/> Serge was the original donator of the James code, which has since been massively improved by people smarter than him.  He tries to answer questions on the listserv and make code contributions when he does get a rare bit of free time.</p>
+      <p>
+        <b>Harmeet Bedi (harmeet at kodemuse.com) (HB)</b>
+      </p>
+      <p>
+        <b>Danny Angus (danny at apache.org) (DA)</b>
+        <br/> Danny is a member of the Apache Software Foundation and married father of two by night, and by day works as lead technical consultant for the <a href="http://www.slc.co.uk">Student Loans Company ltd</a>.</p>
+      
+      <p>
+        <b>Noel J. Bergman (noel at devtech.com) (NjB)</b>
+      </p>
+      
+      <p>
+        <b>Vincenzo Gianferrari Pini (vincenzo.gianferraripini at praxis.it) [VGP]</b>
+      </p>
+      <p>
+        <b>Soeren Hilmer (soren.hilmer at tietoenator.com) [SH]</b>
+      </p>
+      <p>
+        <b>Steve Brewin (sbrewin at synsys.com) [SB]</b>
+      </p>
+      <p>
+        <b>Jason Webb (jw at inovem.com) [JW]</b>
+      </p>
+    </section>
+    <section name="Alumni and Other Contributors">
+    <p>Many people have had a hand in James' success over the years, here we'd like to give credit to those who have made a difference and to those who have left.</p>
+      <p>
+        <b>Darrell DeBoer (DD)</b>
+      </p>
+      <p>
+        <b>Stephen J. McConnell (mcconnell at apache.org) (SJM)</b>
+      </p>
+      <p>
+        <b>Peter M. Goldstein (farsight at alum.mit.edu) (PG)</b>
+      </p>
+      <p>
+        <b>Pete Donald (PD)</b>
+      </p>
+      <p>
+        <b>Charles Benett (charles at benett1.demon.co.uk) (CB)</b>
+      </p>
+      <p>
+        <b>Federico Barbieri, (scoobie at systemy.it) (FB)</b>
+      </p>
+      <p>
+        <b>Stuart Roebuck, stuart.roebuck at adolos.co.uk (SR)</b>
+      </p>
+      <p>
+        <b>Ivan Seskar, iseskar at upsideweb.com (IS)</b>
+      </p>
+      <p>
+        <b>Prasanna Uppaladadium, prasanna at vayusphere.com (PU)</b>
+      </p>
+      <p>
+        <b>Gabriel Bucher, gabriel.bucher at razor.ch (GB)</b>
+      </p>
+      <p>
+        <b>Matthew Pangaro, mattp at lokitech.com (MP)</b>
+      </p>
+      <p>
+        <b>Jason Borden, jborden at javasense.com (JB)</b>
+      </p>
+      <p>
+        <b>Randy Stanard (rstanard at lokitech.com) (RS)</b>
+        <br/> Contributed the James logo.</p>
+      <p>
+        <b>Samuel Sadek (Samuel.Sadek at kpmg.co.uk) (SS)</b>
+      </p>
+      <p>
+        <b>Stephan Schiessling (s at rapi.com) (SS2)</b>
+      </p>
+      <p>
+        <b>Eung-ju Park (colus at apache.org) (EP)</b>
+      </p>
+      <p>
+        <b>Paul Hammant (Paul_Hammant at yahoo.com) (PH)</b>
+      </p>
+      <p>
+        <b>Jeff Keyser (JKeyser at telocity.com) (JK)</b>
+      </p>
+      <p>
+        <b>Andrei Ivanov (myfam at surfeu.fi) (AI)</b>
+      </p>
+      <p>
+        <b>Brad Walker (bwalker at studentadvantage.com) (BW)</b>
+      </p>
+      <p>
+        <b>Christian Buchegger (christian.buchegger at planet-interkom.de) (CB2)</b>
+      </p>
+      <p>
+        <b>Shilpa Dalmia (shilpa at postx.com) (SD)</b>
+      </p>
+      <p>
+        <b>Steve Short (sshort at postx.com) (SS3)</b>
+      </p>
+      <p>
+        <b>Aaron Knauf (aknauf at xtra.co.nz) (AK)</b>
+      </p>
+      <p>
+        <b>Serge "Sergei" Sozonoff (serge at globalbeach.com) (SS4)</b>
+      </p>
+      <p>
+        <b>Kai Londenberg (kai.londenberg at my-vwclub.de) [KL]</b>
+      </p>
+      <p>
+        <b>Mark Imel (james at imelshire.com) [MI]</b>
+      </p>
+      <p>
+        <b>Kevin Schmidt (ktschmidt at earthlink.net) [KS]</b>
+      </p>
+      <p>
+        <b>Hontvari Jozsef (hontvari2 at solware.com) [HJ]</b>
+      </p>
+      <p>
+        <b>Cesar Bonadio (bonadio at picture.com.br) [CB3]</b>
+      </p>
+      <p>
+        <b>Marco Tedone (mtedone at jemos.org) [MT]</b>
+      </p>
+      <p>
+        <b>Tim Stephenson (tim at thestephensons.me.uk) [TS]</b>
+      </p>
+      <p>
+        <b>Richard O. Hammer (rohammer at earthlink.net) [ROH]</b>
+      </p>
+    </section>
+  </body>
 </document>

---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org


Mime
View raw message