You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by so...@apache.org on 2006/02/03 22:40:16 UTC

svn commit: r374754 - in /httpd/site/trunk: docs/ docs/mod_smtpd/ docs/modules/ xdocs/ xdocs/mod_smtpd/ xdocs/modules/

Author: soc-rian
Date: Fri Feb  3 13:40:10 2006
New Revision: 374754

URL: http://svn.apache.org/viewcvs?rev=374754&view=rev
Log:
add mod_smtpd pages, updated homepage to say that 2.2.0 is the best available
version.

Added:
    httpd/site/trunk/docs/mod_smtpd/
    httpd/site/trunk/docs/mod_smtpd/index.html
    httpd/site/trunk/docs/mod_smtpd/install.html
    httpd/site/trunk/xdocs/mod_smtpd/
    httpd/site/trunk/xdocs/mod_smtpd/index.xml
    httpd/site/trunk/xdocs/mod_smtpd/install.xml
Modified:
    httpd/site/trunk/docs/index.html
    httpd/site/trunk/docs/modules/index.html
    httpd/site/trunk/xdocs/index.xml
    httpd/site/trunk/xdocs/modules/index.xml

Modified: httpd/site/trunk/docs/index.html
URL: http://svn.apache.org/viewcvs/httpd/site/trunk/docs/index.html?rev=374754&r1=374753&r2=374754&view=diff
==============================================================================
--- httpd/site/trunk/docs/index.html (original)
+++ httpd/site/trunk/docs/index.html Fri Feb  3 13:40:10 2006
@@ -88,9 +88,10 @@
 <p>The Apache HTTP Server Project is proud to <a href="http://www.apache.org/dist/httpd/Announcement2.2.html">announce</a>
 the release of version 2.2.0 of the Apache HTTP Server ("Apache").</p>
 <p>This version of Apache is a major release and the start of a new stable
-   branch. <a href="docs/2.2/new_features_2_2.html">New features</a> include
+   branch, and represents the best available version of Apache HTTP Server.
+   <a href="docs/2.2/new_features_2_2.html">New features</a> include
    Smart Filtering, Improved Caching, AJP Proxy, Proxy Load Balancing, 
-   Graceful Shutdown support, Large File Support, the Event MPM, and refactored 
+   Graceful Shutdown support, Large File Support, the Event MPM, and refactored
    Authentication/Authorization.</p>
 <p align="center">
 <a href="download.cgi">Download</a> | 
@@ -111,8 +112,7 @@
 <p>The Apache HTTP Server Project is proud to 
    <a href="http://www.apache.org/dist/httpd/Announcement2.0.html">announce</a>
    the release of version 2.0.55 of the Apache HTTP Server ("Apache").</p>
-<p>This version of Apache is principally a security and bug fix release,
-   and represents the best available version of Apache HTTP Server.</p>
+<p>This version of Apache is principally a security and bug fix release.</p>
 <p>For further details, see the 
    <a href="http://www.apache.org/dist/httpd/Announcement2.0.html">announcement</a>.</p>
 <p align="center">

