home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: InfoMgt / InfoMgt.zip / ltclock5.zip / LTCLOCK.TXT < prev    next >
Text File  |  1995-10-29  |  5KB  |  128 lines
  1. ====================================================================
  2.  
  3.           LTClock - The Little Title Bar Clock that COULD
  4.  
  5.        Version 0.5 by Leo Comitale  (comital@ecf.utoronto.ca)
  6.  
  7. ====================================================================
  8.  
  9. LTClock is a simple program to put the time and date in the active
  10. window's title bar.
  11.  
  12. LTClock 0.5 features POSIX style localization, and now it looks
  13. better too.
  14.  
  15. INSTALLATION:
  16. ====================================================================
  17. Simple really,
  18.  
  19. 1. Use Info-Zip's Unzip to extract this archive to any directory.
  20.    (Pkzip will work, too, but you will lose the EA's)
  21. 2. Create a program object (or CNTRL-SHIFT-DRAG LTCLOCK.EXE, for a
  22.    shadow of the executable) and place it in your startup folder.
  23. 3. You can then open the settings and optionally add the following
  24.    switches to the PARAMETERS section:
  25.  
  26.    -L<XXXX> Override the LANG environment variable. (DEFAULT=CDEF)
  27.             Options include: FRAN,GERM,ITAL,SPAI,UK, and USA.
  28.  
  29.    -W       Remove LTClock from the Window List (DEFAULT=appear in Window 
  30.             List)
  31.  
  32.    -O       Specify an offset LTClock should move left in order to 
  33.             make room for title-bar modifying programs like Xit and 
  34.             NPSWPS, this value is specified as a multiple of the width 
  35.             of a title-bar button like the min or max button.  For
  36.             example if you use Xit, then you'd put -o1 in your
  37.             parameters section.
  38.  
  39.  
  40. LOCALE SUPPORT:
  41. ===================================================================
  42. To enable locale support, unzip the file LOCALES.ZIP (*) to a 
  43. directory located in your DPATH (or in the same directory as 
  44. LTClock).
  45.  
  46. Next, edit your config.sys and add the following SET statements:
  47. (These changes will not take effect until you reboot the system.)
  48.  
  49. SET LANG=<LOCALE>
  50.     Where <LOCALE> is one of:   CDEF - Default
  51.                                 FRAN - France
  52.                                 GERM - Germany
  53.                                 ITAL - Italy
  54.                                 SPAI - Spain
  55.                                 UK   - United Kingdom
  56.                                 USA  - USA
  57.  
  58.     Eg) For Germany, put "SET LANG=GERM" in your CONFIG.SYS
  59.  
  60.     NOTE that you can discard any LOCALE binaries you do not need.
  61.     These binaries may be used by other applications written using
  62.     IBM VisualAge C++.  The default locale CDEF is bound to the
  63.     executable so it is not really needed as a seperate binary if
  64.     you use it exclusively.  Also these are NEW binaries, the CSET
  65.     2.0 versions included with LTCLOCK 0.4 and below will not work
  66.     with 0.5.
  67.  
  68.  
  69. SET LTC_FORM=<STRING>
  70.     Where <STRING> defines the POSIX style date/time format
  71.  
  72.     Eg) The default time format would be set by placing
  73.  
  74.         SET LTC_FORM=%a, %b %d  %I:%M
  75.  
  76.         in your CONFIG.SYS, resulting in this:
  77.  
  78.         Mon, Jan 17 8:12
  79.  
  80.     See the file POSIX.FRM for more information on setting up your
  81.     own TIME/DATE format.
  82.  
  83. Change Log:
  84. ===========
  85.  
  86. 0.1 - 01-22-95     - Initial hack, called TCLOCK, never released.
  87. 0.2 - 01-29-95     - First released version.
  88. 0.3 - 02-25-95     - Overhauled update methods
  89.         - added POSIX support for DATE/TIME format
  90.         - added title bar position option
  91.         - added option for appearance in the Window List
  92.         - added update frequency option to alleviate "flickering"
  93.           title bars.
  94. 0.4 - ????????  - lost in the sands of time...
  95. 0.5 - 29-08-95  - LTCLOCK now paints the active titlebar instead of changing
  96.           the text, this solves the problem with "ghost" entries
  97.           in the Window list and even makes the program a
  98.           little more attractive (and as an EXTRA bonus, it
  99.           reduced the code complexity by a large factor!)
  100.         - added check to ensure only ONE instance active
  101.         - programs like PMView/WebEx do not resist the force...
  102.         - titlebar is updated every second, this is not adjustable
  103.           by the user as it is necessary in case of redraws etc.
  104.  
  105. Known Problems (version 0.5):(there always is a catch isn't there?)
  106. ===================================================================
  107. - Any program which adds buttons to the titlebar over and above the
  108.   MIN/MAX buttons (such as Xit, NpsWps, OD etc) will have it's addition 
  109.   overwritten by this clock. :( I have added the -O option to 
  110.   smooth over this, but I'd like to hear anyone's ideas for 
  111.   something a little more "clean".
  112.  
  113. Price Schedule & <stddisclaimer.h>:
  114. ===================================================================
  115. This program is FREE, give it to anyone and everyone who may want it.
  116. Please leave the archive unmodified when redistributing this program,
  117. and please report any bugs to me so I can brood over them, thanks.
  118.  
  119. I do not guarantee this program in any way whatsoever, so use it at 
  120. your own risk.  If you REALLY REALLY like it, email me and I'll give 
  121. you an address where you can send money.  :)
  122.  
  123. Leo Comitale
  124. comital@ecf.utoronto.ca
  125. ===================================================================
  126. (*) LOCALES.ZIP Contains IBM C/C++ Tools Runtime Modules (c) Copyright
  127.     IBM Corporation 1991, 1995.  All Rights Reserved.  These modules
  128.     are the property of IBM and are provided "AS IS."