Script descriptions and operation

Written for wakeup by newbuntu on 2010-09-03

This is an alarm clock with a nice front-end GUI with which to set each alarm's settings. So that any user can set alarms, alarms have the option of not waking your computer, in which case the alarms only go off if that user is logged in. Alarms which are set to wake the computer write to /sys/class/rtc/rtc0/wakealarm to interact with the hardware real-time clock.

Main scripts are:
   wakeup-settings : runs the GUI front end to set the alarm preferences
   wakeup : runs an alarm
   setalarm : set the computer to wake at a (possibly recurring) time
   setnextalarm.py : determine for which alarm the computer should be woken next and do so using setalarm

The alarm text is typed by the user into the front-end GUI with dataitems, which are alphanumeric plus "_" words preceded by a "$". When the alarm is run, these dataitems are replaced with real data. For example, the dataitem $date will be replaced with the actual current date.