home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 4 / CDPD_IV.bin / fish / 931-950 / ff949 / titleclock / titleclock.doc < prev    next >
Text File  |  1993-12-22  |  4KB  |  126 lines
  1.                    TitleClock V2
  2.                by Anders Hammarquist
  3.  
  4. This is FREEWARE, You may copy this program freely as long as you don't
  5. make a profit by doing so. A nominal copying charge is premissible.
  6.  
  7. TitleClock is a little commodity (about 3k) that throws up a clock in the
  8. top right corner of a screens titlebar. It may be set up to display itself
  9. on one or more screens, it may be set to follow you default public screen
  10. and also to always display on the frontmost screen.
  11.  
  12. There have been quite a few changes since the previous release. It will now
  13. display clocks on multiple screens, and also on non-public screens. This
  14. has resulted in new options, and some changes in the way that the program
  15. operates. Beware also that the stack requirement has increased (due to the
  16. use of dos.library's pattern matching functions).
  17.  
  18. TitleClock accepts the following arguments, entered on the command line
  19. from the CLI and in the ToolType field of the icon if run from the
  20. Workbench.
  21.  
  22. UPDATE=
  23.  
  24.     Number of seconds between clock updates. It's not recommended that you
  25.     make this value 0. Although you can, it will load the CPU enormously,
  26.     as TitleClock won't be waiting. Also, you probably don't want to make
  27.     the value too large, as the clock gets erased every time Intuition
  28.     changes the screen title. Though if you have a program that doesn't
  29.     change the screen's title, it would be no problem to put up a
  30.     TitleClock on it with UPDATE set to 60 seconds. Default is 1 second.
  31.     Please note that it believes wierd values, if you set update to -1, it
  32.     will update every 4 294 967 295 seconds
  33.  
  34. SHOWDATE
  35.  
  36.     If present, TitleClock will show todays date in addition to the current
  37.     time.
  38.  
  39. SHOWDAY
  40.  
  41.     If present, TitleClock will show the day in addition to the current
  42.     time.
  43.  
  44. SHORTDAY
  45.  
  46.     If present, the day name will be truncated to the three first
  47.     characters.
  48.  
  49. SHOWSECS
  50.  
  51.     If present, TitleClock will display seconds as well as hours and
  52.     minutes.
  53.  
  54. FORMAT=
  55.  
  56.     Sets the format of the date display. It can be one of the following:
  57.  
  58.     DOS         - displays as dd-mmm-yy
  59.     International   - displays as yy-mmm-dd
  60.     American        - displays as mm-dd-yy
  61.     Canadian        - displays as dd-mm-yy
  62.  
  63.     Default is DOS.
  64.  
  65. PUBSCREEN=
  66.  
  67.     Tells TitleClock which public screen to appear on. This may be a
  68.     standard AmigaDOS pattern, in which case the clock will appear on all
  69.     public screens whose name matches this pattern. The match is case
  70.     sensitive. Please note that specifying a pattern if you have a lot of
  71.     public screens will affect system performance.
  72.  
  73. SCREENPAT=
  74.  
  75.     This tells TitleClock which NON-public screens to appear on. It is a
  76.     standard AmigaDOS pattern, compared to the default title of all system
  77.     screens. The match is case sensitive. Note that the default title of
  78.     a screen may not be the same as that which is displayed. For example,
  79.     the default title for the Workbench screen is 'Workbench Screen'. Also
  80.     note that specifying this option when you have a lot of screens will
  81.     affect system performance.
  82.  
  83. FRONTSCREEN
  84.  
  85.     If this option is specified, TitleClock will display a clock on the
  86.     frontmost screen.
  87.  
  88. DEFSCREEN
  89.  
  90.     If this option is specified, TitleClock will display a clock on the
  91.     default public screen.
  92.  
  93. CX_PRIORITY=
  94.  
  95.     Sets the priority of TitleClock's commodity broker. Default is 0.
  96.  
  97. If you do not specify any of the PUBSCREEN, SCREENPAT, FRONTSCREEN, or
  98. DEFSCREEN options you will not get a clock. Also, the clock will not be
  99. displayed on any screen whose title is hidden, such as on a lot of terminal
  100. programs. Beware that Commodore's screenblanker included with 3.0 does NOT
  101. hide the title, so you will get a clock on it if you match it's title or
  102. specify FRONTSCREEN.
  103.  
  104. If you put TitleClock in your WBStartup drawer, Workbench likes to see
  105. a DONOTWAIT ToolType.
  106.  
  107. That should be it.
  108.  
  109. Questions, comments, bug reports, et.c. to:
  110.  
  111. Internet:
  112.     f92anha@dd.chalmers.se
  113.     -or-
  114.     Anders_Hammarquist@p16.f123.n203.z2.fidonet.cd.chalmers.se
  115.  
  116. FidoNet:
  117.     Anders Hammarquist of 2:203/123.16
  118.  
  119. Spare harddrives, memory, those Ethernet cards you aren't using, anything
  120. else you feel like donating (and any paper mail) to:
  121.  
  122.     Anders Hammarquist
  123.     Schottisvägen 17
  124.     S-424 38  Angered
  125.     Sweden
  126.