Usenet 1994 January/usenetsourcesnewsgroupsinfomagicjanuary1994.iso/sources/unix/volume22/elm2.3/part07

Internet Message Format | 1990-06-07 | 49.5 KB

Subject:  v22i066:  ELM mail syste, release 2.3, Part07/26
Newsgroups: comp.sources.unix
Approved: [e-mail]
X-Checksum-Snefru: 68645385 7b5038d7 f5ca6fea 6947d57d

Submitted-by: Syd Weinstein <[e-mail]>
Posting-number: Volume 22, Issue 66
Archive-name: elm2.3/part07

---- Cut Here and unpack ----
#!/bin/sh
# this is part 7 of a multipart archive
# do not concatenate these parts, unpack them in order with /bin/sh
# file doc/Users.guide continued
#
CurArch=7
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.lp "\h'4p'\f2Berkeley Mail\f1" 1.0i
XA surprisingly sophisticated mailer, especially the version with 4.3 BSD,
X\f2Berkeley Mail\f1 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
X.lp \h'4p'\f2MH\f1 1.0i
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 \f2lots\f1 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
X.lp \h'4p'\f2dmail\f1 1.0i
XA sort of mutated cross between \f2MH\f1 and \f2Berkeley Mail\f1, it was
Xthis program that convinced me to implement the \f2Limit\f1 functions.
X
X.lp \h'4p'\f2NMail\f1 1.0i
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 \f3Elm\f1.  Indubitably.  And quite faster too!
X
X.lp \h'4p'\f2PMX/TERM\f1 1.0i
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 \f2not\f1 the way to do things!!
XOn the other hand, it also shows that the \f2Forms\f1 mode can be quite
Xnicely integrated into a more sophisticated mailer.
X
X.lp \h'4p'\f2fmail\f1 1.0i
XA nickel addition to the \f2/bin/mail\f1 program to add some rudimentary
Xscreen interface stuff, this nonetheless interesting mailer is part of
Xthe AT&T Toolchest.
X
X.lp \h'4p'\f2Laurel\f1 1.0i
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 \f2cross out\f1 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 \f2termcap\f1, perhaps \f3Elm\f1 will do
Xthis too!
X
X.lp \h'4p'\f2Mailtool\f1 1.0i
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 \f2/bin/mail\f1 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
X.lp \h'4p'\f2Metamail\f1 1.0i
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 \f3HAL\f1 did in \f22001: A Space Odyssey\f1 \(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 \f3Elm\f1, 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
X.in 0
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!
X.br
X.ne 5
X.sp
X.hn 1 "Credits and So on Part II - The Usenet Elm Development Group"
X
XAs coordinator of the Elm Development Group, I must add to the credits.
XThis group of volunteers has taken the Elm code from Dave Taylor and
Xadded features, made it more robust, and more portable.
X.sp
XFor getting the Usenet Elm group going, for without which I wouldn't be
Xwriting this, thanks to Greg Hackney at Southwestern Bell Telephone Co.
X.sp
XFor the Configuration system and its newer Dist 2.0 version, thanks are
Xdue to Larry Wall of JPL-NASA.
X.sp
XFor his over two hundred sets of changes to version 2.2, Elm owes a lot
Xto Rob Bernardo at Pacbell.
X.sp
XThe ability to run Elm at all on Intel 286 machines owes a lot to the
Xinsistent nudging of the coordinator by Chip Salzenberg,
XChip Rosenthal, and Tim Evans.
X.sp
XFor getting us the rights to use the news macros and converting all
Xthe documentation over to those macros, thanks to Mike Brown.
X
XNow, before I get accused of leaving someone out, here are the
Xmembers of the Elm Development and the Elm Testing Group:
X.sp
XJonathan Bayer,
XRob Bernardo,
XDoug Blair,
XKevin Bond,
XMike Brown,
XEd Clarke,
XSteven Donegan,
XPaul Ebersman,
XAvi Feldblum,
XSteven Goodman,
XGreg Hackney,
XMark Hahn,
XMitch Hamilton,
XEd Hann,
XDavid Hawkins,
XNate Hess,
XPhil Hochstetler,
XBud Hovell,
XKenneth Ingham,
XChad Larson,
XWarren Lavallee,
XHoward Leadman,
XJohn A. Limpert,
XAndy Linton,
XDarrell McIntosh,
XDatta Miruke,
XPaul M. Moriarty,
XAndrew Mossberg,
XRobert B. Nelson,
XLeo C. Noordhuizen,
XBrian O'Neill,
XFairfax O'Riley,
XPete Phillips,
XDave Rasmussen,
XLen Rose,
XChip Rosenthal,
XChip Salzenberg,
XRay Smith,
XGary Trujillo,
XEd Wells,
XMike Whitman,
XDave Yearke,
XJon Zeeff,
Xand
XSyd Weinstein, Elm Coordinator.
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 "Elm Version 2.3" "USENET Community Trust"
X.SH NAME
Xanswer - phone message transcription system
X.SH SYNOPSIS
X.B answer
X.PP
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 its 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/.elm/aliases.text       individual alias source
X.br
X$HOME/.elm/aliases.hash       individual alias hash table
X.br
X$HOME/.elm/aliases.data       individual alias data table
X.br
X/tmp/snd.$$                   edit buffer for outgoing mail
X.SH BUG REPORTS TO
XSyd Weinstein    [e-mail]    (dsinc!elm)
X.SH COPYRIGHTS
X.ps 18
X\fB\(co\fR\s12 Copyright 1986, 1987 by Dave Taylor
X.br
X.ps 18
X\fB\(co\fR\s12 Copyright 1988, 1989, 1990 by The USENET Community Trust
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 "Elm Version 2.3" "USENET Community Trust"
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 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
Xelm(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    [e-mail]    (dsinc!elm)
X.SH COPYRIGHTS
X.ps 18
X\fB\(co\fR\s12 Copyright 1986, 1987 by Dave Taylor
X.br
X.ps 18
X\fB\(co\fR\s12 Copyright 1988, 1989, 1990 by The USENET Community Trust
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 "Elm Version 2.3" "USENET Community Trust"
X.SH NAME
Xcheckalias - check to see if an alias is defined.
X.SH SYNOPSIS
X.B checkalias
Xalias, alias, ...
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    [e-mail]    (dsinc!elm)
X.SH COPYRIGHTS
X.ps 18
X\fB\(co\fR\s12 Copyright 1986, 1987 by Dave Taylor
X.br
X.ps 18
X\fB\(co\fR\s12 Copyright 1988, 1989, 1990 by The USENET Community Trust
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                      Elm 2.3 Action
X
X          <RETURN>,<SPACE>      Display current message
X           |                    Pipe current message or tagged messages to
X                                        a system command.
X           !                    Shell escape
X           $                    Resynchronize folder
X           ?                    This screen of information
X           +, <RIGHT>           Display next index page
X           -, <LEFT>            Display previous index page
X           =                    Set current message to first message
X           *                    Set current message to last message
X           <NUMBER><RETURN>     Set current message to <NUMBER>
X           /                    Search from/subjects for pattern
X           //                   Search entire message texts for pattern
X           >                    Save current message or tagged messages
X                                        to a folder
X           <                    Scan current message for calendar entries
X           a                    Alias, change to 'alias' mode
X           b                    Bounce (remail) current message
X           C                    Copy current message or tagged messages
X                                        to a folder
X           c                    Change to another folder
X           d                    Delete current message
X          ^D                    Delete messages with a specified pattern
X           e                    Edit current folder
X           f                    Forward current message
X           g                    Group (all recipients) reply to current message
X           h                    Headers displayed with message
X           J                    Increment current message by one
X           j, <DOWN>            Advance to next undeleted message
X           K                    Decrement current message by one
X           k, <UP>              Advance to previous undeleted message
X           l                    Limit messages by specified criteria
X          ^L                    Redraw screen
X           m                    Mail a message
X           n                    Next message, displaying current,
X                                        then increment
X           o                    Change ELM options
X           p                    Print current message or tagged messages
X           q                    Quit, maybe prompting for deleting, storing,
X                                        and keeping messages
X           Q                    Quick quit - no prompting
X           r                    Reply to current message
X           s                    Save current message or tagged messages
X                                        to a folder
X           t                    Tag current message for further operations
X          ^T                    Tag messages with a specified pattern
X           u                    Undelete current message
X          ^U                    Undelete messages with a specified pattern
X           x, ^Q                Exit leaving folder untouched, ask permission
X                                        if folder changed
X           X                    Exit leaving folder untouched, unconditionally
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 in Elm 2.3
X
X Key    Meaning
X ---    -------
X  >     Save current options to elmrc file.
X
X  a     Arrow cursor.  Changes from "->" to inverse bar and back for
X        indicating the current message. Change with <space>.
X
X  c     Calendar file.  See '<' at top level menu for more information on this.
X
X  d     Display pager. "builtin" and "builtin+" will use the built-in pager,
X        or you enter the name of a standard pager, like "more".
X
X  e     Editor to use when composing messages.
X
X  f     Folder directory.  This is what '=', '+', or '%' on the front of a
X        folder name expands to.
X
X  i     Return to index screen.
X
X ^L     Redraw screen.
X
X  m     Mini-menu displayed on index screen or not. Change with <space>.
X
X  n     Names only or names and address displayed. Change with <space>.
X
X  s     Sorting criteria.  Step through with <space>, <return> selects.
X
X  o     Outbound mail file.  Where to save copies of outbound mail when not
X        saved by the recipient's name.
X
X  p     Print messages with this command. '%s' can be used in the command
X        as a filename holder.
X
X  u     User's expertise level. Change with <space>.
X
X  y     Your fullname to be used in outbound mail.
X
X  x     Exit ELM leaving folder untouched.
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 in Elm 2.3
X
X Key    Meaning
X ---    -------
X
X  ?     Help on a specific key, or this summary of commands.
X
X  a     Add the return address of current message to alias database, (or
X        the regular address if current message is copy of a message sent).
X
X  d     Delete a user alias from alias database.
X
X  l     List all aliases in the database.
X
X  m     Make a new user alias, adding it 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.
SHAR_EOF
chmod 0444 doc/elm-help.2 || echo "restore of doc/elm-help.2 fails"
echo "x - extracting doc/elm-help.3 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/elm-help.3 &&
X
X        Command                      Elm 2.3 Action
X
X
X          <RETURN>              Display the current message,
X                                        or (builtin pager only) scroll
X                                        current message forward one line
X          <SPACE>               Display the next screen of the current
X                                        message (builtin pager only),
X                                        or if at the end of a message,
X                                        the first screen of the next message
X           |                    Pipe current message or tagged messages to
X                                        a system command.
X           !                    Shell escape
X           ?                    This screen of information
X           >                    Save current message or tagged messages
X                                        to a folder
X           <                    Scan current message for calendar entries
X           b                    Bounce (remail) current message
X           C                    Copy current message or tagged messages
X                                        to a folder
X           d                    Delete current message
X           f                    Forward current message
X           g                    Group (all recipients) reply to current message
X           h                    Headers displayed with message
X           i                    Return to index screen
X           J                    Increment current message by one
X           j, <DOWN>            Advance to next undeleted message
X           K                    Decrement current message by one
X           k, <UP>              Advance to previous undeleted message
X           m                    Mail a message
X           n                    Display next message
X           p                    Print current message or tagged messages
X           q                    Quit pager mode and return to index screen
X           r                    Reply to current message
X           s                    Save current message or tagged messages
X                                        to a folder
X           t                    Tag current message for further operations
X           u                    Undelete current message
X           x                    Exit leaving folder untouched
SHAR_EOF
chmod 0444 doc/elm-help.3 || echo "restore of doc/elm-help.3 fails"
echo "x - extracting doc/elm.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/elm.1 &&
X.TH ELM 1L "Elm Version 2.3" "USENET Community Trust"
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-folder"
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 DESCRIPTION
X.I Elm\^
Xis an interactive screen-oriented mailer program that supercedes
X.I mail
Xand
X.I mailx.
X.PP
XThere are three main ways to use the \fBelm\fR mailer.  One way
Xto 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. For example,
Xthe command
X.nf
X
X    elm -s testing joe
X
X.fi
Xwould initiate the sending of a message to the alias joe with the subject
X"testing" indicated and
Xwould put you into an editor for you to enter the text of the message.
XIf the subject flag and argument were not present, you would be prompted
Xfor a message subject.
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.
XThe subject flag and argument are optional.
X.PP
XThe third way, elm is invoked
Xwith neither subject nor addresses specified on the command line and
Xwithout standard input redirected.
XYou can then read any messages in your incoming mailbox (or specified
Xfolder), reply to messages in the mailbox, mail messages, etc.
X.PP
XOptions 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-folder\fR  "
XFolder - read folder (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 "  -v"
XVersion - print version and configuration information.
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 System Users Guide,
XThe Elm Forms Mode Guide,
XThe Elm Filter Guide,
XThe Elm Configuration Guide\fR
X.sp
X.br
Xnewalias(1L), checkalias(1L), mail(1), mailx(1), frm(1L), printmail(1L)
X.SH FILES
X/usr/local/lib/elm-help.*         help files
X.br
X/usr/local/lib/aliases.text       system alias source
X.br
X/usr/local/lib/aliases.hash       system alias hash table
X.br
X/usr/local/lib/aliases.data       system alias data table
X.br
X$HOME/.elm/aliases.hash           user alias source
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$HOME/.elm/elmrc                  customized mailer parameters
X.br
X$HOME/.elm/elmheaders             customized message headers
X.br
X/tmp/snd.$$                       outgoing mail edit buffer
X.br
X/tmp/mbox.\fIlogname\fR            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    [e-mail]    (dsinc!elm)
X.SH COPYRIGHTS
X.ps 18
X\fB\(co\fR\s12 Copyright 1986, 1987 by Dave Taylor
X.br
X.ps 18
X\fB\(co\fR\s12 Copyright 1988, 1989, 1990 by The USENET Community Trust
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 4.1 90/04/28 22:41:30 syd Exp $
X# Elm Version 2.3
X# For yes/no settings with ?, ON means yes, OFF means no
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 is "Mail"
X
Xtmpdir
X# where to place temporary files, default directory is "/tmp"
X
Xreceivedmail
X# where to save received messages to, default file is "=received"
X
Xeditor
X# what editor to use ("none" means simulate Berkeley Mail)
X
Xescape
X# the character to use in the builtin editor for entering commands
X
Xsentmail
X# where to save copies of outgoing mail to, default file is "=sent"
X
Xcalendar
X# where to save calendar entries
X
Xsortby
X# how to sort folders, "Mailbox" by default
X
Xprint
X# how to print a message ('%s' is the filename)
X
Xattribution
X# attribution string for replies ('%s' is the author of original message)
X
Xprefix
X# prefix sequence for indenting included message text in outgoing 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
Xsavename
X# save messages, incoming and outbound, by login name of sender/recipient?
X
Xforcename
X# save outbound messages by login name of sender/recipient even if the
X# associated folder doesn't already exist?
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" file to append to outbound messages...
X
Xlocalsignature
X# local ".signature" file to append to appropriate messages...
X
Xremotesignature
X# remote ".signature" file to append to appropriate messages...
X
Xsigdashes
X# do we want dashes above signatures? (News 2.11 compatibility and convention)
X
Xalwayskeep
X# should the default be to keep unread messages in the incoming mailbox?
X
Xalwaysstore
X# should the default be to store read messages to the "received" folder?
X
Xalwaysdelete
X# should the default be to delete messages we've marked for deletion?
X
Xpager
X# program to use for displaying messages ('builtin' is recommended)
X
Xpromptafter
X# prompt for a command after the external pager exits?
X
Xkeepempty
X# should we keep folders from which all messages are deleted?
X
Xkeypad
X# are we running on an HP terminal and want HOME, PREV, NEXT, etc...?
X
Xsoftkeys
X# are we 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# do we want to be able to 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# just show the names 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 message disposition questions be displayed(ON) or
X# auto-answered(OFF) with the default answers when we resync or change folders?
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 4.1 90/04/28 22:41:32 syd Exp $
X#
X# .elm/elmrc - options file for the ELM mail system
X#
X# Saved automatically by ELM 2.3 for Dave Taylor
X#
X
X# For yes/no settings with ?, ON means yes, OFF means no
X
X# where to save calendar entries
Xcalendar = ~/.Agenda
X
X# what editor to use ("none" means simulate Berkeley Mail)
Xeditor = none
X
X# the character to use in the builtin editor for entering commands
Xescape = ~
X
X# the full user name for outbound mail
Xfullname = Dave Taylor
X
X# where to save received messages to, default file is "=received"
Xreceivedmail = $HOME/Mail/received
X
X# where to save my mail to, default directory is "Mail"
Xmaildir = /users/taylor/Mail
X
X#directory to hold my temporary files to avoid NFS cross mount problems
Xtmpdir = /users/taylor/Mail/tmp
X
X# program to use for displaying messages ('builtin' is recommended)
Xpager = builtin
X
X# prefix sequence for indenting included message text in outgoing messages...
Xprefix = >_
X
X# how to print a message ('%s' is the filename)
Xprint = lpr -Plw2 %s
X
X# attribution string for replies ('%s' is the author of original message)
Xattribution = According to %s:
X
X# where to save copies of outgoing mail to, default file is "=sent"
Xsentmail = /users/taylor/Mail/mail.sent
X
X# the shell to use for shell escapes
Xshell = /bin/csh
X
X# local ".signature" file to append to appropriate messages...
Xlocalsignature = localsig
X
X# remote ".signature" file to append to appropriate messages...
Xremotesignature =  remotesig
X
X# do we want dashes above signatures? (News 2.11 compatibility and convention)
Xsigdashes = ON
X
X# how to sort folders, "Mailbox" by default
Xsortby = Reverse-Received
X
X# should the default be to delete messages we've marked for deletion?
Xalwaysdelete = ON
X
X# should the default be to store read messages to the "received" folder?
Xalwaysstore = ON
X
X# should the default be to keep unread messages in the incoming mailbox?
Xalwayskeep = ON
X
X# should we use the "->" rather than the inverse video bar?
Xarrow = OFF
X
X# should the message disposition questions be displayed(ON) or
X# auto-answered(OFF) with the default answers when we resync or change folders?
Xask = ON
X
X# would you like to be asked for Carbon-Copies information each msg?
Xaskcc = ON
X
X# automatically copy message being replied to into buffer?
Xautocopy = OFF
X
X# threshold for bouncing copies of remote uucp messages...
X# zero = disable function.
Xbounceback = 0
X
X# save a copy of all outbound messages?
Xcopy = ON
X
X# do we want to be able to mail out AT&T Mail Forms?
Xforms = OFF
X
X# should we keep folders from which all messages are deleted?
Xkeepempty = OFF
X
X# we're running on an HP terminal and want HOME, PREV, NEXT, etc...
Xkeypad = OFF
X
X# should we display the three-line 'mini' menu?
Xmenu = ON
X
X# when using the page commands (+ - <NEXT> <PREV>) change the current
X# message pointer...?
Xmovepage = ON
X
X# just show the names when expanding aliases?
Xnames = ON
X
X# when messages are copied into the outbound buffer, don't include headers?
Xnoheader = ON
X
X# start up by pointing to the first new message received, if possible?
Xpointnew = ON
X
X# prompt for a command after the external pager exits?
Xpromptafter = ON
X
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)?
Xresolve = ON
X
X# save messages, incoming and outbound, by login name of sender/recipient?
Xsavename = ON
X
X# save outbound messages by login name of sender/recipient even if the
X# associated folder doesn't already exist?
Xforcename = OFF
X
X# are we running on an HP terminal and want HOME, PREV, NEXT, etc...?
X# (this implies "keypad=ON" too)
Xsoftkeys = OFF
X
X# set the main prompt timeout for resynching...
Xtimeout = 60
X
X# display message title when displaying pages of message?
Xtitles = ON
X
X# are we good at it?  0=beginner, 1=intermediate, 2+ = expert!
Xuserlevel = 2
X
X# tell us about addresses to machines we can't directly get to?
Xwarnings = OFF
X
X# enable the weedout list to be read?
Xweed = ON
X
X# what headers I DON'T want to see, ever.
Xweedout = "Path:" "Via:" "Sent:" "Date" "Status:" "Original" "Phase"
X    "Subject:" "Fruit" "Sun" "Lat" "Buzzword" "Return" "Posted"
X    "Telephone" "Postal-Address" "Origin" "X-Sent-By-Nmail-V" "Resent"
X    "X-Location" "Source" "Mood" "Neuron" "Libido" "To:" "X-Mailer:"
X    "Full-Name:" "X-HPMAIL" "Cc:" "cc:" "Mmdf" "Network-" "Really-"
X    "Sender:" "Post" "Message-" "Relay-" "Article-" "Lines:"
X    "Approved:" "Xref:" "Organization:"     "*end-of-user-headers*"
X
X# alternative addresses that I could receive mail from (usually a
X# forwarding mailbox) and don't want to have listed...
Xalternatives = hplabs!taylor  hpldat!taylor  taylor@hplabs  taylor%hpldat
X
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 "Elm Version 2.3" "USENET Community Trust"
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 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    [e-mail]    (dsinc!elm)
X.SH COPYRIGHTS
X.ps 18
X\fB\(co\fR\s12 Copyright 1986, 1987 by Dave Taylor
X.br
X.ps 18
X\fB\(co\fR\s12 Copyright 1988, 1989, 1990 by The USENET Community Trust
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 "Elm Version 2.3" "USENET Community Trust"
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 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/.elm/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-o\fR too).
X.SH AUTHOR
XDave Taylor, Hewlett-Packard Laboratories.
X.SH FILES
X$HOME/.elm/filter-rules     The ruleset for the users filter
X.br
X$HOME/.elm/filterlog        A log of what has been done
X.br
X$HOME/.elm/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    [e-mail]    (dsinc!elm)
X.SH COPYRIGHTS
X.ps 18
X\fB\(co\fR\s12 Copyright 1986, 1987 by Dave Taylor
X.br
X.ps 18
X\fB\(co\fR\s12 Copyright 1988, 1989, 1990 by The USENET Community Trust
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 "Elm Version 2.3" "USENET Community Trust"
X.SH NAME
Xfrm - list from and subject of all messages in mailbox or file
X.SH SYNOPSIS
X.B frm
X[-n]
X[ folder ]
X.br
X.B frm
X[-n]
X[ username ]
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 folder is specified, the program reads that folder
Xrather than the default mailbox.  If the argument is a
X\fIusername\fR then look for that user's 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
XFolder 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    [e-mail]    (dsinc!elm)
X.SH COPYRIGHTS
X.ps 18
X\fB\(co\fR\s12 Copyright 1986, 1987 by Dave Taylor
X.br
X.ps 18
X\fB\(co\fR\s12 Copyright 1988, 1989, 1990 by The USENET Community Trust
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 "Elm Version 2.3" "USENET Community Trust"
X.SH NAME
Xlistalias - list user and system aliases
X.SH SYNOPSIS
X.B listalias
X[ regular-expression ]
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    [e-mail]    (dsinc!elm)
X.SH COPYRIGHTS
X.ps 18
X\fB\(co\fR\s12 Copyright 1986, 1987 by Dave Taylor
X.br
X.ps 18
X\fB\(co\fR\s12 Copyright 1988, 1989, 1990 by The USENET Community Trust
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 "Elm Version 2.3" "USENET Community Trust"
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 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    [e-mail]    (dsinc!elm)
X.SH COPYRIGHTS
X.ps 18
X\fB\(co\fR\s12 Copyright 1986, 1987 by Dave Taylor
X.br
X.ps 18
X\fB\(co\fR\s12 Copyright 1988, 1989, 1990 by The USENET Community Trust
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 "Elm Version 2.3" "USENET Community Trust"
X.SH NAME
Xnewalias - install new elm aliases for user and/or system
X.SH SYNOPSIS
X.B newalias
X[-g]
X.SH DESCRIPTION
X.I Newalias
Xcreates new hash and data files from a text file.
XIf the program is invoked with the
X.I -g
X(global) flag, the program updates the system alias files.
XOtherwise, the program looks for a file called \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
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.sp
XAliases are case insensitive so dave and Dave are both the same alias.
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/local/lib/aliases.text     alias source for system
X.br
X/usr/local/lib/aliases.hash     alias hash table for system
X.br
X/usr/local/lib/aliases.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    [e-mail]    (dsinc!elm)
X.SH COPYRIGHTS
X.ps 18
X\fB\(co\fR\s12 Copyright 1986, 1987 by Dave Taylor
X.br
X.ps 18
X\fB\(co\fR\s12 Copyright 1988, 1989, 1990 by The USENET Community Trust
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 "Elm Version 2.3" "USENET Community Trust"
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 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
SHAR_EOF
echo "End of part 7"
echo "File doc/newmail.1 is continued in part 8"
echo "8" > s2_seq_.tmp
exit 0

exit 0 # Just in case...