home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff204.lzh / JPClock / JPClock.doc < prev    next >
Text File  |  1989-04-30  |  7KB  |  130 lines
  1. *****************************************************************************
  2.                                                                              
  3.                                    JPClock                                   
  4.                                                                              
  5.                      © Copyright 1989 by Jonathan Potter                     
  6.                                                                              
  7.                   Another fantabulous Public Domain release                  
  8.                                                                              
  9. *****************************************************************************
  10.  
  11. JPClock - the ultimate WorkBench clock!
  12.  
  13. USAGE : 
  14.         JPClock [FLAGS]
  15.  
  16.         Flags are:
  17.  
  18.         -a           : Set Alarm on
  19.         -atALARMTIME : Set Alarm time to ALARMTIME (HH:MM:SS or H:MM:SSC)
  20.         -dSECONDS    : Set Delay between updates to SECONDS seconds
  21.         -f           : Set Stay Front on
  22.         -ot          : Turn time display off
  23.         -oy          : Turn day display off
  24.         -od          : Turn date display off
  25.         -of          : Turn fast memory display off
  26.         -oc          : Turn chip memory display off
  27.         -ol          : Turn total memory display off
  28.         -s           : Swap to second screen
  29.         -u           : USA format; MM-DD-YY instead of DD-MM-YY
  30.         -xX          : Open window with x-coordinate X
  31.         -yY          : Open window with y-coordinate Y
  32.         -12          : Set time to 12 hours format
  33.  
  34. Since the Amiga's conception, there have been umpteen different clock
  35. programs to go with it. The first of these, of course, was the WorkBench
  36. Clock, and other (third-party?) clocks have followed suit. Each one offered
  37. slightly different features; all (of course) showed time, some showed free
  38. memory in the system, and some showed the date. However, I have never found
  39. a clock program that is quite flexible enough, with enough features for me.
  40. Enter JPClock!
  41. JPClock is quite a short clock program, around 13K long, however it is
  42. packed with features. On first appearance, it looks just like any other
  43. clock, with maybe a little more. A title bar-height window opens at the
  44. top of the WorkBench screen, displaying the following information
  45.  
  46.       TIME      DAY DATE      FAST  CHIP  TOTAL
  47.  
  48. in the following format
  49.  
  50.       HH:MM:SS  DDD DD-MM-YY  XXXX  XXXX  XXXX
  51.  
  52. (note, as yet I have not found another clock program that gives all this
  53. information.) Quite simply, TIME is the current time, DAY is the day of the
  54. week, and DATE is the date. Note that by specifying the -u flag when running
  55. JPClock, DATE is displayed in the USA format of MM-DD-YY. FAST is the amount
  56. of free FAST memory in the system, likewise CHIP is the amount of free CHIP
  57. memory in the system, and TOTAL is the two added together.
  58. Activating the JPClock window (which can be closed, dragged and depth
  59. arranged) by clicking on it, and then pressing the RIGHT MOUSE BUTTON,
  60. POPs open a larger window with several gadgets in it. Specifically, these
  61. gadgets are TIME, DATE, ALARM, SWAP SCREENS, STAY FRONT, and ALARM ON.
  62. TIME allows you to set the system time from within JPClock - simply click in
  63. the string gadget and type the time in (in the format HH:MM:SS). Note that
  64. the last two values are optional, however, to change the second or third
  65. value (minutes or seconds) you must specify the preceding values.
  66. DATE similarly allows you to set the system date, in the format DD-MM-YY
  67. (or MM-DD-YY in -u USA mode). Note please that JPClock is not capable of
  68. handling years past 1999, although it will not crash, the aesthetic balance
  69. of the clock will be disturbed. I have no doubts, however, that by 1999 much
  70. more sophisticated clocks will be available (if not computers) :-).
  71. ALARM allows you to set the Alarm time, ie the time at which the alarm, if
  72. enabled by the ALARM ON gadget, rings. The alarm ring is simply 10
  73. DisplayBeeps (screen flashes).
  74. SWAP SCREENS allows you to shove the clock window to the second screen,
  75. and by clicking again, to shove it back. Note that the window will not move
  76. if there is no second screen, or if the second screen is not big enough
  77. (minimum dimensions are 504x45.)
  78. STAY FRONT, when switched on (highlighted), will keep the JPClock window
  79. at the front of the display at all times. This means that you can never
  80. lose it behind other windows.
  81. ALARM ON, as explained before, allows you to switch the alarm on or off.
  82.  
  83. The fifteen startup flags allow to to change the way JPClock is configured.
  84. The flag -d allows you to change the delay between updates, and
  85. therefore, the accuracy of the clock. -dSECONDS sets the clock to one update
  86. every SECONDS seconds, where SECONDS is a number from between 1 and 10.
  87. The more time between updates, the less CPU cycles the clock will steal.
  88. The -f flag allows you to automatically set the STAY FRONT option
  89. on; this is identical in effect to turning it on manually by clicking on the
  90. gadget. Similarly, the -a flag allows you to turn the ALARM on. The -u flag
  91. allows you to set USA date mode on; ie dates will be displayed (and expected
  92. to be entered) in the form MM-DD-YY, as opposed to the DD-MM-YY format.
  93. The -o flags allow you to turn various displays in the clock off. -ot turns
  94. the time display off, -oy turns the day display and -od turns the date
  95. display off. -of, -oc and -ol turn fast, chip and total memory display off.
  96. Note that you cannot turn everything off; if everything is turned off, time
  97. is automatically turned back on. The clock window size is changed depending
  98. on how much information is displayed.
  99. The -s flag allows you to automatically shove the clock window to the second
  100. screen; of course, if there is no second screen, or the second screen is too
  101. small, it will not move.
  102. The -at flag, followed by a time in the form HH:MM:SS (or H:MM:SSC if 12 hour
  103. mode is enabled - see below) will set the Alarm time to the time specified.
  104. The -x and -y flags allow you to specify which position the JPClock window
  105. will open in initially; these values default to 70 and 0. -xX and -yY opens
  106. the window with coordinates X,Y.
  107. The -12 flag allows you to specify 12 hour format for the time display. When
  108. -12 is specified, the time will be displayed in the format H:MM:SSC, where
  109. C is a character, either A or P, for AM and PM respectively. Note that when
  110. this option is specified, time and alarm time are expected to be entered
  111. in this format.
  112.  
  113. Please enjoy JPClock, and do not use it for any evil purposes (huh?..)
  114.  
  115. In case you feel the urge to correspond with me, my address is
  116.  
  117.    3 William Street
  118.    Clarence Park
  119.    South Australia, 5034
  120.    Australia
  121.  
  122. and as someone suggested I include it, my 'phone number is 08-293-2788.
  123.  
  124. Jon.
  125.  
  126. PS: JPClock is Public Domain, you may do whatever you like with it, however,
  127.     if you decide to sell it, at least leave my name in it.
  128.  
  129.                                   -JP-
  130.