Added: httpd/site/trunk/docs/mod_smtpd/index.html
URL: http://svn.apache.org/viewcvs/httpd/site/trunk/docs/mod_smtpd/index.html?rev=374754&view=auto
==============================================================================
--- httpd/site/trunk/docs/mod_smtpd/index.html (added)
+++ httpd/site/trunk/docs/mod_smtpd/index.html Fri Feb  3 13:40:10 2006
@@ -0,0 +1,182 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+               "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+ <head>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+       <meta name="author" content="HTTPd developers" /><meta name="email" content="dev@httpd.apache.org" />
+    <title>mod_smtpd - Modular SMTP Server for Apache 2.2 - The Apache HTTP Server Project</title>
+ </head>
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+<p><a href="/"><img src="../images/httpd_logo_wide.gif" alt="The Apache HTTP Server Project" border="0"/></a></p>
+ <table border="0" width="100%" cellspacing="4">
+   <tr>
+    <!-- LEFT SIDE NAVIGATION -->
+    <td valign="top" nowrap="nowrap">
+           <p><b>Essentials</b></p>
+    <menu compact="compact">
+          <li><a href="/ABOUT_APACHE.html">About</a></li>
+          <li><a href="http://www.apache.org/licenses/">License</a></li>
+          <li><a href="/docs/2.2/faq/">FAQ</a></li>
+          <li><a href="/security_report.html">Security<br />Reports</a></li>
+        </menu>
+      <p><b>Download!</b></p>
+    <menu compact="compact">
+          <li><a href="/download.cgi">from a mirror</a></li>
+        </menu>
+      <p><b><a 
+href="/docs/">Documentation</a></b></p>
+    <menu compact="compact">
+          <li><a href="/docs/2.2/">Version 2.2</a></li>
+          <li><a href="/docs/2.0/">Version 2.0</a></li>
+          <li><a href="/docs/1.3/">Version 1.3</a></li>
+          <li><a href="/docs/trunk/">Trunk</a> (dev)</li>
+        </menu>
+      <p><b>Get Involved</b></p>
+    <menu compact="compact">
+          <li><a href="/lists.html">Mailing Lists</a></li>
+          <li><a href="/bug_report.html">Bug Reports</a></li>
+          <li><a href="/dev/">Developer Info</a></li>
+        </menu>
+      <p><b>Subprojects</b></p>
+    <menu compact="compact">
+          <li><a href="/docs-project/">Docs</a></li>
+          <li><a href="/test/">Test</a></li>
+          <li><a href="/test/flood/">Flood</a></li>
+          <li><a href="/apreq/">libapreq</a></li>
+          <li><a href="/modules/">Modules</a></li>
+          <li><a href="/cli/">cli (.NET)</a></li>
+        </menu>
+      <p><b><a 
+href="/info/">Miscellaneous</a></b></p>
+    <menu compact="compact">
+          <li><a href="/contributors/">Contributors</a></li>
+          <li><a href="/awards.html">Awards</a></li>
+          <li><a href="http://webring.com/hub?ring=apachesupport">Support<br />Webring</a></li>
+        </menu>
+    </td>
+    <!-- RIGHT SIDE INFORMATION -->
+    <td align="left" valign="top">
+                <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>Introduction</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>
+    <tt>mod_smtpd</tt> is a modular SMTP server similar in spirit to
+    <a href="http://smtpd.develooper.com">qpsmtpd</a>.
+  </p>
+<p>
+    For developers it offers a dependable
+    platform to quickly write a custom SMTP application
+    without the burdens of portability, protocol, daemonization and/or
+    process scheduling,
+  </p>
+<p>For system administrators it precludes the need for
+    a separate SMTP daemon and also allows for simple replacement of SMTP backend
+    without having to switch SMTP daemons (just load a different queue module!).
+    Features Include:
+  </p>
+<ul>
+    <li>Simple yet advanced plugin system based on Apache hooks.</li>
+    <li>Close to nothing built in. All functionality is required by plugins.</li>
+    <li>Use of Apache filters for the SMTP "DATA" command.</li>
+  </ul>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>Get It!</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>
+    <tt>mod_smtpd</tt> hasn't been released yet. It is still alpha quality and
+    isn't ready for production use. If you'd like to try it out
+    development of mod_smtpd can be followed through the
+    <a href="http://subversion.tigris.org/">Subversion</a>
+    repositories. For public access you can use :
+  </p>
+<pre><code>
+    % svn checkout http://svn.apache.org/repos/asf/httpd/mod_smtpd/trunk/ mod_smtpd
+  </code></pre>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>Documentation</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<ul>
+    <li><a href="install.html">Installation instructions</a></li>
+    <li>More documentation coming soon!</li>
+  </ul>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>Mailing Lists</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>
+    Discussions on <tt>mod_smtpd</tt> take place on the main HTTPd development
+    mailing list.
+  </p>
+<ul type="square">
+    <li>
+      <a href="mailto:dev-subscribe@httpd.apache.org">dev@httpd.apache.org</a>
+      - module development (<a href="http://mail-archives.apache.org/mod_mbox/httpd-dev/">archives</a>).
+    </li>
+    <li>
+      <a href="mailto:cvs-subscribe@httpd.apache.org">cvs@httpd.apache.org</a>
+      - svn commit logs for httpd, including mod_mbox
+      (<a href="http://mail-archives.apache.org/mod_mbox/httpd-cvs/">archives</a>).
+    </li>
+  </ul>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>History</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>
+    <tt>mod_smtpd</tt> started it's life as a 2005 Google Summer of Code project
+    taken on by <strong>Rian Hunter</strong> and <strong>Jem Berkes</strong> with
+    mentors <strong>Nick Kew</strong> and <strong>Paul Querna</strong>. It continues
+    its life being developed and maintained by Rian Hunter with help from the httpd
+    developers.
+  </p>
+  </blockquote>
+ </td></tr>
+</table>
+         </td>
+   </tr>
+   <!-- FOOTER -->
+   <tr><td colspan="2"><hr noshade="noshade" size="1"/></td></tr>
+   <tr><td colspan="2" align="center">
+        <font size="-1">
+         <em>Copyright &#169; 1999-2005, The Apache Software Foundation</em>
+        </font>
+       </td>
+   </tr>
+  </table>
+ </body>
+</html>

