1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/docs/xml/masqmail.aliases.5.xml	Fri Sep 26 17:05:23 2008 +0200
     1.3 @@ -0,0 +1,63 @@
     1.4 +<?xml version="1.0" standalone='no'?>
     1.5 +<!DOCTYPE spec SYSTEM "man.dtd">
     1.6 +
     1.7 +<manpage name="masqmail.aliases" section="5" desc="masqmail alias file format">
     1.8 +
     1.9 +<description>
    1.10 +<p>This man page describes the format of the masqmail alias file. Its usual location is <file>/etc/aliases</file>.</p>
    1.11 +</description>
    1.12 +
    1.13 +<section name="File Format">
    1.14 +<p>The alias file consists of lines of the form:</p>
    1.15 +<pre>
    1.16 +local_part: item1, item2, ...
    1.17 +</pre>
    1.18 +
    1.19 +<p>Items can be surrounded by quotes '"'. If within the quotes other
    1.20 +quotes are needed for an address they can be escaped with a leading
    1.21 +backslash '\'.</p>
    1.22 +
    1.23 +<p>A leading '\' indicates that this address shall not be further
    1.24 +expanded.</p>
    1.25 +
    1.26 +<p>A leading pipe symbol '|' indicates that the item shall be treated
    1.27 +as a pipe command. The content of the message will then be sent to the
    1.28 +standard input of a command. The command will run under the user id
    1.29 +and group id masqmail is running as. If quotes are needed, the pipe
    1.30 +symbol must appear <i>within</i> the quotes.</p>
    1.31 +
    1.32 +<p>Loops will be detected, the offending address will be ignored.</p>
    1.33 +
    1.34 +<p>Aliases will be expanded at <i>delivery</i> time. This means that
    1.35 +if there is a message still in the queue and you change any alias
    1.36 +which matches one of the recipient addresses, the change will have
    1.37 +effect next time a delivery is attemped.</p>
    1.38 +
    1.39 +<p>There is no need to restart masqmail or run any command when the
    1.40 +alias file has been changed.</p>
    1.41 +</section>
    1.42 +
    1.43 +<section name = "Author">
    1.44 +<p>masqmail was written by Oliver Kurth
    1.45 +&lt;oku@masqmail.cx&gt;</p><p>You will find the newest version of
    1.46 +masqmail at <url href="http://masqmail.cx/masqmail/"/> or search for it
    1.47 +in freshmeat (<url href="http://www.freshmeat.net"/>). There is also a mailing list,
    1.48 +you will find information about it at masqmails main site.</p>
    1.49 +</section>
    1.50 +
    1.51 +<section name = "Bugs">
    1.52 +<p>You should report them to the mailing list.</p>
    1.53 +</section>
    1.54 +
    1.55 +<section name = "See also">
    1.56 +<p>
    1.57 +<manref name="masqmail.conf" section="5" href="masqmail.conf.5.html"/>, <manref name="masqmail" section="8" href="masqmail.8.html"/>, 
    1.58 +</p>
    1.59 +</section>
    1.60 +
    1.61 +<section name = "Comments">
    1.62 +<p>This man page was written using <manref name="xml2man" section="1"
    1.63 + href="http://masqmail.cx/xml2man/"/> by the same author.</p>
    1.64 +</section>
    1.65 +
    1.66 +</manpage>