


     RRRREEEEAAAADDDDMMMMSSSSGGGG((((1111LLLL)))) UUUUSSSSEEEENNNNEEEETTTT CCCCoooommmmmmmmuuuunnnniiiittttyyyy TTTTrrrruuuusssstttt ((((EEEEllllmmmm VVVVeeeerrrrssssiiiioooonnnn 2222....3333))))  RRRREEEEAAAADDDDMMMMSSSSGGGG((((1111LLLL))))



     NNNNAAAAMMMMEEEE
          readmsg - read messages from incoming mail

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
          rrrreeeeaaaaddddmmmmssssgggg [----pppp] [----nnnn] [----ffff ffffiiiilllleeeennnnaaaammmmeeee] [----hhhh]
          rrrreeeeaaaaddddmmmmssssgggg [----pppp] [----nnnn] [----ffff ffffiiiilllleeeennnnaaaammmmeeee] [----hhhh] number [number ...]
          rrrreeeeaaaaddddmmmmssssgggg [----pppp] [----nnnn] [----ffff ffffiiiilllleeeennnnaaaammmmeeee] [----hhhh] pattern

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
          _R_e_a_d_m_s_g is a program that gives the _e_l_m user the
          functionality of the mailx "~r" command from the editor of
          their choice.  There are three different ways of using the
          program;

          First off, if you're actually creating a reply to a message
          from within the _e_l_m system then _r_e_a_d_m_s_g without any
          arguments will include a summary of the headers and the body
          of the message being replied to.  If you aren't currently
          editing a message the program will return an error.

          Secondly, if you want to include certain messages, you can
          specify them by listing their ordinal locations in the mail
          file (that is, their "message numbers") up to 25 at a time.
          The _m_e_t_a-number '$' is understood to mean the last message
          in the mailfile.  Similarly, '*' is understood to represent
          every message in the file (that is, 1-$)

          Finally, you can also specify a pattern that occurs in one
          of the messages as a way of including it.  This pattern can
          be typed in directly (no quotes) if the words are separated
          by a single space in the actual message.  The pattern
          matching is case sensitive, so "Hello" and "hello" are NOT
          the same thing!!


          The ----ffff flag indicates that you'd rather use the file
          specified for the operations specified rather than the
          default mailbox.

          The ----hhhh flag instructs the program to include the entire
          header of the matched message or messages when displaying
          their text.  (default is to display the From: Date: and
          Subject: lines only)

          The ----nnnn flag instructs the program to exclude _a_l_l headers.
          This is used mostly for extracting files mailed and such.

          Finally, the ----pppp flag indicates that the program should put
          form-feeds (control-L) between message headers.


     EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS



     PPPPaaaaggggeeee 1111                                          ((((pppprrrriiiinnnntttteeeedddd 11110000////7777////99990000))))






     RRRREEEEAAAADDDDMMMMSSSSGGGG((((1111LLLL)))) UUUUSSSSEEEENNNNEEEETTTT CCCCoooommmmmmmmuuuunnnniiiittttyyyy TTTTrrrruuuusssstttt ((((EEEEllllmmmm VVVVeeeerrrrssssiiiioooonnnn 2222....3333))))  RRRREEEEAAAADDDDMMMMSSSSGGGG((((1111LLLL))))



          First off, to use this from within vvvviiii to include the text of
          the current message, you could use the command:

               :r !readmsg

          (as you hit the ':' the editor will put you at the bottom of
          the screen with the ':' prompt).  The space following ':r'
          is required.


          Let's look at something more interesting, however;

          Suppose you have the mailfile;

             From joe Jun 3 1986 4:45:30 MST
             Subject: hello

             Hey Guy!  Wanta go out and have a milk this evening?

             Joe

             From john Jun 3 1986 4:48:20 MST
             Subject: Dinner at Eight
             From: John Dinley <xyz!john>

             Remember you should show up about eight, okay?

                       - John D -

             From xxzyz!cron Jun 3 1986 5:02:43 MST

             Cannot connect to server: blob
             Job 43243 deleted from queue.

          The following commands will result in;

            $ readmsg 2
            [ display the second message, from John ]

            $ readmsg
            [ an error, unless we're calling from _e_l_m ]

            $ readmsg BLOB
            [ no match - case sensitive! ]

            $ readmsg -h connect to server
            [ displays third message, including headers ]


     FFFFIIIILLLLEEEESSSS
          /usr/mail/<username>          The incoming mail
          $HOME/.readmsg           The temp file from _e_l_m



     Page 2                                          (printed 10/7/90)






     RRRREEEEAAAADDDDMMMMSSSSGGGG((((1111LLLL)))) UUUUSSSSEEEENNNNEEEETTTT CCCCoooommmmmmmmuuuunnnniiiittttyyyy TTTTrrrruuuusssstttt ((((EEEEllllmmmm VVVVeeeerrrrssssiiiioooonnnn 2222....3333))))  RRRREEEEAAAADDDDMMMMSSSSGGGG((((1111LLLL))))



     AAAAUUUUTTTTHHHHOOOORRRR
          Dave Taylor, Hewlett-Packard Laboratories

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
          newmail(1L), elm(1L)

     BBBBUUUUGGGGSSSS
          The '*' metacharacter doesn't always work as expected!
          Perhaps the pattern matching should be case insensitive?

     BBBBUUUUGGGG RRRREEEEPPPPOOOORRRRTTTTSSSS TTTTOOOO
          Syd Weinstein  elm@DSI.COM    (dsinc!elm)

     CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTTSSSS
          Copyright 1986, 1987 by Dave Taylor
          Copyright 1988, 1989, 1990 by The USENET Community Trust







































     Page 3                                          (printed 10/7/90)



