--- a/doc/HOWTO.html Sun Jan 20 00:12:17 2008 +0100
+++ b/doc/HOWTO.html Sun Jan 20 00:22:09 2008 +0100
@@ -1,334 +1,1015 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<!-- Created on December, 29 2004 by texi2html 1.64 -->
+<!--
+Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
+ Karl Berry <karl@freefriends.org>
+ Olaf Bachmann <obachman@mathematik.uni-kl.de>
+ and many others.
+Maintained by: Olaf Bachmann <obachman@mathematik.uni-kl.de>
+Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
+
+-->
<HEAD>
- <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE> VMailMgr HOWTO</TITLE>
+<TITLE>VMailMgr HOWTO: </TITLE>
+<META NAME="description" CONTENT="VMailMgr HOWTO: ">
+<META NAME="keywords" CONTENT="VMailMgr HOWTO: ">
+<META NAME="resource-type" CONTENT="document">
+<META NAME="distribution" CONTENT="global">
+<META NAME="Generator" CONTENT="texi2html 1.64">
</HEAD>
-<BODY>
-<H1> VMailMgr HOWTO</H1>
+
+<BODY LANG="" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
-<H2>Bruce Guenter
-<A HREF="mailto:bruceg@em.ca">mailto:bruceg@em.ca</A>,
- Dan Kuykendall
-<A HREF="mailto:dan@kuykendall.org">mailto:dan@kuykendall.org</A></H2> v1.w, 2000-09-15
-<P><HR>
-<EM> This document explains how to setup VMailMgr support pop3 virtual domain services in conjunction with Qmail.</EM>
-<HR>
-<H2><A NAME="s1">1. Introduction</A></H2>
+<A NAME="SEC1"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC2"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<P>
+
+Copyright (C) 1998 Bruce Guenter
+</P><P>
+
+This document explains how to setup VMailMgr support pop3 virtual domain
+services in conjunction with Qmail.
+</P><P>
+
+<H1> 1. Introduction </H1>
+<!--docid::SEC1::-->
+<P>
-<P>VMailMgr (short for Virtual MAIL ManaGeR) is a package of programs
+VMailMgr (an abbreviation for Virtual Mail Manager) is a package of programs
designed to manage multiple domains of mail addresses and mailboxes
-on a single host. It co-operates with qmail for mail delivery and
+on a single host. It co-operates with qmail for mail delivery and
program control.
-<H2>1.1 What is VMailMgr and why should I use it?</H2>
+</P><P>
-<P>VMailMgr is:
-<P> A series of utilities for managing virtual domains
-which include a password checking interface for qmail which replaces
-the usual checkpassword, and an authentication module for Courier
-IMAP, that provide access to the virtual mailboxes by one of three
+<HR SIZE="6">
+<A NAME="SEC2"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC3"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 1.1 What is VMailMgr and why should I use it? </H2>
+<!--docid::SEC2::-->
+<P>
+
+VMailMgr is a series of utilities for managing virtual domains, including:
+<UL>
+<LI>
+a password checking interface for qmail, which replaces the usual
+checkpassword, and
+<LI>
+an authentication module for Courier IMAP
+</UL>
+<P>
+
+These utilities provide access to the virtual mailboxes by one of three
methods:
+</P><P>
+
<UL>
-<LI> IP-based virtual server access (invisible to the POP3 user)</LI>
-<LI> username-based access (username-virtualuser)</LI>
-<LI> hostname-based access (virtualuser@virtual.host or
-virtualuser:virtual.host)</LI>
+<LI>
+IP-based virtual server access (invisible to the POP3 user)
+<LI>
+username-based access (virtual user logs in as <SAMP>`username-virtualuser'</SAMP>)
+<LI>
+hostname-based access (virtual user logs in as <SAMP>`virtualuser@virtual.host'</SAMP>
+or <SAMP>`virtualuser:virtual.host'</SAMP>)
</UL>
-<P>You should use it if you prefer to have each domain controlled by a
+<P>
+
+You should use VMailMgr if you prefer to have each domain controlled by a
seperate username, allowing the use of system quotas and better
-security
-<H2>1.2 New versions </H2>
+security.
+</P><P>
+
+<HR SIZE="6">
+<A NAME="SEC3"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC2"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC4"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 1.2 New versions </H2>
+<!--docid::SEC3::-->
+<P>
+
+The newest version of this document can be found on the VMailMgr homepage
+<A HREF="http://www.vmailmgr.org/">http://www.vmailmgr.org/</A> in various formats, including the
+texinfo source and HTML and plaintext versions.
+</P><P>
-<P>The newest version of this can be found on the VMailMgr homepage
-<A HREF="http://www.vmailmgr.org/">http://www.vmailmgr.org/</A> in its HTML version as well as
-in the source package SGML source, HTML, and text. Other versions
-may be found in different formats at the LDP homepage
-<A HREF="http://www.linuxdoc.org/">http://www.linuxdoc.org/</A>.
-<H2>1.3 Comments </H2>
+<HR SIZE="6">
+<A NAME="SEC4"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC3"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC5"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 1.3 Comments </H2>
+<!--docid::SEC4::-->
+<P>
+
+Comments on this HOWTO should be directed to the VMailMgr mailing
+list. To subscribe, send a blank email to
+<A HREF="mailto:vmailmgr-subscribe@lists.untroubled.org">vmailmgr-subscribe@lists.untroubled.org</A>.
+</P><P>
-<P>Comments on this HOWTO should be directed to the VMailMgr mailing
-list. To subscribe, send an email to
-<A HREF="mailto:vmailmgr-subscribe@lists.em.ca">vmailmgr-subscribe@lists.em.ca</A>.
-<H2>1.4 History </H2>
+<HR SIZE="6">
+<A NAME="SEC5"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC4"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC6"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 1.4 History </H2>
+<!--docid::SEC5::-->
+<P>
+
+This document was started by Bruce Guenter and reworked by Dan
+Kuykendall, then by Charles Cazabon.
+</P><P>
-<P>This document was started by Bruce Guenter and reworked by Dan
-Kuykendall.
-<H2>1.5 Copyrights and Trademarks </H2>
+<HR SIZE="6">
+<A NAME="SEC6"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC5"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC7"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 1.5 Copyrights and Trademarks </H2>
+<!--docid::SEC6::-->
+<P>
-<P>Copyright (c) Dan Kuykendall.
+Copyright (C) Dan Kuykendall.
+</P><P>
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1
or any later version published by the Free Software Foundation
-<P>A copy of the license is available at
-<A HREF="http://www.gnu.org/copyleft/fdl.txt">GNU Free Documentation License</A>.
-<H2>1.6 Acknowledgements and Thanks </H2>
+</P><P>
+
+A copy of the license is available at
+<A HREF="http://www.gnu.org/copyleft/fdl.txt">GNU Free Documentation License</A>.
+</P><P>
-<P>Thanks to Bruce Guenter for VMailMgr and the core of this
-HOWTO. Thanks to Mike Bell, who always seems to have the answers to
+<HR SIZE="6">
+<A NAME="SEC7"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC6"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC8"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 1.6 Acknowledgements and Thanks </H2>
+<!--docid::SEC7::-->
+<P>
+
+Thanks to Bruce Guenter for VMailMgr and the core of this
+HOWTO. Thanks to Mike Bell, who always seems to have the answers to
my questions. Finally, thanks to all those on the
-<A HREF="mailto:vmailmgr@lists.em.ca">vmailmgr@lists.em.ca</A>
+<A HREF="mailto:vmailmgr@lists.untroubled.org">vmailmgr@lists.untroubled.org</A>
mailing list who have helped me, or asked the same stuff so many
times that I had to write this to stop the repeat questions.
-<H2><A NAME="s2">2. Installation</A></H2>
+</P><P>
-<H2>2.1 Get the files</H2>
+<HR SIZE="6">
+<A NAME="SEC8"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC7"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC9"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H1> 2. Installation </H1>
+<!--docid::SEC8::-->
+<P>
-<P>Visit the VMailMgr website
-<A HREF="http://www.vmailmgr.org/">http://www.vmailmgr.org/</A> to
-get the package.
-<P>If you get the binary RPMS you will need at least the vmailmgr package.
-<H2>2.2 Install with RPMS</H2>
+<HR SIZE="6">
+<A NAME="SEC9"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC8"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC10"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 2.1 Get the files </H2>
+<!--docid::SEC9::-->
+<P>
-<H3>Compiling SRC.RPM's</H3>
+Visit the VMailMgr website <A HREF="http://www.vmailmgr.org/">http://www.vmailmgr.org/</A> or one of its
+mirror sites to download the package. There are two primary methods of
+installing:
+</P><P>
+
+<UL>
+<LI>
+from source
+<P>
+
+<LI>
+from a binary package -- specifically, an <CODE>RPM</CODE> binary package
+<P>
-<P>Simply compile the src.rpm file with the `<CODE>rpm --rebuild</CODE>` command.
--Example-
-<HR>
-<PRE>
- rpm -ivh vmailmgr-0.96.9-1.src.rpm
-</PRE>
-<HR>
-<H3>Installing RPM's</H3>
+</UL>
+<P>
+
+If you get the binary RPMS you will need at least the vmailmgr package.
+</P><P>
+
+<HR SIZE="6">
+<A NAME="SEC10"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC9"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC11"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 2.2 Install with RPMS </H2>
+<!--docid::SEC10::-->
+<P>
+
+To install from binary <CODE>RPM</CODE> packages, you can download the binaries,
+or build them from the source RPM package.
+</P><P>
-<P>After compiling the source rpms, the binaries will be located
-in `<CODE>/usr/src/redhat/RPMS/i386/</CODE>` or something similar.
-<P>Simply run the following command for each package
-<PRE>
- rpm -ivh <location>/<package.i386.rpm>
-</PRE>
+<HR SIZE="6">
+<A NAME="SEC11"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC10"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC12"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H3> 2.2.1 Compiling the Source RPM (SRPM) Package </H3>
+<!--docid::SEC11::-->
+<P>
--Example-
-<HR>
-<PRE>
- rpm -ivh /usr/src/redhat/RPMS/i386/vmailmgr-0.96.9-1.i386.rpm
- rpm -ivh /usr/src/redhat/RPMS/i386/vmailmgr-daemon-0.96.9-1.i386.rpm
-</PRE>
-<HR>
-<P>
-<P>
-<H2>2.3 Install with source</H2>
+If you download the binary packages directly, skip to the next step.
+</P><P>
+
+Download the source rpm package (<SAMP>`vmailmgr-<VAR>VERSION</VAR>.src.rpm'</SAMP>),
+and then use the <CODE>rpm</CODE> tool to build the binary RPM package from it
+with the <SAMP>`rpm --rebuild'</SAMP> command as follows:
+</P><P>
+
+<TABLE><tr><td> </td><td class=example><pre>rpm --rebuild vmailmgr-1.0.0-1.src.rpm
+</pre></td></tr></table></P><P>
-<P>If you dont ue RPMS you can install from source.
-<P>Run the following command
-<PRE>
- (As non-root user)
- tar zxf <package.tar.gz>
- cd <newly created dir>
- ./configure
- make
- (As root)
- make install
-</PRE>
+<HR SIZE="6">
+<A NAME="SEC12"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC11"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC13"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H3> 2.2.2 Installing the Binary RPM packages </H3>
+<!--docid::SEC12::-->
+<P>
+
+After compiling the source RPM, the binary RPM packages will be located
+in the appropriate output directory (typically
+<TT>`/usr/src/redhat/RPMS/i386/'</TT>).
+</P><P>
+
+Install each package using the <SAMP>`-i'</SAMP> option of <CODE>rpm</CODE> (i.e.
+<SAMP>`rpm -ivh <VAR>PACKAGE</VAR>.i386.rpm'</SAMP>) as follows:
+</P><P>
+
+<TABLE><tr><td> </td><td class=example><pre>rpm -ivh /usr/src/redhat/RPMS/i386/vmailmgr-1.0.0-1.i386.rpm
+rpm -ivh /usr/src/redhat/RPMS/i386/vmailmgr-daemon-1.0.0-1.i386.rpm
+</pre></td></tr></table></P><P>
--Example-
-<HR>
-<PRE>
- (As non-root user)
- tar zxf vmailmgr-0.96.9.tar.gz
- cd vmailmgr-0.96.9
- ./configure
- make
- (As root)
- make install
-</PRE>
-<HR>
+<HR SIZE="6">
+<A NAME="SEC13"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC12"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC14"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 2.3 Install from source </H2>
+<!--docid::SEC13::-->
+<P>
+
+If you dont use RPM packages, you can install from source with the following
+commands. First, as a regular, non-root user:
+</P><P>
+
+<TABLE><tr><td> </td><td class=example><pre>tar xzf <TT>`vmailmgr-<VAR>VERSION</VAR>.tar.gz'</TT>
+cd <TT>`vmailmgr-<VAR>VERSION</VAR>'</TT>
+./configure
+make
+</pre></td></tr></table></P><P>
+
+Then, as user <SAMP>`root'</SAMP>:
+</P><P>
+
+<TABLE><tr><td> </td><td class=example><pre>make install
+</pre></td></tr></table></P><P>
-That should do it.
-<H2><A NAME="s3">3. Setup</A></H2>
+<HR SIZE="6">
+<A NAME="SEC14"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC13"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC15"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H1> 3. Setup </H1>
+<!--docid::SEC14::-->
+<P>
+
+In the following setup examples, it is assumed that your binaries are installed
+in the <TT>`/usr/bin]'</TT> directory, and configuration files are located in the
+<TT>`/etc/vmailmgr/'</TT> directory, as is the case if you installed from the RPMs.
+</P><P>
-<P>In the following setup examples, it is assumed that your binaries
-are installed in `<CODE>/usr/bin</CODE>`, and configuration is in
-`<CODE>/etc/vmailmgr</CODE>`, as is the case if you installed from the
-RPMs.
-If you installed from source, configure puts the binaries into
-`<CODE>/usr/local/bin</CODE>` and the configuration into
-`<CODE>/usr/local/etc/vmailmgr</CODE>` by default.
-<H2>3.1 Setting Up a Virtual Domain</H2>
+If you installed from source, configure instead puts the binaries into
+<TT>`/usr/local/bin/'</TT> and the configuration into
+<TT>`/usr/local/etc/vmailmgr/'</TT> by default.
+</P><P>
-<P>The following steps are necessary to set up a virtual domain with
+<HR SIZE="6">
+<A NAME="SEC15"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC14"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC16"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 3.1 Setting Up a Virtual Domain </H2>
+<!--docid::SEC15::-->
+<P>
+
+The following steps are necessary to set up a virtual domain with
vmailmgr (assuming vmailmgr has been compiled and installed). As an
-example, we'll set up a virtual user `<CODE>me@mydomain.org</CODE>`,
-with aliases of `<CODE>myself@mydomain.org</CODE>` and
-`<CODE>myname@mydomain.org</CODE>`.
+example, we'll set up a virtual user <SAMP>`me@mydomain.org'</SAMP>,
+with aliases of <SAMP>`myself@mydomain.org'</SAMP> and
+<SAMP>`myname@mydomain.org'</SAMP>.
+</P><P>
+
<OL>
-<LI>Set up a DNS entry for the domain. This is not covered here, as it
+<LI>
+Set up a DNS entry for the domain. This is not covered here, as it
is dependant on far too many other things. I will mention that to
-make IP based virtual domains work a PTR record which matches an
+make IP based virtual domains work a <SAMP>`PTR'</SAMP> record which matches an
entry in virtualdomains is nessesary, for example, if nslookup
-10.56.33.122 returns <CODE>mail.mydomain.com</CODE>,
-`<CODE>virtualdomains</CODE>` needs an entry like
-`<CODE>mail.mydomain.com:myuser</CODE>'
+10.56.33.122 returns <SAMP>`mail.mydomain.com'</SAMP>,
+<TT>`control/virtualdomains'</TT> needs an entry like
+<SAMP>`mail.mydomain.com:myuser'</SAMP>.
+<P>
+
For the example, we'll assume that the mail exchanger for
-mydomain.org is already set up to point to your computer.</LI>
-<LI>Set up a base user for the domain. Create a user, with a name of
+<SAMP>`mydomain.org'</SAMP> is already set up to point to your computer.
+</P><P>
+
+<LI>
+Set up a base user for the domain. Create a user, with a name of
your choosing. Since the maildirs for all the users in the
virtual domain will be stored under this user's home directory,
make sure you set the user up in a partition or disk that is
appropriate for such storage. The tools that you should use to
accomplish this step vary greatly between different systems. For
-our example, I'll add a user `<CODE>myuser</CODE>`.</LI>
-<LI>Configure qmail to recognize the domain. To do this, you need to
-modify two of qmail's configuration files in
-`<CODE>/var/qmail/control</CODE>` `<CODE>rcpthosts</CODE>` and
-`<CODE>virtualdomains</CODE>`.
-<UL>
-<LI>To `<CODE>rcpthosts</CODE>` :
-add the line `<CODE>mydomain.org</CODE>`. </LI>
-<LI>To `<CODE>virtualdomains</CODE>` :
-add the line `<CODE>mydomain.org:myuser</CODE>`.</LI>
-</UL>
+our example, I'll add a user <SAMP>`myuser'</SAMP>.
+<P>
-If you wish to have mail to `<CODE>anything.mydomain.org</CODE>`
-be delivered in the same way, add the following
+<LI>
+Configure qmail to recognize the domain. To do this, you need to
+modify two of qmail's configuration files in
+<TT>`/var/qmail/control'</TT>: <TT>`rcpthosts'</TT> and <TT>`virtualdomains'</TT>.
<UL>
-<LI>To `<CODE>rcpthosts</CODE>` :
-add the line `<CODE>.mydomain.org</CODE>`. </LI>
-<LI>To `<CODE>virtualdomains</CODE>` :
-add the line `<CODE>.mydomain.org:myuser</CODE>`.</LI>
+<LI>
+To <TT>`rcpthosts'</TT>, add the line <SAMP>`mydomain.org'</SAMP>.
+<LI>
+To <TT>`virtualdomains'</TT>, add the line <SAMP>`mydomain.org:myuser'</SAMP>.
</UL>
-</LI>
-<LI>Configure qmail-popup/qmail-pop3d to use `<CODE>checkvpw</CODE>` as
-the password checker. This step is dependant on how you have
-installed qmail.
+<P>
+
+If you wish to have mail to <SAMP>`anything.mydomain.org'</SAMP>
+be delivered in the same way:
+<UL>
+<LI>
+To <TT>`rcpthosts'</TT>, add the line <SAMP>`.mydomain.org'</SAMP>.
+<LI>
+To <TT>`virtualdomains'</TT>, add the line <SAMP>`.mydomain.org:myuser'</SAMP>.
+</UL>
+<P>
+
+<LI>
+Configure <CODE>qmail-popup</CODE>/<CODE>qmail-pop3d</CODE> to use <CODE>checkvpw</CODE> as the
+password checker. This step is dependant on how you have installed qmail.
<UL>
-<LI>Replace `<CODE>checkpassword</CODE>` in the command you use to
-invoke qmail-popup/qmail-pop3d (either in
-`<CODE>/etc/inet.conf</CODE>` or in a `<CODE>tcpserver</CODE>`
-command) with `<CODE>checkvpw</CODE>`.</LI>
-<LI>And/Or at the prompt type: `<CODE>echo checkvpw >
-/var/qmail/control/checkpassword</CODE>`</LI>
+<LI>
+Replace <CODE>checkpassword</CODE> in the command you use to
+invoke <CODE>qmail-popup</CODE>/<CODE>qmail-pop3d</CODE> (either in
+<TT>`/etc/inet.conf'</TT> or in a <CODE>tcpserver</CODE>
+command) with <CODE>checkvpw</CODE>.
+<LI>
+And/Or at the prompt type <SAMP>`echo checkvpw > <TT>`/var/qmail/control/checkpassword'</TT>'</SAMP>.
</UL>
-</LI>
-<LI>Set up the vmailmgr files:
+<P>
+
+<LI>
+Set up the vmailmgr files:
<UL>
-<LI>Either change user to the user you just created (for example,
-type `<CODE>su - myuser</CODE>`) or log in (with either telnet or
-at the console) as the new user.</LI>
-<LI>Set up the base vmailmgr files by running `<CODE>vsetup</CODE>`.</LI>
-<LI>Use the included programs to add users and aliases.
+<LI>
+Either change user to the user you just created (for example,
+type <SAMP>`su - myuser'</SAMP>) or log in (with either telnet or
+at the console) as the new user.
+<LI>
+Set up the base vmailmgr files by running <CODE>vsetup</CODE>.
+<LI>
+Use the included programs to add users and aliases.
For our example, we would type the following commands:
-<PRE>
- vadduser me
- vaddalias myself me
- vaddalias myname me
-</PRE>
-</LI>
+<P>
+
+<TABLE><tr><td> </td><td class=example><pre>vadduser me
+vaddalias myself me
+vaddalias myname me
+</pre></td></tr></table></P><P>
+
</UL>
-</LI>
+
</OL>
+<P>
After you have completed all these steps, you will need to kill and
-restart `<CODE>qmail-send</CODE>` to make it read the new
-`<CODE>virtualdomains</CODE>` table.
-<P>If you are using `<CODE>inetd</CODE>` to launch `<CODE>qmail-popup</CODE>`,
-`<CODE>kill -HUP</CODE>` the `<CODE>inetd</CODE>` process as well.
-<H2>3.2 Using one IP address for mutiple domains</H2>
+restart <CODE>qmail-send</CODE> to make it read the new
+<TT>`virtualdomains'</TT> control file.
+</P><P>
+
+If you are using <CODE>inetd</CODE> to launch <CODE>qmail-popup</CODE>,
+<SAMP>`kill -HUP'</SAMP> the <CODE>inetd</CODE> process as well.
+</P><P>
-<P>There are two ways to log in without using multiple IP addresses.
+<HR SIZE="6">
+<A NAME="SEC16"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC15"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC17"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 3.2 Using one IP address for mutiple domains </H2>
+<!--docid::SEC16::-->
<P>
+
+There are two ways to log in without using multiple IP addresses.
+</P><P>
+
<OL>
-<LI>The first way is to log in as
-`<CODE>userSEPvirtual.domain.org</CODE>`, where `<CODE>user</CODE>` is the
-mailbox name of the virtual user, SEP is one of `<CODE>@</CODE>` or
-`<CODE>:</CODE>` (by default, this is configurable in the
-`<CODE>/etc/vmailmgr/</CODE>' directory), and
-`<CODE>virtual.domain.org</CODE>' is the virtual domain's name, as
-listed in `<CODE>/var/qmail/control/virtualdomains</CODE>'.</LI>
-<LI>The second way is to use the internal form of the mailbox name --
-that is, `<CODE>baseuser-user</CODE>', where `<CODE>user</CODE>' is the
-same as above, and `<CODE>baseuser</CODE>' is the username of the
-managing user.</LI>
+<LI>
+The first way is to log in as
+<SAMP>`user<VAR>SEP</VAR>virtual.domain.org'</SAMP>, where <SAMP>`user'</SAMP> is the
+mailbox name of the virtual user, <VAR>SEP</VAR> is one of <SAMP>`@'</SAMP> or
+<SAMP>`:'</SAMP> (by default; this is configurable in the
+<TT>`/etc/vmailmgr/'</TT> directory), and
+<SAMP>`virtual.domain.org'</SAMP> is the virtual domain's name, as
+listed in <TT>`/var/qmail/control/virtualdomains'</TT>.
+<P>
+
+<LI>
+The second way is to use the internal form of the mailbox name --
+that is, <SAMP>`baseuser-user'</SAMP>, where <SAMP>`user'</SAMP> is the
+same as above, and <SAMP>`baseuser'</SAMP> is the username of the
+managing user.
+<P>
+
</OL>
+<P>
-Example: `<CODE>/var/qmail/control/virtualdomains</CODE>' contains
-<PRE>
- testdomain.org:testuser
-</PRE>
+For example, if <TT>`/var/qmail/control/virtualdomains'</TT> contains
+<SAMP>`mydomain.com:myuser'</SAMP> and user <SAMP>`myuser'</SAMP> exists and has
+set up a virtual mailbox with the name <SAMP>`me'</SAMP>, and the
+<TT>`separators'</TT> configuration file <TT>`/etc/vmailmgr/'</TT> contains <SAMP>`@'</SAMP>,
+this virtual user could log in as <SAMP>`me@mydomain.com'</SAMP>,
+<SAMP>`me:mydomain.com'</SAMP>, or <SAMP>`myuser-me'</SAMP>.
+</P><P>
-User `<CODE>myuser</CODE>' exists, and has set up a virtual mailbox with
-the name `<CODE>me</CODE>'. The `<CODE>separators</CODE>' variable in
-`<CODE>/etc/vmailmgr/</CODE>' contains `<CODE>@:</CODE>'. This virtual user
-could log in as `<CODE>me@mydomain.com</CODE>',
-`<CODE>me:mydomain.cm</CODE>', or `<CODE>myuser-me</CODE>'.
+<HR SIZE="6">
+<A NAME="SEC17"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC16"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC18"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 3.3 Catching all misdirected mail in a virtual domain </H2>
+<!--docid::SEC17::-->
<P>
-<P>
-<H2>3.3 Catching all misdirected mail in a virtual domain</H2>
-<P>In the `<CODE>vmailmgr/</CODE>' configuration directory, there is an
-entry called `<CODE>default-username</CODE>'. If mail to a virtual
+In the <CODE>vmailmgr</CODE> configuration directory, there is a
+file called <TT>`default-username'</TT>. If mail to a virtual
domain does not match any users or aliases in that domain, it is
delivered to the name listed in this configuration item if it exists
-(which defaults to `<CODE>+</CODE>'). To make this deliver to you,
-simply type:
-<PRE>
- vaddalias + me
-</PRE>
-<H2>3.4 VMailMgr IMAP support</H2>
+(which defaults to <SAMP>`+'</SAMP>). To make this deliver to you,
+simply type <SAMP>`vaddalias + me'</SAMP>.
+</P><P>
-<P>VMailMgr supports Courier-IMAP, but Courier-IMAP does not come with
+<HR SIZE="6">
+<A NAME="SEC18"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC17"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC19"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 3.4 VMailMgr IMAP support </H2>
+<!--docid::SEC18::-->
+<P>
+
+VMailMgr supports Courier-IMAP, but Courier-IMAP does not come with
an authentication module for VMailMgr. This means that some minor
work is required for making the two work together.
+</P><P>
+
+The steps are:
+</P><P>
+
<UL>
-<LI>You must copy `<CODE>/usr/bin/authvmailmgr</CODE>` to
-`<CODE>/usr/lib/courier-imap/libexec/authlib/authvmailmgr</CODE>`.</LI>
-<LI>Then modify the `<CODE>AUTHMODULES</CODE>` statement in
-`<CODE>/usr/lib/courier-imap/etc/imapd.config</CODE>` and add
-`<CODE>authvmailmgr</CODE>` as the first authentication module.</LI>
+<LI>
+Copy <TT>`/usr/bin/authvmailmgr'</TT> to
+<TT>`/usr/lib/courier-imap/libexec/authlib/authvmailmgr'</TT>.
+<P>
+
+<LI>
+Modify the <CODE>AUTHMODULES</CODE> statement in
+<TT>`/usr/lib/courier-imap/etc/imapd.config'</TT> and add
+<SAMP>`authvmailmgr'</SAMP> as the first authentication module.
</UL>
-<H2>3.5 Enabling enforcement of virtual user quotas</H2>
+<P>
-<P>VMailMgr supports per-virtual-user quotas, but not out of the box,
+<HR SIZE="6">
+<A NAME="SEC19"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC18"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC20"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 3.5 Enabling enforcement of virtual user quotas </H2>
+<!--docid::SEC19::-->
+<P>
+
+VMailMgr supports per-virtual-user quotas, but not out of the box,
as it is not needed by the majority of users, and requires an extra
program to be run on each delivery.
+</P><P>
+
To configure quota support, create the file
-`<CODE>/etc/vmailmgr/vdeliver-predeliver</CODE>`, containing
+<TT>`/etc/vmailmgr/vdeliver-predeliver'</TT>, containing
the following:
-<PRE>
- #!/bin/sh
- /usr/bin/vcheckquota
-</PRE>
+</P><P>
+
+<TABLE><tr><td> </td><td class=example><pre>#!/bin/sh
+/usr/bin/vcheckquota
+</pre></td></tr></table></P><P>
This is executed as a shell script, so you will need to make it
-executable by running the following command:
-<PRE>
- chmod +x /etc/vmailmgr/vdeliver-predeliver
-</PRE>
-<H2>3.6 Enabling processing of autoresponses</H2>
+executable by running the command <SAMP>`chmod +x /etc/vmailmgr/vdeliver-predeliver'</SAMP>.
+</P><P>
-<P>Download and install the qmail-autoresponder package, found at
-<A HREF="http://em.ca/~bruceg/qmail-autoresponder/">http://em.ca/~bruceg/qmail-autoresponder/</A>.
+<HR SIZE="6">
+<A NAME="SEC20"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC19"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC21"> > </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 3.6 Enabling processing of autoresponses </H2>
+<!--docid::SEC20::-->
+<P>
+
+Download and install the qmail-autoresponder package, found at
+<A HREF="http://untroubled.org/qmail-autoresponder/">http://untroubled.org/qmail-autoresponder/</A>.
+</P><P>
+
As with the above section, create a shell script
-`<CODE>/etc/vmailmgr/vdeliver-postdeliver</CODE>`, containing the
-following:
-<PRE>
- #!/bin/sh
- if test -s $MAILDIR/autoresponse/message.txt
- then
- qmail-autoresponder $MAILDIR/autoresponse/message.txt $MAILDIR/autoresponse
- fi
-</PRE>
-<H2>3.7 Web-based interfaces for vmailmgr</H2>
+<TT>`/etc/vmailmgr/vdeliver-postdeliver'</TT>, containing the following:
+</P><P>
+
+<TABLE><tr><td> </td><td class=example><pre>#!/bin/sh
+if test -s $MAILDIR/autoresponse/message.txt ; then
+ qmail-autoresponder $MAILDIR/autoresponse/message.txt $MAILDIR/autoresponse
+fi
+</pre></td></tr></table></P><P>
-<P>There are currently a few working solutions to administrate
+<HR SIZE="6">
+<A NAME="SEC21"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC20"> < </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ > ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 3.7 Web-based interfaces for vmailmgr </H2>
+<!--docid::SEC21::-->
+<P>
+
+There are currently a few working solutions to administrate
your vmailmgr system via a web interface. Only requirement is
that the vmailmgrd daemon is running, and that you have
a webserver on your system.
-<OL>
-<LI>For Python fans, there is vpyadmin by Bruce Guenter. The files can
-be downloaded at
-<A HREF="http://em.ca/~bruceg/vpyadmin/">http://em.ca/~bruceg/vpyadmin/</A>, and
+</P><P>
+
+<UL>
+<LI>
+For Python fans, there is vpyadmin by Bruce Guenter. The files can
+be downloaded at <A HREF="http://untroubled.org/vpyadmin/">http://untroubled.org/vpyadmin/</A>, and
the development code is online at
<A HREF="http://bruce-guenter.dyndns.org/cgi-bin/vpyadmin/">http://bruce-guenter.dyndns.org/cgi-bin/vpyadmin/</A>
-(sample.org / samplevm).</LI>
-<LI>And if you like PHP, you can use oMail-admin by Olivier Müller:
+(sample.org / samplevm).
+<P>
+
+<LI>
+And if you like PHP, you can use oMail-admin by Olivier Müller:
it fully supports all vmailmgr functions, and speaks englich,
french, italian, spanish, german and russian. Project homepage:
<A HREF="http://omail.omnis.ch">http://omail.omnis.ch</A>. Online demo:
-<A HREF="http://admin.omnis.ch/omail/">http://admin.omnis.ch/omail/</A> (test.com / test).</LI>
-<LI>And there are also C-based CGI scripts in the <CODE>cgi</CODE>
-directory of the vmailmgr distribution.</LI>
-</OL>
+<A HREF="http://admin.omnis.ch/omail/">http://admin.omnis.ch/omail/</A> (test.com / test).
+<P>
+
+<LI>
+And there are also C-based CGI scripts in the <TT>`cgi'</TT>
+subdirectory of the vmailmgr distribution.
+<P>
+
+</UL>
+<P>
+
+<HR SIZE="6">
+<A NAME="SEC_Contents"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H1>Table of Contents</H1>
+<UL>
+<A NAME="TOC1" HREF="HOWTO.html#SEC1">1. Introduction</A>
+<BR>
+<UL>
+<A NAME="TOC2" HREF="HOWTO.html#SEC2">1.1 What is VMailMgr and why should I use it?</A>
+<BR>
+<A NAME="TOC3" HREF="HOWTO.html#SEC3">1.2 New versions</A>
+<BR>
+<A NAME="TOC4" HREF="HOWTO.html#SEC4">1.3 Comments</A>
+<BR>
+<A NAME="TOC5" HREF="HOWTO.html#SEC5">1.4 History</A>
+<BR>
+<A NAME="TOC6" HREF="HOWTO.html#SEC6">1.5 Copyrights and Trademarks</A>
+<BR>
+<A NAME="TOC7" HREF="HOWTO.html#SEC7">1.6 Acknowledgements and Thanks</A>
+<BR>
+</UL>
+<A NAME="TOC8" HREF="HOWTO.html#SEC8">2. Installation</A>
+<BR>
+<UL>
+<A NAME="TOC9" HREF="HOWTO.html#SEC9">2.1 Get the files</A>
+<BR>
+<A NAME="TOC10" HREF="HOWTO.html#SEC10">2.2 Install with RPMS</A>
+<BR>
+<UL>
+<A NAME="TOC11" HREF="HOWTO.html#SEC11">2.2.1 Compiling the Source RPM (SRPM) Package</A>
+<BR>
+<A NAME="TOC12" HREF="HOWTO.html#SEC12">2.2.2 Installing the Binary RPM packages</A>
+<BR>
+</UL>
+<A NAME="TOC13" HREF="HOWTO.html#SEC13">2.3 Install from source</A>
+<BR>
+</UL>
+<A NAME="TOC14" HREF="HOWTO.html#SEC14">3. Setup</A>
+<BR>
+<UL>
+<A NAME="TOC15" HREF="HOWTO.html#SEC15">3.1 Setting Up a Virtual Domain</A>
+<BR>
+<A NAME="TOC16" HREF="HOWTO.html#SEC16">3.2 Using one IP address for mutiple domains</A>
+<BR>
+<A NAME="TOC17" HREF="HOWTO.html#SEC17">3.3 Catching all misdirected mail in a virtual domain</A>
+<BR>
+<A NAME="TOC18" HREF="HOWTO.html#SEC18">3.4 VMailMgr IMAP support</A>
+<BR>
+<A NAME="TOC19" HREF="HOWTO.html#SEC19">3.5 Enabling enforcement of virtual user quotas</A>
+<BR>
+<A NAME="TOC20" HREF="HOWTO.html#SEC20">3.6 Enabling processing of autoresponses</A>
+<BR>
+<A NAME="TOC21" HREF="HOWTO.html#SEC21">3.7 Web-based interfaces for vmailmgr</A>
+<BR>
+</UL>
+</UL>
+<HR SIZE=1>
+<A NAME="SEC_OVERVIEW"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H1>Short Table of Contents</H1>
+<BLOCKQUOTE>
+<A NAME="TOC1" HREF="HOWTO.html#SEC1">1. Introduction</A>
+<BR>
+<A NAME="TOC8" HREF="HOWTO.html#SEC8">2. Installation</A>
+<BR>
+<A NAME="TOC14" HREF="HOWTO.html#SEC14">3. Setup</A>
+<BR>
+
+</BLOCKQUOTE>
+<HR SIZE=1>
+<A NAME="SEC_About"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H1>About this document</H1>
+This document was generated by <I>Bruce.Guenter.dyndns.org</I> on <I>December, 29 2004</I>
+using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
+"><I>texi2html</I></A>
+<P></P>
+The buttons in the navigation panels have the following meaning:
+<P></P>
+<table border = "1">
+<TR>
+<TH> Button </TH>
+<TH> Name </TH>
+<TH> Go to </TH>
+<TH> From 1.2.3 go to</TH>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [ < ] </TD>
+<TD ALIGN="CENTER">
+Back
+</TD>
+<TD>
+previous section in reading order
+</TD>
+<TD>
+1.2.2
+</TD>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [ > ] </TD>
+<TD ALIGN="CENTER">
+Forward
+</TD>
+<TD>
+next section in reading order
+</TD>
+<TD>
+1.2.4
+</TD>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [ << ] </TD>
+<TD ALIGN="CENTER">
+FastBack
+</TD>
+<TD>
+previous or up-and-previous section
+</TD>
+<TD>
+1.1
+</TD>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [ Up ] </TD>
+<TD ALIGN="CENTER">
+Up
+</TD>
+<TD>
+up section
+</TD>
+<TD>
+1.2
+</TD>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [ >> ] </TD>
+<TD ALIGN="CENTER">
+FastForward
+</TD>
+<TD>
+next or up-and-next section
+</TD>
+<TD>
+1.3
+</TD>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [Top] </TD>
+<TD ALIGN="CENTER">
+Top
+</TD>
+<TD>
+cover (top) of document
+</TD>
+<TD>
+
+</TD>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [Contents] </TD>
+<TD ALIGN="CENTER">
+Contents
+</TD>
+<TD>
+table of contents
+</TD>
+<TD>
+
+</TD>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [Index] </TD>
+<TD ALIGN="CENTER">
+Index
+</TD>
+<TD>
+concept index
+</TD>
+<TD>
+
+</TD>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [ ? ] </TD>
+<TD ALIGN="CENTER">
+About
+</TD>
+<TD>
+this page
+</TD>
+<TD>
+
+</TD>
+</TR>
+</TABLE>
+<P></P>
+where the <STRONG> Example </STRONG> assumes that the current position
+is at <STRONG> Subsubsection One-Two-Three </STRONG> of a document of
+the following structure:
+<UL>
+<LI> 1. Section One </LI>
+<UL>
+<LI>1.1 Subsection One-One</LI>
+<UL>
+<LI> ... </LI>
+</UL>
+<LI>1.2 Subsection One-Two</LI>
+<UL>
+<LI>1.2.1 Subsubsection One-Two-One
+</LI><LI>1.2.2 Subsubsection One-Two-Two
+</LI><LI>1.2.3 Subsubsection One-Two-Three <STRONG>
+<== Current Position </STRONG>
+</LI><LI>1.2.4 Subsubsection One-Two-Four
+</LI></UL>
+<LI>1.3 Subsection One-Three</LI>
+<UL>
+<LI> ... </LI>
+</UL>
+<LI>1.4 Subsection One-Four</LI>
+</UL>
+</UL>
+
+<HR SIZE=1>
+<BR>
+<FONT SIZE="-1">
+This document was generated
+by <I>Bruce.Guenter.dyndns.org</I> on <I>December, 29 2004</I>
+using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
+"><I>texi2html</I></A>
+
</BODY>
</HTML>