home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / util / multifin / maclock1.sit / ReadMe.MacAClock < prev   
Text File  |  1991-05-23  |  4KB  |  69 lines

  1. * MacAClock Version 1.0.1
  2.  
  3. MacAClock is a regular program that displays an analog clock on a screen. The clock can be displayed in color/grayscale or in b/w. It also displays the current day and date. You can assign individual colors to the clock background, the frame, second arm, minute arm, hour arm, day and date.
  4.  
  5. MacAClock is free but not public domain. Use it if you like it. You can freely distribute the program as long as it is not for financial/commercial purposes. This document "ReadMe.MacAClock" must accompany the distribution. I want to make sure persons get credit. Some parts of this program are based on the source codes that  are written by these people.
  6.  
  7. Version 1.0.1 now works on all Macintosh computers (Plus or better). You may need the 32-Bit Color QuickDraw to get better color selection.
  8.  
  9.  
  10. * WARNING!
  11.  
  12. MacAClock is free -> USE AT YOUR OWN RISK! I am NOT responsible for any problems that arise as the result of using this program.
  13.  
  14. Users of MacAClock version 1.0 should upgrade to 1.0.1 to avoid random system errors or MacAClock suddenly quits.
  15.  
  16.  
  17. *Credits (no particular order)
  18.  
  19. MacAClock is based on the Clock DA for Turbo Pascal (by Borland International). I ported the DA, added color and an alarm feature so it could work as a regular program under MultiFinder. I don't know the original author. So the author should receive a credit.
  20.  
  21. Pop-up menu and some dialog routines are written by J. B. Parrett and Michael S. Engber (the author of the wonderful program Save A Tree).
  22.  
  23. Special thanks to the Computer Store of Corvallis for allowing me to debug this program on its Classic.
  24.  
  25.  
  26. * Potential problems :
  27.  
  28. MacAClock is a MultiFinder-aware program. It depends on other programs to work smoothly. If an application currently running in the foreground doesn't yield time to the background applications, the second arm of MacAClock may look "jerky".
  29.  
  30. A foreground application that changes colors (like Digital Darkroom) can cause unusually MacAClock display.
  31.  
  32. Hide and then show the clock to force a window update will solve both problems.
  33.  
  34.  
  35. * How to change the date and day formats
  36.  
  37. Month/date/year -> date/month/year :
  38. For users who don't use the US date format (month/date/year), you can change the format to date/month/year by using a ResEdit (Resource Editor for Macintosh computers).
  39. Here's how :
  40.     a. using ResEdit, open MacAClock.
  41.     b. open 'vers' resource. Vers with ID = 0 belongs to MacAClock.
  42.     c. create a new 'vers' resource with ID = 128. You don't need to fill out any information. This 'vers' with ID = 128 signals MacAClock to use date/month/year format.
  43.     d. quit Resedit after saving the change and run MacAClock. That's all you need to do.
  44.  
  45. Days :
  46. The day strings ("Sun ", ..., "Sat ") can be modified. Notice the strings must be four characters long and Sunday is the first day of a week. The resource that contains these strings is 'STR#' ID = 132.
  47. For the time being, Geneva font of size 9 is used. Future update will allow users to change the font and size.
  48.  
  49.  
  50. * History
  51.  
  52. Version 1.0 -> 1.0.1
  53. Fixed: crashing on MacPlus or SE, random crashing on all Macintoshs.
  54.  
  55.  
  56. * Future Upgrade
  57. I am planning to add font and size menus to the program. The current version uses Geneva 9.
  58.  
  59.  
  60. Comment
  61. If you use MacAClock and like it, send me a postcard of your hometown. If you have any comment about how to improve the program or if you find any "inconsistancy" (or bugs - arrgh), please send comment to :
  62.  
  63. Zikif Hamdy
  64.     US Mail : P.O. Box 782, Corvallis, OR 97339-0782
  65.     Internet : hamdyz@prism.cs.orst.edu
  66.     AOL : ZikifH
  67.  
  68.  
  69.