Added: httpd/site/trunk/docs/mod_smtpd/install.html
URL: http://svn.apache.org/viewcvs/httpd/site/trunk/docs/mod_smtpd/install.html?rev=374754&view=auto
==============================================================================
--- httpd/site/trunk/docs/mod_smtpd/install.html (added)
+++ httpd/site/trunk/docs/mod_smtpd/install.html Fri Feb  3 13:40:10 2006
@@ -0,0 +1,178 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+               "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+ <head>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+       <meta name="author" content="HTTPd developers" /><meta name="email" content="dev@httpd.apache.org" />
+    <title>mod_smtpd - Modular SMTP Server for Apache 2.2 Installation - The Apache HTTP Server Project</title>
+ </head>
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+<p><a href="/"><img src="../images/httpd_logo_wide.gif" alt="The Apache HTTP Server Project" border="0"/></a></p>
+ <table border="0" width="100%" cellspacing="4">
+   <tr>
+    <!-- LEFT SIDE NAVIGATION -->
+    <td valign="top" nowrap="nowrap">
+           <p><b>Essentials</b></p>
+    <menu compact="compact">
+          <li><a href="/ABOUT_APACHE.html">About</a></li>
+          <li><a href="http://www.apache.org/licenses/">License</a></li>
+          <li><a href="/docs/2.2/faq/">FAQ</a></li>
+          <li><a href="/security_report.html">Security<br />Reports</a></li>
+        </menu>
+      <p><b>Download!</b></p>
+    <menu compact="compact">
+          <li><a href="/download.cgi">from a mirror</a></li>
+        </menu>
+      <p><b><a 
+href="/docs/">Documentation</a></b></p>
+    <menu compact="compact">
+          <li><a href="/docs/2.2/">Version 2.2</a></li>
+          <li><a href="/docs/2.0/">Version 2.0</a></li>
+          <li><a href="/docs/1.3/">Version 1.3</a></li>
+          <li><a href="/docs/trunk/">Trunk</a> (dev)</li>
+        </menu>
+      <p><b>Get Involved</b></p>
+    <menu compact="compact">
+          <li><a href="/lists.html">Mailing Lists</a></li>
+          <li><a href="/bug_report.html">Bug Reports</a></li>
+          <li><a href="/dev/">Developer Info</a></li>
+        </menu>
+      <p><b>Subprojects</b></p>
+    <menu compact="compact">
+          <li><a href="/docs-project/">Docs</a></li>
+          <li><a href="/test/">Test</a></li>
+          <li><a href="/test/flood/">Flood</a></li>
+          <li><a href="/apreq/">libapreq</a></li>
+          <li><a href="/modules/">Modules</a></li>
+          <li><a href="/cli/">cli (.NET)</a></li>
+        </menu>
+      <p><b><a 
+href="/info/">Miscellaneous</a></b></p>
+    <menu compact="compact">
+          <li><a href="/contributors/">Contributors</a></li>
+          <li><a href="/awards.html">Awards</a></li>
+          <li><a href="http://webring.com/hub?ring=apachesupport">Support<br />Webring</a></li>
+        </menu>
+    </td>
+    <!-- RIGHT SIDE INFORMATION -->
+    <td align="left" valign="top">
+                <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>Installation instructions</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>
+    <tt>mod_smtpd</tt> is very easy to install and setup. First, we
+    need to build the module and make the Apache HTTPd webserver load
+    it. Then, we'll setup our archives repository and complete
+    Apache's configuration.
+  </p>
+<p>
+    <tt>mod_smtpd</tt> has, of course, some requirements :
+  </p>
+<ul>
+    <li>Apache HTTPd &gt;= 2.2 (<tt>mod_smtpd</tt> has been tested succesfully with Apache 2.2.0 and 2.3.0-dev)</li>
+    <li>APR and APR-Util &gt;= 0.9</li>
+    <li>libapreq2</li>
+  </ul>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>Download and build</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>
+    You can download a source tarball or checkout sources via Subversion :
+  </p>
+<pre><code>
+    svn checkout https://svn.apache.org/repos/asf/httpd/mod_smtpd/trunk mod_smtpd
+  </code></pre>
+<p>
+    Then, build <tt>mod_smtpd</tt> :
+  </p>
+<pre><code>
+    ./autogen.sh
+    ./configure
+    make clean all
+    su -c 'make install'
+  </code></pre>
+<p>
+    Refer to the configure help (<tt>./configure --help</tt>) if you
+    need a to specify an installation prefix (<tt>--prefix=...</tt>)
+    or any other specific setup.
+  </p>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>Preliminary Apache setup</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>
+    The next step is to make Apache HTTPd load the <tt>mod_smtpd</tt>
+    module at runtime. Edit your Apache configuration file, and add
+    the following to the rest of the <tt>LoadModule</tt> lines :
+  </p>
+<pre><code>
+    LoadModule smtpd_module /usr/lib/apache2/modules/mod_smtpd.so
+  </code></pre>
+<p>
+    Or replace that directory with your default Apache 2.2 install directory.
+  </p>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>mod_smtpd configuration</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>
+    You now need to configure Apache to run mod_smtpd whenever a network
+    connection comes in. We recommend this virtual host setup:
+  </p>
+<pre><code>
+      NameVirtualHost *:80
+      NameVirtualHost *:25
+
+      &lt;VirtualHost *:80&gt;
+        # your webserver configuration here
+      &lt;/VirtualHost &gt;
+
+      &lt;VirtualHost *:25&gt;
+        ServerName localhost # or whatever desired
+        SmtpProtocol On
+        # addition mod_smtpd or associated plugin configuration here
+      &lt;/VirtualHost &gt;
+  </code></pre>
+  </blockquote>
+ </td></tr>
+</table>
+         </td>
+   </tr>
+   <!-- FOOTER -->
+   <tr><td colspan="2"><hr noshade="noshade" size="1"/></td></tr>
+   <tr><td colspan="2" align="center">
+        <font size="-1">
+         <em>Copyright &#169; 1999-2005, The Apache Software Foundation</em>
+        </font>
+       </td>
+   </tr>
+  </table>
+ </body>
+</html>

