NAME
    IM::Folder - mail/news folder handler

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
    The *IM::Folder* module handles mail/news message folders.

    This modules is provided by IM (Internet Message).

EXAMPLES
     &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"

COPYRIGHT
    IM (Internet Message) is copyrighted by IM developing team. You can
    redistribute it and/or modify it under the modified BSD license. See the
    copyright file for more details.

