3.10 Messaging

Every adventurer in Imperian can send and receive messages. These are not
quite like letters, which you must purchase, write on, and have         
delivered for a fee. They are not quite like tells, which require that  
the other person be active in the realms.                               


Quick Summary
-------------
 MSG [WRITE [TO]] <who> <message>       - send a message.
 MSG COUNT                              - tells you how many messages you have.
 MSG DELETE #                           - delete message by number.
 MSG DELETE IMPERIAN [CONFIRM]          - deletes ALL system messages        
 MSG DELETE RANGE first TO last         - delete range of messages.
 MSG EMPTY <folder>                     - delete all messages in folder.
 MSG FOLDER CREATE <folder>             - create a new folder.
 MSG FOLDER LIST                        - list your folders.
 MSG FOLDER DELETE <folder> [CONFIRM]   - delete existing folder.
                                        - WARNING - does delete preserved too. 
 
                              
 MSG FORWARD # [TO] <who>               - forward a message to someone else.   
       
 MSG FOLDER RENAME <folder> [TO] <name> - rename existing folder.
 MSG FOLDER PRESERVE <folder>           - preserve all msgs in folder.
 MSG FOLDER UNPRESERVE <folder>         - unpreserve all msgs in folder.
 MSG LAST                               - tells you what your message is.
 MSG LIST [*|<folder>] [start] [FULL]   - list msgs (in folder, *=anywhere).   
 
 MSG DESC [*|<folder>] [start] [FULL]   - list msgs (in folder, *=anywhere). 
 MSG LIST PRESERVE[D] [start] [FULL]    - list msgs (in folder, *=anywhere).
 MSG MOVE # [TO] <folder>               - move a message to a folder.
 MSG MOVE FROM <sender> [TO] <folder>   - move a message to a folder.
 MSG PRESERVE[D] [LIST] [#]             - list, count, or add preserved msgs.  
     
                                        - (preserved msgs will not decay).
 MSG READ #                             - read a message by number.
 MSG AGAIN|NEXT|PREV[IOUS]              - read again, next, or prev. msg.
 MSG REPLY <message>                    - reply to last read message.
 MSG SEARCH <terms>                     - search all messages.
 MSG SEARCH FROM <person> [start]       - find all messages from person.
 MSG SUMMARY                            - list folders and message counts.
 MSG UNPRESERVE #                       - unpreserve a msgs.

 CMSG <folder>                          - Same as MSG EMPTY folder.
 DELMSG ALL                             - delete all messages in all folders.  
                     
 DM|DELMSG [#]                          - delete last read message, or by #.   
                  
 MSGS|MESSAGES                          - same as MSG LIST.
 RL                                     - same as MSG PREVIOUS.
 RM|READMSG                             - same as MSG NEXT.
 RM 0|-1                                - same as MSG AGAIN, MSG PREVIOUS.
 MMSG [<group>] <message>               - send the same message to all members of GROUP

Reading:  MSG READ #
          RL           (reads the msg after the one you just read)
          MSG READPREV (same)
          MSG READNEXT (reads the msg after the one you just read)
          MSG READAGAIN (re-reads the msg you just read)
          
Sending:  MSG <to> <yourmessage>, or MSG WRITE [TO] <to> <yourmessage>
          Examples: MSG Avasyu Greetings, Creator!
                    MSG WRITE TO Avasyu Greetings, Creator!
          MMSG [<to group>] <yourmessage>
          Examples: MMSG [Jeremy, Eoghan] You're the best!

Deleting: MSG DELETE #, or DM #, or DM (deletes the last msg you read).
CMSG <folder> (deletes all messages in a folder. Irreversible!)         
          Examples: DM 4 (deletes message 4)
                    CMSG inbox (deletes all messages in your inbox)

Folders:  MSG FOLDER LIST (to see a summary by folders) or MSG SUMMARY.

Searching: MSG SEARCH book (find all messages with the word 'book' in   
them).                                                                  


Preserving
----------
Messages over a certain age (currently about 85 Imperian months) that
are not PRESERVED will decay naturally over time and go away.

You can preserve up to 1,000 messages (as of this writing).
We'd be happy if you were to preserve far fewer!

Preserved messages are protected from most forms of deletion,
even by yourself, except MSG FOLDER DELETE (that wipes out
all messages in a folder, preserved or not).

To be on the safe side, only preserve what you need to, and
don't just go deleting everything in the hope that maybe
the preserved ones will survive! Preserving is for keeping
a few really important messages around.


Related Commands
----------------
 CONFIG RETURNMESSAGE <message>
 - This allows you to set an answering message that adventurers will see 
     whenever they send you a message.

If you receive a message while you are not active in the realms, you    
will be notified when you next return.