home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / com / utils / elm / readmsg.man < prev    next >
Text File  |  1992-03-28  |  4KB  |  115 lines
  1. NAME
  2.      readmsg - read messages from incoming mail
  3.  
  4. SYNOPSIS
  5.      readmsg [-p] [-n] [-f filename] [-h]
  6.      readmsg [-p] [-n] [-f filename] [-h] number [number ...]
  7.      readmsg [-p] [-n] [-f filename] [-h] pattern
  8.  
  9. DESCRIPTION
  10.      Readmsg is a program that gives the elm user  the  functionality  of  the
  11.      mailx  "~r"  command  from  the  editor of their choice.  There are three
  12.      different ways of using the program;
  13.  
  14.      First off, if you're actually creating a reply to a message  from  within
  15.      the  elm system then readmsg without any arguments will include a summary
  16.      of the headers and the body of the message  being  replied  to.   If  you
  17.      aren't currently editing a message the program will return an error.
  18.  
  19.      Secondly, if you want to include certain messages, you can  specify  them
  20.      by  listing  their  ordinal  locations  in  the mail file (that is, their
  21.      "message numbers") up to 25 at a time.  The meta-number '$' is understood
  22.      to  mean  the last message in the mailfile.  Similarly, '*' is understood
  23.      to represent every message in the file (that is, 1-$)
  24.  
  25.      Finally, you can also specify  a  pattern  that  occurs  in  one  of  the
  26.      messages as a way of including it.  This pattern can be typed in directly
  27.      (no quotes) if the words are separated by a single space  in  the  actual
  28.      message.   The pattern matching is case sensitive, so "Hello" and "hello"
  29.      are NOT the same thing!!
  30.  
  31.  
  32.      The -f flag indicates that you'd rather use the file  specified  for  the
  33.      operations specified rather than the default mailbox.
  34.  
  35.      The -h flag instructs the program to include the  entire  header  of  the
  36.      matched  message  or messages when displaying their text.  (default is to
  37.      display the From: Date: and Subject: lines only)
  38.  
  39.      The -n flag instructs the program to exclude all headers.  This  is  used
  40.      mostly for extracting files mailed and such.
  41.  
  42.      Finally, the -p flag indicates that the  program  should  put  form-feeds
  43.      (control-L) between message headers.
  44.  
  45.  
  46. EXAMPLES
  47.      First off, to use this from within vi to include the text of the  current
  48.      message, you could use the command:
  49.  
  50.           :r !readmsg
  51.  
  52.      (as you hit the ':' the editor will put you at the bottom of  the  screen
  53.      with the ':' prompt).  The space following ':r' is required.
  54.  
  55.  
  56.      Let's look at something more interesting, however;
  57.  
  58.      Suppose you have the mailfile;
  59.  
  60.         From joe Jun 3 1986 4:45:30 MST
  61.         Subject: hello
  62.  
  63.         Hey Guy!  Wanta go out and have a milk this evening?
  64.  
  65.         Joe
  66.  
  67.         From john Jun 3 1986 4:48:20 MST
  68.         Subject: Dinner at Eight
  69.         From: John Dinley <xyz!john>
  70.  
  71.         Remember you should show up about eight, okay?
  72.  
  73.                  - John D -
  74.  
  75.         From xxzyz!cron Jun 3 1986 5:02:43 MST
  76.  
  77.         Cannot connect to server: blob
  78.         Job 43243 deleted from queue.
  79.  
  80.      The following commands will result in;
  81.  
  82.        $ readmsg 2
  83.        [ display the second message, from John ]
  84.  
  85.        $ readmsg
  86.        [ an error, unless we're calling from elm ]
  87.  
  88.        $ readmsg BLOB
  89.        [ no match - case sensitive! ]
  90.  
  91.        $ readmsg -h connect to server
  92.        [ displays third message, including headers ]
  93.  
  94.  
  95. FILES
  96.      /usr/mail/<username> The incoming mail
  97.      $HOME/.readmsg The temp file from elm
  98.  
  99. AUTHOR
  100.      Dave Taylor, Hewlett-Packard Laboratories
  101.  
  102. SEE ALSO
  103.      newmail(1L), elm(1L)
  104.  
  105. BUGS
  106.      The '*' metacharacter doesn't always work as expected!
  107.      Perhaps the pattern matching should be case insensitive?
  108.  
  109. BUG REPORTS TO
  110.      Syd Weinstein elm@DSI.COM (dsinc!elm)
  111.  
  112. COPYRIGHTS
  113.      (c) Copyright 1986, 1987 by Dave Taylor
  114.      (c) Copyright 1988, 1989, 1990 by The USENET Community Trust
  115.