reminder.pl - Notification of Important Dates
reminder.pl my.reminder # Normal case, sends Email reminder.pl *.reminder # Normal case, sends Email reminder.pl -debug 1 test.txt # Use this for debugging
Use this program manually or in a cron job to generate Email to people regarding upcoming events they wish to be notified of. The program checks the current date against a list of interesting dates and generates Email to a set of individuals a few days beforehand.
This is the 'background task' of a system of reminders. See Webfile ( http://www.hps.com/~tpg/toolbox/index.php?file=webfile) for a way to manage the config file for reminders using a browser.
Output from the program is an Email sent to a list you designate. The body of the Email looks like this:
TO: email@example.com Subject: Upcoming Events Birthday for John Smith (08/04) is 10 days away URL=http://www.somedomain.com/remind/my.html See http://www.all-yours.net/postcard/ for postcards
The configuration file consists of various keyword=value lines which control options to the program. These need to come before anything else. Keywords (upper case only) that are recognized are:
The rest of the file consists of lines describing events you are interested in. Each line consists of three parts like this:
EVENT MM/DD COMMENT
Here's a sample configuration file.
# # Use this to give warnings of upcoming events # # Remove comment to stop this when you are gone etc #DISABLE=yes # Set number of days of lead we are looking for DAYSB4=8 # Specify destination of Email target EMAILDESTfirstname.lastname@example.org # Set comment lines which will always be sent when # there is something to remind you of COMMENT=See http://www.all-yours.net/postcard/ for postcards # event mm/dd Comment Birthday 06/04 Fred Smyth Birthday 10/01 Katrina Valentines 02/14 Wife Valentines 02/14 Mistress St_Urho's_Day 03/16 Ursala Anniversary 08/21 Our wedding anniversary
If no fatal errors are detected, the program exits with a return code of 0.
Written by Terry Gliedt <email@example.com> in 2001-2004. This is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; See http://www.gnu.org/copyleft/gpl.html