\begindata{text,538234116}
\textdsversion{12}
\template{help}
\chapter{Zmail: Watches for new mail in your mailbox

}
\chapter{\center{_______________________________________}}

\smaller{
\chapter{\center{/USR/CONTRIBUTED CAVEAT}}


The software and documentation in /usr/contributed are supported by users on 
campus rather than by the central support organizations.  That is, they are 
*not* supported by Academic Computing or the ITC.  Questions or comments about 
the contents of /usr/contributed should be send to the support person for the 
particular application, library, or information file.  The support person is 
cited in the Support Person field at the end of the documentation for the 
particular topic.

\chapter{\center{_______________________________________}}

}

\section{What zmail is

}\leftindent{
Zmail is a small, simple application which notifies you via zephyr when you 
receive mail.

}
\section{Starting zmail

}\leftindent{
When zmail starts, it automatically forks and begins looking for new mail in 
your mailbox. By default, zmail checks your mailbox every forty seconds. This 
can be changed by using the -st (sleep time) option. For example, "zmail -st 
60" causes zmail to check your mailbox every sixty seconds. Zmail does not 
require you to run any other mail programs, however, to receive the 
zephyrgrams it sends you \italic{must} run zwgc (see the man pages on zephyr, 
zstart and zwgc for more information). If you run zmail with the "-nofork" 
command-line switch, it will not automatically fork on startup.

}
\section{Warnings

}\leftindent{
Zmail only counts mail at the interval you specify. If you set the delay to a 
very long time, you will not receive notice of new mail promptly. On the other 
hand, setting the delay to a very short time places a greater load on the 
workstation.

}

\section{Customizing your .zwgc.desc for zmail

}\leftindent{
Zmail always sends zephyrgrams to you with instance zmail. A typical handler 
for zmail zephyrgrams in your .zwgc.desc file would look like this:


\programexample{if (upcase($instance) == "ZMAIL") then

	fields signature body

	print "Zmail:\\n\\n"

	print $body

	print "\\n"

	put

	exit

endif


}}\leftindent{This should appear before your default instance handler (placing 
this at the top of the file will accomplish this). For more details on 
.zwgc.desc files, consult the \italic{zwgc} and \italic{zephyr} help files.

}
\section{Program Author}

\leftindent{
jz1j+@andrew.cmu.edu}


\section{Related tools}  


Select (highlight) one of the italicized names and choose "Show Help on 
Selected Word" from the pop-up menu to see the help file for:


\leftindent{\italic{xbiff

zstart

zwgc

zephyr

}}
\chapter{\center{_______________________________________}}

\smaller{
\chapter{\center{/USR/CONTRIBUTED CAVEAT}}


The software and documentation in /usr/contributed are supported by users on 
campus rather than by the central support organizations.  That is, they are 
*not* supported by Academic Computing or the ITC.  Questions or comments about 
the contents of /usr/contributed should be send to the support person for the 
particular application, library, or information file.  The support person is 
cited in the Support Person field at the end of the documentation for the 
particular topic.

\chapter{\center{_______________________________________}}

}\enddata{text,538234116}
