home *** CD-ROM | disk | FTP | other *** search
/ Windows 95 Secrets (4th Edition) / Windows95Secrets4thEdition.iso / utility / clocks / winclock / winclock.doc < prev    next >
Encoding:
Text File  |  1995-04-24  |  41.5 KB  |  1,129 lines
  1.             WinClock
  2.            ----------
  3.  
  4.           Version 4.03
  5.          --------------
  6.  
  7.        Copyright (c) 1990-1995 David A. Feinleib.
  8.     ------------------------------------------------
  9.  
  10. Introduction
  11. ------------
  12.     WinClock is a digital clock for Microsoft Windows 3.1 that has the
  13.     following features:
  14.     
  15.     - Display of time and date in many different formats
  16.     - 25 alarms (which can be set for daily or only a specified date)
  17.     - Date display in any of six languages
  18.     - Run Program Timer (ability to run programs at specified times)
  19.     - Optional hourly "beep"
  20.     - Allows user to set date and time easily
  21.     - Optionally stays in front of other applications
  22.     - "Remembers" its position on the screen
  23.     - Two stopwatches
  24.     - Two countdown timers
  25.     - Colon separating hours and minutes may be set to "blink"
  26.     - Context sensitive help
  27.     - Direct Screen saver compatibility (Auto detect active screen saver)
  28.     - "Cascade" and "Tile" compatibility
  29.  
  30. Additions/Improvements in versions of WinClock
  31. ----------------------------------------------
  32.  
  33.     - Version 2.00      [August 16, 1990]
  34.  
  35.     Version 2.00 was released to registered users and other select users
  36.     as a "pre-release" version of the major upgrade from versions
  37.     1.xx to 2.0x.  Please see the information about Version 2.01 for
  38.     additions/improvements.
  39.  
  40.     - Version 2.01      [August 22, 1990]
  41.  
  42.     Version 2.01 was released as the second "pre-release" version and
  43.     was numbered 2.01 to differentiate it from version 2.00.  It
  44.     included several enhancements to the timers, date display, and bug
  45.     fixes.
  46.  
  47.     Please see the information about Version 2.02 for
  48.     additions/improvements.
  49.  
  50.     - Version 2.02      [August 24, 1990]
  51.  
  52.     WinClock 2.02 fixed bugs in the timers and added several features
  53.     to the timers.  Some bugs in Version 2.01 concerning the display
  54.     of the date were also fixed.
  55.  
  56.     WinClock 2.02 was divided into segments so that while Versions 2.0x
  57.     were larger than 1.xx, it could run in less memory.
  58.  
  59.     WinClock 2.02 added support for International date formats as well
  60.     as more options for selecting date formats.
  61.  
  62.     WinClock 2.02 reduced some "flicker" that occurred on certain
  63.     monitors under certain conditions.
  64.  
  65.     WinClock 2.02 added four timers: two stopwatches and two countdown
  66.     timers.
  67.  
  68.     A bug which caused the second alarm to display an incorrect message
  69.     was fixed.
  70.  
  71.     WinClock 2.02 can "remember" its position on the screen.
  72.  
  73.     Context sensitive help was added (using Windows 3.0 help).
  74.  
  75.     WinClock 2.02 optionally displays the system box whereas previous
  76.     versions automatically displayed the system box.  This reduces the
  77.     area WinClock uses on the screen.
  78.  
  79.     The dialog box which allows the user to enter the date and time can
  80.     now be moved.
  81.  
  82.     Position adjustment was added to WinClock.  This means that when
  83.     the WinClock date format is changed or a timer is displayed,
  84.     WinClock will automatically move so that it does not appear off
  85.     the screen.
  86.  
  87.     WinClock 2.02 aligns itself by its right side and not by its
  88.     left side which allows it to better retain its position when one
  89.     of the display options (such as displaying the system box) is
  90.     changed.
  91.  
  92.     In WinClock 2.02, the alarm configuration file and the WinClock
  93.     configuration file have been combined into one configuration file
  94.     (winclock.cfg) which speeds up the program and reduces the amount
  95.     of disk space used.
  96.  
  97.     WinClock now stores configuration files in the Windows directory
  98.     instead of in its own directory to assure that the configurations
  99.     are read.  (In previous versions of WinClock, the configuration
  100.     file was not always read because it was in the wrong directory.)
  101.  
  102.     - Version 2.03      [August 25, 1990]
  103.  
  104.     Version 2.03 added the "Anti-Cascade" option which, when
  105.     selected, causes WinClock not to be cascaded when the
  106.     user cascades windows.
  107.  
  108.     Version 2.03 fixed a bug in the timers which caused an incorrect
  109.     display of the timers when the seconds weren't selected to
  110.     be displayed.
  111.  
  112.     - Version 2.04      [August 29, 1990  &  August 30, 1990]
  113.  
  114.     Version 2.04 fixed a problem which occurred when tiling windows.
  115.     This fix allows the user to hide WinClock for about seven seconds
  116.     during which time the open windows may be tiled.
  117.  
  118.     New icons were added to WinClock in version 2.04 (August 30, 1990).
  119.  
  120.     - Version 2.05      [September 6, 1990]
  121.  
  122.     Version 2.05 removed some bugs in version 2.04.
  123.  
  124.     - Version 2.06      [September 11, 1990 & September 21, 1990]
  125.  
  126.     Please note that WinClock 2.06 was released in Beta Test on September
  127.     11, 1990.  Small bugs concerning the blinking colon (see below) were
  128.     fixed during this date and the actual release date of September 21,
  129.     1990.
  130.  
  131.     Version 2.06 added the feature which allows the user to select
  132.     to have the colon in the time blink on and off on the second
  133.     when the seconds are not being displayed.
  134.  
  135.     Version 2.06 (and later) will display a short note if WinClock
  136.     is already running and the user tries to run WinClock.
  137.  
  138.     - Version 2.07      [September 23, 1990]
  139.  
  140.     Version 2.07 added Screen Saver Compatibility.  Setting this option
  141.     on will cause WinClock to be hidden (not displayed on the screen)
  142.     after a certain amount of time when the mouse or keyboard have not
  143.     been activated.
  144.  
  145.     - Version 2.08      [September 29, 1990]
  146.  
  147.     Version 2.08 fixed a bug in the timers which caused the display to
  148.     show incorrect timer counts.
  149.  
  150.     Version 2.08 modified the timer start/stop button to make it easier
  151.     to use.
  152.  
  153.     Version 2.08 added the "Lock location" option which allows the user
  154.     to lock WinClock's location on the screen.
  155.  
  156.     - Version 3.00      [October 5, 1990]
  157.  
  158.     Please note that this version was released as "3.00 Beta Test"
  159.     so that it could be tested and bugs could be reported.
  160.  
  161.     Version 3.00 added many features to the "Alarms" section.  You can
  162.     now run a program at a certain time and enter the time for alarms
  163.     to go off in 12-hour or 24-hour format.
  164.  
  165.     The "Run-Program" option was the reason for the change of major
  166.     version number from 2.xx to 3.00.
  167.  
  168.     There are now four alarms instead of just two.
  169.  
  170.     You may now specify the screen saver compatibility delay in
  171.     the form MM:SS (minutes:seconds) instead of just seconds.  (You may
  172.     enter the delay in seconds; it will be converted to the MM:SS form.)
  173.  
  174.     Bugs which caused the set time/date feature to function
  175.     incorrectly have been fixed.
  176.  
  177.     You may now specify the time to set in the set time/date function
  178.     in 12 or 24 hour format.
  179.  
  180.     The keyboard interface was updated to reflect changes that
  181.     were made in the last several versions.
  182.  
  183.     Previous versions of WinClock had trouble dealing with
  184.     configuration files created by different versions of WinClock -
  185.     sometimes causing memory or other problems.  This has been
  186.     fixed.  (Please note though, that, as in other versions, you
  187.     will have to re-select your Preferences when you first upgrade to
  188.     this version of WinClock.)
  189.  
  190.     The time it takes for WinClock to write the configuration file
  191.     was reduced.
  192.  
  193.     - Version 3.01      [October 15, 1990]
  194.  
  195.     Versions 3.01 and 3.02 were released to specific Beta Testers.
  196.  
  197.     A bug which caused the screen-saver compatibility function to work
  198.     incorrectly was fixed.
  199.  
  200.     - Version 3.02      [November 2, 1990]
  201.  
  202.     Direct screen saver compatibility was added to WinClock.  This means
  203.     that WinClock can now automatically detect an active screen saver and
  204.     hide itself.  (WinClock is directly compatible with most available
  205.     screen savers.)
  206.  
  207.     The alarms now have different "beeps" - high, low; long, short.
  208.  
  209.     The Beep of the Hourly Beep was changed to a more regular beep
  210.     so that it does not get speeded up on faster machines.
  211.  
  212.     A Beep option was added to the timers so that the countdown timers
  213.     can beep when they finish.
  214.  
  215.     A bug which caused the set time/date function to malfunction was
  216.     fixed.
  217.  
  218.     The time and date may be set in 12/24 hour format.
  219.  
  220.     The alarms dialog box was modified to look better and be easier
  221.     to use.
  222.  
  223.     The direct screen-saver compatibility option was enhanced.  In
  224.     addition, WinClock compatibility was added for other screen-savers.
  225.  
  226.     The code to write the configuration file has been optimized so that
  227.     unlike previous versions, if no changes are made to the Preferences
  228.     or Alarms section, the configuration file will not be changed; this
  229.     means that the configuration file will only be written when
  230.     changes are made and that the hard disk usage of WinClock has been
  231.     decreased while the speed with which WinClock runs has been
  232.     increased.
  233.  
  234.     - Version 3.03      [December 7, 1990]
  235.  
  236.     This version added features to the alarms.
  237.  
  238.     - Version 3.04      [December 23, 1990]
  239.  
  240.     This version enhanced the alarms further.
  241.  
  242.     The run-program option can now list files available
  243.     to run.
  244.  
  245.     There are many different date settings for the alarms,
  246.     including dates such as every, every other...
  247.     combined with Sunday, Monday, Tuesday...
  248.  
  249.     Some bugs in the set date and time dialog box were fixed;
  250.     WinClock now handles changes from 12 to 24 hour format
  251.     correctly.
  252.  
  253.     There are now ten alarms available instead of just four.
  254.  
  255.     Version 3.04 added compatibility with more screen savers.
  256.  
  257.     Version 3.04 added full Registered User support (please see
  258.     the section on registering WinClock for more information).
  259.  
  260.     - Version 3.04 - 1-11-91    [January 11, 1991]
  261.  
  262.     A small bug fix was made which allows the user to set different
  263.     alarms without having to click OK after setting each one.
  264.  
  265.     - Version 3.04 - 1-29-91    [January 29, 1991]
  266.  
  267.     A small bug fix was made which fixes the problem which occurred
  268.     when the resolution or Windows video driver was changed.
  269.     WinClock now returns to the lower right hand corner if a different
  270.     resolution is detected; the user can then move WinClock to the
  271.     user's preferred position.
  272.  
  273.     - Version 3.04 - 2-02-91    [February 2, 1991]
  274.  
  275.     A small bug fix was made which allows WinClock to search for
  276.     files on the path when checking to see whether the program
  277.     selected to run (see Alarms) using the "Run Program" option
  278.     exists.
  279.  
  280.     - Version 3.04 - 2-03-91    [February 3, 1991]
  281.  
  282.     A small bug fix was made so that WinClock will position itself
  283.     correctly on the screen the first time it is run.
  284.  
  285.     - Version 3.04 - 2-15-91    [February 15, 1991]
  286.  
  287.     A small bug fix was made so that WinClock could be moved using
  288.     the "Move" menu command as well as by just using the mouse and
  289.     left mouse button to move WinClock.
  290.  
  291.     - Version 3.05 - 2-17-91    [February 17, 1991]
  292.  
  293.     A bug fix was made so that the currently selected alarm's
  294.     settings are properly recorded.
  295.  
  296.     An option was added that allows WinClock to sound an alarm
  297.     even if a screen saver is active.
  298.  
  299.     - Version 3.10              [March 24, 1991]
  300.  
  301.     An option was added so that WinClock can remind the user
  302.     of an event (appointment, etc.) that the user has set in
  303.     the alarms section, on startup of WinClock.
  304.  
  305.     Enhancements were made for registered users.
  306.  
  307.     The code was optimized; Windows can now swap portions
  308.     of WinClock out to disk more easily.
  309.  
  310.     - Version 3.10              [March 26, 1991]
  311.  
  312.     Additional screen saver compatibility was added.
  313.  
  314.     - Version 3.11              [April 15, 1991]
  315.  
  316.     Screen saver compatibility was improved, updated, and modified
  317.     to deal better with different screen savers.
  318.  
  319.     An option was added to allow a change from PM to pm.
  320.  
  321.     - Version 3.15              [May 5, 1991]
  322.  
  323.     Screen saver compatibility was further enhanced.
  324.  
  325.     If no separator is entered in the Preferences box, WinClock
  326.     will now default to a space as separator, which fixes
  327.     a bug in previous versions.
  328.  
  329.     The alarm interface was revamped; it is now much easier
  330.     to set a single alarm.
  331.  
  332.     - Version 3.20              [February 17, 1992]
  333.                 [March 15, 1992]
  334.                 [April 17, 1992]
  335.  
  336.     Released April 17, 1992.
  337.  
  338.     Changed underscore in Hourly Beep from H to o so that it would not
  339.     conflict with the underscore under the H in Help (in menu).
  340.  
  341.     Added fix so that right mouse button works correctly.
  342.  
  343.     WinClock will now work properly under the debugging kernel.
  344.  
  345.     Fixed bug that caused WinClock to work incorrectly when
  346.     Microsoft Tutorials were running.  WinClock now does not
  347.     conflict with the tutorials.
  348.  
  349.     Fixed bug that caused system box to change incorrectly under
  350.     Windows 3.1.
  351.  
  352.     Fixed bug that caused WinClock to work incorrectly with Windows
  353.     3.1 screen savers.
  354.  
  355.     Made WinClock menu more concise.
  356.  
  357.     Added options to Preferences dialog to allow you to choose
  358.     whether WinClock returns you to Windows if a DOS box is
  359.     active and it is time for an alarm or the hourly beep to occur.
  360.  
  361.     - Version 3.21                [May 14, 1992]
  362.  
  363.     Added code to select associated radio button if
  364.     note or run program (in alarm dialog box) edit box is selected.
  365.  
  366.     - Version 3.21                [June 1, 1992]
  367.  
  368.     Released version 3.21 to public.
  369.     
  370.     - Version 3.22                [February 20, 1994]
  371.                   [May 27, 1994]
  372.  
  373.     Released to beta testers.
  374.  
  375.     - Version 4.00                [August 23, 1994]
  376.  
  377.     Released August 23, 1994.
  378.  
  379.     Alarms can now use the speaker or wave files.  
  380.  
  381.     Added support for display in any of six languages.
  382.  
  383.     Preferences dialog enhanced to support more customization of display;
  384.     can change separators between each part of the date and add extra
  385.     space to the left and right of the display.
  386.     
  387.     Modified hourly beep function; now called hourly alert function/
  388.     Includes wave file support, which can repeat based on number of hours.
  389.  
  390.     Most selections now done using drop down combo boxes instead of
  391.     radio buttons.
  392.     
  393.     - Version 4.01                [September 3, 1994]
  394.     
  395.     Added a flag to wave file play function to allow WinClock to work
  396.     with the PC-Speaker sound driver.  Note that when using the
  397.     PC-Speaker driver, the wave file will only be played once (it
  398.     will not be repeated for the number of hours).  This is due to a limitation
  399.     of the PC Speaker driver (it is a synchronous device).
  400.  
  401.     - Version 4.02                [December 25, 1994]
  402.         
  403.     Added "Today" button to Alarms dialog to allow for easier setting
  404.     of One-Date alarms.            
  405.         
  406.     Fixed bug which caused corrupt display when time 
  407.     was displayed without date.  
  408.     
  409.     Fixed bug that caused timer display to be cut off 
  410.     if displayed with time and date.
  411.     
  412.     Fixed bug that caused wave file error messagebox's to appear
  413.     on screen repeatedly if a wave file error occurred.
  414.     
  415.     Fixed bug that did not allow for entering of proper dates in 
  416.     alarm setting single date edit box.
  417.     
  418.     Fixed bug that caused choice of Note or Run Program selection in
  419.     Alarms Setting dialog box not to be stored if the edit box for either
  420.     was clicked on rather than the radio button.
  421.     
  422.     When checking whether programs in the Run Program edit box are
  423.     valid or not WinClock now allows for command line parameters
  424.     (ie write.exe file.txt rather than just write.exe without a 
  425.     parameter).                                     
  426.     
  427.     WinClock can now be set not to display the time (previously this option
  428.     appeared in the Preferences dialog but the program did not
  429.     use this preference when displaying the date and time).
  430.     
  431.     Fixed bug (from version 4.00; did not occur in 3.21) which caused 
  432.     insufficient display space when using timers or stopwatches.
  433.     
  434.     - Version 4.03                      [March 27, 1995]
  435.                     [April 24, 1995]
  436.  
  437.     Fixed bug which caused wave file not to be played on enhanced
  438.     alarms after the first time an alarm was activated.
  439.     
  440.     Fixed bug which caused enhanced alarm to be activated
  441.     improperly (i.e. first/second/third/fourth of every month
  442.     did not function properly).
  443.  
  444.     Modified Display Space Feature so that space before clock text can
  445.     be increased or reduced as necessary.
  446.  
  447.     Released April 24, 1995.
  448.  
  449.                     
  450. Requirements for running WinClock
  451. ---------------------------------
  452.     
  453.     - Microsoft Windows 3.1
  454.     - WinClock (WINCLOCK.EXE, WCHOOK.DLL, WSAVER.DLL
  455.     DATEFUNC.DLL, WINCLOCK.HLP, DAFLIB.DLL, DAFLIB.HLP)
  456.  
  457. Running/Installing/Upgrading WinClock
  458. -------------------------------------
  459.  
  460.     Please note that the following directions assume you are using a
  461.     mouse.  If you are not using a mouse, please refer to your Windows
  462.     documentation for equivalent keystrokes.
  463.  
  464.     - Upgrading WinClock
  465.     If you are upgrading from a previous version of WinClock, you
  466.     should copy this version of WinClock to the same directory that
  467.     the old version is in.  Since configuration files of previous
  468.     versions of WinClock are not compatible with this version,
  469.     the first time you run WinClock you will see a message which
  470.     tells you that your configuration file was created by a different
  471.     version of WinClock and that your preference settings have been
  472.     reset to the default.  You may want to change the settings back
  473.     to your preferred settings.
  474.  
  475.     1. Copy WINCLOCK.EXE, WCHOOK.DLL, WINCLOCK.HLP, DAFLIB.DLL,
  476.        and DAFLIB.HLP to your Windows directory or another 
  477.        directory of your choice.  Note that all of the files must be
  478.        copied to the same directory.
  479.  
  480.     2. Do one of the following:
  481.     
  482.     Note: Option D is highly recommended over A, B, and C.
  483.     
  484.     A.  Click on "File" then "Run..." in the Program Manager menu.
  485.         Type WINCLOCK.EXE (including the path) in the "Command
  486.         line" edit box and click "OK".  If you use this option,
  487.         you will have to do this every time you want to run
  488.         WinClock.
  489.  
  490.     B.  Click on one of the program groups in the Program
  491.         Manager (the "Accessories" group is suggested).  Select
  492.         "File" then "New..." from the program manager menu.
  493.         Select "Program Item" and type WINCLOCK.EXE in the
  494.         "Command line" edit box.  For example, you might type:
  495.         C:\WINDOWS\WINCLOCK.EXE if that was the directory into
  496.         which you had copied WinClock.  WinClock has several
  497.         different icons from which you may choose.  To see
  498.         the icons, click on "Change icon" then click on
  499.         "View next" until you find an icon that you like.
  500.         When you want to run WinClock, double click on the
  501.         WinClock icon.
  502.  
  503.     C.  On the line that says "load=" in your WIN.INI file,
  504.         add WINCLOCK.EXE (with the appropriate path).  For
  505.         example, if you copied WINCLOCK.EXE to C:\WINDOWS,
  506.         the line would say: load=C:\WINDOWS\WINCLOCK.EXE
  507.  
  508.         This option will automatically run WinClock each time
  509.         you run Windows.
  510.  
  511.     D.  Do both B and C, which will automatically run WinClock
  512.         and allow you to run WinClock easily if you close it.
  513.  
  514. WinClock Options
  515. ----------------
  516.  
  517.     To bring up a list of options, click once on the WinClock
  518.     system box.
  519.  
  520.     1. Help...
  521.  
  522.     This will bring up help about WinClock and explain how to
  523.     use context sensitive help.  It will also display an index
  524.     of all help available for WinClock.
  525.  
  526.     
  527.     2. Set Time/Date...
  528.     
  529.     This allows you to easily enter the time and date.  When
  530.     the window pops up, enter the correct time and date.
  531.     Click AM or PM to set the time in 12-hour format
  532.     or click 24-hr and enter the time in 24-hour format.
  533.     WinClock will automatically convert 24-hour format
  534.     to 12-hour format if you click PM after 24-hr was selected.
  535.     WinClock will also convert from PM to 24-hour format.
  536.  
  537.     The current time and date will be shown in the edit boxes
  538.     when the window originally appears.  To update the time and
  539.     date displayed in the edit boxes to the current time and
  540.     date, click the "Time" or "Date" push-button depending on
  541.     which you want to update.
  542.  
  543.     When you have made all your choices, click "OK"
  544.     (or press <Enter>).  If you want to leave the old
  545.     time and date, click "Cancel".
  546.  
  547.     You should select Auto Advance Date only if you are
  548.     using a version of DOS that does not advance the
  549.     date correctly at midnight.
  550.  
  551.     3. Alarms...
  552.  
  553.     This allows you to configure one or both of WinClock's
  554.     alarms.  To set an alarm: Click on the alarm you want to
  555.     set (Alarm One or Two).  When you have made your choices,
  556.     click "OK".  If you want to leave the alarms the way
  557.     they were, click "Cancel".
  558.  
  559.     -Enabled
  560.     If you want the alarm to be on, select
  561.     "Enabled" (so that there is an "x" in the box). If
  562.     you do not want the alarm to be on, but only want to set it
  563.     for use at a later time, click on "Enabled" until there is no
  564.     "x" in the box.
  565.  
  566.     -Time
  567.     Enter the time for the alarm to go off in
  568.     the edit box.  If you select AM or PM, enter the time
  569.     in 12-hour format.  If you select 24-hr, enter the time
  570.     in 24-hour format.
  571.  
  572.     -Date
  573.     One Date
  574.  
  575.     Select One Date to have the alarm go off on a single date.  Type the
  576.     date in the edit box.
  577.  
  578.     Start Date
  579.  
  580.     Select Start Date and enter the start date in the edit box.  The start
  581.     date is the date from which the alarms in the lower portion of the
  582.     dialog box start.  The start date causes the alarm to go off on-Beep
  583.     To have the alarm beep when it goes off, select "Beep" so
  584.     that there is an "x" in the box.  Select high or low pitch.
  585.     Select the duration of the beep.  Short is about eight
  586.     seconds; long is about 30 seconds.  Both beeps may be
  587.     stopped by clicking "OK" when the box alerting you to
  588.     the alarm appears.
  589.  
  590.     Week Interval
  591.     - Periodic
  592.     The periodic section causes alarms to go off on dates such as:
  593.     Every Thursday, Every other Wednesday, and so on.  Select the
  594.     periods that you want and choose the dates with which they
  595.     should be combined.
  596.  
  597.     - Of Every Month
  598.     This section causes alarms to go off on dates such as:
  599.     The first Thursday of every month, the second Wednesday
  600.     of every month, and so on.
  601.  
  602.     - Day
  603.     This section is combined with options you select in the
  604.     "Periodic" and "Of Every Month" sections.
  605.  
  606.     Examples
  607.     --------
  608.     Periodic
  609.  
  610.     To have an alarm go off Every Other Tuesday, you would
  611.     select "Every Other" in the "Periodic" Section and
  612.     "Tuesday" in the "Day" section.
  613.  
  614.     If you entered 5-15-90 in the "Start Date" edit box and
  615.     selected "Every" and "Tuesday," since 5-15-90 is a Tuesday,
  616.     the alarm would go off on 5-15-90, 5-22-90, 5-29-90,
  617.     6-04-90, and so on.
  618.  
  619.     Of Every Month
  620.  
  621.     To have an alarm go off on the Second Wednesday of Every
  622.     Month, you would select "Second" in the "Of Every Month"
  623.     section and "Wednesday" in the "Day" section.
  624.  
  625.     If you entered 5-15-90 in the "Start Date" edit box and
  626.     selected "Third" in the "Of Every Month Section" and
  627.     "Monday" in the "Day" section, the alarm would go off on
  628.     6-17-90, since that is the third Monday of the month.
  629.  
  630.     -Note/Run Program
  631.     If you want to, enter a note to display when the alarm goes
  632.     off.  Select "Run Program" to run a program at the time
  633.     for which you have set the alarm.  Type the full pathname
  634.     of the program you want to run.  Select "Max" if you want
  635.     the program to be maximized when it is run, "Min" to have
  636.     it minimized, or "Normal" to have it shown in its normal
  637.     size.
  638.  
  639.     If you type the name of a program that does not exist on
  640.     your hard disk, a warning message will appear when you
  641.     click "OK".  You may then choose to edit the name of
  642.     the program to run or to leave it unedited.
  643.  
  644.     4. Timers...
  645.  
  646.     WinClock has two stopwatches and two countdown timers.  By
  647.     selecting different options you can have WinClock display
  648.     some or all of the timers as well as the time and date.  In
  649.     order to use a countdown timer, you must type a number from
  650.     which to countdown in the "Countdown from" edit box.  This
  651.     number must be in the form: HH:MM (hours:minutes).  If it
  652.     is not in this form, any number found (that is before non
  653.     numeric numbers, excluding the colon) will be used as the
  654.     minutes.
  655.  
  656.     Select "Display Timer" individually for each timer if you
  657.     want to display it (or to not display it).  Select
  658.     "Display Date" and/or "Display Time" if you want to
  659.     display the date and/or time while one or more of the
  660.     timers are running.  The display of the date and time
  661.     are not dependent on the timer that is currently selected.
  662.     "Display seconds" is selected by default.  If you do not
  663.     want to display the seconds, click on it so that there is
  664.     no "x" in the box.  You can choose to display the seconds
  665.     individually for each timer.  The seconds will only be
  666.     displayed if "Display Timer" has been selected.
  667.  
  668.     The settings that you make in the Timer dialog box only
  669.     effect the WinClock display while one or more timers are
  670.     running.  The settings will be saved while WinClock is
  671.     running but will be reset to the default when WinClock
  672.     is restarted.
  673.  
  674.     When you have selected to display a timer, it is displayed
  675.     as follows:
  676.     The first stopwatch appears as: S1 00:00:00
  677.     The second stopwatch appears as: S2 00:00:00
  678.     The first countdown timer appears as: C1 00:00:00
  679.     The second countdown timer appears as: C2 00:00:00
  680.  
  681.     The current count (time elapsed) of the selected timer
  682.     will appear in the "Current Count" box while the Timers
  683.     dialog box is displayed.
  684.  
  685.     When a timer is stopped, its current count will be displayed
  686.     in the "Current Count" box until you switch to another timer.
  687.     The stopped timer will then reset itself to zero.
  688.  
  689.     The "Start/Stop" button will reflect whether the
  690.     currently selected timer is running.  If the current timer
  691.     is running, the button will display "Stop" so that you may
  692.     stop the timer.  If the current timer is not running,
  693.     the button will display "Start" so that you may start it.
  694.  
  695.     Each countdown timer may be set to "beep" or not to "beep."
  696.     Select "beep" so that there is an "x" in the box if you
  697.     want the countdown timer to beep when it finishes.  Select
  698.     the pitch and the duration of the beep.  The short beep
  699.     lasts about eight seconds; the long beep lasts about
  700.     thirty seconds.  Both beeps may be stopped by clicking
  701.     "OK" when the window alerting you that the timer has
  702.     finished appears.
  703.  
  704.     5.  Hourly beep
  705.  
  706.     Select this option if you want WinClock to sound a short beep
  707.     and flash on the hour.  A check mark will appear next to
  708.     "Hourly beep" if it is selected.  To turn off the Hourly beep,
  709.     click on "Hourly beep".  The check mark will disappear.
  710.  
  711.     Special note for 386 Enhanced mode:
  712.     If a DOS box is active and hourly beep is enabled, 
  713.     WinClock will, by default, return you to Windows and beep.  
  714.     You must then double click on the DOS icon to return to 
  715.     the DOS box.  If you do not want to be returned to Windows 
  716.     when an hourly beep occurs, deselect the For Hourly Beep 
  717.     check box in the Preferences dialog box.
  718.     
  719.     New!  WinClock now includes support for wave files when
  720.     sounding the hourly alert.
  721.  
  722.     6. Preferences...
  723.  
  724.     Preferences allows you to change how the date and time are
  725.     displayed.  Select the options you want and click "OK".
  726.  
  727.     Date Formats
  728.     ------------
  729.     - Separator
  730.     You may change the character that separates the parts of the
  731.     date by typing a different character in the "Separator"
  732.     edit box.  Although it is possible to type more than one
  733.     character, only the first character you type will be used.
  734.  
  735.     - Blinking Colon
  736.     If you would like the colon that separates the hours and
  737.     minutes of the time to blink on the second when the
  738.     seconds are not displayed, select "Blink Colon" so that
  739.     there is an "x" in the box.
  740.  
  741.     Screen Saver Compatibility
  742.     --------------------------
  743.     WinClock is compatible with most available screen savers.
  744.     (Note that WinClock itself is not a screen saver.)
  745.  
  746.     - Auto
  747.     Setting this option will cause WinClock to be hidden when
  748.     a screen saver saves the screen.  This option is compatible
  749.     with most screen savers; it is recommended that you try this
  750.     option first if you would like screen saver compatibility.
  751.  
  752.     - Delay
  753.     Setting this option on will cause WinClock to be hidden
  754.     (not displayed on the screen) after the amount of time that
  755.     you specify in the edit box, when the mouse and keyboard have
  756.     not been activated.
  757.  
  758.     You must set the delay in the form MM:SS (minutes:seconds).
  759.     If it is not in this form, any number found (that is before
  760.     non numeric numbers, excluding the colon) will be used as
  761.     the seconds.
  762.  
  763.     It is recommended that you use this option if the "auto"
  764.     option (see above) does not work correctly with your
  765.     screen saver.
  766.  
  767.     - None
  768.     This turns off screen saver compatibility which means that
  769.     WinClock will not be hidden if you have a screen saver.
  770.  
  771.     Display
  772.     -------
  773.     - Bring To Front
  774.     If you want WinClock to appear over other applications,
  775.     select "Bring To Front".
  776.  
  777.     - System Box
  778.     If you want WinClock to display a system box, select
  779.     "System Box".  Hiding the system box reduces the area that
  780.     WinClock takes up on the screen.  See "Displaying/
  781.     Hiding the system box" for more information.
  782.  
  783.     - Anti-Cascade
  784.     You should select "Anti-Cascade" if you do not want
  785.     WinClock to be cascaded when you cascade the open
  786.     windows.
  787.  
  788.     Screen Location
  789.     ---------------
  790.     - One Screen Location
  791.     WinClock remembers one screen location by default.  This
  792.     means that when you move WinClock it remembers its
  793.     position on the screen so that the next time you run
  794.     WinClock, it will go to the position where it was when it
  795.     was closed.
  796.  
  797.     - Always Return To Default Screen Location
  798.     If you want to move WinClock to a certain location for only
  799.     the current time that WinClock is running but then revert to
  800.     the default screen position, select "Always Return To
  801.     Default Screen Location."  The next time you run WinClock,
  802.     it will revert to its default location.
  803.  
  804.     - Lock Location
  805.     This will lock WinClock's location on the screen so that you
  806.     do not move it accidently.
  807.  
  808.     DOS boxes, Alarms, and Hourly Beep
  809.     ----------------------------------
  810.     The following information only applies when Windows is 
  811.     running in 386 Enhanced mode.
  812.  
  813.     If a DOS box is active and an alarm is enabled and set to 
  814.     go off, WinClock will, by default, return you to Windows 
  815.     and display the message, beep, and/or run a specified 
  816.     program.  You must then double click on the DOS icon to 
  817.     return to the DOS box.  If you do not want to be returned 
  818.     to Windows when an alarm occurs, deselect the For Alarms 
  819.     check box in the Preferences dialog box.
  820.  
  821.     If a DOS box is active and hourly beep is enabled, 
  822.     WinClock will, by default, return you to Windows and 
  823.     beep.  You must then double click on the DOS icon 
  824.     to return to the DOS box.  If you do not want to be 
  825.     returned to Windows when an hourly beep occurs, deselect 
  826.     the For Hourly Beep check box in the Preferences dialog box.
  827.  
  828.     7. About...
  829.  
  830.     Select "About..." to display information about WinClock.
  831.  
  832. Getting Help
  833. ------------
  834.  
  835.     WinClock help may be accessed in three ways:
  836.  
  837.     1.  Select help from the WinClock system menu.  This will display
  838.     an index of all help available for WinClock.  It will also
  839.     explain how to use WinClock's context sensitive help.
  840.  
  841.     2.  You may access context sensitive help by clicking on one of the
  842.     WinClock system menu items, holding down the mouse button, and
  843.     pressing F1.
  844.  
  845.     3.  You may access context sensitive help from most
  846.     of WinClock's dialog boxes by clicking on the "Help" button
  847.     if one is displayed.
  848.  
  849. Displaying/Hiding the system box
  850. --------------------------------
  851.  
  852.     You may display/hide the system box in the following ways:
  853.  
  854.     1.  Open the Preferences dialog box and select System Box so that
  855.     there is an "x" in the box.  This will display the system box.
  856.     To hide the system box from the Preferences dialog box, select
  857.     System Box so that there is no "x" in the box.
  858.  
  859.     2.  Double click on the WinClock caption (the caption is the area
  860.     in which the time and date are displayed).  If the system box is
  861.     hidden, it will appear; if it is displayed, it will be hidden.
  862.  
  863. The right mouse button
  864. ----------------------
  865.  
  866.     If you want to "Tile" the open windows, you should click once
  867.     with the right mouse button on the WinClock client area (the
  868.     area where the time and date are displayed).  This will cause
  869.     WinClock to be hidden for about seven seconds, during which time
  870.     you may tile the open windows.
  871.  
  872. Avoiding cascading or tiling WinClock
  873. -------------------------------------
  874.  
  875.     Cascading
  876.     ---------
  877.     If you want to "Cascade" the open windows, it is useful to
  878.     have the "Anti-Cascade" option selected (in the
  879.     Preferences dialog box)  so that WinClock does not get cascaded.
  880.  
  881.     To select "Anti-Cascade", select "Preferences..." from
  882.     WinClock's system menu.  In the "Preferences" dialog box,
  883.     select "Anti-Cascade" so that there is an "x" in the box.
  884.  
  885.     Tiling
  886.     ------
  887.     If you want to "Tile" the open windows, you should click once
  888.     with the right mouse button on the WinClock client area (the
  889.     are where the time and date are displayed).  This will cause
  890.     WinClock to be hidden for about seven seconds, during which time
  891.     you may tile the open windows.
  892.  
  893. Moving WinClock
  894. ---------------
  895.  
  896.     To move WinClock, click on WinClock and, while holding the mouse
  897.     button down, move WinClock.
  898.  
  899. Closing WinClock
  900. ----------------
  901.  
  902.     To close WinClock, do one of the following:
  903.  
  904.     1.  Double click on the WinClock system box.
  905.  
  906.     2.  Click once on the WinClock system box and then click on
  907.        "Close".
  908.  
  909. How to contact me
  910. -----------------
  911.  
  912.     Comments and suggestions (and reports of problems) would be greatly
  913.     appreciated.  You can contact me in the following ways:
  914.  
  915.     1. Write:
  916.  
  917.     David A. Feinleib
  918.     30 Hamilton Road #401
  919.     Arlington, MA 02174
  920.  
  921.     2. Send CompuServe mail to:
  922.  
  923.     76516,20
  924.  
  925.     3. Send Internet mail to:
  926.  
  927.     76516.20@compuserve.com
  928.  
  929. How to pay for/register WinClock
  930. --------------------------------
  931.  
  932.     WinClock is ShareWare.  
  933.  
  934.     You may make copies of this program and give them to others as
  935.     long as the documentation is provided with the program, both
  936.     unaltered.
  937.  
  938.     Please refer to the About Box for information on registering
  939.     the program.  From the About Box you can print out a 
  940.     registration form.  Alternatively, you can print out the file
  941.     REGISTER.DOC.
  942.  
  943.     Please include your name, address, and current version number,
  944.     as well as the name of the program that you are registering.
  945.  
  946.     (The version number may be found in the About Box.)
  947.     See above for the address.
  948.  
  949. Thanks!
  950. -------
  951.  
  952.     My thanks to those BIX users who, by downloading WinClock, inspired
  953.     me to write this version.  Credit is due to John Ogren for
  954.     suggesting the addition of international date formats.  Thanks to
  955.     Guy J. Gallo for his suggestions (most of which were implemented)
  956.     on the alarms.  Thanks to Steve Garcia, Ernest Karhu, Mark Lutton,
  957.     and William Saito for their suggestions which greatly
  958.     influenced this version of WinClock and especially to Peter Kaminski
  959.     for help with the icons and for his numerous comments, suggestions,
  960.     and support from the beginning and all through the testing stages
  961.     which resulted in many of the changes in this version.  My thanks
  962.     to Peter W. Meek for his encouragement, sense of humor, testing,
  963.     and suggestions for the new alarm options.  Thanks to Steve
  964.     Moshier for help with the algorithms used in the new alarm options.
  965.     Thanks to Bruce Wheelock for his extensive testing.  Thanks to
  966.     Arlan Fuller for his sense of humor and help with various parts
  967.     of WinClock.
  968.     
  969.     Version 4.00 and later -- Thanks to Larry Lovell, James W. Baer, and
  970.     Peter H. Orvis for their invaluable bug reports and suggestions.
  971.     Also thanks to Jim Roth for his bug report about wave files 
  972.     and enhanced alarms.
  973.  
  974. Other products by the same author
  975. ---------------------------------
  976. For MS Windows 3.x:
  977.  
  978.     Utilities
  979.     ---------
  980.  
  981.     RandScrn            Randomize your Windows 3.1 screen savers.  Comes
  982.         with several new savers, including Random
  983.         Rectangles, Random Pixels, Bouncing lines,
  984.         Laser Show, and Circles.
  985.  
  986.  
  987.     RunProg             RunProg allows you to run a program at a size
  988.         that you specify, maximized, minimized, normal,
  989.         hidden, or coordinates that you specify,
  990.         from the Program Manager or from your WIN.INI
  991.         file.
  992.  
  993.     PrintSwitch         Easily switch between HPPCL and PostScript modes
  994.         on a Hewlett Packard laser printer with a postscript
  995.         cartridge installed
  996.  
  997.     IconCalc            A full-function calculator in an icon!
  998.  
  999.     Pos                 Pos displays the mouse cursor position in relation
  1000.         to the screen (screen coordinates) and in relation
  1001.         to the window which has the input focus.  Pos makes
  1002.         a good addition to the Windows Software Development
  1003.         Kit and is also useful when selecting monitor
  1004.         resolutions.  It was originally developed to
  1005.         allow the user to move the mouse cursor to screen
  1006.         positions ahead of time.  In addition, Pos
  1007.         can display the dimensions of a window.
  1008.  
  1009.    Mem                  Mem can display the amount of memory free, the
  1010.         largest block of memory free, the percent of
  1011.         system resources free, and/or the amount of disk
  1012.         space free on drives that you select.
  1013.         Mem can sound an alarm when the disk space, free
  1014.         memory, or percent of system resources free goes
  1015.         below amounts that you specify (a different amount
  1016.         may be specified for each disk drive).
  1017.  
  1018.     ChCursor            If you find that you sometimes lose track of the
  1019.         mouse cursor on the screen, ChangeCursor will
  1020.         allow you to press the right mouse button to
  1021.         highlight the cursor.  Other features include the
  1022.         ability to position the cursor in the center of
  1023.         the screen with a click of the right mouse button,
  1024.         and the ability to hide the cursor when you start
  1025.         typing and then have it displayed again when the
  1026.         mouse is moved.
  1027.  
  1028.     Lock                Lock is a keyboard lock and screen saver.  It will
  1029.         automatically lock the keyboard after a certain
  1030.         time.
  1031.  
  1032.     SaveSet             SaveSet allows you to cause the "Save Settings" Check
  1033.         Box that appears when you exit Windows to be
  1034.         automatically un-checked or checked.
  1035.  
  1036.     Click               Click will produce a keyboard "click".  This is
  1037.         especially useful to those users who have used
  1038.         a keyboard click for DOS but have been unable to
  1039.         find one for MS Windows.  The duration and
  1040.         pitch of the click may be easily changed by the
  1041.         user.
  1042.  
  1043.     Games
  1044.     -----
  1045.  
  1046.     Hop                 The only computer Hop-Over puzzle.  Hop is a short
  1047.         form of Chinese Checkers.  (Hop can undo moves and
  1048.         solve the puzzle automatically, if you want it to.)
  1049.  
  1050.     Magic Squares       The only magic squares game for Windows 3.0.
  1051.         (A magic square is a square array of numbers,
  1052.         in which each row, column, and diagonal adds
  1053.         up to the same number.)
  1054.  
  1055.         Can save and retrieve games, and includes
  1056.         several solutions on disk.
  1057.  
  1058.         Can use different size puzzles, from 3 x 3 to
  1059.         9 x 9.
  1060.  
  1061.     Slide               Slide is the Classic Sliding Block Puzzle.
  1062.         Features:
  1063.  
  1064.         - Saves and retrieves games
  1065.         - Can undo moves one at a time
  1066.         - Saves last game automatically
  1067.         - 3x3 to 9x9 puzzle size
  1068.  
  1069.  
  1070. For DOS:
  1071.  
  1072.     DskNum              DskNum estimates the number of disks needed for
  1073.         a DOS Backup.  It estimates for 360Kb, 720Kb,
  1074.         1.2Mb, and 1.44Mb disks.
  1075.  
  1076.     DlFile
  1077.      (with DirSrch)     DlFile goes through your disk directories looking
  1078.         for the filespec you specify.  If found, it prompts
  1079.         to delete it.  This is very convenient for finding
  1080.         and deleting "*.BAK".
  1081.  
  1082.     ShowDirs            ShowDirs displays directories on your system that
  1083.         match the one specified.  It can search a single
  1084.         drive or an entire system.
  1085.  
  1086.     Mem                 Mem displays the amount of conventional memory
  1087.         in your computer and the amount free.  It displays
  1088.         information about extended memory if you have
  1089.         it in your computer.
  1090.  
  1091. These programs are available on BIX, CompuServe, the Boston Computer
  1092. Society's IBM BBS, and from other ShareWare libraries.  If you would like
  1093. more information, you may contact me as shown in the section "How to
  1094. contact me".
  1095.  
  1096. Error Messages & Solutions
  1097. ---------------------------
  1098.  
  1099.     Message                                 What it means / Solution
  1100.     ---------------                         ------------------------
  1101.  
  1102.     W1000 - No system timers available      WinClock must use one of the
  1103.             Windows "Timers" to update the
  1104.             time.  You should try closing
  1105.             another application, closing
  1106.             WinClock, and running WinClock
  1107.             again.
  1108.  
  1109.     W1010 - Unable to save WinClock
  1110.     configuration file              WinClock was unable to save
  1111.             the information you entered
  1112.             in the "Preferences" box.
  1113.  
  1114.     W1020 - Invalid time entered            You entered an invalid time.
  1115.             Enter a valid time.
  1116.  
  1117.     W1021 - Invalid date entered            You entered an invalid date.
  1118.             Enter a valid date.
  1119.  
  1120.  
  1121. Disclaimer
  1122. -------------------
  1123.  
  1124.     WinClock is supplied as is.  The author disclaims all warranties
  1125.     expressed or implied, including, without limitation, the
  1126.     warranties of merchantability and of fitness for any purpose.
  1127.     The author assumes no liability for damages, direct or conse-
  1128.     quential, which may result from the use of WinClock.
  1129.