Using PMS via the ``pms'' (small commands) interface
====================================================

Concepts
--------
A ``server'' is something like a POP3 server, or the ~/Mail directory
in Mutt/MH: a collection of folders. PMS supports as many servers as
you want, via pluggable modules. Each server has a name.
Most people call the default server ``default'' and use it almost
exclusively.

A ``folder'' is a collection of messages and folders.

A message is an e-mail message, a newsgroup posting, or anything else
that has structured headers with unstructured body.

Note:
All commands that receive options, can receive a non-ambigous
prefix of the option.

comp
----
Compose a message.

Options:
  -without_sig: do not include signature

current
-------
Print the current folder and message: useful inside prompts.

edit
----
Edit an existing draft

Argument:
  draft number

folder
------
Change folder

Options:
  -relative: change to a subfolder of the current folder
  -push: push the folder rather then replace, so it can later be popped

Argument:
  folder name

forw
----
Forward the current message

Options:
  -without_sig

from
----
Limit to the messages with a given sender.

Argument:
  sender (as a regular expression)
  If it is not given, the sender of the current message is assumed.

i
-
Change the current message

Argument:
  Index of message to change to

label
-----
Label the current message.

Argument:
  Label

labels
------
Limit to messages with a given label.

Argument:
  Label. If not given, label of current message is assumed.

m
-
Go to previous message.

p
-
Go to next message

mv
--
Move a message to a different folder.

Arguments:
  folder -- name of folder to move to
  server -- name of server. Default is the current server

pop
---
Pop the current folder off the stack.

recursive
---------
Push on the folder stack a folder whose messages are the messages
in the current folder, plus those in all the children.

repl
----
Reply to current message

Options:
  -without_sig: do not include signature
  -to_all: add all those in the To: and CC: of original message to recipients
  -no_include_text: don't quote the original message

replies
-------
Limit to the replies to the current message.

resync
------
Resynchronize the folder with the messages actually in it. In case
some other program changes the folder.

rm
--
Remove the current message.

Arguments:
  A list of numeric ranges: if given, delete those messages instead.

scan
----
Report on the messages in the current folder

Options:
  -summary: summarize subjects
  -folder_only: only print short summary for each folder
  -recursive: report on subfolders as well

s
-
Sort.

Argument:
  criterion -- a prefix of subject, from, or date.

server
------
Change the default server.

Argument:
  server name

show
----
Show the current message

Options:
  -headers_only: only show headers
  -full_headers: show all headers

subject
-------
Limit to messages with given subject.
  
Argument:
  subject. If not given, assume subject of current message. 
