home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 24 / CD_ASCQ_24_0995.iso / win / tools / wclok404 / winclock.doc < prev    next >
Text File  |  1995-07-05  |  43KB  |  1,137 lines
  1.             WinClock
  2.            ----------
  3.  
  4.           Version 4.04
  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.     - Version 4.04                                              [July 5, 1995]
  450.     
  451.     If wave file edit box is selected in Alarm settings
  452.     dialog box, radio button will now change automatically.
  453.  
  454.     If Run Program Browse is selected in Alarm settings and a valid
  455.     filename is entered, radio button will now change automatically.
  456.  
  457.                     
  458. Requirements for running WinClock
  459. ---------------------------------
  460.     
  461.     - Microsoft Windows 3.1 or higher
  462.     - WinClock (WINCLOCK.EXE, WCHOOK.DLL, WSAVER.DLL
  463.     DATEFUNC.DLL, WINCLOCK.HLP, DAFLIB.DLL, DAFLIB.HLP)
  464.  
  465. Running/Installing/Upgrading WinClock
  466. -------------------------------------
  467.  
  468.     Please note that the following directions assume you are using a
  469.     mouse.  If you are not using a mouse, please refer to your Windows
  470.     documentation for equivalent keystrokes.
  471.  
  472.     - Upgrading WinClock
  473.     If you are upgrading from a previous version of WinClock, you
  474.     should copy this version of WinClock to the same directory that
  475.     the old version is in.  Since configuration files of previous
  476.     versions of WinClock are not compatible with this version,
  477.     the first time you run WinClock you will see a message which
  478.     tells you that your configuration file was created by a different
  479.     version of WinClock and that your preference settings have been
  480.     reset to the default.  You may want to change the settings back
  481.     to your preferred settings.
  482.  
  483.     1. Copy WINCLOCK.EXE, WCHOOK.DLL, WINCLOCK.HLP, DAFLIB.DLL,
  484.        and DAFLIB.HLP to your Windows directory or another 
  485.        directory of your choice.  Note that all of the files must be
  486.        copied to the same directory.
  487.  
  488.     2. Do one of the following:
  489.     
  490.     Note: Option D is highly recommended over A, B, and C.
  491.     
  492.     A.  Click on "File" then "Run..." in the Program Manager menu.
  493.         Type WINCLOCK.EXE (including the path) in the "Command
  494.         line" edit box and click "OK".  If you use this option,
  495.         you will have to do this every time you want to run
  496.         WinClock.
  497.  
  498.     B.  Click on one of the program groups in the Program
  499.         Manager (the "Accessories" group is suggested).  Select
  500.         "File" then "New..." from the program manager menu.
  501.         Select "Program Item" and type WINCLOCK.EXE in the
  502.         "Command line" edit box.  For example, you might type:
  503.         C:\WINDOWS\WINCLOCK.EXE if that was the directory into
  504.         which you had copied WinClock.  WinClock has several
  505.         different icons from which you may choose.  To see
  506.         the icons, click on "Change icon" then click on
  507.         "View next" until you find an icon that you like.
  508.         When you want to run WinClock, double click on the
  509.         WinClock icon.
  510.  
  511.     C.  On the line that says "load=" in your WIN.INI file,
  512.         add WINCLOCK.EXE (with the appropriate path).  For
  513.         example, if you copied WINCLOCK.EXE to C:\WINDOWS,
  514.         the line would say: load=C:\WINDOWS\WINCLOCK.EXE
  515.  
  516.         This option will automatically run WinClock each time
  517.         you run Windows.
  518.  
  519.     D.  Do both B and C, which will automatically run WinClock
  520.         and allow you to run WinClock easily if you close it.
  521.  
  522. WinClock Options
  523. ----------------
  524.  
  525.     To bring up a list of options, click once on the WinClock
  526.     system box.
  527.  
  528.     1. Help...
  529.  
  530.     This will bring up help about WinClock and explain how to
  531.     use context sensitive help.  It will also display an index
  532.     of all help available for WinClock.
  533.  
  534.     
  535.     2. Set Time/Date...
  536.     
  537.     This allows you to easily enter the time and date.  When
  538.     the window pops up, enter the correct time and date.
  539.     Click AM or PM to set the time in 12-hour format
  540.     or click 24-hr and enter the time in 24-hour format.
  541.     WinClock will automatically convert 24-hour format
  542.     to 12-hour format if you click PM after 24-hr was selected.
  543.     WinClock will also convert from PM to 24-hour format.
  544.  
  545.     The current time and date will be shown in the edit boxes
  546.     when the window originally appears.  To update the time and
  547.     date displayed in the edit boxes to the current time and
  548.     date, click the "Time" or "Date" push-button depending on
  549.     which you want to update.
  550.  
  551.     When you have made all your choices, click "OK"
  552.     (or press <Enter>).  If you want to leave the old
  553.     time and date, click "Cancel".
  554.  
  555.     You should select Auto Advance Date only if you are
  556.     using a version of DOS that does not advance the
  557.     date correctly at midnight.
  558.  
  559.     3. Alarms...
  560.  
  561.     This allows you to configure one or both of WinClock's
  562.     alarms.  To set an alarm: Click on the alarm you want to
  563.     set (Alarm One or Two).  When you have made your choices,
  564.     click "OK".  If you want to leave the alarms the way
  565.     they were, click "Cancel".
  566.  
  567.     -Enabled
  568.     If you want the alarm to be on, select
  569.     "Enabled" (so that there is an "x" in the box). If
  570.     you do not want the alarm to be on, but only want to set it
  571.     for use at a later time, click on "Enabled" until there is no
  572.     "x" in the box.
  573.  
  574.     -Time
  575.     Enter the time for the alarm to go off in
  576.     the edit box.  If you select AM or PM, enter the time
  577.     in 12-hour format.  If you select 24-hr, enter the time
  578.     in 24-hour format.
  579.  
  580.     -Date
  581.     One Date
  582.  
  583.     Select One Date to have the alarm go off on a single date.  Type the
  584.     date in the edit box.
  585.  
  586.     Start Date
  587.  
  588.     Select Start Date and enter the start date in the edit box.  The start
  589.     date is the date from which the alarms in the lower portion of the
  590.     dialog box start.  The start date causes the alarm to go off on-Beep
  591.     To have the alarm beep when it goes off, select "Beep" so
  592.     that there is an "x" in the box.  Select high or low pitch.
  593.     Select the duration of the beep.  Short is about eight
  594.     seconds; long is about 30 seconds.  Both beeps may be
  595.     stopped by clicking "OK" when the box alerting you to
  596.     the alarm appears.
  597.  
  598.     Week Interval
  599.     - Periodic
  600.     The periodic section causes alarms to go off on dates such as:
  601.     Every Thursday, Every other Wednesday, and so on.  Select the
  602.     periods that you want and choose the dates with which they
  603.     should be combined.
  604.  
  605.     - Of Every Month
  606.     This section causes alarms to go off on dates such as:
  607.     The first Thursday of every month, the second Wednesday
  608.     of every month, and so on.
  609.  
  610.     - Day
  611.     This section is combined with options you select in the
  612.     "Periodic" and "Of Every Month" sections.
  613.  
  614.     Examples
  615.     --------
  616.     Periodic
  617.  
  618.     To have an alarm go off Every Other Tuesday, you would
  619.     select "Every Other" in the "Periodic" Section and
  620.     "Tuesday" in the "Day" section.
  621.  
  622.     If you entered 5-15-90 in the "Start Date" edit box and
  623.     selected "Every" and "Tuesday," since 5-15-90 is a Tuesday,
  624.     the alarm would go off on 5-15-90, 5-22-90, 5-29-90,
  625.     6-04-90, and so on.
  626.  
  627.     Of Every Month
  628.  
  629.     To have an alarm go off on the Second Wednesday of Every
  630.     Month, you would select "Second" in the "Of Every Month"
  631.     section and "Wednesday" in the "Day" section.
  632.  
  633.     If you entered 5-15-90 in the "Start Date" edit box and
  634.     selected "Third" in the "Of Every Month Section" and
  635.     "Monday" in the "Day" section, the alarm would go off on
  636.     6-17-90, since that is the third Monday of the month.
  637.  
  638.     -Note/Run Program
  639.     If you want to, enter a note to display when the alarm goes
  640.     off.  Select "Run Program" to run a program at the time
  641.     for which you have set the alarm.  Type the full pathname
  642.     of the program you want to run.  Select "Max" if you want
  643.     the program to be maximized when it is run, "Min" to have
  644.     it minimized, or "Normal" to have it shown in its normal
  645.     size.
  646.  
  647.     If you type the name of a program that does not exist on
  648.     your hard disk, a warning message will appear when you
  649.     click "OK".  You may then choose to edit the name of
  650.     the program to run or to leave it unedited.
  651.  
  652.     4. Timers...
  653.  
  654.     WinClock has two stopwatches and two countdown timers.  By
  655.     selecting different options you can have WinClock display
  656.     some or all of the timers as well as the time and date.  In
  657.     order to use a countdown timer, you must type a number from
  658.     which to countdown in the "Countdown from" edit box.  This
  659.     number must be in the form: HH:MM (hours:minutes).  If it
  660.     is not in this form, any number found (that is before non
  661.     numeric numbers, excluding the colon) will be used as the
  662.     minutes.
  663.  
  664.     Select "Display Timer" individually for each timer if you
  665.     want to display it (or to not display it).  Select
  666.     "Display Date" and/or "Display Time" if you want to
  667.     display the date and/or time while one or more of the
  668.     timers are running.  The display of the date and time
  669.     are not dependent on the timer that is currently selected.
  670.     "Display seconds" is selected by default.  If you do not
  671.     want to display the seconds, click on it so that there is
  672.     no "x" in the box.  You can choose to display the seconds
  673.     individually for each timer.  The seconds will only be
  674.     displayed if "Display Timer" has been selected.
  675.  
  676.     The settings that you make in the Timer dialog box only
  677.     effect the WinClock display while one or more timers are
  678.     running.  The settings will be saved while WinClock is
  679.     running but will be reset to the default when WinClock
  680.     is restarted.
  681.  
  682.     When you have selected to display a timer, it is displayed
  683.     as follows:
  684.     The first stopwatch appears as: S1 00:00:00
  685.     The second stopwatch appears as: S2 00:00:00
  686.     The first countdown timer appears as: C1 00:00:00
  687.     The second countdown timer appears as: C2 00:00:00
  688.  
  689.     The current count (time elapsed) of the selected timer
  690.     will appear in the "Current Count" box while the Timers
  691.     dialog box is displayed.
  692.  
  693.     When a timer is stopped, its current count will be displayed
  694.     in the "Current Count" box until you switch to another timer.
  695.     The stopped timer will then reset itself to zero.
  696.  
  697.     The "Start/Stop" button will reflect whether the
  698.     currently selected timer is running.  If the current timer
  699.     is running, the button will display "Stop" so that you may
  700.     stop the timer.  If the current timer is not running,
  701.     the button will display "Start" so that you may start it.
  702.  
  703.     Each countdown timer may be set to "beep" or not to "beep."
  704.     Select "beep" so that there is an "x" in the box if you
  705.     want the countdown timer to beep when it finishes.  Select
  706.     the pitch and the duration of the beep.  The short beep
  707.     lasts about eight seconds; the long beep lasts about
  708.     thirty seconds.  Both beeps may be stopped by clicking
  709.     "OK" when the window alerting you that the timer has
  710.     finished appears.
  711.  
  712.     5.  Hourly beep
  713.  
  714.     Select this option if you want WinClock to sound a short beep
  715.     and flash on the hour.  A check mark will appear next to
  716.     "Hourly beep" if it is selected.  To turn off the Hourly beep,
  717.     click on "Hourly beep".  The check mark will disappear.
  718.  
  719.     Special note for 386 Enhanced mode:
  720.     If a DOS box is active and hourly beep is enabled, 
  721.     WinClock will, by default, return you to Windows and beep.  
  722.     You must then double click on the DOS icon to return to 
  723.     the DOS box.  If you do not want to be returned to Windows 
  724.     when an hourly beep occurs, deselect the For Hourly Beep 
  725.     check box in the Preferences dialog box.
  726.     
  727.     New!  WinClock now includes support for wave files when
  728.     sounding the hourly alert.
  729.  
  730.     6. Preferences...
  731.  
  732.     Preferences allows you to change how the date and time are
  733.     displayed.  Select the options you want and click "OK".
  734.  
  735.     Date Formats
  736.     ------------
  737.     - Separator
  738.     You may change the character that separates the parts of the
  739.     date by typing a different character in the "Separator"
  740.     edit box.  Although it is possible to type more than one
  741.     character, only the first character you type will be used.
  742.  
  743.     - Blinking Colon
  744.     If you would like the colon that separates the hours and
  745.     minutes of the time to blink on the second when the
  746.     seconds are not displayed, select "Blink Colon" so that
  747.     there is an "x" in the box.
  748.  
  749.     Screen Saver Compatibility
  750.     --------------------------
  751.     WinClock is compatible with most available screen savers.
  752.     (Note that WinClock itself is not a screen saver.)
  753.  
  754.     - Auto
  755.     Setting this option will cause WinClock to be hidden when
  756.     a screen saver saves the screen.  This option is compatible
  757.     with most screen savers; it is recommended that you try this
  758.     option first if you would like screen saver compatibility.
  759.  
  760.     - Delay
  761.     Setting this option on will cause WinClock to be hidden
  762.     (not displayed on the screen) after the amount of time that
  763.     you specify in the edit box, when the mouse and keyboard have
  764.     not been activated.
  765.  
  766.     You must set the delay in the form MM:SS (minutes:seconds).
  767.     If it is not in this form, any number found (that is before
  768.     non numeric numbers, excluding the colon) will be used as
  769.     the seconds.
  770.  
  771.     It is recommended that you use this option if the "auto"
  772.     option (see above) does not work correctly with your
  773.     screen saver.
  774.  
  775.     - None
  776.     This turns off screen saver compatibility which means that
  777.     WinClock will not be hidden if you have a screen saver.
  778.  
  779.     Display
  780.     -------
  781.     - Bring To Front
  782.     If you want WinClock to appear over other applications,
  783.     select "Bring To Front".
  784.  
  785.     - System Box
  786.     If you want WinClock to display a system box, select
  787.     "System Box".  Hiding the system box reduces the area that
  788.     WinClock takes up on the screen.  See "Displaying/
  789.     Hiding the system box" for more information.
  790.  
  791.     - Anti-Cascade
  792.     You should select "Anti-Cascade" if you do not want
  793.     WinClock to be cascaded when you cascade the open
  794.     windows.
  795.  
  796.     Screen Location
  797.     ---------------
  798.     - One Screen Location
  799.     WinClock remembers one screen location by default.  This
  800.     means that when you move WinClock it remembers its
  801.     position on the screen so that the next time you run
  802.     WinClock, it will go to the position where it was when it
  803.     was closed.
  804.  
  805.     - Always Return To Default Screen Location
  806.     If you want to move WinClock to a certain location for only
  807.     the current time that WinClock is running but then revert to
  808.     the default screen position, select "Always Return To
  809.     Default Screen Location."  The next time you run WinClock,
  810.     it will revert to its default location.
  811.  
  812.     - Lock Location
  813.     This will lock WinClock's location on the screen so that you
  814.     do not move it accidently.
  815.  
  816.     DOS boxes, Alarms, and Hourly Beep
  817.     ----------------------------------
  818.     The following information only applies when Windows is 
  819.     running in 386 Enhanced mode.
  820.  
  821.     If a DOS box is active and an alarm is enabled and set to 
  822.     go off, WinClock will, by default, return you to Windows 
  823.     and display the message, beep, and/or run a specified 
  824.     program.  You must then double click on the DOS icon to 
  825.     return to the DOS box.  If you do not want to be returned 
  826.     to Windows when an alarm occurs, deselect the For Alarms 
  827.     check box in the Preferences dialog box.
  828.  
  829.     If a DOS box is active and hourly beep is enabled, 
  830.     WinClock will, by default, return you to Windows and 
  831.     beep.  You must then double click on the DOS icon 
  832.     to return to the DOS box.  If you do not want to be 
  833.     returned to Windows when an hourly beep occurs, deselect 
  834.     the For Hourly Beep check box in the Preferences dialog box.
  835.  
  836.     7. About...
  837.  
  838.     Select "About..." to display information about WinClock.
  839.  
  840. Getting Help
  841. ------------
  842.  
  843.     WinClock help may be accessed in three ways:
  844.  
  845.     1.  Select help from the WinClock system menu.  This will display
  846.     an index of all help available for WinClock.  It will also
  847.     explain how to use WinClock's context sensitive help.
  848.  
  849.     2.  You may access context sensitive help by clicking on one of the
  850.     WinClock system menu items, holding down the mouse button, and
  851.     pressing F1.
  852.  
  853.     3.  You may access context sensitive help from most
  854.     of WinClock's dialog boxes by clicking on the "Help" button
  855.     if one is displayed.
  856.  
  857. Displaying/Hiding the system box
  858. --------------------------------
  859.  
  860.     You may display/hide the system box in the following ways:
  861.  
  862.     1.  Open the Preferences dialog box and select System Box so that
  863.     there is an "x" in the box.  This will display the system box.
  864.     To hide the system box from the Preferences dialog box, select
  865.     System Box so that there is no "x" in the box.
  866.  
  867.     2.  Double click on the WinClock caption (the caption is the area
  868.     in which the time and date are displayed).  If the system box is
  869.     hidden, it will appear; if it is displayed, it will be hidden.
  870.  
  871. The right mouse button
  872. ----------------------
  873.  
  874.     If you want to "Tile" the open windows, you should click once
  875.     with the right mouse button on the WinClock client area (the
  876.     area where the time and date are displayed).  This will cause
  877.     WinClock to be hidden for about seven seconds, during which time
  878.     you may tile the open windows.
  879.  
  880. Avoiding cascading or tiling WinClock
  881. -------------------------------------
  882.  
  883.     Cascading
  884.     ---------
  885.     If you want to "Cascade" the open windows, it is useful to
  886.     have the "Anti-Cascade" option selected (in the
  887.     Preferences dialog box)  so that WinClock does not get cascaded.
  888.  
  889.     To select "Anti-Cascade", select "Preferences..." from
  890.     WinClock's system menu.  In the "Preferences" dialog box,
  891.     select "Anti-Cascade" so that there is an "x" in the box.
  892.  
  893.     Tiling
  894.     ------
  895.     If you want to "Tile" the open windows, you should click once
  896.     with the right mouse button on the WinClock client area (the
  897.     are where the time and date are displayed).  This will cause
  898.     WinClock to be hidden for about seven seconds, during which time
  899.     you may tile the open windows.
  900.  
  901. Moving WinClock
  902. ---------------
  903.  
  904.     To move WinClock, click on WinClock and, while holding the mouse
  905.     button down, move WinClock.
  906.  
  907. Closing WinClock
  908. ----------------
  909.  
  910.     To close WinClock, do one of the following:
  911.  
  912.     1.  Double click on the WinClock system box.
  913.  
  914.     2.  Click once on the WinClock system box and then click on
  915.        "Close".
  916.  
  917. How to contact me
  918. -----------------
  919.  
  920.     Comments and suggestions (and reports of problems) would be greatly
  921.     appreciated.  You can contact me in the following ways:
  922.  
  923.     1. Write:
  924.  
  925.     David A. Feinleib
  926.     30 Hamilton Road #401
  927.     Arlington, MA 02174
  928.  
  929.     2. Send CompuServe mail to:
  930.  
  931.     76516,20
  932.  
  933.     3. Send Internet mail to:
  934.  
  935.     76516.20@compuserve.com
  936.  
  937. How to pay for/register WinClock
  938. --------------------------------
  939.  
  940.     WinClock is ShareWare.  
  941.  
  942.     You may make copies of this program and give them to others as
  943.     long as the documentation is provided with the program, both
  944.     unaltered.
  945.  
  946.     Please refer to the About Box for information on registering
  947.     the program.  From the About Box you can print out a 
  948.     registration form.  Alternatively, you can print out the file
  949.     REGISTER.DOC.
  950.  
  951.     Please include your name, address, and current version number,
  952.     as well as the name of the program that you are registering.
  953.  
  954.     (The version number may be found in the About Box.)
  955.     See above for the address.
  956.  
  957. Thanks!
  958. -------
  959.  
  960.     My thanks to those BIX users who, by downloading WinClock, inspired
  961.     me to write this version.  Credit is due to John Ogren for
  962.     suggesting the addition of international date formats.  Thanks to
  963.     Guy J. Gallo for his suggestions (most of which were implemented)
  964.     on the alarms.  Thanks to Steve Garcia, Ernest Karhu, Mark Lutton,
  965.     and William Saito for their suggestions which greatly
  966.     influenced this version of WinClock and especially to Peter Kaminski
  967.     for help with the icons and for his numerous comments, suggestions,
  968.     and support from the beginning and all through the testing stages
  969.     which resulted in many of the changes in this version.  My thanks
  970.     to Peter W. Meek for his encouragement, sense of humor, testing,
  971.     and suggestions for the new alarm options.  Thanks to Steve
  972.     Moshier for help with the algorithms used in the new alarm options.
  973.     Thanks to Bruce Wheelock for his extensive testing.  Thanks to
  974.     Arlan Fuller for his sense of humor and help with various parts
  975.     of WinClock.
  976.     
  977.     Version 4.00 and later -- Thanks to Larry Lovell, James W. Baer, and
  978.     Peter H. Orvis for their invaluable bug reports and suggestions.
  979.     Also thanks to Jim Roth for his bug report about wave files 
  980.     and enhanced alarms.
  981.  
  982. Other products by the same author
  983. ---------------------------------
  984. For MS Windows 3.x:
  985.  
  986.     Utilities
  987.     ---------
  988.  
  989.     RandScrn            Randomize your Windows 3.1 screen savers.  Comes
  990.         with several new savers, including Random
  991.         Rectangles, Random Pixels, Bouncing lines,
  992.         Laser Show, and Circles.
  993.  
  994.  
  995.     RunProg             RunProg allows you to run a program at a size
  996.         that you specify, maximized, minimized, normal,
  997.         hidden, or coordinates that you specify,
  998.         from the Program Manager or from your WIN.INI
  999.         file.
  1000.  
  1001.     PrintSwitch         Easily switch between HPPCL and PostScript modes
  1002.         on a Hewlett Packard laser printer with a postscript
  1003.         cartridge installed
  1004.  
  1005.     IconCalc            A full-function calculator in an icon!
  1006.  
  1007.     Pos                 Pos displays the mouse cursor position in relation
  1008.         to the screen (screen coordinates) and in relation
  1009.         to the window which has the input focus.  Pos makes
  1010.         a good addition to the Windows Software Development
  1011.         Kit and is also useful when selecting monitor
  1012.         resolutions.  It was originally developed to
  1013.         allow the user to move the mouse cursor to screen
  1014.         positions ahead of time.  In addition, Pos
  1015.         can display the dimensions of a window.
  1016.  
  1017.    Mem                  Mem can display the amount of memory free, the
  1018.         largest block of memory free, the percent of
  1019.         system resources free, and/or the amount of disk
  1020.         space free on drives that you select.
  1021.         Mem can sound an alarm when the disk space, free
  1022.         memory, or percent of system resources free goes
  1023.         below amounts that you specify (a different amount
  1024.         may be specified for each disk drive).
  1025.  
  1026.     ChCursor            If you find that you sometimes lose track of the
  1027.         mouse cursor on the screen, ChangeCursor will
  1028.         allow you to press the right mouse button to
  1029.         highlight the cursor.  Other features include the
  1030.         ability to position the cursor in the center of
  1031.         the screen with a click of the right mouse button,
  1032.         and the ability to hide the cursor when you start
  1033.         typing and then have it displayed again when the
  1034.         mouse is moved.
  1035.  
  1036.     Lock                Lock is a keyboard lock and screen saver.  It will
  1037.         automatically lock the keyboard after a certain
  1038.         time.
  1039.  
  1040.     SaveSet             SaveSet allows you to cause the "Save Settings" Check
  1041.         Box that appears when you exit Windows to be
  1042.         automatically un-checked or checked.
  1043.  
  1044.     Click               Click will produce a keyboard "click".  This is
  1045.         especially useful to those users who have used
  1046.         a keyboard click for DOS but have been unable to
  1047.         find one for MS Windows.  The duration and
  1048.         pitch of the click may be easily changed by the
  1049.         user.
  1050.  
  1051.     Games
  1052.     -----
  1053.  
  1054.     Hop                 The only computer Hop-Over puzzle.  Hop is a short
  1055.         form of Chinese Checkers.  (Hop can undo moves and
  1056.         solve the puzzle automatically, if you want it to.)
  1057.  
  1058.     Magic Squares       The only magic squares game for Windows 3.0.
  1059.         (A magic square is a square array of numbers,
  1060.         in which each row, column, and diagonal adds
  1061.         up to the same number.)
  1062.  
  1063.         Can save and retrieve games, and includes
  1064.         several solutions on disk.
  1065.  
  1066.         Can use different size puzzles, from 3 x 3 to
  1067.         9 x 9.
  1068.  
  1069.     Slide               Slide is the Classic Sliding Block Puzzle.
  1070.         Features:
  1071.  
  1072.         - Saves and retrieves games
  1073.         - Can undo moves one at a time
  1074.         - Saves last game automatically
  1075.         - 3x3 to 9x9 puzzle size
  1076.  
  1077.  
  1078. For DOS:
  1079.  
  1080.     DskNum              DskNum estimates the number of disks needed for
  1081.         a DOS Backup.  It estimates for 360Kb, 720Kb,
  1082.         1.2Mb, and 1.44Mb disks.
  1083.  
  1084.     DlFile
  1085.      (with DirSrch)     DlFile goes through your disk directories looking
  1086.         for the filespec you specify.  If found, it prompts
  1087.         to delete it.  This is very convenient for finding
  1088.         and deleting "*.BAK".
  1089.  
  1090.     ShowDirs            ShowDirs displays directories on your system that
  1091.         match the one specified.  It can search a single
  1092.         drive or an entire system.
  1093.  
  1094.     Mem                 Mem displays the amount of conventional memory
  1095.         in your computer and the amount free.  It displays
  1096.         information about extended memory if you have
  1097.         it in your computer.
  1098.  
  1099. These programs are available on BIX, CompuServe, the Boston Computer
  1100. Society's IBM BBS, and from other ShareWare libraries.  If you would like
  1101. more information, you may contact me as shown in the section "How to
  1102. contact me".
  1103.  
  1104. Error Messages & Solutions
  1105. ---------------------------
  1106.  
  1107.     Message                                 What it means / Solution
  1108.     ---------------                         ------------------------
  1109.  
  1110.     W1000 - No system timers available      WinClock must use one of the
  1111.             Windows "Timers" to update the
  1112.             time.  You should try closing
  1113.             another application, closing
  1114.             WinClock, and running WinClock
  1115.             again.
  1116.  
  1117.     W1010 - Unable to save WinClock
  1118.     configuration file              WinClock was unable to save
  1119.             the information you entered
  1120.             in the "Preferences" box.
  1121.  
  1122.     W1020 - Invalid time entered            You entered an invalid time.
  1123.             Enter a valid time.
  1124.  
  1125.     W1021 - Invalid date entered            You entered an invalid date.
  1126.             Enter a valid date.
  1127.  
  1128.  
  1129. Disclaimer
  1130. -------------------
  1131.  
  1132.     WinClock is supplied as is.  The author disclaims all warranties
  1133.     expressed or implied, including, without limitation, the
  1134.     warranties of merchantability and of fitness for any purpose.
  1135.     The author assumes no liability for damages, direct or conse-
  1136.     quential, which may result from the use of WinClock.
  1137.