home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / mm / mm-manual-mss.tar.Z / mm-manual-mss.tar / mm-manual / 03-messseq-ps.mss < prev    next >
Text File  |  1991-01-04  |  7KB  |  193 lines
  1. @part<three,root="mm.mss">
  2. @begin(text)
  3. @Chapter(Message Sequences)@tag<messseq>
  4.  
  5. @Section(Message Sequences)
  6. @blankspace<1 line>
  7.  
  8. When you are working in @b(read mode) or @b(send mode), any command
  9. you enter will apply either to the message you are reading or to the
  10. outgoing message.  At @b(top level), however, commands can apply to
  11. any or all of the messages in your mailbox.  You may, for example,
  12. want to read all messages from a particular person about a certain
  13. subject.  Or perhaps you'd like to delete any message about a meeting
  14. or class once the event has passed.  Message sequences make this
  15. possible.
  16.  
  17. A message sequence is a word or phrase that describes some group of
  18. messages that have a particular trait in common.
  19.  
  20. The simplest form is a number or range of numbers.  For example,
  21. messages 5 through 10 can be specified as follows:@ @ @ @ @ 5:10@ @ @
  22. @ @ 5-10@ @ @ @ @ 5,6,7,8,9,10@ @ @ @ @ 5+6
  23.  
  24. Asterisk (*) means the last message, the highest-numbered message.
  25.  
  26. There are many other message sequences, listed below.  Some require a
  27. value as suggested in <> brackets.  Type @i<help message-sequence> to
  28. list them online.
  29.  
  30. @section(Description of Message Sequences)
  31. @blankspace(1 line)
  32. @end(text)
  33. @begin(text2, columnbalance=on)
  34.  
  35. @begin(itemize) 
  36.  
  37. AFTER <date>: all messages sent or received after a certain date or
  38. day, as @i(after April 1, 1989) or @i(after Tuesday).  A time can be
  39. specified after the date or day, as @i<after Tuesday 1:00pm>.
  40.  
  41. ALL: every message in your file, including any marked for deletion,
  42. from oldest to newest.  See also INVERSE.
  43.  
  44. ANSWERED: messages you have @i<reply>'d to or @i<answer>ed.
  45.  
  46. BEFORE <date>: all messages sent or received before a certain date or
  47. day.  See AFTER.
  48.  
  49. CURRENT: the message MM is pointing at, for example, the last one
  50. @i(read).  Also abbreviated as period (@.).
  51.  
  52. DELETED: messages that have been marked for deletion with the
  53. @i<delete> command, or moved using the @i<move> command.  On a
  54. subsequent @i<expunge> or @i<exit> command, the deleted messages will
  55. be physically removed from your mail file and gone forever.
  56.  
  57. FLAGGED: messages marked by the @i(flag) command.
  58.  
  59. FROM <user>: messages from a person.  It searches both the user ID and
  60. the name in the @i(from) field, so note, for example, that @i(from
  61. sue) matches the user ID @i(sue) but also anyone else named Sue.  Be
  62. careful when deleting @i(from) a name.
  63.  
  64. INVERSE: all messages, like ALL, but in inverse order (most recent
  65. message first).
  66.  
  67. KEYWORD <keyword-name>: messages marked by the @i(keyword) command.
  68. You can define keywords to mark groups of messages by a keyword name.
  69. Whenever you want to refer to the messages marked with a certain
  70. keyword, you type a two word sequence: @i[keyword <keyword-name>].
  71.  
  72. LAST: the last message.  Also abbreviated as asterisk (*).
  73.  
  74. LAST <number>: the last @i(n) messages.
  75.  
  76. LONGER <number>: all messages containing more than, or exactly, a
  77. certain number of characters.
  78.  
  79. NEW: messages that are both @i<recent> and @i<unseen>.  Generally this
  80. is a message that has arrived while you were away from the computer,
  81. or perhaps one that has just arrived while you were working.
  82.  
  83. ON <date>: messages sent or received on a certain date or day.  See
  84. AFTER.
  85.  
  86. PREVIOUS SEQUENCE: the last message sequence used in an MM command.
  87. You might preview a sequence by typing something like @i<headers
  88. <message sequence>>, and then, if it is what you want, type @i<read
  89. previous sequence> rather than retyping the same message sequence
  90. again.
  91.  
  92. RECENT: messages that are new as of this session with MM.  If you have
  93. 5 new messages when you log in, then they would all be marked
  94. @i<recent> until you've ended your session with MM.
  95.  
  96. SEEN: messages you have already looked at.  Most likely all or nearly
  97. all the messages in your mailbox are considered @i<seen> since you
  98. usually read any @i(unseen) ones when you start MM.  A message that is
  99. marked @i<seen> will not have a U or N next to its header.
  100.  
  101. SHORTER <number>: all messages containing fewer than a certain number
  102. of characters.
  103.  
  104. SINCE <date>: messages sent or received on or after a certain date or
  105. day.  See AFTER.  Unlike @i<after>, @i<since> includes the date
  106. specified.
  107.  
  108. SUBJECT <word>: all messages that have a certain word (or part of a
  109. word) in their subject field.  For example, to see messages that have
  110. "computer" in the subject, use @i<subject computer>.  
  111.  
  112. TEXT <word>: all messages that have a certain word (or part of a word)
  113. in their text.  For example, the word "computer" might not be in the
  114. subject field of some messages, but you can reference all messages
  115. that mention "computer" in their text by @i<text computer>.  You might
  116. try part of the word instead, like @i<text comput>, to include
  117. "computing", "compute", etc as well.
  118.  
  119. TO <user>: all messages that were sent to a user, including carbon
  120. copies, but not blind carbon copies (the "cc" but not "bcc" header
  121. fields).  Most of the messages in your mailbox are @i<to> yourself,
  122. but you may have some @i<to> other people that are cc'd to yourself,
  123. and some that were @i<to> other people besides yourself.
  124.  
  125. UNANSWERED: messages you did not @i<reply> to or @i(answer).
  126.  
  127. UNDELETED: messages that haven't been deleted via the @i<delete> or
  128. @i<move> commands.
  129.  
  130. UNFLAGGED: messages not @i<flag>ged.
  131.  
  132. UNKEYWORD <keyword-name>: messages not included in the keyword.
  133.  
  134. UNSEEN: messages that were never @i<type>d or @i<read>.
  135.  
  136. @end(itemize)
  137. @end(text2)
  138.  
  139. @begin(text)
  140. @Section[Message Sequence examples]
  141. @end(text)
  142. @begin(text2, columnbalance=on)
  143.  
  144. Here are some simple examples of commands using message sequences.
  145. You may also use several in one command to further specify the desired
  146. messages.
  147.  
  148. This would put you into @b<read mode> and would let you read all the
  149. @i[flag]ged messages:
  150.  
  151. @begin(example)
  152. MM>@p(read flagged <cr>)
  153. @end(example)
  154.  
  155. This would read all the messages from hmh:
  156.  
  157. @begin(example) 
  158. MM>@p(read from hmh <cr>)
  159. @end(example)
  160.  
  161. This would read messages 3 through 8 individually:
  162.  
  163. @begin(example)
  164. MM>@p(read 3:8 <cr>)
  165. @end(example)
  166.  
  167. This would display the header lines of all the messages that are
  168. unanswered from hmh (note that two message sequences are combined,
  169. @i<from> and @i<unanswered>):
  170.  
  171. @begin(example)
  172. MM>@p(hea from hmh unanswered <cr>)
  173. @end(example)
  174.  
  175. This command marks for deletion all messages from 5 through 15 that
  176. contain the string "deadline" in the text of the message:
  177.  
  178. @begin(example)
  179. MM>@p(delete 5:15 text deadline <cr>)
  180. @end(example)
  181.  
  182. This would display the header lines of all messages you have received
  183. since (and including) Monday:
  184.  
  185. @begin(example)
  186. MM>@p(headers since Monday <cr>)
  187. @end(example)
  188.  
  189. @end<text2>
  190.  
  191.  
  192.  
  193.