Modified: httpd/site/trunk/docs/modules/index.html
URL: http://svn.apache.org/viewcvs/httpd/site/trunk/docs/modules/index.html?rev=374754&r1=374753&r2=374754&view=diff
==============================================================================
--- httpd/site/trunk/docs/modules/index.html (original)
+++ httpd/site/trunk/docs/modules/index.html Fri Feb  3 13:40:10 2006
@@ -156,6 +156,24 @@
   </blockquote>
  </td></tr>
 </table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <a name="mod_smtpd"><strong>mod_smtpd</strong></a>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>Serve SMTP on Apache with <tt>mod_smtpd</tt>.</p>
+<ul>
+<li><a href="http://httpd.apache.org/mod_smtpd">Website</a></li>
+<li>Source: <a href="https://svn.apache.org/repos/asf/httpd/mod_smtpd/trunk">mod_smtpd</a></li>
+<li>ViewCVS: <a href="http://svn.apache.org/viewcvs.cgi/httpd/mod_smtpd">mod_smtpd</a></li>
+<li>Mailing list: <a href="mailto:dev-subscribe@httpd.apache.org">dev@httpd.apache.org</a></li>
+</ul>
+  </blockquote>
+ </td></tr>
+</table>
          </td>
    </tr>
    <!-- FOOTER -->

