.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "HOLIDAY" "1" "24 May 2003" "Gordon Messmer" ""

.SH NAME
holiday \- Reply to mail automatically
.SH SYNOPSIS

\fBholiday\fR [ \fB\fI-I login\fB\fR ]


\fBholiday\fR [ \fB\fI-j\fB\fR ] [ \fB\fI-a alias\fB\fR ] [ \fB\fI-h hostname\fB\fR ] [ \fB\fI-t days\fB\fR ] [ \fB\fI-r\fB\fR ] \fB\fIlogin\fB\fR

.SH "DESCRIPTION"
.PP
\fBholiday\fR automatically replies to incoming
mail.  The reply is contained in the file
\fI.vacation.msg\fR in your home directory.  The
\fBholiday\fR program, run interactively, will create
and edit a \fI.vacation.msg\fR file in your home
directory.
.PP
For example, the message created by \fBholiday\fR
is:

.nf
\fBSubject: away from my mail

I will not be reading my mail for a while. Your mail regarding
"$SUBJECT" will be read when I return.\fR
.fi
.PP
The \fI.vacation.msg\fR file should include a
header with at least a `\fBSubject:\fR' line (it should
not contain a `\fBTo:\fR' line and need not contain a
`\fBFrom:\fR' line, since these are generated
automatically).
.PP
The fields `\fBFrom:\fR' and
`\fBReply-To:\fR' are evaluated in the following order:
If there is a `\fBReply-To:\fR', and the option
\fB-r\fR is given, then its entry is accepted.  Otherwise,
the entry of the `\fBFrom:\fR' field is taken.  If no
valid address is found, the \fBholiday\fR program will
not send a reply.  After determining the senders address, the user and
domain parts will be compared to the
`\fBno_reply_to_users\fR', and
`\fBno_reply_to_domains\fR' settings, respectively.  If
a match is found, \fBholiday\fR will not send a
reply.
.PP
If the string \fB$SUBJECT\fR appears in the
\fI.vacation.msg\fR file, it is replaced with the
subject of the original message when the reply is sent.
.PP
No message is sent if the `\fBTo:\fR'or the
`\fBCc:\fR' line does not list the user to whom the
original message was sent or one of a number of aliases for them.
Also, no message will be sent if a `\fBPrecedence:
bulk\fR' or `\fBPrecedence: junk\fR' or
`\fBPrecedence: list\fR' line is included in the
header.
.SH "OPTIONS"
.TP
\fB-I\fR
Initialize the \fI.vacation.db\fR file
and edit \fI.vacation.msg\fR.
.PP
If the \fB-I\fR flag is not specified, and a
\fBuser\fR argument is given,
\fBholiday\fR begins processing a message read from
standard input to which it will reply.
.TP
\fB-a\fI "alias"\fB\fR
Indicate that \fBalias\fR is one of the
valid aliases for the user running
\fBholiday\fR, so that mail addressed to that
alias generates a reply.
.TP
\fB-h\fI "hostname"\fB\fR
Use \fBhostname\fR as the hostname in
the `\fBFrom:\fR' header in the reply
sent.
.TP
\fB-j\fR
Do not check whether the recipient appears in the
`\fBTo:\fR' or the `\fBCc:\fR'
line. Reply always.
.TP
\fB-t\fIN\fB\fR
Change the interval between repeat replies to the same
sender.  \fBN\fR is the number of days
between replies. Default is one week.
.TP
\fB-r\fR
If there is a `\fBReply-To:\fR' header,
send the automatic reply to the address given there.
Otherwise, use the `\fBFrom:\fR'
entry.
.TP
\fB-?\fR
issue short usage line.
.SH "USAGE"
.PP
If \fBholiday\fR is run with no arguments, or
with the \fB-I\fR argument, it will create a new
\fI.vacation.msg\fR file for you, using the editor
specified by the \fBVISUAL\fR or \fBEDITOR\fR
environment variable, or
\fBvi\fR(1)
if neither of those environment variables are set.
.PP
Afterward, \fBholiday\fR will output delivery
instructions in the form:

.nf
\fB|/usr/bin/holiday username\fR
.fi
.PP
You must set up delivery instructions which include this
command.  On systems running Sendmail, you might create a
\fI.forward\fR file in your home directory
containing:

.nf
\fB\\username, "|/usr/bin/holiday username"\fR
.fi
.PP
On systems running Courier, you might create a \fI.courier\fR file in your home directory
containing:

.nf
\fB./Maildir/
|/usr/bin/holiday username\fR
.fi
.PP
where \fBusername\fR is your login
name.
.PP
To stop \fBholiday\fR, remove the
\fI.forward\fR file, or move it to a new name.
.SH "FILES"
.TP
\fB$HOME/.vacation.msg\fR
The message that will be sent back in reply to mail that you receive.
.TP
\fB$HOME/.vacation.db\fR
The list of addresses to which the holiday program has replied.
.SH "SEE ALSO"
.PP
\fBvi\fR(1)
\fBsendmail\fR(8)
.SH "AUTHOR"
.PP
holiday is copyleft 2003 by Gordon Messmer.