syd@dsinc.UUCP (Syd Weinstein) (12/12/88)
---- Cut Here and unpack ----
#!/bin/sh
# this is part 5 of a multipart archive
# do not concatenate these parts, unpack them in order with /bin/sh
# file doc/Users.guide continued
#
CurArch=5
if test ! -r s2_seq_.tmp
then echo "Please unpack part 1 first!"
exit 1; fi
( read Scheck
if test "$Scheck" != $CurArch
then echo "Please unpack part $Scheck next!"
exit 1;
else exit 0; fi
) < s2_seq_.tmp || exit 1
echo "x - Continuing file doc/Users.guide"
sed 's/^X//' << 'SHAR_EOF' >> doc/Users.guide
X.sp 2
XAs you can see, it's quite easy to use the \fBElm\fR system, so
Xrather than continue with our example, let's
Xlook at some other aspects of the program.
X.sp 2
X.H 1 "Non-Interactive Uses of Elm"
X.P 1
XBefore we go ahead and discuss the \fBElm\fR utilities, it's worth
Xnoting that
Xthere are a couple of other ways to use the main mail
Xsystem, namely to 'send only' and to send files (batchmail).
X.P
XTo send a message to someone without any of the associated
Xoverhead of the main system being loaded, you can invoke the
Xmailer with the name(s) of the people to send to. The
Xmailer will then prompt for Subject, Copies, and then drop
Xyou in your editor (defined in the \fI.elmrc\fR file) to compose
Xthe message. When composition is complete, the program
Xverifies transmission then terminates. For example;
X.nf
X $ \fBelm dave_taylor\fR
X To: taylor@hplabs.HP.COM (Dave Taylor)
X Subject: \fBthis is a test\fR
X Copies To: \fB<return>\fR
X \fI...invokes editor, message composed, then...\fR
X Your options now are:
X S)end the message, E)dit it again, change/add H)eaders or F)orget it
X What is your choice? \fBS\fRend
X mail sent!
X $
X.fi
XNote that the user input is in \fBbold\fR face, so you can see that
Xthe mailer verified the alias expansion too!
X.sp
X.P
XThe mailer also supports batch type mailing, of files and so on,
Xby using the following command;
X.nf
X $ \fBelm dave_taylor < help.c\fR
X.fi
Xwhich will read in the file and transmit it to the specified user.
XA subject may be specified with ``-s \fIsubject\fR'' as an option
Xto the program, as in;
X.nf
X $ \fBelm -s "File help.c, as promised" dave_taylor < help.c\fR
X.fi
X.sp
X.H 1 "The Elm Utilities"
X.sp
X.P
XThe \fBElm\fR mail system is really much more than a single
Xprogram for reading and writing mail. It's a unified
Xenvironment for intelligently dealing with electronic
Xcorrespondence. As a consequence, it contains a number of other
Xprograms to aid in the easy processing of `email',
Xincluding the following;
X.VL 14 2
X.LI "answer"
XAn answering-machine transcription program. Please see the
X`man'ual entry for more information on how to use this program.
X.LI "autoreply"
XThis program, in conjunction with the ``arepdaemon'', enables users
Xto automatically reply to incoming mail when they're not directly
Xavailable...
X.LI "checkalias"
XA script for checking aliases simply.
X.LI "messages"
XA script that lists the number of messages in the specified
Xmailbox. Suitable for login scripts and such.
X.LI "newmail"
XThis program monitors a mailbox or set of mailboxes and can
Xoutput notification of new mail in one of two possible
Xformats; either:
X.DS
X.ft CW
X.ps 9
X>> New mail from Jimmy Carter - Urgent matters of state
X>> New mail from joe@ucbvax.arpa - Did I hear someone say PARTY??
X.ft R
X.ps 10
X.DE
Xif running as \fInewmail\fR or:
X.DS
X.ft CW
X.ps 9
XJimmy Carter -- Urgent matters of state
Xjoe@ucbvax.arpa -- Did I hear someone say PARTY??
X.ft R
X.ps 10
X.DE
Xif running as \fIwnewmail\fR. BSD Users will find this is
Xa far superior \fIbiff\fR program.
X.LI "wnewmail"
XThis is the same program as newmail, but has different
Xdefaults if invoked this way.
X.LI "readmsg"
XThis handy little program can be used in two ways...first off,
Xit can be used to easily read a specific message in the
Xincoming mailbox, specified by ordinal number, by a string that
Xthe message contains, by the metacharacter `$' which
Xrepresents the last message in the mailbox, or `*' which matches
Xall the messages in the folder or mailbox.
X.P 0
XFor example;
X.DS
X$ \fBreadmsg 4 5 9 | lpr\fR
X.DE
Xwould generate a printout, \fIsans\fR superfluous headers, of the fourth,
Xfifth and ninth messages in your mailbox.
X.DS
X$ \fBreadmsg Carter | page\fR
X.DE
Xwould be a fast way to read what `ole Jimmy has to say...
Xand
X.DS
X$ \fBreadmsg -h hear someone say\fR
X.DE
Xwould list, including all the message headers, the message
Xcontaining the string ``hear someone say''.
X.LI "from"
XSimilar to the Berkeley \fIfrom\fR command, this will
Xgive you a ``table of contents'' of either the current
Xmailbox or a mailbox of your choice. It's useful to
Xsee what mail is pending, or what's in a mailbox.
XIf used with the `-n' option, it will number each message
Xin a way compatible with the arguments \fIreadmsg\fR
Xexpects to get, too!
X.LI "newalias"
XThis is used to install new user/group aliases. Please see
X\fIThe Elm Alias Users Guide\fR for further information on this!
X.LI "fastmail"
XSometimes you want to have a batchmailing system that works as
Xquickly as possible, not bothering with aliases or any of the
Xother ``deluxe'' features of \fBElm\fR. An example of this would
Xbe if you have a large mailing list for a newsletter, say.
XThis command, \fIfastmail\fR, is designed just for that purpose.
XIt avoids the lengthy startup time of \fBElm\fR while still
Xgenerating valid \fIRFC-822\fR\*F mail.
X.FS
XIf you don't know what RFC-822 is, don't worry about it!
X.FE
XPlease see the `man' entry for more information on this
Xcommand (use \fBman fastmail\fR after installation).
X.LE
X.sp 2
X.H 1 "Credits and So on"
X.P
XThis mailer has been evolving over the past few years with
Xinvaluable comments on the interface and general mail
Xissues from the following people;
XJim Davis, Steve Wolf (or should that say Steve!! Wolf!!!! perhaps?),
XLarry Fenske, Rob Sartin,
XJohn Dilley and Carl Dierschow.
X.sp
XFor the Berkeley implementation, lots of help came from
Xboth John Lebovitz and Ken Stone.
X.sp
XFor the Amdahl/UTS implementation, thanks to Scott McGregor and
XStan Isaacs.
X.sp
XFor the Sun problems, Dave England in Lancaster (UK) turned out to be
X``bloody useful'', as he would no doubt say.
X.sp
XThe Pyramid version is due to the work of Steve Malone
Xof the University of Washington.
X.sp
XA number of other people have been amazingly disciplined at reporting
Xproblems and (usually, much to my relief) indicating the fixes needed,
Xespecially Guy Hillyer, Bruce Townsend and Eric Negaard.
X.sp
XThere have been many, many others, too numerous to mention, that
Xhave inspired me with questions like "Why can't Elm..." or
X"Why does it ..." or "Can we make it..." too. A loud round of
Xapplause and an enthusiastic THANK YOU to you all!!
X.sp
XAlso helpful was the ability to have my `own' machine to
Xclose up the many many iterative loops that this software
Xhas gone through \(em since being on a big multi-user machine
Xtends to slow it down to a standstill...
XFor that, I thank Hewlett-Packard Colorado Networks Division for their
Xinitial support, and now HP Laboratories for the wonderful working
Xenvironment that I have here (more than any one person is safe having,
XI suspect).
X.sp
XMailers that have influenced the design and implementation of \fBElm\fR,
Xfor better or worse, include the following;
X.VL 12 1
X.LI "\fI/bin/mail\fR "
XThe most basic of mailers, this one was simply the example of how \fInot\fR
Xto force the user to interact with a program.
X.LI "\fIBerkeley Mail\fR "
XA suprisingly sophisticated mailer, especially the version with 4.3 BSD,
X\fIBerkeley Mail\fR still suffers from the tendency to force the user to
Xknow too much about the system, and also lacks a friendly, non-cryptic
Xinterface for the large subset of the population that use Unix but aren't
Xinterested in becoming a ``hacker''.
X.LI "\fIMH\fR "
XThis is another nifty mailer. The main difference between this and the
Xother mailers about is that it is a discrete set of programs rather than
Xa single unified interface. This is quite useful for those people that
Xreceive \fIlots\fR of mail and are willing to spend some time learning
Xthe intricacies of the program. It's quite powerful, but again, misses some
Xof the basic friendly features the majority of users are interested in.
X.LI "\fIdmail\fR "
XA sort of mutated cross between \fIMH\fR and \fIBerkeley Mail\fR, it was
Xthis program that convinced me to implement the \fILimit\fR functions.
X.LI "\fINMail\fR "
X(a part of the HP AI Workstation Software Environment). This program hints
Xat the power that mailers could be given to help deal with mail in a quick
Xand intelligent fashion. Most of what it can do, and a lot more, are
Xtherefore part of \fBElm\fR. Indubitably. And quite faster too!
X.LI "\fIPMX/TERM\fR "
XPart of the AT&T Mail package, a single glance at this interface convinced
Xme that a PC interface, with almost half of the screen taken up by a silly
Xfunction key mapping, is most certainly \fInot\fR the way to do things!!
XOn the other hand, it also shows that the \fIForms\fR mode can be quite
Xnicely integrated into a more sophisticated mailer.
X.LI "\fIfmail\fR "
XA nickel addition to the \fI/bin/mail\fR program to add some rudimentary
Xscreen interface stuff, this nonetheless interesting mailer is part of
Xthe AT&T Toolchest.
X.LI "\fILaurel\fR "
XA program only available within Xerox PARC, this was an interesting
Xearly attempt at a graphics based full-screen mail program. The one,
Xperhaps trivial, part of the interface I really like was the fact that
Xit would \fIcross out\fR a message that was marked for deletion. One
Xday when we get real graphics and the ability to use them indicated in
Xa facility (not too) like \fItermcap\fR, perhaps \fBElm\fR will do
Xthis too!
X.LI "\fIMailtool\fR "
XPart of the Sun distribution package, this program is a really nice
Xexample of what can be done by putting a smart shell on top of a dumb
Xprogram \(em it uses \fI/bin/mail\fR for all the `dirty work'. Other than
Xthat, it's not a particularly interesting interface or mailer, and it
Xcertainly doesn't add much functionality!
X.LI "\fIMetamail\fR "
XWhat can I say? This isn't even a real mailer, but is just what I dream
Xof as an interface to mail in the future. A program that works sort of
Xlike \fBHAL\fR did in \fI2001: A Space Odyssey\fR \(em where it interrupts
Xme as appropriate for important mail, and can answer inane and other
Xqueries itself according to what I teach it. Maybe \fBElm\fR, by some sort
Xof groupmind metamorphosis, will change into that someday. Maybe not. Maybe
Xno-one bothers to read this far into the document!!
X.LE
X.sp
XFinally, it's also been a very useful experience overall,
Xconfirming my beliefs that iterative software design and
Xkeeping a close watch on users (not to mention an open
Xmind and mailbox!) improves a product manyfold. Comments,
Xfeedback and bug reports (and fixes!) are, of course, always welcome!
SHAR_EOF
echo "File doc/Users.guide is complete"
chmod 0444 doc/Users.guide || echo "restore of doc/Users.guide fails"
echo "x - extracting doc/answer.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/answer.1 &&
X.TH ANSWER 1L
X.ad b
X.SH NAME
Xanswer - phone message transcription system
X.SH SYNOPSIS
X.B answer
X.PP
X.SH HP-UX COMPATIBILITY
X.TP 10
XLevel:
XHP-UX/CONTRIBUTED
X.TP
XOrigin:
XHewlett-Packard
X.SH DESCRIPTION
X.I Answer\^
Xis a part of the
X.B Elm
Xmail system and is designed for secretaries and the like
Xto allow them to answer phones and|or listen to phone message
Xmachines and quickly and easily transcribe the messages into
Xelectronic mail.
X.P
XThe program uses it's own alias set (usually a subset of the
Xsystem aliases, with more fields per user (ie unique first
Xnames, unique last names, first-initial lastname, and so on)).
XNote this means that you must create and then install, using
X.I newalias,
Xa separate alias table for the account this program is to
Xbe run from.
X.P
XInterface-wise, the program is a breeze to use - type 'answer'
Xto start it up and then merely type a user name at the
X.nf
X
X Message to:
X
X.fi
Xprompt, and then enter the message, ending with a blank line.
XNames can be entered as 'Firstname Lastname' and the system
Xwill try to find a mail alias based on the first letter of the
Xfirst name plus the last name. For example, 'Dave Taylor'
Xwill cause the program to search for an alias 'd_taylor' in
Xthe file (note the transliteration into lower case). The
Xprogram will loop until killed or quit.
X.P
X.I Answer
Xcan be easily exited by typing any of 'quit', 'exit' 'done',
Xor 'bye' at the 'Message to:' prompt.
X.SH AUTHOR
XDave Taylor, Hewlett-Packard Laboratories
X.SH SEE ALSO
X.I "The Elm Alias System Users Guide",
Xby Dave Taylor
X.sp
X.br
Xnewalias(1L), checkalias(1L), mail(1), mailx(1), from(1L), printmail(1L)
X.SH FILES
X$home/.alias_hash individual alias hash table
X.br
X$home/.alias_data individual alias data table
X.br
X/tmp/snd.$$ edit buffer for outgoing mail
X.SH BUG REPORTS TO
XSyd Weinstein syd@dsinc.UUCP (dsinc!syd)
SHAR_EOF
chmod 0444 doc/answer.1 || echo "restore of doc/answer.1 fails"
echo "x - extracting doc/autoreply.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/autoreply.1 &&
X.TH AUTOREPLY 1L
X.ad b
X.SH NAME
Xautoreply - Automatic mail reply system
X.SH SYNOPSIS
X.B autoreply
X.br
X.B "autoreply off"
X.br
X.B autoreply
X.I filename
X.PP
X.SH HP-UX COMPATIBILITY
X.TP 10
XSystems:
XAT&T System V and Berkeley BSD
X.TP
XOrigin:
XHewlett-Packard
X.SH DESCRIPTION
X.I Autoreply\^
Xis a part of \fBThe Elm Mail System\fR
Xand is designed to enable users to easily set up
Xan automatic response to all mail they receive. This is
Xtypically during a vacation or some other period of time that
Xthe user is not available to reply to mail (although some
Xpeople get enough mail that they have it permanently running
Xto simply send an "ack" to each message)
X.PP
XThe system is quite easy to use...
XYou can type "autoreply" and be informed of your current
Xstatus in the system (on or off), or "autoreply off" will
Xturn your autoreplying off.
X.PP
XTo add yourself to the system, you need merely to compose a
Xform response in a file somewhere, then type "autoreply \fIfile\fR"
Xwhere \fIfile\fR is the name of the file.
X.SH "SPECIAL NOTE"
XFor this to function correctly, the program "arepdaemon" must
Xbe running as a daemon in background. This program automatically
Xchecks all the currently enrolled users for new mail in their
Xmailboxes...
X.SH AUTHOR
XDave Taylor, Hewlett-Packard Laboratories.
X.SH SEE ALSO
X.I "The Elm Users Guide",
Xby Dave Taylor
X.sp
X.br
Xarepdaemon(1L), elm(1L), mail(1), mailx(1)
X.SH "BUGS"
XUnfortunately, this program isn't too brilliant about identifying
Xmail that shouldn't be responded to (like mail from other
Xdaemons, or your mother) but that's a more general problem anyway.
X.sp
XAlso, occasionally a user will remove themselves from the
Xautoreply system and the system won't turn their autoreply
Xoff. This is a problem that hasn't been solved yet (obviously
Xsince it's in the "bugs" section!!) and any further information
Xwould be appreciated!
X.SH BUG REPORTS TO
XSyd Weinstein syd@dsinc.UUCP (dsinc!syd)
SHAR_EOF
chmod 0444 doc/autoreply.1 || echo "restore of doc/autoreply.1 fails"
echo "x - extracting doc/chkalias.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/chkalias.1 &&
X.TH CHECKALIAS 1L
X.ad b
X.SH NAME
Xcheckalias - check to see if an alias is defined.
X.SH SYNOPSIS
X.B checkalias
Xalias, alias, ...
X.SH HP-UX COMPATIBILITY
X.TP 10
XLevel:
XHP-UX/CONTRIBUTED
X.TP
XOrigin:
XHewlett-Packard
X.SH DESCRIPTION
X.I Checkalias
Xchecks the user file first, and then the system alias file
Xto try to find the specified alias or aliases. If found,
Xthe value of the alias is printed out, otherwise an error
Xis generated.
X.P
XNote: this is in fact a one-line shell script;
X.nf
X
X elm -c $*
X.fi
X.SH AUTHOR
XDave Taylor, Hewlett-Packard Laboratories
X.SH SEE\ ALSO
Xnewalias(1L), elm(1L), mail(1), mailx(1)
X.SH BUGS
XNote that the precedence of aliases is user file then system
Xfile. This means that a user can 'overload' an alias by having
Xone defined in the system file also defined in theirs. This
Xshouldn't turn out to be a problem, but is something for
Xthe system administrator to keep in mind when creating the
Xsystem alias file.
X.SH BUG REPORTS TO
XSyd Weinstein syd@dsinc.UUCP (dsinc!syd)
SHAR_EOF
chmod 0444 doc/chkalias.1 || echo "restore of doc/chkalias.1 fails"
echo "x - extracting doc/elm-help.0 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/elm-help.0 &&
X
X Command Action
X
X | Pipe current message to ...
X ! Shell escape
X $ Resynchronize mailbox (force it)
X ? This screen of information
X +, <SPACE> Next page of headers
X - Previous page of headers
X = Set current message to 1
X * Set current message to last message
X <n> Set current message to n
X / Search from/subjects for pattern
X // Search entire message bodies for pattern
X > Save current message or tagged to file
X < Scan current message for calendar entries
X
X a Alias, change to 'alias' mode
X b Bounce (remail) current message
X c Change current mail file
X d Delete current message
X ^D Delete messages with specified patter
X e Edit the current mailbox
X f Forward message to specified user
X g Group (all recipients) reply to message
X h Headers displayed with message
X j Increment current message by one
X k Decrement current message by one
X l Limit messages by specified criteria
X m Mail to arbitrary user(s)
X n Next message (Read current, then increment)
X o Change Elm options
X p print current message
X q Quit - mail deleted, saved in mbox or left.
X r Reply to current message
X s Save message to specified file
X t Tag a message for further operations
X ^T Tag messages with specified pattern
X u Undelete current message
X x Exit - don't record as read, don't save...
X
X ^L Rewrite screen.
X <RETURN> Read current message
X ^Q, DEL Exit - don't record as read, don't save...
SHAR_EOF
chmod 0444 doc/elm-help.0 || echo "restore of doc/elm-help.0 fails"
echo "x - extracting doc/elm-help.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/elm-help.1 &&
X
X Commands available from the Options Menu
X
XChar Meaning
X---- -------
X c Change `calendar' file to the file specified. See '<' at top level
X menu for more information on this.
X
X d Display pager. `builtin' will use the built-in pager, or you
X can put anything else you'd like, including "/bin/more"
X
X e Editor to use when composing messages
X
X f Folder directory. This is what '=', '+', or '%' expands to.
X
X s Sorting criteria. Step through with space, <return> selects.
X
X o Outbound mail file. Where to save copies of outbound mail.
X
X p How to print messages. '%s' can be used as a filename holder
X
X y Your fullname for outbound mail.
X
X a arrow cursor. Changes from "->" to inverse bar and back
X
X m display mini-menus or not. Expert users usually don't.
SHAR_EOF
chmod 0444 doc/elm-help.1 || echo "restore of doc/elm-help.1 fails"
echo "x - extracting doc/elm-help.2 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/elm-help.2 &&
X
X Commands available from the Alias Menu
X
XChar Meaning
X---- -------
X
X ? help on a specific key, or this summary of commands.
X
X a Add return address of current message to alias database
X
X m Make new user alias, adding to alias database when done
X
X r,x return from the alias menu
X
X p check for a person in the alias database
X
X s check for a system in the host routing/domain database
X
SHAR_EOF
chmod 0444 doc/elm-help.2 || echo "restore of doc/elm-help.2 fails"
echo "x - extracting doc/elm.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/elm.1 &&
X.TH ELM 1L
X.ad b
X.SH NAME
Xelm - an interactive mail system
X.SH SYNOPSIS
X.B elm
X[
X.B \-achkKmrwz
X] [
X.B \-f
X.I "alternate-mailbox"
X] [
X.B \-d
X.I debug-level
X]
X.br
X.B elm
X[
X.B \-s
X.I subject
X]
X.I "list of aliases or addresses"
X.PP
X.SH HP-UX COMPATIBILITY
X.TP 10
XLevel:
XHP-UX/CONTRIBUTED
X.TP
XOrigin:
XHewlett-Packard
X.SH DESCRIPTION
X.I Elm\^
Xis a new interactive mailer program that supercedes
X.I mail
Xand
X.I mailx.
X.PP
XThere are three main ways to use the \fBelm\fR mailer;
Xone way to use the mailer is to specify a list of addresses on the
Xcommand line when the mailer is invoked. This will allow sending
Xof a single message to the specified recipients with all the
Xoptions usually available in the \fBelm\fR system itself.
X.PP
XThe second way, used most commonly when transmitting files and such,
Xis to specify the subject of the message and the recipients using
Xthe command line and redirect a file as standard input. For example,
Xthe command
X.nf
X
X elm -s testing joe < test.c
X
X.fi
Xwould mail a copy of the
Xfile test.c to alias joe, with the subject "testing" indicated.
X.PP
XOtherwise, the starting options are;
X.TP 1.0i
X.B " -a"
XArrow - force the arrow cursor (instead of the inverse bar)
X.TP
X.B " -c"
XCheckalias - expand the following aliases and return.
X.TP
X.B " -d \fIlevel\fR "
XDebug - set specified debug level - Output to "$HOME/Elm:debug.info"
X.TP
X.B " -f \fIalternative-mailbox\fR "
XFile - read file (specified) rather than the incoming mailbox.
X.TP
X.B " -h"
XHelp - give a list of starting options.
X.TP
X.B " -?"
XSynonymous with the "-h" option.
X.TP
X.B " -k"
XKeypad - force knowledge of HP terminal keyboard, to allow
Xthe use of the NEXT, PREV and HOME/SHIFT-HOME keys.
X.TP
X.B " -K"
XKeypad + softkeys - enable use of softkeys on HP terminals only.
X.TP
X.B " -m"
XMenu off - Use the extra lines for more message headers.
X.TP
X.B " -s \fIsubj\fR "
XSubject - specify subject for message to mail.
X.TP
X.B " -z"
XZero - don't enter \fBElm\fR if no mail is pending.
X.SH AUTHOR
XDave Taylor, Hewlett-Packard Laboratories
X.SH SEE ALSO
XThe Elm documentation package, including:
X.I
XThe Elm Users Guide,
XThe Elm Reference Guide,
XThe Elm Alias SystemUsers Guide,
XThe Elm Forms Mode Guide,
XThe Elm Filter Guide,
XThe Elm Configuration Guide\fR
Xall written by by Dave Taylor.
X.sp
X.br
Xnewalias(1L), checkalias(1L), mail(1), mailx(1), from(1L), printmail(1L)
X.SH FILES
X/usr/local/bin/elm-help.main help file
X.br
X/usr/mail/.alias_hash system alias hash table
X.br
X/usr/mail/.alias_data system alias data table
X.br
X$HOME/.elm/aliases.hash user alias hash table
X.br
X$HOME/.elm/aliases.data user alias data table
X.br
X/tmp/snd.$$ outgoing mail edit buffer
X.br
X/tmp/mbox.\fIlognamefR temporary mailbox
X.br
X$HOME/ELM:debug.info Debug output if turned on
X.SH DIAGNOSTICS
XShould know about keyboards/softkey terminals other than HP. (If only
Xtermcap were that powerful!)
X.SH BUG REPORTS TO
XSyd Weinstein syd@dsinc.UUCP (dsinc!syd)
SHAR_EOF
chmod 0444 doc/elm.1 || echo "restore of doc/elm.1 fails"
echo "x - extracting doc/elmrc-info (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/elmrc-info &&
X#@(#)$Id: elmrc-info,v 2.1 88/09/15 22:06:08 syd Exp $
X
Xshell
X# The shell to use for shell escapes
X
Xfullname
X# The full user name for outbound mail
X
Xmaildir
X# where to save my mail to, default directory
X
Xmailbox
X# where to save messages to, default file
X
Xeditor
X# what editor to use (none = simulate Berkeley Mail)
X
Xsavemail
X# where to save mail if not specified somewhere else
X
Xcalendar
X# where to save calendar entries
X
Xsortby
X# and how to sort mailboxes, by default
X
Xprint
X# how to print a message ('%s' is the filename)
X
Xprefix
X# prefix sequence for including message text in other messages...
X
Xweedout
X# what headers I DON'T want to see, ever.
X
Xbounceback
X# threshold for bouncing copies of remote uucp messages...
X# zero = disable function.
X
Xtimeout
X# Set the main prompt timeout for resynching...
X
Xautocopy
X# automatically copy message being replied to into buffer?
X
Xcopy
X# save a copy of all outbound messages?
X
Xresolve
X# emulate the mailx message increment mode (only increment after something
X# has been 'done' to a message, either saved or deleted, as opposed to
X# simply each time something is touched)
X
Xweed
X# enable the weedout list to be read...
X
Xnoheader
X# when messages are copied into the outbound buffer, don't include headers
X
Xtitles
X# display message title when displaying pages of message
X
Xeditout
X# edit the headers as the message leaves the machine (sort of)
X
Xsavename
X# save messages, incoming and outbound, by login name of sender/recipient
X
Xmovepage
X# when using the page commands (+ - <NEXT> <PREV>) change the current
X# message pointer...
X
Xpointnew
X# start up by pointing to the first new message received, if possible
X
Xsignature
X# ".signature" files to append to outbound messages...
X
Xlocalsignature
X# local ".signature" files to append to appropriate messages...
X
Xremotesignature
X# remote ".signature" files to append to appropriate messages...
X
Xalwaysleave
X# should we always leave messages as pending (change the default answer to yes)
X
Xalwaysdelete
X# should we always delete messages we've marked for deletion (change the
X# default answer to yes)
X
Xpager
X# program to use for displaying messages ('builtin' is recommended)
X
Xkeypad
X# we're running on an HP terminal and want HOME, PREV, NEXT, etc...
X
Xsoftkeys
X# we're running on an HP terminal and want softkeys available too!
X# (this implies "keypad=ON" too)
X
Xalternatives
X# alternative addresses that I could receive mail from (usually a
X# forwarding mailbox) and don't want to have listed...
X
Xforms
X# we might mail out AT&T Mail Forms
X
Xwarnings
X# tell us about addresses to machines we can't directly get to?
X
Xuserlevel
X# are we good at it? 0=beginner, 1=intermediate, 2+ = expert!
X
Xnames
X# let's just show the names, though, when expanding aliases...
X
Xarrow
X# should we use the "->" rather than the inverse video bar?
X
Xmenu
X# should we display the three-line 'mini' menu?
X
Xask
X# Should the questions as we leave be displayed or auto-answered?
X
Xaskcc
X# Would you like to be asked for Carbon-Copies information each msg?
X
SHAR_EOF
chmod 0444 doc/elmrc-info || echo "restore of doc/elmrc-info fails"
echo "x - extracting doc/elmrc.samp (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/elmrc.samp &&
X#@(#)$Id: elmrc.samp,v 2.1 88/09/15 22:06:21 syd Exp $
X#
X# .msgrc - automatic variable defines for the 'msg' mailer.
X#
X# Personalized for ??
X#
X
X# where to save my mail to, default directory
Xmaildir = ~/Mail
X
X# where to save messages to, default file
Xmailbox = ~/Mail/mailbox
X
X# what editor to use
Xeditor = $EDITOR
X
X# where to save mail if not specified somewhere else
Xsavemail = ~/Mail/mail.sent
X
X# how to print a message ('%s' is the filename)
Xprint = /usr/local/bin/print -p lpn -f %s
X
X# prefix sequence for including message text in other messages...
Xprefix = >
X
X# what headers I DON'T want to see, ever.
X
Xweedout = "Via:" "Sent:" "Date:" "Status:" "Original"
X "From" "Phase" "Subject:" "Fruit" "Sun"
X "Lat" "Buzzword" "Return" "Posted" "Telephone"
X "Postal-Address" "Origin" "X-Sent-By-Nmail-V"
X "Resent" "X-Location" "Source" "Mood" "Neuron"
X "Libido" "To:" "X-Mailer:" "Full-Name:" "X-HPMAIL"
X "Cc:" "cc:" "Mmdf" "Network-"
X
X# automatically copy message being replied to into buffer?
Xautocopy = OFF
X
X# save a copy of all outbound messages?
Xcopy = ON
X
X# emulate the mailx message increment mode (only increment after something
X# has been 'done' to a message, either saved or deleted)
Xresolve = ON
X
X# enable the weedout list to be read...
Xweed = ON
X
X# when messages are copied into the outbound buffer, don't include headers
Xnoheader = ON
X
X# display message title when displaying pages of message
Xtitles = ON
X
X# alternative addresses that I could receive mail from (usually a
X# forwarding mailbox)
X
X# alternatives =
SHAR_EOF
chmod 0444 doc/elmrc.samp || echo "restore of doc/elmrc.samp fails"
echo "x - extracting doc/fastmail.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/fastmail.1 &&
X.TH FASTMAIL 1L
X.ad b
X.SH NAME
Xfastmail - quick batch mail interface to a single address
X.SH SYNOPSIS
X.B fastmail
X[-b bcc-list] [-c cc-list] [-d] [-f fromname] [-r replyto]
X[-s subject] filename address-list
X.br
X.SH HP-UX COMPATIBILITY
X.TP 10
XLevel:
XHP-UX/CONTRIBUTED
X.TP
XOrigin:
XHewlett-Packard
X.SH DESCRIPTION
X.I Fastmail
Xis a low-level interface to the mail system that allows batch
Xprocessing of mail. It's intended for mailing to very large
Xgroups of people in a staggered fashion.
X.PP
XThe starting options are;
X.TP 1.0i
X.B "-b bcc-list"
XThis allows a list of people to receive blind-carbon copies, or BCCs, of
Xthe message. This list should be full email addresses.
X.TP
X.B "-c cc-list"
XThis allows a list of people to receive carbon copies, or CCs, of
Xthe message. This list should be full email addresses.
X.TP
X.B "-d"
XDebug. This is helpful for strange, unfriendly errors from
Xthe program (etc).
X.TP
X.B "-f from"
XThis overrides the users name in the From: line, so that if
Xthe user was x@y, and their name was MrX then the default
XFrom: line would be "From: x@y (MrX)". Using "-f Joe" when
Xinvoking this, though, would change it to "From: x@y (Joe)"
X.TP
X.B "-r replyto"
XOccasionally, you might send mail but want the replies to go
Xto a different address (very common with mailing lists).
XThere is a header for this purpose called "Reply-To:" which
Xcan be utilized by using this starting option. For example,
Xwe could send mail with a reply-to to list-request by
Xusing "-r list-request". The header generated would then
Xbe of the form "Reply-To: list-request".
X.TP
X.B "-s subject"
XThe subject of the message is specified by using
Xthis starting option.
X.SH EXAMPLE
XLet's say we're user "big" on machine "big-vax" and we have a
Xshell script called 'batch-mail' that contains the following
Xlines:
X.nf
X
X #
X # Batch Mail - batch mailing of a file to a LOT of users
X #
X # Usage: batch-mail "from" "subject" filename
X
X sender_copy = $LOGIN
X replto = "The-Mr-Big-list"
X
X fastmail -b $sender_copy -r $replyto -f "$1" -s "$2" $3 person1
X sleep 10
X fastmail -r $replyto -f "$1" -s "$2" $3 person2
X sleep 10
X fastmail -r $replyto -f "$1" -s "$2" $3 person3
X sleep 10
X fastmail -r $replyto -f "$1" -s "$2" $3 person4
X
X < etc >
X
Xwith the invocation:
X
X batch-mail "Mr. Big" "Warning to all" warning.text
X
X.fi
Xwould mail a copy of the 'warning.text' file to person1, person2,
Xperson3, etc. "$LOGIN" will also receive a copy of the first message
Xin the mail, \fIsilently\fR. Each resultant message will include the headers:
X.nf
X
X From: big-vax!big (Mr. Big)
X Subject: Warning to all
X Reply-To: The-Mr-Big-list
X
X.fi
XThis program should turn out to be considerably
Xfaster than the alternative methods of accomplishing this task.
X.SH FILES
X/usr/lib/sendmail sendmail transport if available
X.br
X/bin/rmail transport if no sendmail
X.br
X/tmp/fastmail.$$ temporary file
X.SH AUTHOR
XDave Taylor, Hewlett-Packard Laboratories
X.SH SEE\ ALSO
Xsendmail(1), rmail(1), elm(1L)
X.SH BUG REPORTS TO
XSyd Weinstein syd@dsinc.UUCP (dsinc!syd)
SHAR_EOF
chmod 0444 doc/fastmail.1 || echo "restore of doc/fastmail.1 fails"
echo "x - extracting doc/filter.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/filter.1 &&
X.TH FILTER 1L
X.ad b
X.SH NAME
Xfilter - filter incoming messages before adding to mailbox
X.SH SYNOPSIS
X.B filter
X[-v] [-o output]
X.br
X.B filter
X[-n]
X.br
X.B filter
X[-r] [-o output]
X.br
X.B filter
X[-c] [-s] [-o output]
X.br
X.B filter
X[-c] [-S] [-o output]
X.SH HP-UX COMPATIBILITY
X.TP 10
XLevel:
XHP-UX/CONTRIBUTED
X.TP
XOrigin:
XHewlett-Packard Laboratories
X.SH DESCRIPTION
X.I Filter
Xis a sophisticated program that allows incoming mail to be
Xfiltered against a wide set of criteria. The format for the
Xrules, located in $HOME/.filter_rules, is;
X.nf
X
X \fIrule\fR ::= \fBif (\fIexpression\fP) then \fIaction\fR
X
X.fi
Xwhere \fIexpression\fR is:
X.nf
X
X \fIexpression\fR ::= { \fBnot\fR } \fIcondition\fR \fIexpr2\fR
X
X \fIexpr2\fR ::= \fINULL\fR | \fBand\fI condition expr2
X
X \fIcondition\fR ::= \fIfield relationship value\fR
X ::= \fBlines\fI relop numvalue\fR
Xor ::= \fBalways\fR
X
X.fi
XThese further break down as:
X.nf
X
X \fIfield\fR ::= \fBfrom\fR | \fBsubject\fR | \fBto\fR | \fBlines\fR
X
X \fIrelationship\fR ::= \fB=\fR | \fB!=\fR
X
X \fIrelop\fR ::= \fB=\fR | \fB!=\fR | \fB<\fR | \fB>\fR | \fB<=\fR | \fB>=\fR
X
X \fIvalue\fR ::= \fIany quoted string\fR
X
X \fInumvalue\fR ::= \fIany integer value\fR
X
X.fi
X\fIAction\fR can be any of:
X.nf
X
X \fBdelete\fR
X \fBsave \fIfoldername\fR
X \fBsavecopy \fIfoldername\fR
X \fBexecute \fIcommand\fR
X \fBforward \fIaddress\fR
X \fBleave\fR
X
X.fi
XFor further information about the rules language, please see
X\fIThe Elm Filter Guide\fR.
X.sp
XThe flags the \fIfilter\fR program understands are;
X.TP 1.0i
X.B "-c"
XClear logs. If this flag is used, the log files will be removed after
Xbeing summarized by either "-s" or "-S" (see below).
X.TP
X.B "-n"
XNot really. Output what would happen if given message from standard
Xinput, but don't actually do anything with it.
X.TP
X\fB-o \fIfile\fR
XRedirect all log messages to the specified file or device. (This is
Xadded to more gracefully deal with changes in the file system (since
Xsendmail is quite picky about modes of files being redirected into.))
X.TP
X.B "-r"
XRules. List the rules currently being used.
X.TP
X.B "-s"
XSummarize. List a summary of the message filtered log.
X.TP
X.B "-S"
XThis is the same as `-s' but includes message-by-message
Xinformation additionally.
X.TP
X.B "-v"
XVerbose. Give output on standard out for each message filtered. Useful
Xto have redirected to ``/dev/console'' and such. (see \fB-a\fR too).
X.SH AUTHOR
XDave Taylor, Hewlett-Packard Laboratories.
X.SH FILES
X$HOME/.filter-rules The ruleset for the users filter
X.br
X$HOME/.filterlog A log of what has been done
X.br
X$HOME/.filtersum A summary of what has been done
X.br
X/etc/passwd Used to get users home directory
X.SH SEE\ ALSO
X\fIThe Elm Filter Guide\fR, by Dave Taylor.
X.br
Xreadmsg(1L), elm(1L), mail(1), mailx(1), sendmail(1,8)
X.SH COMMENTS
XNot real smart about pattern matching.
X.SH BUG REPORTS TO
XSyd Weinstein syd@dsinc.UUCP (dsinc!syd)
SHAR_EOF
chmod 0444 doc/filter.1 || echo "restore of doc/filter.1 fails"
echo "x - extracting doc/frm.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/frm.1 &&
X.TH FRM 1L
X.ad b
X.SH NAME
Xfrm - list from and subject of all messages in mailbox or file
X.SH SYNOPSIS
X.B frm
X[-n]
X[ filename ]
X.br
X.B frm
X[-n]
X[ username ]
X.SH HP-UX COMPATIBILITY
X.TP 10
XLevel:
XHP-UX/CONTRIBUTED
X.TP
XOrigin:
XHewlett-Packard
X.SH DESCRIPTION
X.I Frm
Xoutputs a line per message in the current users mailbox
Xof the form;
X.PP
X<from> [subject]
X.PP
XIf a filename is specified, the program reads that file
Xrather than the default file. If the argument is a
X\fIusername\fR then look for that users mailbox.
X.PP
XFurthermore, if the \fI-n\fR flag is specified, the headers
Xwill be numbered using the same numbering scheme that, for
Xexample, \fIreadmsg\fR will understand.
X.PP
XFilename can be specified with the same notation as
Xwhen invoking the \fBElm\fR mailer.
X.SH AUTHOR
XDave Taylor, Hewlett-Packard Laboratories.
X.SH SEE\ ALSO
Xreadmsg(1L), elm(1L), mail(1), mailx(1)
X.SH BUG REPORTS TO
XSyd Weinstein syd@dsinc.UUCP (dsinc!syd)
SHAR_EOF
chmod 0444 doc/frm.1 || echo "restore of doc/frm.1 fails"
echo "x - extracting doc/listalias.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/listalias.1 &&
X.TH LISTALIAS 1L
X.ad b
X.SH NAME
Xlistalias - list user and system aliases
X.SH SYNOPSIS
X.B listalias
X[ regular-expression ]
X.SH HP-UX COMPATIBILITY
X.TP 10
XLevel:
XHP-UX/CONTRIBUTED
X.TP
XOrigin:
XHewlett-Packard Laboratories
X.SH DESCRIPTION
X.I Listalias
Xoutputs a line per alias in both the user and the system
Xaliases. Each line is of the form;
X.nf
X
X <alias> <address> (<comment>)
X
X.fi
XIf an optional regular expression is used, just the aliases
Xthat match the specified expression are listed. If not,
Xthey are all listed.
X.sp
XEither way, the output is sorted.
X.SH AUTHOR
XDave Taylor, Hewlett-Packard Laboratories.
X.SH SEE\ ALSO
Xnewalias(1L), elm(1L), checkalias(1L)
X.SH BUGS
XSince the program uses a pipe to egrep, how expressions are evaluated is
Xa function of \fIthat\fR program, not this one!
X.SH BUG REPORTS TO
XSyd Weinstein syd@dsinc.UUCP (dsinc!syd)
SHAR_EOF
chmod 0444 doc/listalias.1 || echo "restore of doc/listalias.1 fails"
echo "x - extracting doc/messages.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/messages.1 &&
X.TH MESSAGES 1L
X.ad b
X.SH NAME
Xmessages - quick count of messages in mailbox or folder
X.SH SYNOPSIS
X.B messages
X.br
X.B messages
Xfolder-name
X.SH HP-UX COMPATIBILITY
X.TP 10
XLevel:
XHP-UX/CONTRIBUTED
X.TP
XOrigin:
XHewlett-Packard
X.SH DESCRIPTION
X.I Messages
Xcounts the occurances of "^From\ " in either the current incoming
Xmailbox or the specified folder.
X.P
XThis is, in fact, a simple little shell script!!
X.SH AUTHOR
XDave Taylor, Hewlett-Packard Laboratories
X.SH SEE\ ALSO
Xfrom(1L), elm(1L)
X.SH BUGS
XDon't be foolish...
X.SH BUG REPORTS TO
XSyd Weinstein syd@dsinc.UUCP (dsinc!syd)
SHAR_EOF
chmod 0444 doc/messages.1 || echo "restore of doc/messages.1 fails"
echo "x - extracting doc/newalias.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/newalias.1 &&
X.TH NEWALIAS 1L
X.ad b
X.SH NAME
Xnewalias - install new elm aliases for user and/or system
X.SH SYNOPSIS
X.B newalias
X[-q]
X.SH HP-UX COMPATIBILITY
X.TP 10
XLevel:
XHP-UX/CONTRIBUTED
X.TP
XOrigin:
XHewlett-Packard
X.SH DESCRIPTION
X.I Newalias
Xcreates new hash and data files from a text file. If the
Xprogram is invoked by any account other than the superuser
Xaccount, the program looks for a file
Xcalled \fI$HOME/.elm/aliases.text\fR
Xand, upon finding it, creates files \fI$HOME/.elm/aliases.hash\fR and
X\fI$HOME/.elm/aliases.data\fR for the
X.I elm
Xprogram.
X.PP
XIf the superuser invokes the program, they are given the
Xoption of either updating their personal alias files or
Xthe system alias files.
XThe question can be supressed, with the default being
Xthe user files for the superuser, if the ``-q'' flag is
Xpresent upon invokation.
X.PP
XThe format that the program expects is;
X.sp
X.nf
X alias, alias, .. : comment : address
Xor
X alias, alias, .. : comment : alias, alias, ...
X
XThe first form is for an individual user such as;
X
X dave, taylor : Dave Taylor : veeger!hpcnou!dat
X
Xand the second is for defining a group alias such as;
X
X gurus : Unix Gurus : alan, john, dave, mike, richard,
X larry, t_richardson
X
X.fi
X.sp
XNote that lines can be continued at will, blank lines are accepted
Xwithout error, and that any line starting with '#' is considered a
Xcomment and is not processed.
X.PP
XFinally, aliases can contain other aliases, and/or groups;
X.sp
X.nf
X unix : Unix people : gurus, taylor, jonboy
X.fi
X' onto the next page, if you please
X.sp 3
X.SH FILES
X$HOME/.elm/aliases.text alias source for user
X.br
X$HOME/.elm/aliases.hash alias hash table for user
X.br
X$HOME/.elm/aliases.data alias data file for user
X.br
X/usr/mail/.alias_text alias source for system
X.br
X/usr/mail/.alias_hash alias hash table for system
X.br
X/usr/mail/.alias_data alias data file for system
X.SH AUTHOR
XDave Taylor, Hewlett-Packard Laboratories.
X.SH SEE\ ALSO
Xelm(1L), checkalias(1L), mail(1), mailx(1)
X.SH DIAGNOSTICS
XNewalias has a couple of descriptive error messages which
Xdon't need to be detailed here. It is, however, worth
Xnoting that the
X.I checkalias
Xprogram can be used to ensure that the aliases are in the
Xproper order and are available for the
X.I elm
Xsystem.
X.SH BUG REPORTS TO
XSyd Weinstein syd@dsinc.UUCP (dsinc!syd)
SHAR_EOF
chmod 0444 doc/newalias.1 || echo "restore of doc/newalias.1 fails"
echo "x - extracting doc/newmail.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/newmail.1 &&
X.TH NEWMAIL 1L
X.ad b
X.SH NAME
Xnewmail,wnewmail - programs to asynchronously notify of new mail
X.SH SYNOPSIS
X.B newmail
X.B [-d]
X.B [-i \fIinterval\fB]
X.B [-w]
X\fIfile-spec\fR {\fIfile-spec\fR...}
X.br
X.B wnewmail
X.B [-d]
X.B [-i \fIinterval\fB]
X.B [-w]
X\fIfile-spec\fR {\fIfile-spec\fR...}
X.PP
X.SH HP-UX COMPATIBILITY
X.TP 10
XLevel:
XHP-UX/CONTRIBUTED
X.TP
XOrigin:
XHewlett-Packard
X.SH DESCRIPTION
X.I Newmail\^
Xis a program to allow monitoring of mailboxes in an intelligent
Xfashion. It is based loosely on \fIbiff(1)\fR and the version
Xof \fInewmail\fR that was distributed with \fBElm 1.7\fR.
X.P
XThe basic operation is that the program will check the list of
Xspecified mailboxes each \fIinterval\fR seconds and will list
Xany new mail that has arrived in any of the mailboxes,
Xindicating the sender name, and the subject of the message.
X.P
XEach entry displayed can be in a number of different formats
Xdepending on the mode of the program, the number of folders
Xbeing monitored, and the status of the message. If you're
Xrunning it as a \fIwindow\fR (e.g. ``-w''
Xor invoked as \fIwnewmail\fR) then the output will be
Xsimilar to:
X.nf
X
X \fIsender name\fR - \fIsubject of message\fR
X Priority: \fIsender name\fR - \fIsubject of message\fR
X
X.fi
Xwhere <sender name> is either the name of the person sending it,
Xif available (the ARPA 'From:' line) or some other brief
Xindication of origin If there
Xis no subject, the message "<no subject>" will appear on
Xthe screen.
X.P
XFolders are indicated by having the folder name appear first
Xon the output line, as in:
X.nf
X
X \fIfolder\fR: \fIsender name\fR - \fIsubject of message\fR
X
X.fi
XIf you're running \fInewmail\fR without the windows option,
Xthen the output is more suitable for popping up on an otherwise
Xactive screen, and will be formatted:
X.nf
X
X >> New mail from \fIsender name\fR - \fIsubject of message\fR
X >> Priority mail from \fIsender name\fR - \fIsubject of message\fR
X
X.fi
XAgain, with folder names indicated as a prefix.
X.P
XThe flags available are:
X.TP 1.0i
X.B "-d"
XThis will turn on the debugging, verbose output mode. It is not
Xrecommended that you use this option unless you're interested in
Xactually debugging the program.
X.TP
X.B "-i \fIinterval\fR "
XThis will change the frequency that the program checks the folders
Xto the interval specified, in seconds. The default interval for
Xthe program is 60 seconds. \fINote: if you change the interval
Xto less than 10 seconds, the program will warn you that it isn't
Xrecommended.\fR
X.TP
X.B "-w"
XUse of the ``-w'' flag will simulate having the program run
Xfrom within a window (e.g. the more succinct output format,
Xand so on). Most likely, rather than using this option you
Xshould be simply invoking \fIwnewmail\fR instead.
X.P
X\fIFile specs\fR are made up of two components, the
X\fIfolder name\fR and the \fIprefix string\fR, the
Xlatter of which can always be omitted.
XThe format is \fIfoldername=prefixstring\fR, and
Xyou can specify folders by full name, by simply
Xthe name of the user whose mailbox should be
Xmonitored, or by the standard \fBElm\fR
Xmetacharacters to specify your folder
Xdirectory (e.g. ``+'', ``='', or ``%'').
X.P
XFolders that cannot be opened due to permission mismatches
Xwill cause the program to immediately abort. On the other
Xhand, files that do not exist will continue to be checked
Xevery \fIinterval\fR seconds, so some care should be
Xexercised when invoking the program.
X.P
XThe program will run until you log out or explicitly kill
Xit, and can internally reset
Xitself if any of the folders shrink in size and
Xthen grow again.
X.P
XThe default folder to monitor is always your incoming mailbox.
X.SH EXAMPLES
XSome example invocations:
X.nf
X
X $ \fBnewmail\fR
X
X.fi
Xwill check your imcoming mailbox every 60 seconds.
X.nf
X
X $ \fBnewmail -i 15 joe root\fR
X
X.fi
Xwill monitor the incoming mailboxes for ``joe'' and ``root'',
Xchecking eery 15 seconds for new mail.
X.nf
X
X $ \fBnewmail "mary=Mary" +postmaster=POBOX\fR
X
X.fi
Xwill monitor the incoming mailbox for user ``mary'', prefixing
Xall messages with the string ``Mary'', and the folder in
Xthe users \fImaildir\fR directory called ``postmaster'',
Xprefixing all of those messages with ``POBOX''.
X.P
XYou can also have more complex monitoring too, for example:
X.nf
X
X $ \fBnewmail -i 30 $LOGNAME=me ${LOGNAME}su=myroot /tmp/mbox\fR
X
X.fi
Xwill check every 30 seconds for the users mailbox, a mailbox that
Xis the users login-name with ``su'' appended (e.g. ``joe'' would
Xbecome ``joesu'') and the file /tmp/mbox, prefixing new mail
Xfor each with ``me'', ``myroot'' and ``mbox'' respectively.
X.SH AUTHOR
XDave Taylor, Hewlett-Packard Laboratories.
X.SH SEE ALSO
Xnotify in sh(1) or csh(1)
X.SH BUG REPORTS TO
XSyd Weinstein syd@dsinc.UUCP (dsinc!syd)
SHAR_EOF
chmod 0444 doc/newmail.1 || echo "restore of doc/newmail.1 fails"
echo "x - extracting doc/printmail.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/printmail.1 &&
X.TH PRINTMAIL 1L
X.ad b
X.SH NAME
Xprintmail - format mail in a readable fashion for printing
X.SH SYNOPSIS
X.B printmail
X{-p}
X{filename}
X.SH HP-UX COMPATIBILITY
X.TP 10
XLevel:
XHP-UX/CONTRIBUTED
X.TP
XOrigin:
XHewlett-Packard
X.SH DESCRIPTION
X.I Printmail
Xcopies all messages from either the file specified or the
Xdefault user mailbox with each message separated by a line of dashes.
XWith the
X.B \-p
Xoption, the messages are separated by a formfeed instead.
X.sp
XIn fact, this command is actually just a slightly differently
Xformatted call to \fIreadmsg\fR:
X.nf
X readmsg {-p} {-f \fIfilename\fR} *
X.fi
Xwhich does all the work here.
X.SH EXAMPLE
XA typical usage of this command is;
X.nf
X
X printmail | lpr
X
X.fi
X.SH AUTHOR
XDave Taylor, Hewlett-Packard Laboratories.
X.SH SEE\ ALSO
Xreadmsg(1L)
X.SH BUG REPORTS TO
XSyd Weinstein syd@dsinc.UUCP (dsinc!syd)
SHAR_EOF
chmod 0444 doc/printmail.1 || echo "restore of doc/printmail.1 fails"
echo "x - extracting doc/readmsg.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/readmsg.1 &&
X.TH READMSG 1L
X.ad b
X.SH NAME
Xreadmsg - read messages from incoming mail
X.SH SYNOPSIS
X.B readmsg
X[\fB-p\fR]
X[\fB-n\fR]
X[\fB-f filename\fR]
X[\fB-h\fR]
X.br
X.B readmsg
X[\fB-p\fR]
X[\fB-n\fR]
X[\fB-f filename\fR]
X[\fB-h\fR]
Xnumber [number ...]
X.br
X.B readmsg
X[\fB-p\fR]
X[\fB-n\fR]
X[\fB-f filename\fR]
X[\fB-h\fR]
Xpattern
X.br
X.SH HP-UX COMPATIBILITY
X.TP 10
XLevel:
XHP-UX/CONTRIBUTED
X.TP
XOrigin:
XHewlett-Packard
X.SH DESCRIPTION
X.I Readmsg
Xis a program that gives the \fIelm\fR user the functionality of
Xthe mailx "~r" command from the editor of their choice. There
Xare three different ways of using the program;
X.P
XFirst off, if you're actually creating a reply to a message
Xfrom within the \fIelm\fR system then \fIreadmsg\fR without any
Xarguments will include a summary of the headers and the body
Xof the message being replied
Xto. If you aren't currently editing a message the program will
Xreturn an error.
X.P
XSecondly, if you want to include certain messages, you can
Xspecify them by listing their ordinal locations in the
Xmail file (that is, their "message numbers")
Xup to 25 at a time. The \fImeta-\fRnumber '$' is understood to mean
Xthe last message in the mailfile. Similarly, '*' is understood to
Xrepresent every message in the file (that is, 1-$)
X.P
XFinally, you can also specify a pattern that occurs in one of
Xthe messages as a way of including it. This pattern can be
Xtyped in directly (no quotes) if the words are separated by a
Xsingle space in the actual message. The pattern matching is case
Xsensitive, so "Hello" and "hello" are NOT the same thing!!
X.sp
X.P
XThe \fB-f\fR flag indicates that you'd rather use the file specified
Xfor the operations specified rather than the default mailbox.
X.P
XThe \fB-h\fR flag instructs the program to include the entire header
Xof the matched message or messages when displaying their
Xtext. (default is to display the From: Date: and Subject: lines
Xonly)
X.P
XThe \fB-n\fR flag instructs the program to exclude \fIall\fR
Xheaders. This is used mostly for extracting files mailed and
Xsuch.
X.P
XFinally, the \fB-p\fR flag indicates that the program should
Xput form-feeds (control-L) between message headers.
X.sp
X.SH "EXAMPLES"
XFirst off, to use this from within \fBvi\fR to include the text of the
Xcurrent message at the end of the current message, you could
Xuse the command;
X.nf
X
X !!readmsg
X
X.fi
X(as you hit the 'G' the editor will put you at the bottom of the screen
Xwith the '!' prompt).
X.sp 2
XLet's look at something more interesting, however;
X.sp
XSuppose you have the mailfile;
X.nf
X
X From joe Jun 3 1986 4:45:30 MST
X Subject: hello
X
X Hey Guy! Wanta go out and have a milk this evening?
X
SHAR_EOF
echo "End of part 5"
echo "File doc/readmsg.1 is continued in part 6"
echo "6" > s2_seq_.tmp
exit 0
--
=====================================================================
Sydney S. Weinstein, CDP, CCP Elm Coordinator
Datacomp Systems, Inc. Voice: (215) 947-9900
{allegra,bellcore,bpa,vu-vlsi}!dsinc!syd FAX: (215) 938-0235