Modified: httpd/site/trunk/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/httpd/site/trunk/xdocs/index.xml?rev=374754&r1=374753&r2=374754&view=diff
==============================================================================
--- httpd/site/trunk/xdocs/index.xml (original)
+++ httpd/site/trunk/xdocs/index.xml Fri Feb  3 13:40:10 2006
@@ -32,9 +32,10 @@
 the release of version 2.2.0 of the Apache HTTP Server ("Apache").</p>
 
 <p>This version of Apache is a major release and the start of a new stable
-   branch. <a href="docs/2.2/new_features_2_2.html">New features</a> include
+   branch, and represents the best available version of Apache HTTP Server.
+   <a href="docs/2.2/new_features_2_2.html">New features</a> include
    Smart Filtering, Improved Caching, AJP Proxy, Proxy Load Balancing, 
-   Graceful Shutdown support, Large File Support, the Event MPM, and refactored 
+   Graceful Shutdown support, Large File Support, the Event MPM, and refactored
    Authentication/Authorization.</p>
 
 <p align="center">
@@ -52,8 +53,7 @@
    <a href="http://www.apache.org/dist/httpd/Announcement2.0.html">announce</a>
    the release of version 2.0.55 of the Apache HTTP Server ("Apache").</p>
 
-<p>This version of Apache is principally a security and bug fix release,
-   and represents the best available version of Apache HTTP Server.</p>
+<p>This version of Apache is principally a security and bug fix release.</p>
 
 <p>For further details, see the 
    <a href="http://www.apache.org/dist/httpd/Announcement2.0.html"

