home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 148.lha / SpudClock / spudclock.doc < prev    next >
Encoding:
Text File  |  1988-04-26  |  3.5 KB  |  73 lines
  1.                       The Man From S.P.U.D. 
  2.                             Presents
  3.                             SPUDclock
  4.  
  5. SPUDclock is a simple program that uses the narrator device to output (say)
  6. the time at certain user specified intervals. It was written mainly to
  7. remind you of the time when you are busy working on the computer. (I used
  8. to miss the beginings of alot of TV shows until this was written). 
  9. To use it simply type at a CLI prompt:
  10.     run spudclock [options]
  11. NOTE: You need to RUN it the first time but if you invoke it later to change
  12. some options you do not need the RUN. (Once the options are changed the later
  13. copy dies leaving only one copy in memory).
  14. The options are zero or more of the following.
  15.         -f              The time is spoken every quarter hour on the quarter
  16.                         hour.
  17.         -t              The time is spoken every half hour on the half hour.
  18.         -h              The time is spoken every hour on the hour.
  19.         -p              The speakers are prestarted. This is if you have 
  20.                         some amplified speakers that sense a signal and then
  21.                         start amplification after a small delay. You don't
  22.                         need this option if you are hooked up to your monitor.
  23.         -s nnnn         Sets the starting time. See note below.
  24.         -e nnnn         Sets the ending time. See note below.
  25.         -v nn           Sets the volume. Where 0 < nn < 64.
  26.         -m message      Says message before saying the time.
  27.         -l              Lists the current settings.
  28.         -d              Causes any unspecified option to revert to their
  29.                         defaults. Normally only the values associated with the
  30.                         options specified on the command line are changed.
  31.         -q              Kills the main running copy of SPUDclock.
  32. Setting Starting and Stopping Times
  33.  
  34. With the -s and -e options you can tell SPUDclock when to start and stop
  35. speaking the time. This is if you are like me and leave your computer on all
  36. the time and don't want to get waken up every half hour. The format for the
  37. times is hhmm. (h - hours, m - minutes, 24 hour time)
  38. If you want to start at 8:30 AM and stop at 11:00 PM then part of your option
  39. set would be:
  40.                 -s 830 -e 2300
  41. "Good Morning" is spoken after the starting time and "Good Night" is
  42. spoken after the ending time. Also, times are spoken intelligently (i.e as
  43. a human would say them.
  44. The defaults are:
  45.         Time spoken every half hour.
  46.         No speaker prestart.
  47.         Starting time 830.
  48.         Ending time 2300.
  49.         Alarm volume 50.
  50. These can be changed in the source and recompiled if desired. The executable
  51. was compiled under Lattice 3.10 and the makefile is included.
  52.  
  53. Any of the options may be changed at any time by invoking the program with
  54. the desired options (use the -d option to put unspecified values at their
  55. defaults).
  56. Example:
  57. My startup-sequence contains the line:
  58.         run spudclock -m mister poetaytoe head says -s 700 -e 2200
  59. so at 10:00 PM the amiga says:
  60.         "mister potato head says it is now ten o'clock, good night"
  61. This program can be distributed and copied freely. If you feel you want to
  62. send a contribution, we'll be glad to accept it. That's up to you though.
  63. Brought to you by 
  64.                 The Man From S.P.U.D.
  65.                 (H. Bret Young and Bob Beaty)
  66. usenet:  ihnp4!pur-ee!youngb
  67. ARPA:    youngb@eg.ecn.purdue.edu
  68. UUCP:    youngb@pur-ee.uucp
  69. US Mail:
  70. H. Bret Young
  71. 716 N. 31st Street
  72. Lafayette, IN 47904
  73.