Mercurial > masqmail
diff docs/masqmail.aliases.5 @ 34:8ea86ac25658
reformating of man page sources
with some typographic improvements
author | meillo@marmaro.de |
---|---|
date | Fri, 07 May 2010 13:50:23 +0200 |
parents | 607221b0dac1 |
children | 8071dc6c6ed1 |
line wrap: on
line diff
--- a/docs/masqmail.aliases.5 Thu May 06 13:31:57 2010 +0200 +++ b/docs/masqmail.aliases.5 Fri May 07 13:50:23 2010 +0200 @@ -1,42 +1,54 @@ -.TH masqmail.aliases 5 User Manuals +.TH masqmail.aliases 5 2010-05-07 masqmail-0.2.21 "File Formats" + .SH NAME masqmail.aliases \- masqmail alias file format + + .SH DESCRIPTION -This man page describes the format of the masqmail alias file. Its usual location is \fI/etc/aliases\f1. +This man page describes the format of the masqmail alias file. +Its usual location is \fI/etc/aliases\fR. + .SH FILE FORMAT The alias file consists of lines of the form: local_part: item1, item2, ... -Items can be surrounded by quotes '"'. If within the quotes other quotes are needed for an address they can be escaped with a leading backslash '\'. +Items can be surrounded by double quotes `"'. +If within the quotes other quotes are needed for an address they can be +escaped with a leading backslash `\\'. -A leading '\' indicates that this address shall not be further expanded. +A leading backslash `\\' indicates that this address shall not be further expanded. -A leading pipe symbol '|' indicates that the item shall be treated as a pipe command. The content of the message will then be sent to the standard input of a command. The command will run under the user id and group id masqmail is running as. If quotes are needed, the pipe symbol must appear within the quotes. +A leading pipe symbol `|' indicates that the item shall be treated as a pipe command. +The content of the message will then be sent to the standard input of a command. +The command will run under the user id and group id masqmail is running as. +If quotes are needed, the pipe symbol must appear within the quotes. Loops will be detected, the offending address will be ignored. -Aliases will be expanded at delivery time. This means that if there is a message still in the queue and you change any alias which matches one of the recipient addresses, the change will have effect next time a delivery is attemped. +Aliases will be expanded at delivery time. +This means that if there is a message still in the queue and you change +any alias which matches one of the recipient addresses, +the change will have effect next time a delivery is attemped. There is no need to restart masqmail or run any command when the alias file has been changed. + .SH AUTHOR -masqmail was written by Oliver Kurth. It is now maintained by Markus Schnalke <meillo@marmaro.de>. +Masqmail was written by Oliver Kurth. +It is now maintained by Markus Schnalke <meillo@marmaro.de>. -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\f1. +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. There is also a mailing list, you will find information about it at masqmail's main site. + .SH BUGS -You should report them to the mailing list. +Please report bugs to the mailing list. + .SH SEE ALSO -\fBmasqmail.conf (5)\f1, \fBmasqmail (8)\f1, - -.SH COMMENTS - -This man page was written using \fBxml2man (1)\f1 by the same author. - +\fBmasqmail.conf(5)\fR, \fBmasqmail(8)\fR,