Added: httpd/site/trunk/xdocs/mod_smtpd/index.xml
URL: http://svn.apache.org/viewcvs/httpd/site/trunk/xdocs/mod_smtpd/index.xml?rev=374754&view=auto
==============================================================================
--- httpd/site/trunk/xdocs/mod_smtpd/index.xml (added)
+++ httpd/site/trunk/xdocs/mod_smtpd/index.xml Fri Feb  3 13:40:10 2006
@@ -0,0 +1,89 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<document>
+  <properties>
+    <author email="dev@httpd.apache.org">HTTPd developers</author>
+    <title>mod_smtpd - Modular SMTP Server for Apache 2.2</title>
+  </properties>
+<body>
+
+<section>
+  <title>Introduction</title>
+  <p>
+    <tt>mod_smtpd</tt> is a modular SMTP server similar in spirit to
+    <a href="http://smtpd.develooper.com">qpsmtpd</a>.
+  </p>
+  <p>
+    For developers it offers a dependable
+    platform to quickly write a custom SMTP application
+    without the burdens of portability, protocol, daemonization and/or
+    process scheduling,
+  </p>
+  <p>For system administrators it precludes the need for
+    a separate SMTP daemon and also allows for simple replacement of SMTP backend
+    without having to switch SMTP daemons (just load a different queue module!).
+    Features Include:
+  </p>
+  <ul>
+    <li>Simple yet advanced plugin system based on Apache hooks.</li>
+    <li>Close to nothing built in. All functionality is required by plugins.</li>
+    <li>Use of Apache filters for the SMTP "DATA" command.</li>
+  </ul>
+</section>
+
+<section>
+  <title>Get It!</title>
+
+  <p>
+    <tt>mod_smtpd</tt> hasn't been released yet. It is still alpha quality and
+    isn't ready for production use. If you'd like to try it out
+    development of mod_smtpd can be followed through the
+    <a href="http://subversion.tigris.org/">Subversion</a>
+    repositories. For public access you can use :
+  </p>
+
+  <pre><code>
+    % svn checkout http://svn.apache.org/repos/asf/httpd/mod_smtpd/trunk/ mod_smtpd
+  </code></pre>
+</section>
+
+<section>
+  <title>Documentation</title>
+  <ul>
+    <li><a href="install.html">Installation instructions</a></li>
+    <li>More documentation coming soon!</li>
+  </ul>
+</section>
+
+<section>
+  <title>Mailing Lists</title>
+  <p>
+    Discussions on <tt>mod_smtpd</tt> take place on the main HTTPd development
+    mailing list.
+  </p>
+
+  <ul type="square">
+    <li>
+      <a href="mailto:dev-subscribe@httpd.apache.org">dev&#64;httpd.apache.org</a>
+      - module development (<a href="http://mail-archives.apache.org/mod_mbox/httpd-dev/">archives</a>).
+    </li>
+    <li>
+      <a href="mailto:cvs-subscribe@httpd.apache.org">cvs&#64;httpd.apache.org</a>
+      - svn commit logs for httpd, including mod_mbox
+      (<a href="http://mail-archives.apache.org/mod_mbox/httpd-cvs/">archives</a>).
+    </li>
+  </ul>
+</section>
+
+<section>
+  <title>History</title>
+  <p>
+    <tt>mod_smtpd</tt> started it's life as a 2005 Google Summer of Code project
+    taken on by <strong>Rian Hunter</strong> and <strong>Jem Berkes</strong> with
+    mentors <strong>Nick Kew</strong> and <strong>Paul Querna</strong>. It continues
+    its life being developed and maintained by Rian Hunter with help from the httpd
+    developers.
+  </p>
+</section>
+
+</body>
+</document>

