View/Edit #87!@read

<help>
  <usage>@read
    <param type='required'>message-number</param> <param type='optional'>on *<param type='required'>collection</param></param>
  </usage>
  <usage>@read</usage>
  <usage>@peek
    <param type='required'>message-number</param> <param type='optional'>on *<param type='required'>collection</param></param>
  </usage>
<text>
<p>Prints the contents of the indiciated messages from your MOO email collection.  You get the message numbers for use here by typing the '@mail' command, which prints a table of contents for your entire MOO email collection.  If no arguments are given to @read, then the 'current message' in your collection is printed.  In any case, the 'current message' after @read finishes is the last one printed.</p>

<p>The message-number arguments for @read and @peek can be replaced with <link target='message-sequences'/> to read multiple messages at once.</p>

<p>As with the @mail command you may @read messages on any publically readable collection (child of $newsgroup).</p>

<p>The @peek command is a variant of @read that works no differently except that it refrains from setting your 'current message'.  This is useful, for example, if you want to see some particular message on a collection without losing track of where you are in it.</p>
</text>
</help>