Mail messages

From Elendor

Jump to: navigation, search
 Many commands in the +Mail system allow you to refer to one or more messages 
 to be acted upon. For example, the syntax for the +SKIM command (see HELP 
 +skim) is:
          +SKIM [@<altname>] [<bboard name>] [<messages>]
   
 Whenever you see "<messages>" or "<message>" in a command syntax, it means 
 that you can supply any of the following strings to describe which message 
 or messages you want to refer to:

 1) A message number.
    Example: +skim 1
      Shows information about message 1 in your mailbox.
    Example: +skim public 5
      Shows information about message 5 on the Public bulletin board.
    Example: +skim @Fred 7
      Shows info about the 7th message held by your alt, Fred.

 2) A range of messages of the form: [<message number>]-[<message number>]
    Example: +skim 5-10
      Shows information about messages 5, 6, 7, 8, 9, and 10 in your mailbox.
    Example: +skim -3
      Shows information about messages 1, 2, and 3.
    Example: +skim 10-
      Shows information about messages 10 and above in your mailbox.
    Example: +skim -
      Shows information about all the messages in your mailbox.

 3) A space-separated list of elements like (1) and (2) above.
    Example: +skim 1 6 2-4 10
      Shows information about messages 1, 6, 2, 3, 4, and 10 in your mailbox.

 4) A "search criteria" of one of the following forms:
   (A) AUTHOR=<player>    (where <player> is a player's name or dbref number)
      Example: +skim author=Fred
        Shows information about all messages in your mailbox sent by Fred.
   (B) MARK=[ NEW | DELETED ]
      Example: +skim mark=new
        Shows information about all messages in your mailbox marked as new.
   (C) SUBJECT=<wildcard string>  (use underscores "_" in place of spaces)
      Example: +skim subject=*Fun_Times*
        Shows information about all messages in your mailbox whose subjects
        contain the phrase "Fun Times". (Search is not case-sensitive.)
   (D) SIZE=[>|<]<number>
      Example: +skim size=>1000
        Shows info about all messages whose sizes are more than 1000 chars.
   (E) TIME=[>|<][ LASTON | LASTOFF | [mm/dd[/yy]] [hh:mm[:ss]] ]
      Example: +skim time=>9/10
        Shows info about all messages sent after 9/10 (September 10th) this
        year. If no date/time is given, it defaults to all messages sent
        after your most recent previous logout. (I.e. "+skim time=" means
        "+skim time=>lastoff")

 5) A message number or range as in (1) or (2) or a list as in (3) followed by
    a search criteria as in (4).
    Example: +skim 1-10 author=Fred
      Shows information about all messages numbered 1 through 10 in your
      mailbox which were written by Fred.

 6) A string of the form described in (5) followed by another search criteria
    as in (4) or followed by another string like in (5).
    Example: +skim 1-10 author=Fred size=>1000
      Shows information about all messages numbered 1 through 10 in your
      mailbox which were written by Fred and have size greater than 1000
      characters.
    Example: +skim 1-10 author=Fred 10-20 size=>1000
      Shows information about all messages numbered 1 through 10 in your
      mailbox which were written by Fred and have size greater than 1000
      characters along with messages numbered 10 through 20 which have
      size greater than 1000 characters.

 7) A "|"-separated list of strings of the form described in (5).
    Example: +skim 1-10 author=Fred | 10-20 size=>1000
      Shows information about all messages numbered 1 through 10 in your
      mailbox which were written by Fred along with all messages numbered
      10 through 20 which have size greater than 1000 characters.

 Remember that all these possible message specifications can be used with much 
 more than just the +SKIM command. Any command syntax which contains 
 "<message>" or "<messages>" accepts all the possible formats. Different 
 +mail commands have different restrictions on the number of messages you 
 can reference at once, however. If you refer to too many messages for a 
 given command, you will get an error message explaining that you've tried 
 to reference too many messages at once.
Personal tools