home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / calendars / remind.3.0.13.README < prev   
Encoding:
Text File  |  1995-11-03  |  4.8 KB  |  139 lines
  1. REMIND version 3.0 for UNIX
  2.  
  3. REMIND is a sophisticated alarm/calendar program.  Details are given
  4. in the man page, "remind.1".
  5.  
  6. 1 - Read the file COPYRIGHT.
  7.  
  8. 2-  Before compiling the software, check to see if it includes patches.
  9.     These are files called patch.xx.  If there are patches, apply them all
  10.     by typing:
  11.  
  12.        cat patch.* | patch
  13.  
  14. 3 - Examine the Makefile and change any parameters which need to be
  15.     changed for your system.  As it stands, the Makefile is set up for a
  16.     BSD system.
  17.  
  18. 4 - Examine the file config.h and adjust parameters as needed
  19.  
  20. 5 - Examine lang.h and choose the language you want Remind to use.
  21.  
  22. 6 - Type 'make'
  23.  
  24. 7 - Type 'sh test-rem' or 'make test' to run the acceptance test.  Note
  25.     that the test script works only for the English version of Remind.
  26.  
  27. 8 - Type 'make install' to install Remind, kall, rem and the man
  28.     pages.
  29.  
  30. Two shell scripts, "remind-all.csh" and "remind-all.sh" are provided.
  31. These allow automatic mailing of reminders to all users who create a
  32. $HOME/.reminders file.  These two scripts are equivalent; one is a
  33. "sh" script and the other is a "csh" script.  Pick the one you want to
  34. use, and follow the instructions in the opening comments of the
  35. script.
  36.  
  37. *** NOTE *** Please be aware that "remind-all.csh" and "remind-all.sh"
  38. have been changed since version 03.00.05 of Remind.  If you install
  39. the new remind executable, make sure you switch over to the new
  40. "remind-all" scripts.
  41.  
  42. A shell script called "rem" is provided for those who like to have
  43. 'remind' assume a default reminders file.  A man page for this script
  44. is provided.  You should examine the script to ensure that the defaults
  45. are correct.
  46.  
  47. Many people have asked me why I supply the "rem" script instead of
  48. having Remind assume a default file.  The answer is: That's how I like
  49. it!  My personal preference is for a program which normally takes
  50. parameters to display usage information when invoked with no
  51. parameters.  I like that behaviour so I can quickly get an idea of
  52. what a program does without poring through the man page.  And I think
  53. I'll keep Remind that way.  Sorry to all who dislike it. :-)
  54.  
  55. A shell script called "kall" is provided so you can kill your background
  56. remind processes when you log out.  See the man page.  Note that kall
  57. depends on the output of "ps", and may not be portable.
  58.  
  59. The file "defs.rem" has some sample Remind definitions and commands,
  60. as well as U.S. and Jewish holidays.
  61.  
  62. OTHER LANGUAGE SUPPORT
  63.  
  64. Remind has support for languages other than English.  See the file
  65. "lang.h" for details.  The language support may vary - you can change
  66. only the substitution filter, or you can translate all of the usage
  67. instructions and error messages as well.  See "french.h" for an
  68. example of the latter.
  69.  
  70. If you add support for a non-English language, Remind will accept both the
  71. English and non-English names of months and weekdays in an input script.
  72. However, you should not rely on this feature if you want to write portable
  73. Remind scripts.
  74.  
  75. At a minimum, you should support month and day names in the foreign
  76. language, and should modify the substitution filter appropriately.
  77. If you are truly diligent, you can translate usage and error messages
  78. too.
  79.  
  80. Take a look at the files "english.h" and "german.h" if you want to add
  81. support for your favourite language.  If you do add another language
  82. to Remind, please let me know!  Here are the basic guidelines:
  83.  
  84. - Your language file should be called "lxxx.h", where lxxx is the first 8
  85.   characters of the ENGLISH name of your language.
  86.  
  87. - Your language file should define L_LANGNAME to be the full English
  88.   name of your language, with the first letter capitalized and the rest
  89.   lower-case.
  90.  
  91. RELEASE NOTES -- miscellaneous info that couldn't go anywhere else!
  92.  
  93. 1. POPUP REMINDERS
  94.  
  95. If you're running under X-Windows and you have the TCL tools,
  96. you can create simple pop-up reminders by creating the following
  97. TCL script called 'popup'.  It pops a message on to the screen and
  98. waits for you to press the 'OK' button.  If you don't press the OK button
  99. within 15 seconds, it exits anyway.  To use it, you can use the '-k' option
  100. for Remind as follows:
  101.  
  102.     remind "-kpopup '%s'&" .reminders
  103.  
  104. Or use the following in your Remind script:
  105.  
  106.     REM AT 17:00 RUN popup 'Time to go home.' &
  107.  
  108. This TCL script is a slightly modified version of one submitted by
  109. Norman Walsh.  TCL is available via FTP at ftp.uu.net in /languages/tcl.
  110.  
  111. -------------- Cut Here ---------- Cut Here ---------- Cut Here -------------
  112. #!/usr/local/bin/wish -f
  113.  
  114. wm withdraw .
  115.  
  116. if { [ llength $argv ] == 1 } {
  117.   eval set msg $argv
  118. } else {
  119.   eval set msg [ list $argv ]
  120. }
  121.  
  122. after 15000 { destroy . ; exit }
  123.  
  124. tk_dialog .d { Message } $msg warning 0 { OK } 
  125.  
  126. destroy .
  127.  
  128. exit
  129. -------------- Cut Here ---------- Cut Here ---------- Cut Here -------------
  130.  
  131.  
  132. --
  133. David F. Skoll <dfs@doe.carleton.ca>
  134. 986 Eiffel Avenue
  135. Ottawa, Ontario K2C 0J2
  136. CANADA
  137.  
  138. Tel. (613) 225-8687
  139.