home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / sndyes11.zip / readme.txt < prev    next >
Text File  |  1995-10-13  |  9KB  |  225 lines
  1.  
  2.                    SendYes!
  3.        A tool for automatically closing windowed text sessions
  4.                   V1.0 Copyright (C) 1995, Wes Santee
  5.                 V1.1 Copyright (C) 1995, Christian Langanke
  6.  
  7.  
  8. 0.0 Table of Contents
  9. ---------------------
  10.  
  11. 1.0  Introduction
  12.  1.1 Background
  13.  1.2 Requirements
  14.  1.3  E-Mailware!
  15.  1.4  Bug reporting
  16.  1.5  Credits
  17. 2.0  Usage
  18.  2.1  Parameters
  19. 3.0  Technical stuff
  20. 4.0  Frequently Asked Questions
  21. 5.0  Author Info
  22.  
  23.  
  24. 1.0  Introduction
  25. -----------------
  26.  
  27. Thank you for trying SendYes!
  28.  
  29. SendYes! is a small utility that looks for the default close boxes
  30. that pop up whenever OS/2 is closing a DOS or OS/2 Windowed or Fullscreen
  31. Text session.  If it sees one being created, SendYes! automatically clicks
  32. the 'Yes' button for you.
  33.  
  34. 1.1 Background
  35. --------------
  36.  
  37. Wes Santee:
  38. "I wrote SendYes! because I hated having to sit and click the 'Yes'
  39.  button during system shutdown to close all of my windowed text
  40.  sessions that were open.  It's very much a kludge and may or may not
  41.  work on your system.  At this point, there are no guarantees.  See the
  42.  file CHANGES.TXT for problems you may run into."
  43.  
  44. Section '3.0  Technical stuff' also gives further technical information 
  45. about SendYes!.
  46.  
  47. Since V1.1 of SendYes only msg boxes containing the particular PM         
  48. confirmation messages for those VIO and fullscreen sessions are closed.   
  49. This is done by comparing the message in the msg box dialog with the      
  50. message expected for the confirmation boxes. In order to be compatible    
  51. with every language version of OS/2, the message text for comparison is   
  52. read out of a PM resource DLL. In V1.0 every message box with a yes button
  53. was intercepted and closed by automatically pressing the yes button.      
  54.  
  55.  
  56. 1.2 Requirements
  57. ----------------
  58.  
  59. SendYes! V1.1 was compiled with the IBM C Set++ V2.
  60. The emx runtime is not longer needed as for V1.0.
  61.  
  62. SendYes! has only been tested on OS/2 Warp 3.0.  It makes several
  63. assumptions as to the ID's of some of the built-in dialog boxes that
  64. OS/2 will show on the screen.  If it works on earlier versions of
  65. OS/2, great. To find out wether SendYes is working on your OS/2,
  66. execute TESTALL.CMD to bring up all four kind of sessions and close 
  67. them with SendYes! active: 
  68. if they close well without confirmation boxes, everything is fine.
  69. If not, please email and tell me so...                                                  
  70.  
  71.  
  72. 1.3  E-Mailware!
  73. ----------------
  74.  
  75. SendYes! is E-Mailware.  What that means is you can do whatever you
  76. want with the program as long as 
  77. - SendYes is not sold as a part of another program package
  78. - no fee is charged for the program other than for cost of media 
  79. - the complete package is distributed unmodified 
  80. - you send me some E-Mail telling me how you liked it (or didn't like it)
  81.  
  82. My E-Mail address is listed at the end of this document.  
  83. Other than that, SendYes! is 100% free of charge.  
  84. With that price, you also get something else...NO WARRANTY.
  85.  
  86. Disclaimer (the non-legalese form): If there are bugs in SendYes!
  87. that totally destroy your computer (which I highly doubt there are),
  88. don't blame me.  If you use this program, you are doing so at your own
  89. risk.
  90.  
  91.  
  92. 1.4  Bug reporting
  93. ------------------
  94.  
  95. If you do find a bug in SendYes! (which I'm sure there are plenty),
  96. please let me know.  Due to the nature of the program, I cannot
  97. guarantee I can fix any problems, but it doesn't hurt to try.
  98. My E-Mail address is listed at the end of this document.
  99.  
  100.  
  101. 1.5  Credits
  102. ------------------
  103.  
  104. All credits for the idea and the creating of the first version 
  105. belong to Wes Santee, who developed V1.0 of SendYes (besides of a beta 
  106. version before). 
  107.  
  108.  
  109. 2.0  Usage
  110. ----------
  111.  
  112. The easiest way to run SendYes! is to create a program object for it,
  113. and put it in your Startup folder.  If you aren't sure how to create a
  114. program object, consult your OS/2 documentation or the system
  115. tutorial.  I recommend to put the SendYes! files in a separate directory,
  116. e.g. in a subdirectory below your utility directory, so that you can 
  117. migrate easier to a future version.
  118. If you use a program object and leave the working dir undefined
  119. or specify the directory SendYes! is installed in,
  120. no modifications of PATH and LIBPATH variables in CONFIG.SYS are required, 
  121.  
  122. NOTE:
  123. - If you are calling SendYes from any other directory than the one it
  124.   is installed in, you must put the file SENDDLL.DLL in a directory pointed 
  125.   to by the LIBPATH variable in your CONFIG.SYS file.
  126. - you can activate SendYes! only once. If you try to activate it
  127.   mopre than once, you will receive an error msg box or an error beep
  128.   (see parameter /Batch for details).
  129.  
  130. 2.1  Parameters
  131. ---------------
  132.  
  133. Since SendYes! does not have an interactive window, all options must
  134. be specified through command line options entered in the 'Parameters'
  135. entryfield for the program object.  Here is a list of the supported
  136. parameters and what they do
  137.  
  138. /Switchentry     tells SendYes! to show itself in the CTRL+ESC window list
  139.                  so you can close it there.
  140. /Close           closes active SendYes! session. If SendYes! is not active,
  141.                  specifying this parameter, you will receive an error 
  142.                  msg box
  143. /Batch           surpesses msg boxes and generates notification/alarm sounds
  144.                  instead on close and startup
  145. /Help or /?      gives a help msg box
  146.  
  147. NOTE:
  148. - specifying the first letter of the parameters is
  149.   sufficient, so /C and /CLOSE is equivalent
  150. - the parameters are case insensitive,
  151.   so parameters /CLOSE, /Close and /close are equivalent
  152. - the switch character preceding the parameters can be '/' or '-',
  153.   so parameters /CLOSE or -close are equivalent
  154.  
  155.  
  156. 3.0  Technical stuff
  157. --------------------
  158.  
  159. SendYes! installs a hook which intercepts the system message queue
  160. and reads the message to be intercepted out of a PM resource DLL.
  161. There it waits for creation of msg boxes and if one receives the focus,
  162. it checks, wether the message text in the msg box is identical to the one 
  163. read on startup. When this is the case, it sends a PM message to this msg box, 
  164. which states that the yes button is pressed, so the confirmation box is closed
  165. with Yes! before it pops up.
  166.  
  167. It is however possible, that SendYes! may not work under future versions of 
  168. OS/2, because SendYes! uses hardcoded and undocumented resource IDs to 
  169. identify msg boxes and to obtain the message shown in the message box. 
  170. Also the resource ID of the message read out of the PM resources at startup 
  171. is not documented and may change in future - although that is not very likely 
  172. to happen.
  173.  
  174. See section '1.2 Requirements' how to use TESTALL.CMD in order to easily find
  175. out, wether SendYes! is working correctly under your Version of OS/2.
  176.  
  177. NOTE:
  178. - The first version of SendYes! came together with the source code.
  179.   I think that most people out there just want to use a reliable and stable 
  180.   SendYes! and do not care for the code.
  181.   So the source code is not longer shipped together with the executables,
  182.   but if you however are interested in the sourcecode of SendYes!, you can 
  183.   obtain it by mailing me a request and I email you the source.
  184.  
  185.  
  186. 4.0  Frequently Asked Questions
  187. -------------------------------
  188.  
  189. Q:  Hey, there's no user interface here!  What's the big idea making
  190.     me use command line parameters!?  Where are my buttons!?
  191. A:  SendYes! needs to be small and fast.  A user interface would be
  192.     needlessly wasteful of memory resources for something so simple.
  193.  
  194. Q:  How can I kill SendYes! once I start it?
  195. A:  Execute 'SENDYES /Close' to close the active instance of 
  196.     SendYes!.  Alternatively, use the '/Switchentry'
  197.     parameter to tell SendYes! to appear in the CTRL+ESC task list.
  198.     See '2.1 Parameters' for details.
  199.     From there, highlight the task and hit the Delete key or
  200.     click the right mouse button on the entry and select Close.
  201.  
  202. Q:  What's going to be in the next version of SendYes!?  
  203. A:  See changes.txt - section THINGS TO COME
  204.     
  205. Q:  How can I test wether SendYes! is 100% working under my version of OS/2?
  206. A:  See section '1.2 Requirements' how to use TESTALL.CMD in order to find
  207.     that out.
  208.  
  209.  
  210. 5.0  Author Info
  211. ----------------
  212.  
  213. Please email me your opinion about SendYes! (and/or report a bug).
  214.  
  215. Author/Maintainer of current version:
  216. Christian Langanke, Germany
  217. Internet: cla@oerag.de
  218.  
  219. Author of V1.00: 
  220. Wes Santee
  221. Internet: wsantee@oz.net
  222.  
  223. Enjoy!
  224.  
  225.