home *** CD-ROM | disk | FTP | other *** search
- Subject: v22i066: ELM mail syste, release 2.3, Part07/26
- Newsgroups: comp.sources.unix
- Approved: rsalz@uunet.UU.NET
- X-Checksum-Snefru: 68645385 7b5038d7 f5ca6fea 6947d57d
-
- Submitted-by: Syd Weinstein <syd@dsinc.dsi.com>
- 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 elm@DSI.COM (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 elm@DSI.COM (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 elm@DSI.COM (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 elm@DSI.COM (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 elm@DSI.COM (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 elm@DSI.COM (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 elm@DSI.COM (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 elm@DSI.COM (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 elm@DSI.COM (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 elm@DSI.COM (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...
-