NAME

SYNOPSIS

DESCRIPTION

OPTIONS

-a

Append messages to any existing file named the base name, ignored with -m, -M, -y, or -Y.

-h

Help, just print an informational message, and exit.

-k

Keep the individual message files. Normally they would be removed as they are copied.

-m

Combine message files to monthly mailboxes of type mbox.YYMM, sorted by date/time.

-M

Combine message files to monthly mailboxes of type YYMM/mbox, sorted by date/time.

-y

Combine message files to yearly mailboxes of type mbox.YYYY, sorted by date/time.

-Y

Combine message files to yearly mailboxes of type YYYY/mbox, sorted by date/time. With -m, combine to monthly mailboxes of type YYYY/mbox.MM. With -M, combine to monthly mailboxes of type YYYY/MM/mbox.

-v

Verbose, provide more feedback.

OPERANDS

base_name

The base name (minus the “.YYYYMMDD.hhmmss.nnnnn” suffix) of the individual message files to reassemble into standard Internet style mailbox files. If no such arguments are given, recomposemail searches the current directory for any file names matching the message file name pattern, and acts on these files.

USAGE

In the absense of any of the -a, -m, -M, -y, or -Y options, if a file by the name of the base name already exists, a new file with a unique name will be created by appending a dot followed by a number, e.g., “mbox.1”.

With -m, -M, -y, or -Y, message files are appended to files with names such as “mbox.9801”, “9801/mbox”, “mbox.1998”, or “1998/mbox”, respectively, where “9801” is the year and the month, and “1998” is the year. The files and/or directories are created as needed.

If -Y is combined with -m or -M, message files are appended to files with names such as “1998/mbox.01” or “1998/01/mbox”, respectively, where “1998” is the year, and “01” is the month.

In all cases, the individual message files are removed as they are copied, except when -k is specified.

EXAMPLES

recomposemail tcl-list

Combine the email messages in the current directory that match the mail file suffix pattern into mailbox files per each unique base name. The messages will be appended to any such pre-existing files. The individual message files will not be deleted. Progress will be verbosely reported:

recomposemail -akv

Combine the email messages in the files with base names “bart” and “sally” into monthly mailbox files per base name, such as “bart.9801” and “sally.9801”. If any such files already exist, they will be appended:

recomposemail -m bart sally

Combine the email messages in the files with base name “ALERT” into monthly mailbox files in subdirectories, such as “9801/ALERT”, “9802/ALERT”, etc. If any such files already exist, they will be appended:

recomposemail -M ALERT

Combine the email messages in the files with base name “yomama” into monthly mailbox files in yearly subdirectories, such as “1998/yomama.01”, “1998/yomama.02”, etc. If any such files already exist, they will be appended:

recomposemail -Ym yomama

FILES

mbox.YYYYMMDD.hhmmss.nnnnn

Serialized individual email message files, where “mbox” is the name of the mailbox, “YYYYMMDD” is the year, month, and day, “hhmmss” is the hour, minute, and second, and “nnnnn” is a serial number.

DIAGNOSTICS

BUGS

Due to command line length and argument limitations (implementation dependent), some of the system commands used in the script might fail when used with extremely large numbers of message files.

Mailbox date divisions other than monthly and yearly, such as daily, etc., are currently not supported.

SEE ALSO

AUTHOR