home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / asmutil / tbones07.zip / README < prev    next >
Text File  |  1991-01-20  |  6KB  |  120 lines
  1. ============================================================================
  2. TBONES07                                                January 20, 1990
  3. Copyright (C) 1990, 1991 by Robert Curtis Davis
  4. All Rights Reserved
  5.  
  6. TBONES requires DOS Version 2 or later.
  7.  
  8. README file
  9. ============================================================================
  10. ****************************************************************************
  11.  
  12. ONE-LINE DESCRIPTION:
  13. --------------------
  14.         TBONESxx.ZIP - Skeletal ASM code to help make your TSRs.
  15.  
  16. ****************************************************************************
  17. ============================================================================
  18.  
  19. What is TBONES?
  20. --------------
  21.     TBONES is a set of skeletal Assembly Language programs to help
  22. you learn about and then to aid in the writing of your own DOS Terminate-
  23. but-Stay-Resident (TSR) programs. The ASM programs in the TBONES package
  24. are set up so you can relatively easily drop in the .ASM routine you want
  25. to run when your TSR triggers.
  26.  
  27.         TSR programs typically are activated when you press a "Hot Key"
  28. combination on the keyboard.
  29.  
  30.         TSRBONES is the flagship program of the TBONES package. It is the
  31. safest, most robust, and most astute TSR in the package at avoiding problems
  32. with DOS's non-reentrancy and with intruding upon time-critical CPU tasks. A
  33. TSR beginner should use only the TSRBONES program.
  34.  
  35.         TSRINT and TSRKEY, on the other hand, do NOTHING to prevent you from
  36. getting in trouble by writing your own TSR routine so that it interrupts and
  37. re-enters DOS code at unsafe times. TSRINT and TSRKEY are raw skeletal TSRs,
  38. and you should know a good bit about making a good TSR before you use them as
  39. the starting point in the design of your program. At the outset, you would do
  40. well to use only TSRBONES.
  41.  
  42. ======================================
  43. I'm impatient -- How do I "run" TBONES?
  44. --------------------------------------
  45. ****************************************************************************
  46. DISCLAIMER:
  47. ----------
  48.         T-BONES is currently under development and this is a preliminary
  49. version. This software is not warranted to be suitable for any purpose and
  50. the author will not be held responsible for any damages arising directly or 
  51. indirectly from its use. By the act of using this software, the user agrees 
  52. to these conditions.
  53.  
  54. ****************************************************************************
  55.  
  56.         Type TSRBONES at the prompt. A message announcing the installation
  57. of the sample TSR will appear on the screen. The "Hot Key" is:
  58.  
  59.             Cntrl-Alt-B
  60.  
  61. Anytime you press the Control key and the ALT key simultaneously and then
  62. hold them down while the B key is pressed, you trigger the TSR into action.
  63. For this sample TSR, the action routine you trigger is an unsophisticated
  64. "dummy" routine which simply rings the console bell. The whole idea behind
  65. TBONES is that you will add to this "dummy" routine or replace it with a
  66. routine that does something significantly more dazzling than ring a bell.
  67.  
  68.     Type TSRBONES again at the prompt and the TSR will announce that
  69. it is *already* installed and it will not bother to install itself again.
  70.  
  71.     Try triggering the TSR bell in all kinds of situations. The TSR
  72. is smart enough (or, so the theory goes) to determine when it should
  73. trigger, and when it should refrain from triggering to avoid conflict with
  74. other activities being managed by the CPU. 
  75.  
  76.     In testing TSRBONES I have done things like initiating
  77. a desktop publishing program and then immediately hitting the Hot Key and
  78. holding it down throughout the program's initialization, noticing the
  79. times when TSRBONES thinks it is safe to trigger, as indicated by the bell
  80. in the "dummy" routine. I have not been able to break TSRBONES or hang my
  81. system. If you succeed in breaking or hanging something, please tell me how
  82. you did it so I can improve future versions.
  83.  
  84.         For example, TSRBONES will not trigger the bell while a Print Screen
  85. operation is underway, nor while a time-critical disk operation is active, 
  86. nor when you have tried to do a DIR A: with the floppy A: drive door open
  87. and the CPU is wanting to know whether you wish to Abort, Retry, or Fail?
  88.  
  89.         I have found that a major part of the challenge in writing a good
  90. TSR lies in having it stay out of DOS's way in spite of when the user might
  91. hit the Hot Key.
  92.  
  93.         The TSRs in TBONES have been tested on machines running MSDOS Versions
  94. 2.0, 3.3, and 4.01, as well as PCDOS 3.2. They have been used with complete
  95. success with 4DOS3.01a. I would appreciate feedback on how they behave
  96. under DOS v.1.0 (they are supposed to give a polite message that they
  97. require DOS v.2+ and then bail out without trying to installing). I also
  98. would appreciate additional feedback on how they behave under DOS v.2.1+.
  99.  
  100.     I have tried fairly hard to "break" TSRBONES (i.e., to make it
  101. hang my machine or damage something) and have not yet done so. Certainly
  102. that is no guarantee that problems will not arise on your machine. If
  103. you do manage to break TSRBONES, please tell me the relevant facts about
  104. how you did it so I can improve future releases.
  105.  
  106. ============================================
  107. How much does TBONES cost?
  108. -------------------------
  109.         I presently ask only that you send me (preferably by E-mail) a free
  110. copy of any generally-useful TSR that you develop using TBONES. That way, I
  111. am paid in useful software only if TBONES itself proves genuinely useful to
  112. you.
  113.  
  114. ------------------------------------------------------------------------------
  115.             
  116.         GOOD LUCK!
  117.     Bob Davis (sonny@trantor.harris-atd.com)
  118.  
  119. *****************************************************************************
  120.