NAME
    Folder - IM folder handler

DESCRIPTION
SYNOPSIS
    use IM::Folder;

    $current_folder_name = &cur_folder();

    &set_cur_folder($new_current_folder_name);

    ($number_of_files, $number_of_message_files, $minimum_message_number,
    $maximum_message_number) = &folder_info($folder_name);

    $message_number = &message_number($message_number_or_name);

    @message_number_array = &message_range($message_range_string);

    $message_file_path = &message_name($folder_name, $message_number);

DESCRIPTION
    &cur_folder(); results "+inbox"

    &set_cur_folder("+inbox");

    ($a, $b, $c, $d) = &folder_info("+inbox"); results (10, 3, 1, 3)

    &message_number("+inbox", "cur"); results 3

    &message_range("+inbox", "1-3"); results (1, 2, 3)

    &message_name("+inbox", "3"); results "/usr/home/itojun/Mail/inbox/3"

