home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Linux / Divers / remind-03.00.19.tgz / remind-03.00.19.tar / remind-03.00.19 / docs / README.UNIX < prev    next >
Text File  |  1998-01-18  |  5KB  |  134 lines
  1. $Id: README.UNIX,v 1.4 1998/01/19 03:24:09 dfs Exp $
  2. REMIND version 3.0 for UNIX
  3.  
  4. REMIND is a sophisticated alarm/calendar program.  Details are given
  5. in the man page, "remind.1".
  6.  
  7. INSTALLING REMIND:
  8. -----------------
  9.  
  10. If you have Tcl/Tk (wish 4.1 or higher) installed and are running X Windows:
  11. --------------------------------------------------------------
  12.  
  13. 1) Type: wish ./build.tk from the top-level Remind directory.
  14.    Fill in the various options and hit "Build Remind"
  15.  
  16. 2) Type: "make install" -- you may need to be root to do this.
  17.  
  18. If you do NOT have Tcl/Tk or are NOT running X Windows:
  19. -------------------------------------------------------
  20.  
  21. 1) Edit the file "src/custom.h" according to your preferences.
  22.  
  23. 2) Edit the file "src/lang.h" to choose a language.
  24.  
  25. 3) Type: "make"
  26.  
  27. 4) Type: "make install" -- you may need to be root to do this.
  28.  
  29. The subdirectory "www" contains scripts for making a nice calendar
  30. web server.  See the files README and Makefile in that directory.
  31.  
  32. Two shell scripts, "scripts/remind-all.csh" and
  33. "scripts/remind-all.sh" are provided. These allow automatic mailing of
  34. reminders to all users who create a $HOME/.reminders file.  These two
  35. scripts are equivalent; one is a "sh" script and the other is a "csh"
  36. script.  Pick the one you want to use, and follow the instructions in
  37. the opening comments of the script.
  38.  
  39. A shell script called "scripts/rem" is provided for those who like to have
  40. 'remind' assume a default reminders file.  A man page for this script
  41. is provided.  You should examine the script to ensure that the defaults
  42. are correct.
  43.  
  44. Many people have asked me why I supply the "rem" script instead of
  45. having Remind assume a default file.  The answer is: That's how I like
  46. it!  My personal preference is for a program which normally takes
  47. parameters to display usage information when invoked with no
  48. parameters.  I like that behaviour so I can quickly get an idea of
  49. what a program does without poring through the man page.  And I think
  50. I'll keep Remind that way.  Sorry to all who dislike it. :-)
  51.  
  52. A shell script called "scripts/kall" is provided so you can kill your
  53. background remind processes when you log out.  See the man page.  Note
  54. that kall depends on the output of "ps", and may not be portable.
  55.  
  56. The file "examples/defs.rem" has some sample Remind definitions and
  57. commands, as well as U.S. and Jewish holidays.
  58.  
  59. OTHER LANGUAGE SUPPORT
  60.  
  61. Remind has support for languages other than English.  See the file
  62. "src/lang.h" for details.  The language support may vary - you can change
  63. only the substitution filter, or you can translate all of the usage
  64. instructions and error messages as well.  See "src/langs/french.h" for an
  65. example of the latter.
  66.  
  67. To compile Remind for a non-english language, look at the constants
  68. defined in "src/lang.h".  Then, to compile Remind for Italian (as an
  69. example), type:
  70.  
  71.     make "LANGDEF=-DLANG=ITALIAN"
  72.  
  73. If you add support for a non-English language, Remind will accept both the
  74. English and non-English names of months and weekdays in an input script.
  75. However, you should not rely on this feature if you want to write portable
  76. Remind scripts.
  77.  
  78. At a minimum, you should support month and day names in the foreign
  79. language, and should modify the substitution filter appropriately.
  80. If you are truly diligent, you can translate usage and error messages
  81. too.
  82.  
  83. Take a look at the files "src/langs/english.h" and
  84. "src/langs/german.h" if you want to add support for your favourite
  85. language.  If you do add another language to Remind, please let me
  86. know!  Here are the basic guidelines:
  87.  
  88. - Your language file should be called "src/langs/lxxx.h", where lxxx
  89.   is the first 8 characters of the ENGLISH name of your language.
  90.  
  91. - Your language file should define L_LANGNAME to be the full English
  92.   name of your language, with the first letter capitalized and the rest
  93.   lower-case.
  94.  
  95. - You can test your language file with the script "tests/tstlang.rem"
  96.  
  97. RELEASE NOTES -- miscellaneous info that couldn't go anywhere else!
  98.  
  99. 1. POPUP REMINDERS
  100.  
  101. If you're running under X-Windows and you have the TCL tools,
  102. you can create simple pop-up reminders by creating the following
  103. TCL script called 'popup'.  It pops a message on to the screen and
  104. waits for you to press the 'OK' button.  If you don't press the OK button
  105. within 15 seconds, it exits anyway.  To use it, you can use the '-k' option
  106. for Remind as follows:
  107.  
  108.     remind "-kpopup '%s'&" .reminders
  109.  
  110. Or use the following in your Remind script:
  111.  
  112.     REM AT 17:00 RUN popup 'Time to go home.' &
  113.  
  114. This Tcl script is a slightly modified version of one submitted by
  115. Norman Walsh.
  116.  
  117. -------------- Cut Here ---------- Cut Here ---------- Cut Here -------------
  118. #!/usr/local/bin/wish
  119. wm withdraw .
  120. after 15000 { destroy . ; exit }
  121. tk_dialog .d { Message } $argv warning 0 { OK } 
  122. destroy .
  123. exit
  124. -------------- Cut Here ---------- Cut Here ---------- Cut Here -------------
  125.  
  126.  
  127. --
  128. David F. Skoll <dfs@doe.carleton.ca>
  129. 986 Eiffel Avenue
  130. Ottawa, Ontario K2C 0J2
  131. CANADA
  132.  
  133. Tel. (613) 225-8687
  134.