Added docs/historical/. See README for where they were found.
[mmh] / docs / historical / mh4mm.txt
1
2
3
4
5                                    MH  for  MM  Users
6
7
8
9                             Mary  Hegardt                           Tim  Morgan
10
11
12
13                                                April  12,  1990
14
15
16
17 1         Introduction
18
19
20
21 This document is another in a continuing series on use of the MH mail system
22
23 at  UCI.  It  is  intended  for  those  users  accustomed  to  the  mm  "user  agent"
24
25 (mail  program)  under  Tops-20  and  who  are  already  familiar  with  network
26
27 mail,  but  who  may  not  be  experienced  Unix  users.   For  an  introduction
28
29 to  MH,  see  "MH  For  Beginners"  by  Mary  Hegardt  and  Tim  Morgan.   For
30
31 complete, detailed information on the MH system, see The Rand MH Message
32
33 Handling System:  User's Manual  by Marshall T. Rose and John L. Romine.
34
35 Both documents are available for Xeroxing in suite CS408.
36
37
38
39 1.1         UNIX  Versus  Tops-20
40
41
42
43 The  Unix1  paradigm  is  that  each  command,  or  program,  should  perform
44
45 only  one  function.   An  extension  of  this  idea  is  that  the  operating  system
46
47 implements  only  those  functions  which  are  necessary,  but  it  does  so  in  a
48
49 very general way so that programs may still accomplish their functions.  This
50
51 philosophy  probably  evolved  because  the  original  versions  of  Unix  ran  on
52
53 PDP-11 minicomputers which had only a small memory space for each pro-
54
55 cess.
56 ________________________________________________
57     1 Unix is a trademark of AT&T Bell Laboratories
58
59
60
61                                                            1
62 \f
63
64
65
66 Consequently,  all  commands  in  Unix,  with  a  very  few  exceptions,  are  in
67
68 actuality  programs.  On  Tops-20,  in  contrast,  many  of  the  most  frequently
69
70 used  commands  are  built  into  the  user's  shell,  or  exec.  Both  the  Exec  and
71
72 csh,  which  is  typically  the  user's  command  interface  on  Unix,  will  accept
73
74 and parse command lines, attempting to invoke a command as a program if
75
76 it is not one of the built-in commands.  Unix and Tops-20 are surprisingly
77
78 similar internally:  the use of the shell, separate processes for each command
79
80 or  program  to  execute,  standard  input  and  output  for  each  program,  and
81
82 many  other  ideas  are  common  to  both  operating  systems.  Users  should  be
83
84 familiar with the capabilities of the shell, which is described in the document
85
86 "Introduction to the Csh."
87
88
89
90 1.2         The  MH  User  Interface
91
92
93
94 The  MH  mail  "user  agent"  is  different  from  most  other  mail  systems.  mm,
95
96 for example, is a monolithic  system because one program implements all the
97
98 mail-related  functions.   The  disadvantages  of  monolithic  systems  are  that
99
100 (a) they are large, so they tend to put more burden on the computer system,
101
102 and (b) they allow for much less flexibility.  In contrast, MH implements each
103
104 mail command as a separate program:  there is no single program called mh.
105
106 This  approach  facilitates  interspersing  mail  commands  with  other,  perhaps
107
108 unrelated, commands.
109
110
111 Another  unique  feature  of  MH  is  that  it  takes  advantage  of  the  facilities
112
113 provided  by  the  operating  system.  Most  mail  agents,  such  as  mm,  maintain
114
115 a file containing the user's mail in a special, usually undocumented, format.
116
117 When  a  message  is  deleted,  mm  must  take  care  of  compacting  the  mail  file.
118
119 It  must  be  able  to  distinguish  the  separate  messages  contained  in  the  file.
120
121 mm must also implement a simple text editor to allow the user to enter and
122
123 modify a message while it is being composed.  These functions are essentially
124
125 those provided by the operating system when separate files are stored within
126
127 a  directory.   Therefore,  the  approach  taken  by  MH  is  that  each  message  is
128
129 kept  in  a  separate  file.  This  file  simply  contains  the  message,  with  no  other
130
131 special  formatting  characters  or  requirements.   All  the  messages  are  stored
132
133 within  a  normal  Unix  directory.   This  approach  makes  it  easy  to  add  new
134
135 MH commands, to edit messages using standard text editors, etc.
136
137
138
139                                                            2
140 \f
141
142
143
144 All your MH related files are stored in a directory within your home directory.
145
146 Usually this directory is called Mail or mhbox, although you are free to name
147
148 it as you choose.  Another file in your home directory called .mh_profile is
149
150 equivalent  to  the  MM.INIT  file  under  mm.  It  contains  all  the  options  which
151
152 you  prefer  for  the  various  MH  commands.  It  also  contains  the  name  of  the
153
154 MH  directory  and  the  name  that  you  want  on  your  outgoing  mail  in  the
155
156 From:  field (your "signature ").
157
158
159
160 2         Getting  Started
161
162
163
164 2.1         Incorporating  Mail
165
166
167
168 Another important difference between mm and MH is the concept of the mail-
169
170 drop  file.  Under Tops-20, the mail transport system delivers new messages
171
172 directly into the recipient's MAIL.TXT file, where they may then be processed
173
174 with  mm.   In  contrast,  the  Unix  mail  transport  system,  called  MMDF-II,
175
176 makes  no  assumptions  about  the  user  agent  used  by  the  recipient.  Instead,
177
178 it puts all new mail into a special file called the maildrop.  This file is in the
179
180 /usr/spool/mail  directory.  When  you  log  in,  if  there  is  new  mail  for  you
181
182 in your maildrop, you will be so notified by the message
183
184
185                  You  have  new  ZOTnet  mail  --  type  inc  (or  mail)
186
187
188 When you are ready to process this new mail, you may type the command
189
190
191                  %  inc
192
193
194 ("incorporate") which will copy the new mail into separate files, one per mes-
195
196 sage, stored in your "inbox" folder.  A folder is a subdirectory beneath your
197
198 MH directory which is used to store related messages.  Additional information
199
200 on  folders  is  given  in  Section  4.5,  page  13.   The  "inbox"  is  a  distinguished
201
202 folder  because  by  default  inc  will  always  copy  new  mail  into  that  folder,
203
204 removing it from the maildrop.
205
206
207 If  this  is  the  first  time  you  have  used  inc  or  any  other  MH  command,  the
208
209 mh-install  program  will  inform  you  that  it  is  creating  your  Mail  directory.
210
211 It will also create the "inbox" folder directory, and .mh_profile.
212
213
214
215                                                            3
216 \f
217
218
219
220 2.2         Message  Numbers
221
222
223
224 As inc processes each message, it prints a "scan" listing showing the message
225
226 number, the date the message was sent, the name of the sender, the subject,
227
228 and  sometimes  the  initial  part  of  the  text  of  the  message.  A  "scan"  listing
229
230 is thus similar to the output of the HEADERS command in mm.  Each message
231
232 within  a  folder  is  given  a  number,  starting  with  1,  by  which  it  can  be  ref-
233
234 erenced.  Inc  will  display  the  numbers  assigned  to  each  new  message  in  its
235
236 "scan" listing.
237
238
239 As  in  mm,  there  is  a  "current  message"  number  which  usually  identifies  the
240
241 message most recently manipulated by the user.  With most MH commands,
242
243 this  will  be  the  default  message  if  no  messages  are  explicitly  specified  in
244
245 a  command.   Inc  makes  the  first  new  message  the  current  message,  which
246
247 is  indicated  by  a  "+"  character  in  the  scan  listing,  just  after  the  message
248
249 number.
250
251
252 Many  MH  commands  take  a  list  of  messages  to  process.   A  message  desig-
253
254 nation  is  either  a  single  message  number,  two  message  numbers  separated
255
256 by  a  dash.   The  dash  format  indicates  a  range  of  messages  including  the
257
258 endpoints.  A message list consists of one or more message designations sep-
259
260 arated by spaces.  For example, messages 11 through 15 and message 17 may
261
262 be indicated by typing
263
264
265                  11-15  17
266
267
268 as the argument to some command.  There are also several predefined names
269
270 for  messages  or  lists  of  messages  which  may  be  used  in  place  of  message
271
272 numbers:
273
274
275    cur          The  current  message  (the  last  one  that  was  handled).  Equivalent
276
277                 to "."  or "CURRENT" in mm.
278
279   next          The next message
280
281   prev          The previous message
282
283   first         The first message in the current folder.
284
285    last         The last message in the folder.  Equivalent to % or * in mm.
286
287      all        All messages (first  last ).  Same as in mm.
288
289
290 It  is  also  possible  for  you  to  define  your  own  named  sequences  of  messages.
291
292
293
294                                                            4
295 \f
296
297
298
299 See the pick  command description for more details.
300
301
302
303 3         Processing  Messages
304
305
306
307 This section contains a list of the common mm commands and their equiva-
308
309 lents in the in MH mail system.  A short textual note describes how the MH
310
311 commands differ from their mm counterparts.
312
313
314
315 3.1         Listing  Messages
316
317
318
319 As mentioned in Section 2.2, the scan  command may be used to summarize
320
321 the  messages  in  a  folder,  similar  to  the  HEADERS  command  in  mm.   Unlike
322
323 most MH commands, however, scan defaults to all the messages in the current
324
325 folder unless you specify one or messages on the command line to be scanned.
326
327 So simply typing
328
329
330                  %  scan
331
332
333 is equivalent to typing HEADERS  ALL (or H  A) in mm.
334
335
336
337 3.2         Reading  Mail
338
339
340
341 Unlike  the  READ  command  in  mm,  in  MH  there  is  no  special  mail-reading
342
343 mode (indicated in mm by the R> prompt).  The command to read messages
344
345 in  MH  is  show.   If  no  message  list  is  specified,  then  the  current  message
346
347 is  displayed.  The  message  is  displayed  by  your  "showproc",  as  specified  in
348
349 the  .mh_profile,  described  in  Section  4.2.  Normally,  your  "showproc"  will
350
351 be  more  or  mhless.  Both  of  these  programs__will__display_ your  messages  one
352
353 screenful  at  a  time.   You  press  the  __space_bar______ __on  your  terminal  to  see  the
354                        ____________
355 next screenful, or the __return____ _key to see the next line.
356
357
358 The command
359
360
361                  %  show  next
362
363
364
365                                                            5
366 \f
367
368
369
370 (which  will  display  the  first  message  following  the  current  message  in  the
371
372 current folder) can be abbreviated as simply
373
374
375                  %  next
376
377
378 Similarly, the command "show  prev" can be abbreviated as simply "prev".
379
380
381 To get a paper copy of a mail message, take the output from the show  com-
382
383 mand and pipe it into the imprint  command.
384
385
386                  %  show  5  _  imprint
387
388
389 See the manual page for imprint  for more information.
390
391
392
393 3.3         Deleting  Messages
394
395
396
397 The equivalent of the DELETE command in mm is rmm  in MH (remove mes-
398
399 sages).  It  acts  on  the  current  message  unless  messages  are  specified  on  the
400
401 command  line.  Unlike  mm,  the  deleted  messages  will  no  longer  show  up  in
402
403 a  "scan"  listing.   But  the  messages  are  not  completely  removed;  they  are
404
405 renamed to have a comma prepended to the name of the file containing the
406
407 message within its folder directory.  Therefore, if you need to recover a mes-
408
409 sage,  it  is  possible  to  go  into  the  directory  and  rename  the  message  back.
410
411 Be careful in doing this not to overwrite a new message with the same mes-
412
413 sage  number!  It  is  a  Unix  convention  that  files  whose  names  begin  with  a
414
415 comma will be removed from disk (expunged ) early each morning.  Therefore,
416
417 your deleted messages will be available for the rest of the day, unless you re-
418
419 move another message subsequently which has the same message.  Then the
420
421 previously deleted message is gone.
422
423
424
425 3.4         Replying  to  Mail
426
427
428
429 The  equivalent  of  the  REPLY  command  in  mm  is  repl  in  MH.  Repl  may  be
430
431 given the number of the message to which you wish to reply, or it will default
432
433 to  the  current  message.   When  replying  in  mm,  you  are  prompted  asking
434
435 if  you  wish  to  reply  to  all  the  recipients  of  the  message  to  which  you  are
436
437 replying, or only to its sender.  In MH, normally the reply will be constructed
438
439
440
441                                                            6
442 \f
443
444
445
446 to be sent to all the recipients.  You may select which recipients receive copies
447
448 of  your  reply  by  using  the  -query  option  on  repl,  or  by  putting  this  option
449
450 in  your  .mh_profile,  as  described  in  Section  4.2.  If  you  wish  a  reply  to  go
451
452 to everyone but yourself, you can use repl  -nocc  me.
453
454
455
456 3.5         Sending  Mail
457
458
459
460 The equivalent of the SEND mm command is comp ("compose") in MH. These
461
462 two  commands  are  fairly  similar,  except  that  the  recipient  of  the  message
463
464 cannot be specified on the comp  command line.  The comp  program invokes
465
466 a simple editor called prompter  which will prompt you for the To:, Cc:, and
467
468 Subject:   fields  of  the  message.   Then  a  line  of  dashes  is  typed,  and  you
469
470 may  enter  the__body__of  your  message  (its  text,__in__mm_ terms).  When  you  are
471
472 finished, type __ctrl__-__D (equivalent to typing __ESC_______or control-Z in mm).  Then
473
474 you'll receive the prompt
475
476
477                  What  now?
478
479
480 which  is  similar  to  mm's  S>  prompt.  You  may  receive  a  list__of__the_ options
481
482 that  you  have  at  this  point  by  typing  "?"   followed  by  __return____._  Here  is  a
483
484 short  list  of  the  options  and  their  meanings.  Notice  that,  unlike  mm,  there
485
486 are very few commands to modify the message (such as the TEXT, TO, CC, etc.,
487
488 commands which may be typed at the S> prompt in mm).  In place of these
489
490 commands,  you  use  the  edit  command  to  invoke  your  favorite  text  editor
491
492 on the message, and you use it to make the equivalent changes.  You also use
493
494 your  editor  to  include  other  files  into  the  body  of  the  message,  rather  than
495
496 using  control-B,  as  in  mm.  One  additional  use  of  the  edit  command  is  for
497
498 spelling checking.  In mm, you may use the command SPELL for this purpose.
499
500 In MH, you type "edit  spell"2  instead.  This will cause the spelling checker
501
502 to be run, giving you a list of the possibly misspelled words in your message.
503
504
505
506      edit  editor              Edit  the  message  using  the  specified  editor.   When  you
507
508                                exit, you will be back at What  now?.
509 ________________________________________________
510     2 Actually, any program named after the "edit" command will be invoked with what-
511
512 ever  arguments  you  have  given  and  a  path  to  the  file  containing  the  message  you  are
513 editing.
514
515
516
517                                                            7
518 \f
519
520
521
522                 list           Shows the message you just typed
523
524
525    whom  -check                Verifies that the addresses you have used are valid as far
526
527                                as our system can tell
528
529
530                 send           Sends the message to the recipients
531
532
533                 push           Sends the message in the background
534
535
536                 quit           Quits  without  sending  the  message.   Saves  the  text  of
537
538                                the  message  as  a  "draft".  Type  comp  -use  to  get  back
539
540                                to that draft later.
541
542
543  quit  -delete                 Quit, throwing away the draft
544
545
546
547 3.6         Forwarding  Mail
548
549
550
551 The  forw  command  is  used  in  MH  to  forward  messages.   It  will  take  a  list
552
553 of  messages  on  the  command  line  to  be  forwarded,  or  it  will  default  to  the
554
555 current  message  if  none  are  specified.   It  will  prompt  you  like  comp  does
556
557 for  the  To:,  Cc:,  and  Subject:  fields.    Note  that,  unlike  mm's  FORWARD
558
559 command, forw  will not construct a subject line automatically.  Also as with
560
561 comp, you will have the opportunity to add additional text to the message(s)
562
563 which you are forwarding, ended with a control-D.
564
565
566
567 3.7         Resending  Mail
568
569
570
571 The  equivalent  of  the  RESEND  command  in  mm  is  the  dist  ("distribute")
572
573 command  in  MH.  Dist  works  very  much  like  the  forw  command,  except
574
575 that  the  prompts  will  be  Resend-To:,  Resend-Cc:,  etc.  After  filling  in  the
576
577 headers,  a  line  of  dashes  is  typed  giving  the  impression  that  additional  text
578
579 can be entered.  Nothing could be further from the truth; if you add any text
580
581 at  this  point  the  dist  will  fail.  Your  only  opportunity  to  add  text  is  in  the
582
583 Resend-Note:  field.
584
585
586
587                                                            8
588 \f
589
590
591
592 4         Advanced  Topics
593
594
595
596 4.1         Selecting  Messages
597
598
599
600 In  mm,  you  may  use  several  reserved  command  words  to  select  messages
601
602 in  place  of  an  explicit  list  of  message  numbers.    For  example,  you  can
603
604 type  "DELETE  FROM  SMITH"  to  remove  all  the  messages  from  a  user  named
605
606 "Smith".   Rather  than  building  such  a  capability  into  each  MH  program
607
608 which  can  process  message  lists,  a  special  program  called  pick  is  used  in-
609
610 stead.   Just  as  there  are  predefined  sequences  of  messages,  such  as  "all",
611
612 "cur", etc., you may use pick  to define your own sequences.  Pick  is capable
613
614 of selecting messages from a folder based on the To:, From:, Subject:, Cc:,
615
616 or  Date:  fields,  or  by  searching  the  body  of  the  message.  The  patterns  to
617
618 be searched for may include full regular expressions (see the "man" page for
619
620 ed(1)  for more information) or simple strings.
621
622
623 Pick  may  be  used  in  one  of  two  ways.  First,  it  may  output  the  sequence  of
624
625 message  numbers  which  match  the  search  parameters.  Using  the  backquot-
626
627 ing  mechanism  of  the  shell,  these  message  numbers  may  then  become  the
628
629 arguments to other MH programs.  The second way to use pick  is to have it
630
631 define a new sequence name which will be the messages which were selected.
632
633 Only  this  second  method  of  using  pick  will  be  described  here;  see  pick(l)  if
634
635 you wish to use the first method.
636
637
638 In your .mh_profile, add the line
639
640
641                  pick:    -seq  sel
642
643
644 Then  each  time  you  use  the  pick  command,  it  will  define  the  resulting  se-
645
646 quence of messages to be called "sel".  Then to "pick" all the messages in the
647
648 current folder which are from "Smith", just type
649
650
651                  %  pick  -from  smith
652
653
654 To see a summary of those messages, type
655
656
657                  %  scan  sel
658
659
660 Then to the remove the messages, type the command
661
662
663
664                                                            9
665 \f
666
667
668
669                  %  rmm  sel
670
671
672 You  can  pick  messages  according  to  any  of  the  headers  (-to  -from  -subj
673
674 -cc  or  -date) or just search all the messages for a given word (-search).
675
676
677
678 4.2         Customizing  Your  Mail  Environment
679
680
681
682 In  mm,  you  use  the  PROFILE  command  to  tailor  your  mail  environment.
683
684 This  command  writes  a  file  called  MM.INIT  in  your  home  directory  which
685
686 is  then  read  by  subsequent  executions  of  mm.   In  the  MH  system,  the  file
687
688 .mh_profile  serves  the  same  purpose.   It  is  edited  with  any  normal  text
689
690 editor,  rather  than  using  a  special-purpose  command  to  modify  it.    The
691
692 format of the file is line oriented, one line per MH program or MH option to
693
694 be  set.  The  only  required  line  in  the  profile  is  the  name  of  the  primary  MH
695
696 mail directory, which is by default Mail.  This information is specified by the
697
698 line
699
700
701                  Path:    Mail
702
703
704 The  textual  name  you  would  like  to  have  on  your  outgoing  mail  is  specified
705
706 by the Signature:  line.  For example,
707
708
709                  Signature:    Mary  Hegardt
710
711
712 The BBoards which you like to read should also be listed in the .mh_profile
713
714 (see  Section  4.6,  page  14,  for  additional  information).   For  example,  if  you
715
716 read the "system" BBoard (where all important announcements are posted),
717
718 as well as "whimsey" and "imagen-users" BBoards, your .mh_profile should
719
720 contain the line
721
722
723                  bboards:    system  whimsey  imagen-users
724
725
726 Other options may be specified on a per-program basis.  The format for these
727
728 lines is the same.  First, the program name is given followed by a colon.  Then
729
730 any flags which are to be the default options for that program are given.  Here
731
732 is a short list of the most common options which you may want to set in your
733
734 .mh_profile:
735
736
737                  showproc:    mhless
738
739
740
741                                                            10
742 \f
743
744
745
746 The  showproc  is  the  program  used  to  show  messages  to  you.  By  default,  it
747
748 is the more  command.  Mhless  is the same as more  except that it omits the
749
750 headers of the messages which you indicate that you wish not to see.  Type
751
752
753                  %  man  mhless
754
755
756 for more information about this program.
757
758
759                  msh:    -scan
760
761
762 Selecting this option causes an automatic scan of new messages on BBoards to
763
764 be made when reading BBoards with bbc, similar to the scan listing produced
765
766 by inc.
767
768
769                  repl:    -query
770
771
772 causes repl  to ask for each address in the message being replied to if it should
773
774 be included in the To:  or Cc:  fields of the reply being composed.
775
776
777                  pick:    -seq  sel
778
779
780 This  line  will  cause  messages  "picked"  by  the  pick  command  to  be  put  into
781
782 a  sequence  named  "sel".  This  sequence  name  may  then  be  used  just  as  the
783
784 built-in sequences ("last", "first", etc.).
785
786
787
788 4.3         Aliases
789
790
791
792 Using MH, you may specify your own private mail aliases.  This feature allows
793
794 you to store lists of addresses or long internet addresses of people with whom
795
796 you  frequently  correspond  in  one  file,  and  then  to  address  them  using  short
797
798 mnemonic names.  Typically, you will call your alias file "aliases";  it must
799
800 be  stored  in  your  MH  directory.  The  format  of  this  file  is  simple.  The  alias
801
802 is  given,  followed  by  a  colon,  followed  by  one  or  more  legal  mail  addresses
803
804 separated by commas.  For example, you might for some reason have an alias
805
806 for all the users named "Rose" in the ICS department:
807
808
809                  roses:    prose,  srose,  mrose,  drose
810
811
812 In addition to your "aliases" file, you will need to modify your .mh_profile
813
814 in  order  to  use  aliases.   You  should  add  the  flag  "-alias  aliases"  to  the
815
816
817
818                                                            11
819 \f
820
821
822
823 entries  for  the  commands  ali,  whom,  send,  and  push,  creating  entries  for
824
825 these  programs  if  they  aren't  already  in  your  .mh_profile.  Now,  messages
826
827 addressed to "roses" will be distributed to all the people listed in the alias.
828
829
830 The  ali  command  is  used  to  show  you  what  an  alias  expands  to.  You  just
831
832 type
833
834
835                  %  ali  alias
836
837
838 and ali  will respond with the expansion of the alias.  Ali  searches the system
839
840 aliases file in addition to your private ones.
841
842
843
844 4.4         Blind  Lists
845
846
847
848 There  are  two  different  types  of  so-called  "blind  addressing"  of  messages.
849
850 Users  of  mm  may  already  be  familiar  with  the  "Blind  Carbon  Copy",  or
851
852 BCC:  field.   It  allows  you  to  add  recipients  to  your  message  just  like  those
853
854 who are CC'd, but the normal recipients will not see that the BCC recipients
855
856 were copied on the message, their replies will not go to the blind recipients,
857
858 and the blind recipients cannot (easily) reply to the message.
859
860
861 The  second  type  of  blind  mailing  is  actually  called  a  "group  address  list",
862
863 although it is commonly referred to as a "blind list".  The format of this type
864
865 of address is
866
867
868                  phrase :    address__list ;
869
870
871 where  the  "phrase "  is  any  English  phrase  of  one  or  more  words,  and  the
872
873 address__list  consists  of  one  or  more  addresses  separated  by  commas.   The
874
875 recipients of a message addressed in this fashion will see simply
876
877
878                  phrase :    ;
879
880
881 so  when  they  reply  to  the  message,  their  reply  will  come  only  to  the  sender
882
883 (or  the  Reply-To:  field,  if  one  was  specified),  rather  than  going  to  all  the
884
885 recipients of the original list.  For example, to use a group address list for the
886
887 "roses" alias you would type:
888
889
890                  To:    People  Named  Rose:    roses;
891
892
893
894                                                            12
895 \f
896
897
898
899 This type of group address is very useful for making up lists of related people,
900
901 such as all the people working on a particular research project.
902
903
904
905 4.5         Folders
906
907
908
909 As  mentioned  previously,  folders  are  directories  within  your  MH  directory
910
911 used  to  store  related  messages.  There  is  no  equivalent  of  the  folder  concept
912
913 in the mm system.  Usually, you will use only the folder "inbox", so you won't
914
915 have to worry about folders.  However, if you process a large volume of mail,
916
917 then folders become invaluable in managing the messages which you wish to
918
919 keep for future reference.
920
921
922 Just as there is a "current message," MH maintains a "current folder," which
923
924 will  normally  be  "inbox".   You  can  change  folders  either  by  specifying  the
925
926 folder on the command line of MH programs which take a list of messages as
927
928 an argument, or by using the folder command:
929
930
931                  %  folder  +folder__name
932
933
934 In  general,  the  folder  name  is  indicated  by  a  "+"  sign  followed  immediately
935
936 by  the  folder  name,  all  preceeding  any  list  of  messages.   For  example,  you
937
938 may  read  the  most  recent  message  in  a  folder  called  "job__offers"  using  the
939
940 command
941
942
943                  %  show  +job__offers  last
944
945
946 This  command  will  have  the  side-effect  of  setting  the  current  folder  to  be
947
948 "job__offers".    You  may  move  messages  from  the  current  folder  into  the
949
950 "job__offers" folder using the command
951
952
953                  %  refile  +job__offers  messages
954
955
956 where, as usual, the messages  list will default to the current message in the
957
958 current  folder  if  none  are  specified.   Note  that,  in  contrast  with  the  show
959
960 command  and  most  other  MH  commands,  the  messages  are  not  considered
961
962 to be in the folder "job__offers".  You may obtain a summary of all your folders
963
964 by typing the command
965
966
967                  %  folders
968
969
970
971                                                            13
972 \f
973
974
975
976 When  you  remove  messages  from  a  folder  using  the  rmm  command,  the
977
978 deleted  messages  will  show  up  as  a  "hole"  in  the  message  numbering.  The
979
980 command
981
982
983                  %  folder  -pack
984
985
986 will cause all the messages within one folder to be renumbered starting with 1.
987
988 Similarly, the command
989
990
991                  %  folders  -pack
992
993
994 will do the same thing for all your folders.
995
996
997 To remove an empty folder, use the command
998
999
1000                  %  rmf  +folder
1001
1002
1003
1004 4.6         Reading  BBoards
1005
1006
1007
1008 Two  special-purpose  programs  are  utilized  in  reading  BBoards.  The  first  is
1009
1010 bbc,  which  is  used  to  check  a  list  of  BBoards  for  new  messages.  The  list  of
1011
1012 messages may be given on the command line, or if not, it will be taken from
1013
1014 the  BBoards:   list  in  your  .mh_profile.   You  may  obtain  a  list  of  all  the
1015
1016 available BBoards by typing the command
1017
1018
1019                  %  bbc  -topics
1020
1021
1022 For  each  BBoard  with  unseen  messages,  bbc  will  invoke  the  MH  shell,  msh,
1023
1024 whose prompt is
1025
1026
1027                  (msh)
1028
1029
1030 The msh  program allows you to read BBoard mail as if it were normal mes-
1031
1032 sages  in  one  of  your  folders.   Almost  all  the  MH  commands  will  work  just
1033
1034 as  the  normally  do.  Typing  the  command  "quit"  to  msh  causes  it  to  stop
1035
1036 reading  the  current  BBoard  and  go  on  to  the  next  one  containing  unseen
1037
1038 messages,  or  to  exit  if  there  are  no  more  such  BBoards.   Typing  control-D
1039
1040 causes  msh  to  exit  unconditionally.  The  command  mark  followed  by  a  mes-
1041
1042 sage  number  causes  msh  to  act  as  if  you  have  seen  that  message  and  all
1043
1044 previous ones.
1045
1046
1047
1048                                                            14
1049 \f
1050
1051
1052
1053 4.7         Checking  for  Mail
1054
1055
1056
1057 Under  Unix,  there  are  about  a  dozen  different  ways  to  check  for  new  mail.
1058
1059 The  easiest  way  to  do  it  is  to  set  the  csh  variable  named  "mail"  to  tell  csh
1060
1061 to check for new mail for you periodically.  To do this, add the line
1062
1063
1064                  set  mail=(60  /usr/spool/mail/$USER)
1065
1066
1067 to  your  .login  file  in  your  home  directory.   This  command  says  to  check
1068
1069 for  mail  if  csh  is  about  to  prompt  you  with  a  %  sign,  and  if  it  has  been  at
1070
1071 least 60 seconds since it last checked for mail.  The advantage of this method
1072
1073 of  mail  notification,  besides  simplicity,  is  that  you  will  never  be  interrupted
1074
1075 by  a  mail  notification.  You  will  only  be  notified  of  new  mail  when  you  are
1076
1077 between commands, when the shell is about to prompt you.
1078
1079
1080 If you desire asynchronous mail notification, which will print to your terminal
1081
1082 regardless of what you are currently doing, you may make use of a "Receive
1083
1084 Mail Hook" called "rcvtty".  To do this, create a file in your home directory
1085
1086 called ".maildelivery".  In this file, put the line
1087
1088
1089                  *  -  pipe  R  /usr/uci/lib/mh/rcvtty
1090
1091
1092 Then  each  time  new  mail  arrives,  you  will  receive  a  one-line  "scan"  listing
1093
1094 of  the  mail  if  your  terminal  is  world-writable.    For  more  information  on
1095
1096 "maildelivery" files, type:
1097
1098
1099                  %  man  5  maildelivery
1100
1101
1102
1103 4.8         Saving  Drafts
1104
1105
1106
1107 Normally  when  you  use  comp,  it  creates  the  message  being  composed  in  a
1108
1109 file  called  "draft"  in  your  MH  directory.   If  you  use  the  "quit"  option  at
1110
1111 the "What  now?"  prompt, this file will remain there.  You may later use the
1112
1113 command
1114
1115
1116                  %  comp  -use
1117
1118
1119 to resume composing the message.
1120
1121
1122
1123                                                            15
1124 \f
1125
1126
1127
1128 If you begin composing a new message and there is already a "draft" file,_you___
1129
1130 will  be  asked  for  the  disposition  of  this  file.  Typing  ?  __return____ _will  give  you
1131
1132 a list of the options at this point.  Normally you will either replace (delete)
1133
1134 the old draft and begin a new one or use the old one.
1135
1136
1137 The -file switch to comp  may be used to specify the name of a draft other
1138
1139 than "draft".  For example, one might type
1140
1141
1142                  %  comp  -file  mary
1143
1144
1145 to begin composing a message maintained in the draft file "mary".  Typing
1146
1147
1148                  %  comp  -file  mary  -use
1149
1150
1151 would cause comp  to resume composing this same draft after a "quit" com-
1152
1153 mand to the "What  now?"  prompt.
1154
1155
1156 Very  advanced  users  of  MH  maintain  multiple  draft  files  in  a  draft  folder.
1157
1158 This  is  a  normal  folder  which  holds  all  your  drafts,  rather  than  having  just
1159
1160 one draft in your MH directory named "draft".  If you feel that you need to
1161
1162 use  draft  folders,  you  should  consult  the  MH  User's  Manual  for  additional
1163
1164 information.
1165
1166
1167
1168                                                            16