Added: httpd/site/trunk/xdocs/mod_smtpd/install.xml
URL: http://svn.apache.org/viewcvs/httpd/site/trunk/xdocs/mod_smtpd/install.xml?rev=374754&view=auto
==============================================================================
--- httpd/site/trunk/xdocs/mod_smtpd/install.xml (added)
+++ httpd/site/trunk/xdocs/mod_smtpd/install.xml Fri Feb  3 13:40:10 2006
@@ -0,0 +1,98 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<document>
+  <properties>
+    <author email="dev@httpd.apache.org">HTTPd developers</author>
+    <title>mod_smtpd - Modular SMTP Server for Apache 2.2 Installation</title>
+  </properties>
+<body>
+
+<section>
+  <title>Installation instructions</title>
+  <p>
+    <tt>mod_smtpd</tt> is very easy to install and setup. First, we
+    need to build the module and make the Apache HTTPd webserver load
+    it. Then, we'll setup our archives repository and complete
+    Apache's configuration.
+  </p>
+
+  <p>
+    <tt>mod_smtpd</tt> has, of course, some requirements :
+  </p>
+
+  <ul>
+    <li>Apache HTTPd >= 2.2 (<tt>mod_smtpd</tt> has been tested succesfully with Apache 2.2.0 and 2.3.0-dev)</li>
+    <li>APR and APR-Util >= 0.9</li>
+    <li>libapreq2</li>
+  </ul>
+</section>
+
+<section>
+  <title>Download and build</title>
+  <p>
+    You can download a source tarball or checkout sources via Subversion :
+  </p>
+
+  <pre><code>
+    svn checkout https://svn.apache.org/repos/asf/httpd/mod_smtpd/trunk mod_smtpd
+  </code></pre>
+
+  <p>
+    Then, build <tt>mod_smtpd</tt> :
+  </p>
+
+  <pre><code>
+    ./autogen.sh
+    ./configure
+    make clean all
+    su -c 'make install'
+  </code></pre>
+
+  <p>
+    Refer to the configure help (<tt>./configure --help</tt>) if you
+    need a to specify an installation prefix (<tt>--prefix=...</tt>)
+    or any other specific setup.
+  </p>
+</section>
+
+<section>
+  <title>Preliminary Apache setup</title>
+  <p>
+    The next step is to make Apache HTTPd load the <tt>mod_smtpd</tt>
+    module at runtime. Edit your Apache configuration file, and add
+    the following to the rest of the <tt>LoadModule</tt> lines :
+  </p>
+
+  <pre><code>
+    LoadModule smtpd_module /usr/lib/apache2/modules/mod_smtpd.so
+  </code></pre>
+
+  <p>
+    Or replace that directory with your default Apache 2.2 install directory.
+  </p>
+</section>
+
+<section>
+  <title>mod_smtpd configuration</title>
+  <p>
+    You now need to configure Apache to run mod_smtpd whenever a network
+    connection comes in. We recommend this virtual host setup:
+  </p>
+
+  <pre><code>
+      NameVirtualHost *:80
+      NameVirtualHost *:25
+
+      &lt;VirtualHost *:80&gt;
+        # your webserver configuration here
+      &lt;/VirtualHost &gt;
+
+      &lt;VirtualHost *:25&gt;
+        ServerName localhost # or whatever desired
+        SmtpProtocol On
+        # addition mod_smtpd or associated plugin configuration here
+      &lt;/VirtualHost &gt;
+  </code></pre>
+</section>
+
+</body>
+</document>

Modified: httpd/site/trunk/xdocs/modules/index.xml
URL: http://svn.apache.org/viewcvs/httpd/site/trunk/xdocs/modules/index.xml?rev=374754&r1=374753&r2=374754&view=diff
==============================================================================
--- httpd/site/trunk/xdocs/modules/index.xml (original)
+++ httpd/site/trunk/xdocs/modules/index.xml Fri Feb  3 13:40:10 2006
@@ -77,5 +77,18 @@
 </ul>
 </section>
 
+<section id="mod_smtpd">
+<title>mod_smtpd</title>
+
+<p>Serve SMTP on Apache with <tt>mod_smtpd</tt>.</p>
+
+<ul>
+<li><a href="http://httpd.apache.org/mod_smtpd">Website</a></li>
+<li>Source: <a href="https://svn.apache.org/repos/asf/httpd/mod_smtpd/trunk">mod_smtpd</a></li>
+<li>ViewCVS: <a href="http://svn.apache.org/viewcvs.cgi/httpd/mod_smtpd">mod_smtpd</a></li>
+<li>Mailing list: <a href="mailto:dev-subscribe@httpd.apache.org">dev@httpd.apache.org</a></li>
+</ul>
+</section>
+
 </body>
 </document>



Re: svn commit: r374754 - in /httpd/site/trunk: docs/ docs/mod_smtpd/ docs/modules/ xdocs/ xdocs/mod_smtpd/ xdocs/modules/

