home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / ONLINE / ELM23-2 / ELM23-2.ZIP / doc / Users.guide (.txt) < prev    next >
Amigaguide Document  |  1991-01-18  |  34KB  |  878 lines
  1. .\" @(#)$Id: Users.guide,v 4.1.1.1 90/06/09 22:49:54 syd Exp $
  2. .\"  Users guide to the ELM mail system.
  3. .\"  format with:
  4. .\"    'tbl Users.guide | troff tmac.n - > Users.fmtd'
  5. .\"  Elm is now in the public trust. Bug reports, comments, suggestions, flames
  6. .\"  etc. should go to:
  7. .\"    Syd Weinstein        elm@DSI.COM (dsinc!elm)
  8. .\"  (C) Copyright 1986, 1987 Dave Taylor
  9. .\"  (C) Copyright 1988, 1989, 1990 Usenet Community Trust
  10. .\"  $Log:    Users.guide,v $
  11. .\" Revision 4.1.1.1  90/06/09  22:49:54  syd
  12. .\" Droped obsolete control Q command from list
  13. .\" From: Joe Wasik
  14. .\" Revision 4.1  90/04/28  22:41:16  syd
  15. .\" checkin of Elm 2.3 as of Release PL0
  16. .tm I trust we've run this through "tbl" first...
  17. .\"  Define the big box macro for troff
  18. .de eb
  19. .sp -1
  20. .ie t \{\
  21. \h'-.5n'\L'|\\nau-1'\l'\\n(.lu+1n\(ul'\L'-|\\nau+1'\l'|0u-.5n\(ul'
  22. .el \{\
  23. \h'-.5n'\l'\\n(.lu+1n'
  24. .po 1i
  25. .ds h0
  26. .ds h1
  27. .ds h2
  28. .ds f0
  29. .ds f1
  30. .ds f2
  31. .nr Hy 1
  32. .nr Pt 1
  33. .nr Pi 0
  34. .lg 0
  35. .\" This will keep the nroff version of the title page on one sheet.
  36. .if t .sv |2.0i
  37. .ce 99
  38. .ps 20
  39. .ss 18
  40. .vs 12
  41. \f3The Elm Users Guide\f1
  42. .sp 3
  43. .ps 12
  44. .ss 14
  45. .vs 14
  46. \f2A painless introduction to electronic mail
  47. using the \f3Elm\fP mail system\f1
  48. .sp 2
  49. Dave Taylor
  50. Hewlett-Packard Laboratories
  51. 1501 Page Mill Road
  52. Palo Alto CA
  53. 94304
  54. .sp 3
  55. email: taylor\s10@\s12hplabs.HP.COM or hplabs!taylor
  56. .sp 3
  57. >>> Elm is now in the public trust. Bug reports, comments, etc. to: <<<
  58. Syd Weinstein
  59. Datacomp Systems, Inc.
  60. 3837 Byron Road
  61. Huntingdon Valley, PA 19006-2320
  62. email: elm\s-1@\s+1DSI.COM  or  dsinc\s-1!\s+1elm
  63. .ps 8
  64. .if t .vs 9
  65. .sp 4
  66. \f3ABSTRACT\f1
  67. .ce 0
  68. .in +1i
  69. .ll -1i
  70. While various Unix utilities have been designed to
  71. take advantage of the CRT screen
  72. (rather than line-oriented systems)
  73. electronic mail systems haven't ``caught the wave''.
  74. This document
  75. presents \f2Elm\f1, a sophisticated
  76. full-screen mail system for interactive use.
  77. \f2Elm\f1 offers all the features of
  78. \f2/bin/mail\f1, \f2Berkeley Mail\f1, \f2uumail\f1, \f2NMail\f1 and
  79. the AT&T Mail family of Unix mailers (namely \f2PMX/TERM\f1) in a
  80. unified and intuitive fashion.
  81. .ll +1i
  82. .in -1i
  83. .if t .sp 3
  84. .if n .sp 2
  85. .ce 2
  86. .ps 18
  87. .if t .vs 14
  88. \f3\(co\f1\s12 Copyright 1986, 1987 by Dave Taylor
  89. .ps 18
  90. \f3\(co\f1\s12 Copyright 1988, 1989, 1990 by The USENET Community Trust
  91. .ps 10
  92. .ss 12
  93. .vs 12
  94. .bp 1
  95. .sv 5v
  96. .ce 99
  97. .ps 14
  98. \f3Elm Users Guide\f1
  99. .ds h0 "Elm Users Guide
  100. .ds h1
  101. .ds h2 "Version 2.3
  102. .ds f0 "May 1, 1990
  103. .ds f1 "Page %
  104. .ps 10
  105. (Version 2.3)
  106. .sp 2
  107. Dave Taylor
  108. Hewlett-Packard Laboratories
  109. 1501 Page Mill Road
  110. Palo Alto CA
  111. 94304
  112. email:  taylor\s-1@\s+1hplabs.HP.COM  or  hplabs\s-1!\s+1taylor
  113. .sp 2
  114. >>> Elm is now in the public trust. Bug reports, comments, etc. to: <<<
  115. Syd Weinstein
  116. Datacomp Systems, Inc.
  117. 3837 Byron Road
  118. Huntingdon Valley, PA 19006-2320
  119. email: elm\s-1@\s+1DSI.COM  or  dsinc\s-1!\s+1elm
  120. .sp 2
  121. May 1, 1990
  122. .ce 0
  123. .sp 3
  124. .hn 1 Introduction
  125. operating system was originally written on a small PDP machine,
  126. to work with teletypewriters.  Consequently, all the original software for
  127. the operating system was written with a `tty' in mind;
  128. with line oriented interfaces, rather than screen oriented.
  129. Gradually this began to change, and, with the addition of the Berkeley \f2vi\f1
  130. visual shell to the \f2ed\f1
  131. line editor, the trend began to be brought to the attention of
  132. Unix systems designers.
  133. And yet, this transition has seemed
  134. too subtle for many software engineers,
  135. and so precious few Unix programs are available
  136. designed to exploit the entire CRT screen.
  137. Consequently, after becoming more and more disenchanted
  138. with the existing electronic mail facilities (\f2binmail\f1
  139. and \f2Berkeley Mail\f1)
  140. I decided to undertake creating my own system.
  141. Once the ball was rolling it became quite
  142. difficult not to keep enhancing it, especially as I
  143. became more and more familiar with various different mail
  144. systems, but the result, I hope, is a solid, unified interface
  145. to electronic mail suitable for almost any environment.
  146. One thing that sets \f3The Elm Mail System\f1 off from
  147. other packages is that it
  148. comes with an extensive documentation set, including;
  149. \f2The Elm Users Guide\f1, which you're holding,
  150. \f2The Elm Reference Guide\f1,
  151. \f2The Elm Alias Users Guide\f1,
  152. \f2The Elm Filter System Users Guide\f1,
  153. \f2The Elm Forms Mode Guide\f1,
  154. and \f2The Elm Configuration Guide\f1.
  155. The names of each indicate
  156. what they discuss (not unreasonably).
  157. This particular document contains;
  158. this introduction, a tutorial session with the mailer, a
  159. discussion of non-interactive uses of \f3Elm\f1,
  160. a brief foray into the \f3Elm\f1 utilities,
  161. and finally, credits and references.
  162. \f2The Elm Reference Guide\f1 contains a
  163. much more indepth discussion of all the possible options
  164. available within the \f3Elm\f1 environment, including
  165. the \f2``.elm/elmrc''\f1 file,
  166. the available outbound mail processing features,
  167. a section for expert users, suggestions
  168. on debugging strange installations, and
  169. many other useful topics.
  170. \f2The Elm Alias Users Guide\f1 is the place
  171. to go to learn about the format of the
  172. ``.elm/aliases.text''
  173. file and the associated data files, to learn how
  174. to create and use path route aliases and domain
  175. based alias routing, system aliases, and other
  176. related topics.
  177. One of the more innovative features of \f3Elm\f1 is
  178. the ability to transmit and receive ``forms'' (as
  179. defined by the AT&T Mail system).  To learn about
  180. how to create and reply to forms you should refer
  181. to \f2The Elm Forms Mode Guide\f1.
  182. If you find yourself getting too much mail delivered in
  183. your mailbox, you might be a good candidate for the
  184. \f2filter\f1 program.  To learn more about what
  185. this program is and how to use it please
  186. consult \f2The Elm Filter System Users Guide\f1.
  187. Finally, if you're working with the actual source code
  188. and are interested in what all the locally configured
  189. options are and mean, please see
  190. \f2The Elm Configuration Guide\f1.  It is
  191. strongly suggested that all system administrators
  192. and people installing the system print out the
  193. local ``sysdefs.h'' file and have it handy while
  194. reading the configuration guide.
  195. The recommended order of learning the \f3Elm\f1
  196. system is to skim this guide until you feel
  197. confident enough to start up the program.  Once
  198. that's reached, \f2use it!\f1  Soon you'll find
  199. areas that you need to expand into, and you can
  200. achieve that by going into the \f2o)ptions\f1
  201. screen within \f2elm\f1 and changing your
  202. user level accordingly.
  203. After a while, sit down again and read through this
  204. guide.  You should have a couple of ``aha!'' intuitive
  205. flashes.  After another period of time, you're
  206. ready to delve into the real power of the system
  207. and read the reference guide.  The other manuals
  208. should be read as the need arises.
  209. In any case, the system should be useable without reading
  210. \f2any\f1 of the documentation!
  211. Any comments or problems with any of the documentation or the program
  212. itself are welcome; if you can't get electronic mail to me, please
  213. feel free instead to drop me a note via the overland mail address
  214. in the title page.
  215. .ne 20
  216. .hn 1 The Main System
  217. Upon entry to the program, the main screen will be
  218. displayed as below;
  219. .\" display start, constant width, remember loc for BOX
  220. .ft CW
  221. .ps 9
  222. .mk a
  223. .mk a
  224. Mailbox is '/usr/mail/mymail' with 15 messages  [Elm 2.2]
  225. r l n l l l l.
  226.  ->    N    1    Apr 24    Larry Fenske    (49)    Hello there
  227.     N    2    Apr 24    jad@hpcnoe    (84)    Chico?  Why go there?
  228.     E    3    Apr 23    Carl Smith    (53)    Dinner tonight?
  229.     NU    4    Apr 18    Don Knuth    (354)    Your version of TeX...
  230.     N    5    Apr 18    games    (26)    Bug in cribbage game
  231.      A    6    Apr 15    kevin    (27)    More software requests
  232.         7    Apr 13    John Jacobs    (194)    How can you hate RUSH?
  233.      U    8    Apr 8    decvax!mouse    (68)    Re: your Usenet article
  234.         9    Apr 6    root    (7)
  235.     O    10    Apr 5    root    (13)
  236. .ce 3
  237. You can use any of the following commands by pressing the first character;
  238. d)elete or u)ndelete mail, m)ail a message, r)eply or f)orward mail, q)uit
  239. To read a message, press <return>.  j = move down, k = move up, ? = help
  240.  Command : @
  241. .\" draw box, proportional Roman font back, display end
  242. .ps 10
  243. .ft 1
  244. There are a number of things to notice about this, the main screen;
  245. .lp \h'12p'\(bu 20p
  246. Most likely, on your computer the message currently ``active'' will be
  247. displayed in an inverse bar rather than being delimited by the two
  248. character arrow as here.  It's nothing to worry about; displaying
  249. inverse video is just quite difficult on printable guides!
  250. .lp \h'12p'\(bu 20p
  251. The first line on the screen always displays the name of the current folder,
  252. the number of messages in the folder, and the current \f3Elm\f1 version number.
  253. .lp \h'12p'\(bu 20p
  254. The arrow (``->'') or inverse video bar will always
  255. indicate which is the current message.
  256. .lp \h'12p'\(bu 20p
  257. The first field that appears associated with each message is
  258. the status field.  This can be blank (as with most of the
  259. ones above, or can have any combination of the following:
  260. The first character signifies temporary status:
  261. .ta .75iC 102p
  262.     E    for an \f2expired\f1 message
  263.     N    for a \f2new\f1 message
  264.     O    for an \f2old\f1 (i.e. not new but not read) message
  265.     D    for a \f2deleted\f1 message
  266. The second character which signifies permanent status:
  267.     U    for \f2urgent\f1 mail
  268.     A    for messages that have an \f2action\f1 associated with them
  269.     F    for a \f2form\f1 letter
  270. The third character of the status field can be a ``+'' to
  271. indicate that the message is \f2tagged\f1 too.
  272. .lp \h'12p'\(bu 20p
  273. Continuing from left to right, the next field is the message
  274. number.  For the most part you can ignore these unless you want
  275. to quickly move to a specific message (as we'll see later).
  276. .lp \h'12p'\(bu 20p
  277. The date associated with each message is typically
  278. the date the person actually \f2sent\f1 the message.
  279. .lp \h'12p'\(bu 20p
  280. The next field displayed indicates whom the message is from.
  281. \f3Elm\f1 will try to display the \f2full name\f1 of the person who
  282. sent the message, rather than the their return address or computer login.
  283. Some systems don't generate the correct headers, though, hence
  284. messages like numbers 2 and 8, where it's their return address.
  285. .lp \h'12p'\(bu 20p
  286. The number in parentheses is the total number of lines in the message.
  287. .lp \h'12p'\(bu 20p
  288. The final field is the subject of the message.  Notice
  289. that messages might not have any subject, as in messages #9 and #10.
  290. .lp \h'12p'\(bu 20p
  291. A maximum of ten messages are displayed at one time\s-2\u1\d\s0.
  292. 1. On screens with greater than 25 lines, more messages will be
  293. displayed automatically.  Further, if you choose to turn off
  294. the Menu display, you can have an even greater number
  295. displayed.
  296. Further into the document we'll learn how to change ``pages'' in the folder.
  297. .lp \h'12p'\(bu 20p
  298. The three line Menu display will always
  299. indicate the relevant commands.  There are actually two possible
  300. menus that can be displayed, based
  301. on the \f2user level\f1 as set from either the o)ptions screen or
  302. the \f2.elm/elmrc\f1
  303. file.  The alternate menu, for more advanced users,
  304. lists more options;
  305. .ft CW
  306. .ps 9
  307. .ce 3
  308. |=pipe, !=shell, ?=help, <n>=set current to n, /=search pattern
  309. a)lias, C)copy, c)hange folder, d)elete, e)dit, f)orward, g)roup reply, m)ail,
  310. n)ext, o)ptions, p)rint, r)eply, s)ave, t)ag, q)uit, u)ndelete, or e(x)it
  311. .ps 10
  312. .ft 1
  313. .lp \h'12p'\(bu 20p
  314. Finally, the '@' character indicates where the cursor would be, awaiting
  315. your input.
  316. .in 0
  317. The typical action at this point is to use the \f2<return>\f1
  318. key to read the current message, which will clear the
  319. screen and display the current message:
  320. .ne 10
  321. .ft CW
  322. .ps 9
  323. .mk a
  324. .tl ' Message 1/15 from Larry Fenske''Apr 24 \'87 at 8:45 pm'
  325. .tl ''Hello there''
  326.  Dave,
  327.       Just wanted to drop you a brief note to see what was going on with
  328.  you this afternoon.  Life here has been the usual fun and games...
  329.          Ah well, off to the great wilds beyond the desk!
  330.                 Larry
  331.  Command ('i' to return to index): @
  332. .ft 1
  333. .ps 10
  334. Before we go further with our example, however, let's very
  335. quickly look at all the functions available from the main
  336. screen:
  337. .\" ensure we get a reasonable chunk of this table on the page...
  338. .ne 10
  339. .lp \h'18p'\f3Command 90p
  340. Action\f1
  341. .lp "\h'18p'<return> or <space>" 90p
  342. Read current message.
  343. .lp \h'18p'| 90p
  344. Pipe current message or tagged messages to specified system command.
  345. .lp \h'18p'! 90p
  346. Shell escape.
  347. .lp \h'18p'$ 90p
  348. Resynchronize folder.
  349. .lp \h'18p'? 90p
  350. Help mode \(em any key pressed will be explained.
  351. .lp "\h'18p'+ or <right>" 90p
  352. Display next page of headers.
  353. .lp "\h'18p'- or <left>" 90p
  354. Display previous page of headers.
  355. .lp \h'18p'= 90p
  356. Set current message to 1.
  357. .lp \h'18p'* 90p
  358. Set current to last message.
  359. .lp \h'18p'<number><return> 90p
  360. Set current message to number \f2number\f1.
  361. .lp \h'18p'/ 90p
  362. Search for pattern in subject/from lines.
  363. .lp \h'18p'// 90p
  364. Search for pattern in entire folder.
  365. .lp \h'18p'< 90p
  366. Scan message for calendar entries.\s-2\u2\d\s0
  367. 2. Some sites might opt not to have the calendar feature available.
  368. .lp \h'18p'> 90p
  369. A synonym for `s' \(em \f2save\f1 message or messages.
  370. .lp \h'18p'a 90p
  371. Alias, change to ``alias'' mode.
  372. .lp \h'18p'b 90p
  373. Bounce \(em remail message [see \f2f \(em forward\f1 too].
  374. .lp \h'18p'C 90p
  375. Copy current message or tagged messages to folder.
  376. .lp \h'18p'c 90p
  377. Change to another folder.
  378. .lp \h'18p'd 90p
  379. Delete current message.
  380. .lp \h'18p'<control>-D 90p
  381. Delete all messages matching specified pattern.
  382. .lp \h'18p'e 90p
  383. Edit current folder, resyncing upon reentry.\s-2\u3\d\s0
  384. 3. Some sites might opt not to have the edit folder feature available.
  385. .lp \h'18p'f 90p
  386. Forward message to specified user.\s-2\u4\d\s0
  387. 4. The difference between \f2Forward\f1 and \f2Bounce\f1 is rather
  388. subtle \(em a forwarded message is ``from'' you, with the
  389. original message included, whereas a bounced message
  390. is still from the original sender.
  391. .lp \h'18p'g 90p
  392. Group reply \(em reply to everyone who received the current message.
  393. .lp \h'18p'h 90p
  394. Display message with headers.
  395. .lp \h'18p'J 90p
  396. Set current to next message.
  397. .lp "\h'18p'j or <down>" 90p
  398. Set current to next message not marked deleted.
  399. .lp \h'18p'K 90p
  400. Set current to previous message.
  401. .lp "\h'18p'k or <up>" 90p
  402. Set current to previous message not marked deleted.
  403. .lp \h'18p'l 90p
  404. Limit displayed messages based on the specified criteria.
  405. .lp \h'18p'<control>-L 90p
  406. Rewrite screen.
  407. .lp \h'18p'm 90p
  408. Mail to arbitrary user(s).
  409. .lp \h'18p'n 90p
  410. Read current message, then increment to next message not marked deleted.
  411. .lp \h'18p'o 90p
  412. Alter current system options.
  413. .lp \h'18p'p 90p
  414. Print current message or tagged messages.
  415. .lp \h'18p'q 90p
  416. Quit \(em maybe prompting for messages to delete, store, or keep.
  417. .lp \h'18p'Q 90p
  418. Quick quit \(em like quit but without prompting.
  419. .lp \h'18p'r 90p
  420. Reply to the author of current message.
  421. .lp \h'18p's 90p
  422. Save current message or tagged messages to folder.
  423. .lp \h'18p't 90p
  424. Tag current message.
  425. .lp \h'18p'<control>-T 90p
  426. Tag all messages matching specified pattern.
  427. .lp \h'18p'u 90p
  428. Undelete current message.
  429. .lp \h'18p'<control>-U 90p
  430. Undelete all messages matching specified pattern.
  431. .lp \h'18p'x 90p
  432. Exit \(em prompt if mailbox changed, don't record as read, don't save...
  433. .lp \h'18p'X 90p
  434. Exit immediately \(em don't record as read, don't save...
  435. .in 0
  436. .\" again, make sure we start on a new page please
  437. .ne 10
  438. But let's go back to our example and see some of this at
  439. work, shall we?
  440. We were reading the message from Larry and the screen looked
  441. like:
  442. .ne 10
  443. .ft CW
  444. .ps 9
  445. .mk a
  446. .tl ' Message 1/15 from Larry Fenske''Apr 24 \'87 at 8:45 pm'
  447. .tl ''Hello there''
  448.  Dave,
  449.       Just wanted to drop you a brief note to see what was going on with
  450.  you this afternoon.  Life here has been the usual fun and games...
  451.           Ah well, off to the great wilds beyond the desk!
  452.                 Larry
  453.  Command ('i' to return to index): @
  454. .ft 1
  455. .ps 10
  456. From this point let's go ahead and reply to the message.  To
  457. do this, we can use the \f2reply\f1 command...
  458. To do this, we type ``r'' and the last few lines change to
  459. something like:
  460. .ft CW
  461. .ps 9
  462. .tl '-------------------------------------------------------------------------------''
  463. .tl 'Command: Reply to message''Copy message (y/n) ? @ '
  464. .sp 2
  465. .ft 1
  466. .ps 10
  467. To which we decide that we don't need the text of this message in
  468. our new one, so we reply \f2no\f1 by pressing the ``n'' key.  The
  469. bottom part of the window then changes to:
  470. .ft CW
  471. .ps 9
  472. .tl '-------------------------------------------------------------------------------''
  473. .tl 'Command: Reply to message''To: Larry Fenske '
  474. .tl 'Subject: Re: Hello there@''
  475. .ft 1
  476. .ps 10
  477. .sp 2
  478. at this point we can either decide to enter a new subject (you could
  479. use either \f2backup word\f1 (<control>-W) or \f2backup line\f1 (this
  480. is the same as your `line kill' character, <control>-X or <control>-U
  481. usually)) or go with this one by pressing \f2<return>\f1.  We'll
  482. just leave it as it is and press \f2<return>\f1, changing the
  483. screen to:
  484. .ps 9
  485. .ft CW
  486. .tl '-------------------------------------------------------------------------------''
  487. .tl 'Command: reply to message''To: Larry Fenske '
  488. .tl 'Subject: Re: Hello there''
  489. .tl 'Copies to: @'''
  490. .ps 10
  491. .ft 1
  492. There's no one we want to have receive copies of this message, so we'll
  493. just press \f2<return>\f1 again to indicate this.
  494. Once you've answered these questions the program will put you into
  495. your favorite editor and let you compose a response.  When you're
  496. done it then asks:
  497. .ps 9
  498. .ft CW
  499. .tl ''-------------------------------------------------------------------------------''
  500. .tl 'Please choose one of the following options by parenthesized letter: @'''
  501. .tl ''e)dit message, edit h)eaders, s)end it, or f)orget it.''
  502. .ft 1
  503. .ps 10
  504. Since we're just interested in sending the message out, we'll
  505. choose the \f2send\f1 option and press ``s''.  The program
  506. then sends the message, indicating that by the line below
  507. saying:
  508. .ps 9
  509. .ft CW
  510.     Sending mail...
  511. .ft 1
  512. .ps 10
  513. then putting at the bottom of the screen ``Mail sent!'' and giving us
  514. the prompt:
  515. .ps 9
  516. .ft CW
  517. .tl ''-------------------------------------------------------------------------------''
  518. .tl 'Command:''(Use \'i\' to return to index.)''
  519. .ps 10
  520. .ft 1
  521. Pretty easy, isn't it?  Let's continue by going back to the main
  522. screen by requesting \f2index\f1: pressing the ``i'' key.  The
  523. screen is then:
  524. .ne 20
  525. .ft CW
  526. .ps 9
  527. .mk a
  528. .mk a
  529. Mailbox is '/usr/mail/mymail' with 15 messages  [Elm 2.2]
  530. r l r l l l l.
  531.  ->        1    Apr 24    Larry Fenske    (49)    Hello there
  532.     N    2    Apr 24    jad@hpcnoe    (84)    Chico?  Why go there?
  533.     E    3    Apr 23    Carl Smith    (53)    Dinner tonight?
  534.     NU    4    Apr 18    Don Knuth    (354)    Your version of TeX...
  535.     N    5    Apr 18    games    (26)    Bug in cribbage game
  536.      A    6    Apr 15    kevin    (27)    More software requests
  537.         7    Apr 13    John Jacobs    (194)    How can you hate RUSH?
  538.      U    8    Apr 8    decvax!mouse    (68)    Re: your Usenet article
  539.         9    Apr 6    root    (7)
  540.     O    10    Apr 5    root    (13)
  541. .ce 3
  542. You can use any of the following commands by pressing the first character;
  543. d)elete or u)ndelete mail, m)ail a message, r)eply or f)orward mail, q)uit
  544. To read a message, press <return>.  j = move down, k = move up, ? = help
  545.  Command : @
  546. .\" draw box, proportional Roman font back, display end
  547. .ft 1
  548. .ps 10
  549. .ft 1
  550. Notice that the first message is no longer marked as \f2new\f1
  551. since we've now read it.
  552. Let's go ahead and read the message from kevin (message #6) since
  553. it has some sort of \f2action\f1 associated with it anyway.  To
  554. do this, we simply press the ``6'' key, which will change the
  555. bottom of the screen to:
  556. .ps 9
  557. .ft CW
  558. .tl 'Command: New Current Message''Set current message to : 6@'
  559. .ft 1
  560. .ps 10
  561. We'll just press \f2<return>\f1 to move the active message
  562. pointer (the arrow).
  563. Now we're pointing at the new message, so let's go ahead and read
  564. it by pressing \f2<return>\f1 again, giving us:
  565. .ne 10
  566. .ft CW
  567. .ps 9
  568. .mk a
  569. .tl ' Message 6/15 from kevin''Apr 15 \'87 at 11:36 am'
  570. .tl ''More software requests''
  571.  Action: please acknowledge receipt
  572.  I don't suppose you have a nifty netnews reader around too, do you??
  573.  kevin
  574.  Command ('i' to return to index): @
  575. .ps 10
  576. .ft 1
  577. .ne 5
  578. Well, it turns out that we don't, but a friend of ours does, so
  579. let's \f2forward\f1 the message to them by pressing ``f'':
  580. .ps 9
  581. .ft CW
  582. .tl '-------------------------------------------------------------------------------''
  583. .tl 'Command: Forward message''Edit outgoing message (y/n) ? @ '
  584. .ft 1
  585. .ps 10
  586. .sp 2
  587. No need to edit it, so let's answer \f2no\f1 with ``n'':
  588. .ps 9
  589. .ft CW
  590. .tl '-------------------------------------------------------------------------------''
  591. .tl 'Command: Forward message''Edit outgoing message (y/n) ? No '
  592. .tl 'To: @'''
  593. .ps 10
  594. .ft 1
  595. We type in the address of the person we're forwarding to (in
  596. this case
  597. .ft CW
  598. usenet\f1) and press
  599. \f2<return>\f1:
  600. .ft CW
  601. .ps 9
  602. .tl '-------------------------------------------------------------------------------''
  603. .tl 'Command: Forward message''To: usenet '
  604. .tl 'Subject: More software requests (fwd)@'
  605. .ft 1
  606. .ps 10
  607. To which we again press \f2<return>\f1 to take the default subject.
  608. \f3Elm\f1 asks for any possible copy recipients, asks us if we're
  609. sure we want to send it, and shoots it off.
  610. Enough mail for now, however, so we just \f2exit\f1 by pressing
  611. the ``x'' key and the program drops us back into our shell.
  612. .sp 2
  613. As you can see, it's quite easy to use the \f3Elm\f1 system, so
  614. rather than continue with our example, let's
  615. look at some other aspects of the program.
  616. .ne 5
  617. .hn 1 Non-Interactive Uses of Elm
  618. Before we go ahead and discuss the \f3Elm\f1 utilities, it's worth
  619. noting that
  620. there are a couple of other ways to use the main mail
  621. system, namely to `send only' and to send files (batchmail).
  622. To send a message to someone without any of the associated
  623. overhead of reading in a mail folder, you can invoke the
  624. mailer with the name(s) of the people to send to.  For example:
  625.   $ \f3elm dave_taylor\f1
  626. mailer will then prompt for Subject, Copies, and then drop
  627. you in your editor (defined in the \f2.elm/elmrc\f1 file) to compose
  628. the message.   When composition is complete, the program
  629. verifies transmission then terminates.
  630. .ne 3
  631. The mailer also supports batch type mailing, of files and so on,
  632. by using the following command:
  633.   $ \f3elm dave_taylor < help.c\f1
  634. which will read in the file and transmit it to the specified user.
  635. .ne 3
  636. A subject may be specified with ``-s \f2subject\f1'' as an option
  637. to the program in either `send only' or `batch' modes, as in:
  638.   $ \f3elm -s "File help.c, as promised" dave_taylor < help.c\f1
  639. .ne 5
  640. .hn 1 The Elm Utilities
  641. The \f3Elm\f1 mail system is really much more than a single
  642. program for reading and writing mail.  It's a unified
  643. environment for intelligently dealing with electronic
  644. correspondence.  As a consequence, it contains a number of other
  645. programs to aid in the easy processing of `email',
  646. including the following;
  647. .lp \h'10p'answer 1.0i
  648. An answering-machine transcription program.  Please see the
  649. manual entry for more information on how to use this program.
  650. .lp \h'10p'autoreply 1.0i
  651. This program, in conjunction with the ``arepdaemon'', enables users
  652. to automatically reply to incoming mail when they're not directly
  653. available.
  654. .lp \h'10p'checkalias 1.0i
  655. A script for checking aliases simply.
  656. .lp \h'10p'messages 1.0i
  657. A script that lists the number of messages in the specified
  658. folder.  Suitable for login scripts and such.
  659. .lp \h'10p'newmail 1.0i
  660. This program monitors a mailbox or set of mailboxes and can
  661. output notification of new mail in one of two possible
  662. formats; either:
  663. .ne 6
  664. .ft CW
  665. .ps 9
  666. >> New mail from Jimmy Carter - Urgent matters of state
  667. >> New mail from joe@ucbvax.arpa - Did I hear someone say PARTY??
  668. .ft 1
  669. .ps 10
  670. if running as \f2newmail\f1 or:
  671. .ft CW
  672. .ps 9
  673. Jimmy Carter -- Urgent matters of state
  674. joe@ucbvax.arpa -- Did I hear someone say PARTY??
  675. .ft 1
  676. .ps 10
  677. if running as \f2wnewmail\f1.  BSD Users will find this is
  678. a far superior \f2biff\f1 program.
  679. .lp \h'10p'wnewmail 1.0i
  680. This is the same program as newmail, but has different
  681. defaults if invoked this way.
  682. .lp \h'10p'readmsg 1.0i
  683. This handy little program can be used in two ways.  First off,
  684. it can be used to easily read a specific message in the
  685. incoming mailbox, specified by ordinal number, by a string that
  686. the message contains, by the metacharacter `$' which
  687. represents the last message in the folder, or `*' which matches
  688. all the messages in the folder.
  689. For example;
  690. $ \f3readmsg 4 5 9 | lpr\f1
  691. would generate a printout, \f2sans\f1 superfluous headers, of the fourth,
  692. fifth and ninth messages in your mailbox.
  693. $ \f3readmsg Carter | page\f1
  694. would be a fast way to read what `ole Jimmy has to say...
  695. $ \f3readmsg -h hear someone say\f1
  696. would list, including all the message headers, the message
  697. containing the string ``hear someone say''.
  698. .lp \h'10p'frm 1.0i
  699. Similar to the Berkeley \f2from\f1 command, this will
  700. give you a ``table of contents'' of either the current
  701. mailbox or a mailbox of your choice.   It's useful to
  702. see what mail is pending, or what's in a mailbox.
  703. If used with the `-n' option, it will number each message
  704. in a way compatible with the arguments \f2readmsg\f1
  705. expects to get, too!
  706. .lp \h'10p'newalias 1.0i
  707. This is used to install new user/group aliases.  Please see
  708. \f2The Elm Alias Users Guide\f1 for further information on this!
  709. .lp \h'10p'fastmail 1.0i
  710. Sometimes you want to have a batchmailing system that works as
  711. quickly as possible, not bothering with aliases or any of the
  712. other ``deluxe'' features of \f3Elm\f1.  An example of this would
  713. be if you have a large mailing list for a newsletter, say.
  714. This command, \f2fastmail\f1, is designed just for that purpose.
  715. It avoids the lengthy startup time of \f3Elm\f1 while still
  716. generating valid \f2RFC-822\f1\s-2\u5\d\s0 mail.
  717. 5. If you don't know what RFC-822 is, don't worry about it!
  718. Please see the manual entry for more information on this
  719. command.
  720. .in 0
  721. .ne 5
  722. .hn 1 Credits and So on
  723. This mailer has been evolving over the past few years with
  724. invaluable comments on the interface and general mail
  725. issues from the following people;
  726. Jim Davis, Steve Wolf (or should that say Steve!! Wolf!!!! perhaps?),
  727. Larry Fenske, Rob Sartin,
  728. John Dilley and Carl Dierschow.
  729. For the Berkeley implementation, lots of help came from
  730. both John Lebovitz and Ken Stone.
  731. For the Amdahl/UTS implementation, thanks to Scott McGregor and
  732. Stan Isaacs.
  733. For the Sun problems, Dave England in Lancaster (UK) turned out to be
  734. ``bloody useful'', as he would no doubt say.
  735. The Pyramid version is due to the work of Steve Malone
  736. of the University of Washington.
  737. A number of other people have been amazingly disciplined at reporting
  738. problems and (usually, much to my relief) indicating the fixes needed,
  739. especially Guy Hillyer, Bruce Townsend and Eric Negaard.
  740. There have been many, many others, too numerous to mention, that
  741. have inspired me with questions like "Why can't Elm..." or
  742. "Why does it ..." or "Can we make it..." too.  A loud round of
  743. applause and an enthusiastic THANK YOU to you all!!
  744. Also helpful was the ability to have my `own' machine to
  745. close up the many many iterative loops that this software
  746. has gone through \(em since being on a big multi-user machine
  747. tends to slow it down to a standstill...
  748. For that, I thank Hewlett-Packard Colorado Networks Division for their
  749. initial support, and now HP Laboratories for the wonderful working
  750. environment that I have here (more than any one person is safe having,
  751. I suspect).
  752. Mailers that have influenced the design and implementation of \f3Elm\f1,
  753. for better or worse, include the following;
  754. .lp \h'4p'\f2/bin/mail\f1 1.0i
  755. The most basic of mailers, this one was simply the example of how \f2not\f1
  756. to force the user to interact with a program.
  757. .lp "\h'4p'\f2Berkeley Mail\f1" 1.0i
  758. A surprisingly sophisticated mailer, especially the version with 4.3 BSD,
  759. \f2Berkeley Mail\f1 still suffers from the tendency to force the user to
  760. know too much about the system, and also lacks a friendly, non-cryptic
  761. interface for the large subset of the population that use Unix but aren't
  762. interested in becoming a ``hacker''.
  763. .lp \h'4p'\f2MH\f1 1.0i
  764. This is another nifty mailer.  The main difference between this and the
  765. other mailers about is that it is a discrete set of programs rather than
  766. a single unified interface.  This is quite useful for those people that
  767. receive \f2lots\f1 of mail and are willing to spend some time learning
  768. the intricacies of the program.  It's quite powerful, but again, misses some
  769. of the basic friendly features the majority of users are interested in.
  770. .lp \h'4p'\f2dmail\f1 1.0i
  771. A sort of mutated cross between \f2MH\f1 and \f2Berkeley Mail\f1, it was
  772. this program that convinced me to implement the \f2Limit\f1 functions.
  773. .lp \h'4p'\f2NMail\f1 1.0i
  774. (a part of the HP AI Workstation Software Environment).  This program hints
  775. at the power that mailers could be given to help deal with mail in a quick
  776. and intelligent fashion.  Most of what it can do, and a lot more, are
  777. therefore part of \f3Elm\f1.  Indubitably.  And quite faster too!
  778. .lp \h'4p'\f2PMX/TERM\f1 1.0i
  779. Part of the AT&T Mail package, a single glance at this interface convinced
  780. me that a PC interface, with almost half of the screen taken up by a silly
  781. function key mapping, is most certainly \f2not\f1 the way to do things!!
  782. On the other hand, it also shows that the \f2Forms\f1 mode can be quite
  783. nicely integrated into a more sophisticated mailer.
  784. .lp \h'4p'\f2fmail\f1 1.0i
  785. A nickel addition to the \f2/bin/mail\f1 program to add some rudimentary
  786. screen interface stuff, this nonetheless interesting mailer is part of
  787. the AT&T Toolchest.
  788. .lp \h'4p'\f2Laurel\f1 1.0i
  789. A program only available within Xerox PARC, this was an interesting
  790. early attempt at a graphics based full-screen mail program.  The one,
  791. perhaps trivial, part of the interface I really like was the fact that
  792. it would \f2cross out\f1 a message that was marked for deletion.  One
  793. day when we get real graphics and the ability to use them indicated in
  794. a facility (not too) like \f2termcap\f1, perhaps \f3Elm\f1 will do
  795. this too!
  796. .lp \h'4p'\f2Mailtool\f1 1.0i
  797. Part of the Sun distribution package, this program is a really nice
  798. example of what can be done by putting a smart shell on top of a dumb
  799. program \(em it uses \f2/bin/mail\f1 for all the `dirty work'.  Other than
  800. that, it's not a particularly interesting interface or mailer, and it
  801. certainly doesn't add much functionality!
  802. .lp \h'4p'\f2Metamail\f1 1.0i
  803. What can I say?  This isn't even a real mailer, but is just what I dream
  804. of as an interface to mail in the future.  A program that works sort of
  805. like \f3HAL\f1 did in \f22001: A Space Odyssey\f1 \(em where it interrupts
  806. me as appropriate for important mail, and can answer inane and other
  807. queries itself according to what I teach it.  Maybe \f3Elm\f1, by some sort
  808. of groupmind metamorphosis, will change into that someday.  Maybe not.  Maybe
  809. no-one bothers to read this far into the document!!
  810. .in 0
  811. Finally, it's also been a very useful experience overall,
  812. confirming my beliefs that iterative software design and
  813. keeping a close watch on users (not to mention an open
  814. mind and mailbox!) improves a product manyfold.  Comments,
  815. feedback and bug reports (and fixes!) are, of course, always welcome!
  816. .ne 5
  817. .hn 1 "Credits and So on Part II - The Usenet Elm Development Group"
  818. As coordinator of the Elm Development Group, I must add to the credits.
  819. This group of volunteers has taken the Elm code from Dave Taylor and
  820. added features, made it more robust, and more portable.
  821. For getting the Usenet Elm group going, for without which I wouldn't be
  822. writing this, thanks to Greg Hackney at Southwestern Bell Telephone Co.
  823. For the Configuration system and its newer Dist 2.0 version, thanks are
  824. due to Larry Wall of JPL-NASA.
  825. For his over two hundred sets of changes to version 2.2, Elm owes a lot
  826. to Rob Bernardo at Pacbell.
  827. The ability to run Elm at all on Intel 286 machines owes a lot to the
  828. insistent nudging of the coordinator by Chip Salzenberg,
  829. Chip Rosenthal, and Tim Evans.
  830. For getting us the rights to use the news macros and converting all
  831. the documentation over to those macros, thanks to Mike Brown.
  832. Now, before I get accused of leaving someone out, here are the
  833. members of the Elm Development and the Elm Testing Group:
  834. Jonathan Bayer,
  835. Rob Bernardo,
  836. Doug Blair,
  837. Kevin Bond,
  838. Mike Brown,
  839. Ed Clarke,
  840. Steven Donegan,
  841. Paul Ebersman,
  842. Avi Feldblum,
  843. Steven Goodman,
  844. Greg Hackney,
  845. Mark Hahn,
  846. Mitch Hamilton,
  847. Ed Hann,
  848. David Hawkins,
  849. Nate Hess,
  850. Phil Hochstetler,
  851. Bud Hovell,
  852. Kenneth Ingham,
  853. Chad Larson,
  854. Warren Lavallee,
  855. Howard Leadman,
  856. John A. Limpert,
  857. Andy Linton,
  858. Darrell McIntosh,
  859. Datta Miruke,
  860. Paul M. Moriarty,
  861. Andrew Mossberg,
  862. Robert B. Nelson,
  863. Leo C. Noordhuizen,
  864. Brian O'Neill,
  865. Fairfax O'Riley,
  866. Pete Phillips,
  867. Dave Rasmussen,
  868. Len Rose,
  869. Chip Rosenthal,
  870. Chip Salzenberg,
  871. Ray Smith,
  872. Gary Trujillo,
  873. Ed Wells,
  874. Mike Whitman,
  875. Dave Yearke,
  876. Jon Zeeff,
  877. Syd Weinstein, Elm Coordinator.
  878.