README for the Perl Module Time::Avail Copyright (c) 1998 Peter Santoro. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself; however, you must leave this copyright statement intact. ----------------- Document Contents ----------------- - Document Contents - Overview - Getting the Distribution - Installation of the Module - Using the Module - Contacting the Author - Removing the Module -------- Overview -------- Avail.pm is a Perl module that contains code to calculate the time remaining within a given time interval. The only exported function is timeAvailable. timeAvailable() compares the current day and time with the specified time interval and returns the number of minutes remaining or 0 if no time remains. The time interval used by timeAvailable() is passed in as three parameters: starting time, ending time, and a day mask. ------------------------ Getting the Distribution ------------------------ This distribution can be retrieved at or from CPAN at . -------------------------- Installation of the Module -------------------------- Make sure the user executing this has sufficient permissions to add and modify files in the global perl installation. The user should use this sequence to install this module. perl Makefile.PL make make install make realclean ---------------- Using the Module ---------------- The module is simple to use. It is fully documented with pod documentation. To read it, execute perldoc Time::Avail after the module is installed. An HTML version of the pod documentation is included in the distribution. It was created with pod2html, which comes with Perl. --------------------- Contacting the Author --------------------- I welcome any feedback on this module. If you have comments, questions, bug reports, or ideas, feel free to send them to me, Peter Santoro, peter@pscomp.com. ------------------- Removing the Module ------------------- Under a user with sufficient permissions and from the Avail distribution directory, execute perl Makefile.PL if there isn't a file called Makefile. Then execute make uninstall