new

 $folder = new(ftype[, foldername][, options])

Creates a new Mail::Folder object of the specified type. Arguments are:

ftype

The type of folder. Possible values are mbox, maildir, emaul, or NNTP.

foldername

The name of the folder. If present, the open method is called with foldername as the argument.

options

A hash where the following options may be the keys:

Content-Length

Content-length header is created or updated by append_message and update_message.

Create

If set, the folder is created if it doesn't already exist.

DefaultFolderType

Autodetects folder type if create option is set and AUTODETECT has been set.

DotLock

Uses .lock-style folder locking with the proper folder interface (currently used only with the mbox interface).

Flock

Uses flock-style folder locking with the proper folder interface (currently used only with the mbox interface).

NFSLock

Deals with NFS-style file locking with the proper folder interface and the NFS server in question.

notMUA

If set, makes updates but doesn't save message labels or the current message indicator. If not set (the default), saves labels and the current message indicator as appropriate for the folder interface.

Timeout

Overrides the default timeout value. Specified in seconds. Particularly useful for folder interfaces that involve network communications.