This file describes the interfaces mswatch uses to communicate with other
programs to watch mailstores and synchronize mailboxes.

* mailstore watcher

About: watches a given mailstore and reports when mailboxes change

- Invocation: mailstore watcher application defined, watch MAILSTORE

- Once <MAILSTORE> is being watched, print '\n' (the ascii newline character)
- When a mailbox changes, print '<MAILBOX>\n'
Where <MAILBOX> is the name of the mailbox that has changed; eg INBOX


* mailbox synchronizer

About: synchronizes a given set of mailboxes between two mailstores

- Invocation: "<PROGRAM> <MAILBOX> ..."
<PROGRAM> synchronizes the set of mailboxes. The mailbox name "" means
synchronize all maiboxes.

The mswatchrc configuration file also allows mbsync-style string prepending.
In this case, invocation is: "<PROGRAM> <X:MAILBOX|X> ..."
Where "X:MAILBOX" means sync that mailbox ("X:" conveys whatever information
PROGRAM would like to receive) and only "X" means synchronize all mailboxes.