MBOX-INBOX(1)

NAME
mbox-inbox - ColdSync conduit to fetch from a mbox-format inbox to Palm Mail database

SYNOPSIS
    conduit fetch {
        type: mail/DATA;
        path: "<...>/mbox-inbox";
                  pref: mail/2;
      arguments:
                  Mailbox: /path/to/mailbox;
        Inbox-name:     Inbox;
                  Truncate-after: 4000
    }

DESCRIPTION
The "mbox-inbox" conduit reads messages from a mailbox and copies them into the Palm mail database.

The mailbox can be a primary mailbox (i.e. /var/spool/username), a subfolder in a maildir (~/Mail/palm), a file resulting from, say, procmail filtering, or whatever. The author designed this particular conduit such that he could drag e-mails/documents to a "palm" folder.

Messages copied to the Palm will be deleted after processing via the simple mechanism of truncating the mailbox file. The mailbox will be locked appropriately during the process.

This conduit assumes that the incoming mail is process appropriately before it hits the mailbox. That is, things like MIME and HTML aren't handled properly (except for truncating). Furthermore, because the original messages are deleted but what goes to the Palm is truncated, there's a chance that important information buried in large documents will be lost.

OPTIONS

"Mailbox"
    The filename of the mailbox that gets synched to the Palm. This needs to be readable, writable, and lockable. It's assumed that anything else accessing the mailbox will be well-behaved in terms of format and access locking. Most MTA's are, but with all the newfangled spam blockers out there... Network shares are probably iffy.

"Inbox-name"
    The category into which the messages are copied. The default Inbox will be used if not specified.

"Truncate-after"
    Messages with bodies larger than this will be truncated. By default, this is 4000 bytes (the same as the Palm Mail app default).

    If the Palm mail sync preferences are available (mail/2), an attempt will be made to get the truncation value from there. This hasn't been well tested.

AUTHOR
Christophe Beauregard <christophe.beauregard@sympatico.ca>

SEE ALSO
coldsync(8)

ColdSync Conduits, in the ColdSync documentation.

POD ERRORS
Hey! The above document had some coding errors, which are explained below:

Around line 254:
    You forgot a '=back' before '=head1'