home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 007.lha / RSLClock.doc < prev    next >
Text File  |  1986-11-10  |  7KB  |  111 lines
  1.     RSLClock is a superficially simple little utility that "runs" 
  2. unobtrusively at the end of the screen title bar.  The "close" gadget 
  3. and "window to front/back" gadgets are there, but they are hidden from view! 
  4. There it sits, indicating both the currently free memory, the time, and once 
  5. a minute, the date. It also "pops up" to the front of the Workbench screen, 
  6. once every minute. If you would like military time you can run the program 
  7. with "Run RSLClock long" it will then read out 12 hour time in AM/PM type 
  8. (hours & minutes), otherwise the default setting is Hours:minutes in 12 hour 
  9. style.
  10.      SYNTAX:
  11.         LONG (this will toggle military 24 hour time with HH:MM:SS style)        
  12.         BACK (this will create a "backdrop" black screen that can be toggled
  13.                 in/out by using left-Amiga N/M keys or by double clicking
  14.                 the menu button when the window is activated - use it
  15.                 to hide current screen)
  16.         NOPOPUP (this disables the feature to pop clock window to front of
  17.                 workbench screen at the beginning of every minute)
  18.         SPLITUP (this will split up the memory display into free chip and
  19.                 fast memory, separately)     
  20.         COLOR [B],[D] (this sets the colors of the window pen - first number
  21.                 can be 0-3, and background pen - second number can be 0-3.
  22.                 Any other numbers will give you the default colors)
  23.         POSITION [X],[Y] (this sets the left top edge of the window if the
  24.                 given width allows it, should you be utilizing WB 1.2 in
  25.                 400 line Workbench mode use an asterisk * and a space before
  26.                 the position commands in order for the program to recognize more
  27.                 than 200 lines per screen) 
  28.         [disk drive] (i.e. DF1: this will indicate the number of free Kbytes
  29.                 on indicated disk drive, re-evaluated once every minute!)
  30.         [# Kbytes before emergency shutdown] (i.e. 25 this will shut down
  31.                 this utility and reclaim the memory if your system's free
  32.                 memory falls below this point, default is 10 Kbytes!)
  33.         ? (this will display syntax)
  34.  
  35.         Note single letters are the same as typing the entire command!  
  36.         As an example RUN RSLClock b s DF1: p 120,45  will run the program
  37. with a backdrop screen, split memory into it's chip and fast components,
  38. display info on DF1: and displace the window to the given coordinates!
  39. *****************************************************************************
  40. New In Version 1.1:
  41.      This new update includes a menu which allows you to change all of the
  42. available options of RSLClockPlus, after it is running.  An additional
  43. feature available via the Menu is the ability to summon an emergency CLI
  44. which runs completely independent of all other tasks.  Since RSLClockPlus
  45. always pops up in front of all other Workbench windows, this may be helpful
  46. when there isn't any other way to get into a CLI.  I found PopCLI redundant
  47. with this feature available, but be cautious since this feature, like
  48. EXECUTE, takes 40 odd bytes from your memory and won't give it back without
  49. a warmboot!  A very small price to pay!.  Also, if the backdrop screen is
  50. enabled and the RSLClockPlus window is activated, simply double clicking the
  51. right menu button twice will toggle you in and out of the backdrop screen!
  52.       In addition to the new features, the older features have been
  53. "polished" up a bit!  Although the program is a bit larger than 1.0, I think
  54. that it is worth it.  To the best of my knowledge it runs on both 1.1 and
  55. 1.2 (beta 4).  Please tell me if there are any problems running it under any
  56. of the available versions of KS!
  57. *****************************************************************************
  58.      
  59. *****************************************************************************
  60. New in Version 1.11:
  61.      There is an unfortunate flaw in the ctime() function which came with
  62. my Aztec compiler, which I had to build a "fix" for.  Now the date will
  63. not be displayed as "Nov 0" when in fact it is "Oct 31"!
  64.      Another problem fixed in Ver 1.11 is due to the fact that the device
  65. driver for the floppy drives think that there are only 488 bytes per block,
  66. instead of 512, which is the way that INFO calculates it!  Since everyone
  67. believes INFO, I have adjusted this "anomaly" so that the free bytes of the
  68. disk drive will be the same as displayed using the INFO command!
  69. ****************************************************************************
  70.  
  71. ****************************************************************************
  72. New in Version 1.2:
  73.      I have found out that there in fact is ONLY 448 bytes per block on the
  74. disk drive!  the remaining 24 bytes are used by AmigaDOS as its overhead.
  75. I have decided that in a rebellious mood I will display what space is really
  76. available to you, the user instead of the "Public Relations" space available
  77. indicated via the INFO command.  Truth is more important than having my program
  78. agree with INFO's inaccurate value!  So back to a 5% discrepancy with INFO's
  79. value!
  80.      COLOR, and POSITION commands have been included in this version.  I happen
  81. to prefer the default values (of course I do, I wrote them into it as defaults),
  82. but if you people want to customize it you own liking, GO AHEAD! Of course,
  83. the menu allows you to change colors "on the run".
  84.      In previous versions only 3 significant digits were displayed for 
  85. Kbytes free on peripheral storage devices.  This is fine for floppies, but
  86. not for hard disks.  In this version hard disks will be displayed with 5
  87. significant numbers (if you have MORE than 99999K Bytes free, you shouldn't
  88. be caring about your available free memory)!
  89.       Another small feature added in this version update, is that once the
  90. backdrop is enabled and brought to the front by double clicking the right
  91. menu mouse button, simply hitting any key on the keyboard will bring back
  92. the previously active screen and activate the last window used!
  93. ****************************************************************************
  94.  
  95.      I know that there already is an abundance of "clock" programs, but this 
  96. is optimized for my own needs.  I hope that others find it useful!
  97.      I would like to thank Addison-Wesley, without whose ROM Kernal books,
  98. I would still be using my C compiler to compile "Hello there!" type programs.  
  99.      Please feel free to use this utility and distribute it freely.
  100.      Given all the suggestions for additional features, I hope that this 
  101. program hasn't grown TOO BIG for a utility.  I am presently considering adding
  102. an additional BACKSCRATCH option, using the chinese backscratch feature that
  103. was never a well documented feature in the Amiga A1000 hardware specs, it will
  104. scratch the user's back at a pre-selected interval!
  105.      Feel free to comment, suggest, compliment, and disparage, as you wish!
  106.      Happy Hacking!
  107.                                                    -RSL-
  108. AMuse BBS (212)269-4879: Roy S. Laufer
  109. CIS:  72435,1025
  110. Delpi: RSLaufer
  111.