Posted by Rian Hunter <ri...@MIT.EDU>.
On Feb 3, 2006, at 5:36 PM, Paul Querna wrote:

> Garrett Rooney wrote:
>> On 2/3/06, soc-rian@apache.org <so...@apache.org> wrote:
>>> +    <tt>mod_smtpd</tt> started it's life as a 2005 Google Summer  
>>> of Code project
>>> +    taken on by <strong>Rian Hunter</strong> and <strong>Jem  
>>> Berkes</strong> with
>>> +    mentors <strong>Nick Kew</strong> and <strong>Paul Querna</ 
>>> strong>. It continues
>>> +    its life being developed and maintained by Rian Hunter with  
>>> help from the httpd
>>> +    developers.
>> Ok, now we're seeing this both in the mod_mbox and mod_smtpd web
>> pages.  This is supposed to be a community project, ASF projects  
>> don't
>> have lead developers, and they don't generally go out of their way to
>> assign credit like this, that's normally kept to the CHANGES file and
>> the svn commit logs.  Putting this sort of thing on the web pages
>> seems quite inappropriate to me.
>
> +1.
>
> It is perhaps notable that it was _started_ as a SoC project, but  
> the rest of it can most likely be nuked.  We do have some similar  
> language under http://httpd.apache.org/ABOUT_APACHE.html too.
>
> -Paul
>

+1 I used mod_mbox as the model for the mod_smtpd page. Excuse my  
ignorance.

Rian

Re: svn commit: r374754 - in /httpd/site/trunk: docs/ docs/mod_smtpd/ docs/modules/ xdocs/ xdocs/mod_smtpd/ xdocs/modules/

Posted by Paul Querna <ch...@force-elite.com>.
Garrett Rooney wrote:
> On 2/3/06, soc-rian@apache.org <so...@apache.org> wrote:
> 
>> +    <tt>mod_smtpd</tt> started it's life as a 2005 Google Summer of Code project
>> +    taken on by <strong>Rian Hunter</strong> and <strong>Jem Berkes</strong> with
>> +    mentors <strong>Nick Kew</strong> and <strong>Paul Querna</strong>. It continues
>> +    its life being developed and maintained by Rian Hunter with help from the httpd
>> +    developers.
> 
> Ok, now we're seeing this both in the mod_mbox and mod_smtpd web
> pages.  This is supposed to be a community project, ASF projects don't
> have lead developers, and they don't generally go out of their way to
> assign credit like this, that's normally kept to the CHANGES file and
> the svn commit logs.  Putting this sort of thing on the web pages
> seems quite inappropriate to me.

+1.

It is perhaps notable that it was _started_ as a SoC project, but the 
rest of it can most likely be nuked.  We do have some similar language 
under http://httpd.apache.org/ABOUT_APACHE.html too.

-Paul


Re: svn commit: r374754 - in /httpd/site/trunk: docs/ docs/mod_smtpd/ docs/modules/ xdocs/ xdocs/mod_smtpd/ xdocs/modules/

Posted by Garrett Rooney <ro...@electricjellyfish.net>.
On 2/3/06, soc-rian@apache.org <so...@apache.org> wrote:

> +    <tt>mod_smtpd</tt> started it's life as a 2005 Google Summer of Code project
> +    taken on by <strong>Rian Hunter</strong> and <strong>Jem Berkes</strong> with
> +    mentors <strong>Nick Kew</strong> and <strong>Paul Querna</strong>. It continues
> +    its life being developed and maintained by Rian Hunter with help from the httpd
> +    developers.

Ok, now we're seeing this both in the mod_mbox and mod_smtpd web
pages.  This is supposed to be a community project, ASF projects don't
have lead developers, and they don't generally go out of their way to
assign credit like this, that's normally kept to the CHANGES file and
the svn commit logs.  Putting this sort of thing on the web pages
seems quite inappropriate to me.

-garrett