home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / database / dpclk101.arj / DPCLOCK.DOC < prev   
Text File  |  1993-07-15  |  5KB  |  157 lines
  1.                               DPCLOCK 1.01
  2.                               ────────────
  3.  
  4. Purpose
  5. ───────
  6. DPCLOCK (DOS Prompt CLOCK) is, yes, another onscreen clock.  The variation
  7. is that this clock is displayed only at the DOS prompt.  It does not appear
  8. over your application programs.
  9.  
  10. DPCLOCK is similar to, and uses the same basic syntax as, Randolph Beck's
  11. older DOSCLOCK.  However, it is updated for compatibility with DOSKEY and
  12. PCED 2.1, has a few additional options, and does not support DOSCLOCK's /*
  13. option (display clock over applications).
  14.  
  15. Version 1.01 corrects an obscure bug that may cause problems for those
  16. few application programs that use DOS buffered input functions.
  17.  
  18.  
  19. Installation
  20. ────────────
  21. The command to install DPCLOCK is:
  22.  
  23.     DPCLOCK [/12] [/24] [/C] [/S] [/M]
  24.  
  25. All of the options are, well, optional.  Thus, the simplest way to start
  26. DPCLOCK is to simply type the command:
  27.  
  28.     DPCLOCK
  29.  
  30. DPCLOCK will load and display the current time in the upper right hand
  31. corner of your screen.
  32.  
  33.     ┌────────────────────────────────────────────────────────────────┐
  34.     │                            IMPORTANT                           │
  35.     │  If you use PCED (version 2.1 or later), DOSKEY, or a similar  │
  36.     │  command line editor, load the editor BEFORE loading DPCLOCK.  │
  37.     └────────────────────────────────────────────────────────────────┘
  38.  
  39. The options, if present, may be in any order.  They are not case-sensitive,
  40. so "/m" and "/M" are the same.  The options are:
  41.  
  42.     /12       Display the clock in 12-hour format with "am" or "pm".
  43.               This is the default setting.
  44.  
  45.     /24       Display the clock in 24-hour (military) format.
  46.  
  47.     /C        Specify clock display color; see below for more information.
  48.  
  49.     /M        Display hours and minutes (HH:MM) only.  This is the
  50.               default setting.
  51.  
  52.     /S        Display hours, minutes, and seconds (HH:MM:SS).
  53.  
  54. For example, the following command selects a 24-hour display with seconds
  55. using color 116:
  56.  
  57.     DPCLOCK /24 /S /C116
  58.  
  59.  
  60. Changing options
  61. ────────────────
  62. After loading, you can re-run DPCLOCK at any time to change the options.
  63. For example, you can switch back to a 12-hour clock showing HH:MM by typing
  64. this command:
  65.  
  66.     DPCLOCK /12 /M
  67.  
  68.  
  69. Display colors
  70. ──────────────
  71. Normally, DPCLOCK doesn't do anything about screen colors when it displays
  72. the clock; it simply uses whatever colors are already there.  If you want
  73. DPCLOCK to use a particular color, you can specify it with the /C option.
  74. You can specify the color when you load DPCLOCK and as often as you want
  75. after it is loaded.
  76.  
  77. To specify the color, you need color codes.  For color monitors, use the
  78. following chart:
  79.  
  80.     Code      Color
  81.     ────      ─────
  82.       0       Black
  83.       1       Blue
  84.       2       Green
  85.       3       Cyan
  86.       4       Red
  87.       5       Magenta
  88.       6       Yellow
  89.       7       White
  90.  
  91. Specify the color in this format:
  92.  
  93.     fg[+];bg
  94.  
  95. "fg" is the foreground color and "bg" is the background color; add "+" to
  96. the foregound color to brighten it (by the way, "bright black" is a dark
  97. grey on most monitors).  For example:
  98.  
  99.     DPCLOCK /C6;1     (yellow on blue)
  100.     DPCLOCK /C7+;3    (bright white on cyan)
  101.  
  102. For black backgrounds, you can omit the BG color.  These are identical:
  103.  
  104.     DPCLOCK /C2+;0    (bright green on black)
  105.     DPCLOCK /C2+      (bright green on black)
  106.  
  107. For monochrome monitors, use one of the following codes:
  108.  
  109.     /C1       Underlined
  110.     /C1+      Bright underlined
  111.     /C7       Normal
  112.     /C7+      Bright
  113.     /C0;7     Inverse
  114.  
  115. To revert to normal processing (DPCLOCK uses whatever colors it finds), use
  116. /C0.
  117.  
  118.  
  119. Unloading DPCLOCK
  120. ─────────────────
  121. If you need to unload DPCLOCK, run the program again with the /U option:
  122.  
  123.     DPCLOCK /U
  124.  
  125. DPCLOCK will unload itself from memory if possible.  It may not be possible
  126. if other resident programs were loaded after DPCLOCK; DPCLOCK will display a
  127. message if this is the case.
  128.  
  129.  
  130. Notes
  131. ─────
  132. 1. DPCLOCK uses about 850 bytes of memory when installed.
  133.  
  134. 2. The clock may display "over" a few applications; for example, the clock
  135. is displayed while you are entering a search string in Buerg Software's LIST
  136. program.  For the most part, though, the clock will display only at the DOS
  137. prompt.
  138.  
  139.  
  140.                        -----------------------------
  141.  
  142.                      DPCLOCK was written and is hereby
  143.                      released to the public domain by:
  144.  
  145.                                Chris Dunford
  146.                           The Cove Software Group
  147.                             Post Office Box 1072
  148.                              Columbia, MD 21044
  149.  
  150.                                 410/992-9371
  151.                            CompuServe: 76703,2002
  152.                     Internet: 76703.2002@compuserve.com
  153.  
  154.  This program is provided "as is."  The author disclaims all liability for
  155.  any damages caused by, or claimed to have been caused by, the program.  By
  156.                 using this free program, you agree to this.
  157.