home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / bugalr.zip / BUGALERT.HLP (.txt) next >
OS/2 Help File  |  1993-06-12  |  29KB  |  835 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Help for BugAlert ΓòÉΓòÉΓòÉ
  3.  
  4. Use BugAlert to view various pieces of information from windows or 
  5. applications. 
  6.  
  7. Related Information: 
  8.  
  9. o Purpose of BugAlert 
  10. o Registration of BugAlert 
  11. o Modes of BugAlert 
  12. o Harvesting information from windows 
  13. o BugAlert hotkey 
  14. o BugAlert with IPMD debugger 
  15. o Defaults 
  16. o Known bugs 
  17. o Notes 
  18. o Future 
  19.  
  20.  
  21. ΓòÉΓòÉΓòÉ 1.1. Purpose of BugAlert ΓòÉΓòÉΓòÉ
  22.  
  23. The purpose of BugAlert is to help debug an application.  It does this by 
  24. harvesting information from windows and applications and can be used in 
  25. conjunction with the IPMD debugger providing information that's not currently 
  26. available.  Used with the IPMD debugger, it can facilitate setting a breakpoint 
  27. in a window procedure when given the value of the window handle. 
  28.  
  29. BugAlert consists of four basic windows, i.e., the main dialog window, the mode 
  30. dialog window, the information dialog window and the window data dialog window. 
  31. The main window consists of the system menu icon, title bar, menu bar and two 
  32. checkboxes.  The mode dialog window consists of five groups of buttons (radio 
  33. buttons and checkboxes) and defines the current mode of BugAlert  The 
  34. information dialog window consists of three listboxes and several static text 
  35. fields and displays the information harvested from either the window or window 
  36. handle pointed to by the mouse.  The window data window consists of a menu bar 
  37. and a multi-line entry field control and displays the extra bytes of memory 
  38. associated with a window class. 
  39.  
  40. The system menu in the mode, information and data dialog windows has been 
  41. altered so that these windows can not be closed down, they can only be hidden. 
  42. The left button double click and ALT+F4 hide the windows instead of closing 
  43. them down.  BugAlert can only be closed down from the main dialog window. If 
  44. the EXIT menu item is used the window positions are saved, whereas, if the left 
  45. button double click, ALT+F4 or CLOSE menu items is used, they are not. 
  46.  
  47. The information displayed for all modes is as follows: 
  48.  
  49.    Both parent and owner window lineage along with the window handle, id, 
  50.    title, class, style flags, procedure address, process and thread ids, 
  51.    rectangle coordinates and class bytes for the currently selected window. 
  52.  
  53.    The style flags (class, window and control) are parsed and the mnemonics 
  54.    listed in the Style: list box. 
  55.  
  56.  Another dialog can be brought up that lists all the windows currently on the 
  57.  desktop along with certain attributes whether they're visible or not. 
  58.  
  59.  
  60. ΓòÉΓòÉΓòÉ 1.2. Registering BugAlert ΓòÉΓòÉΓòÉ
  61.  
  62. By sending $35 to: 
  63.  
  64. RDW Controls, 11111 Berwick Drive, Rancho Cucamonga, CA 91730 
  65.  
  66. You will then receive a registered copy of BugAlert. 
  67.  
  68. The unregistered copy of BugAlert always wakes up with the About window and it 
  69. stays up until the OK button is click or the Enter key pressed.  Also, the 
  70. Settings menu and the Actions menu item Enum are disabled. 
  71.  
  72. The registered copy of BugAlert wakes up the first time with the About window 
  73. and upon pressing the Register button a dialog comes up to actually register 
  74. your copy.  Once this is done BugAlert wakes up without the About window. 
  75. Also, nothing is disabled. 
  76.  
  77. There are two pieces of information required in the registration dialog--the 
  78. name under which BugAlert is to be registered and the serial number that is 
  79. supplied on the BugAlert diskette. 
  80.  
  81.  
  82. ΓòÉΓòÉΓòÉ 1.3. Modes of BugAlert ΓòÉΓòÉΓòÉ
  83.  
  84. The mode in which BugAlert will operate is defined in the mode dialog.  This is 
  85. shown by clicking the Show Mode Dialog checkbox in the main BugAlert window. 
  86. The mode dialog contains five groups:  Level, Source, Breakpoint, Highlight and 
  87. File Names. 
  88.  
  89. Level tells BugAlert at what window level to harvest its information, i.e., 
  90. Frame implies the immediate frame window parent of the window currently under 
  91. the mouse and Child implies the window immediately under the mouse. 
  92.  
  93. Source tells BugAlert where to harvest its information, i.e., Window implies 
  94. the window under the mouse and Handle implies the text in that window if it 
  95. evaluates into a valid window handle and if not, the window itself. 
  96.  
  97. Breakpoint tells BugAlert the breakpoint preferences. Set if checked tells 
  98. BugAlert to bring up the breakpoint address dialog in IPMD and load the address 
  99. of the window procedure associated with the window handle into the address 
  100. entry field.  This may take a moment or two to appear.  Verify if checked tells 
  101. BugAlert to let the user exit the breakpoint address dialog and if not checked 
  102. BugAlert will exit the dialog as soon as the address is loaded. 
  103.  
  104. Highlight tells BugAlert the way to highlight the window currently under the 
  105. cursor.  There are four radio buttons representing four kinds of highlighting 
  106. which are made up of combinations of outlining and inverting.  Outline implies 
  107. that a rectangle made up of a dashed line will outline the window.  Fill 
  108. implies that the area within the window will be inverted.  Both implies that 
  109. both kinds of highlighting will be used.  None implies that no highlighting 
  110. will be used.  No highlighting is done in Handle mode. 
  111.  
  112. File Names tells BugAlert where to obtain the names of the debugger and 
  113. application.  Default Application if checked implies that the application file 
  114. name is stored in the .ini file and if not checked or the name is not stored in 
  115. the .ini file, a dialog window will come up requesting this information when 
  116. starting a debugger session. Default Debugger implies that the debugger file 
  117. name is stored in the .ini file and if not checked or the name is not stored in 
  118. the .ini file, a dialog window will come up requesting this information when 
  119. starting a debugger session. 
  120.  
  121.  
  122. ΓòÉΓòÉΓòÉ 1.4. Harvesting information. ΓòÉΓòÉΓòÉ
  123.  
  124. There are two ways to harvest information from windows or window handles.  One 
  125. way is to browse around the desktop, i.e., click the Actions menu item "Browse" 
  126. or the browse hotkey, F11.  The other way is to simply place the mouse over the 
  127. window or window handle and press the load hotkey, F12. 
  128.  
  129.  
  130. ΓòÉΓòÉΓòÉ 1.5. BugAlert hotkey. ΓòÉΓòÉΓòÉ
  131.  
  132. F11, F12 and WM_BUTTON1DOWN have been set aside as hotkeys for BugAlert. 
  133. WM_BUTTON1DOWN is only effective while browsing.  F12 is not effective while 
  134. browsing.  F11 is effective any time. 
  135.  
  136. F11 toggles between browse and non-browse operation.  F12 harvests the 
  137. information dialog from the window or window handle (see mode flags) beneath 
  138. the cursor.  WM_BUTTON1DOWN stops browsing.  F12 also sets a breakpoint if the 
  139. debugger is operational (see mode flags). 
  140.  
  141.  
  142. ΓòÉΓòÉΓòÉ 1.6. Bugalert with IPMD debugger ΓòÉΓòÉΓòÉ
  143.  
  144. The IPMD debugger is started as a child process from BugAlert by clicking the 
  145. Actions menu item Debug start.  (This same menu item becomes Debug stop after 
  146. the debugger comes up.)  For BugAlert to work properly with the debugger in 
  147. operation, the debugger must be in asynchronous mode. 
  148.  
  149. The debugger then comes up and is operated in the same way as you would without 
  150. BugAlert.  BugAlert can be in any mode to start a debugger session and the 
  151. information harvested is the same as in a normal session.  But setting 
  152. breakpoints requires a special mode setting. 
  153.  
  154. This special mode includes Child level, Handle source and Set breakpoint.  The 
  155. level, source and highlight mode are automatically set upon starting a debugger 
  156. session.  The Set breakpoint is set by the user and if checked, breakpoints can 
  157. be set.  Once the debugger is operating the mode can be changed, but for a 
  158. breakpoint to be set this special mode must be set. 
  159.  
  160. A breakpoint can be set in one of two ways.  (1) Place the mouse over the 
  161. window containing the address of the window handle and press F12.  (2) While 
  162. browsing around the desktop, click the left mouse button over the window 
  163. containing the address of the window handle. 
  164.  
  165.  
  166. ΓòÉΓòÉΓòÉ 1.7. Defaults ΓòÉΓòÉΓòÉ
  167.  
  168. The mode, highlight, some switches, window positions and registration 
  169. information are kept in the BUGALERT.INI file.  These serve as defaults every 
  170. time BugAlert wakes up and are set automatically every time BugAlert closes 
  171. down. 
  172.  
  173.  
  174. ΓòÉΓòÉΓòÉ 1.8. Known bugs ΓòÉΓòÉΓòÉ
  175.  
  176. There are some known bugs in BugAlert 
  177.  
  178. (1) The "gun" cursor which is active while browsing reverts back to the "arror" 
  179. cursor when passing over a disabled button control.  It reverts back to the 
  180. "gun" cursor when passing over any BugAlert windows. 
  181.  
  182. (2) Information can not be harvested from a "Group box" window while browsing. 
  183. It can be harvested if selected in the enumeration of the desktop windows 
  184. dialog. 
  185.  
  186. (3) WARNING:  BugAlert has problems dealing with IPMD while the storage dialog 
  187. is open.  If you need to look at storage that's ok, but you must close down 
  188. this dialog before using BugAlert operations again. 
  189.  
  190.  
  191. ΓòÉΓòÉΓòÉ 1.9. Notes ΓòÉΓòÉΓòÉ
  192.  
  193. (1) If a window is identical in size and on top of another window, BugAlert 
  194. will only harvest the information on the bottom window while browsing or with 
  195. the browse hotkey.  But the information on any window can be harvested by 
  196. selecting that window in the enumerated list in the enumeration dialog. 
  197.  
  198.  
  199. ΓòÉΓòÉΓòÉ 1.10. Future ΓòÉΓòÉΓòÉ
  200.  
  201. Future releases of BugAlert will be able to harvest window information or 
  202. examine storage addresses that are stored in the window static memory, have a 
  203. hot key to make BugAlert visible at any time (it may be buried under other 
  204. windows) and work with other OS/2 2.x PM debuggers. 
  205.  
  206.  
  207. ΓòÉΓòÉΓòÉ 2. Help for Application dialog ΓòÉΓòÉΓòÉ
  208.  
  209. This dialog contains two entry fields.  The first one contains the full-path 
  210. and file name of the application to be given to the debugger.  The OK button 
  211. accepts the information and continues on with the debugging session and Cancel 
  212. rejects the information and returns to the normal BugAlert operation. 
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ 3. Help for Window Data dialog ΓòÉΓòÉΓòÉ
  216.  
  217. This dialog contains the window "extra bytes" data and presents it in one of 
  218. several views, i.e., bytes, longs, shorts and text. 
  219.  
  220.  
  221. ΓòÉΓòÉΓòÉ 4. Help for Debug dialog ΓòÉΓòÉΓòÉ
  222.  
  223. This dialog contains two entry fields.  The first one contains the full-path 
  224. and file name of your debugger.  The second one contains any command line 
  225. arguments.  The OK button accepts and the Cancel button ignores the 
  226. information. 
  227.  
  228.  
  229. ΓòÉΓòÉΓòÉ 5. Help for information dialog. ΓòÉΓòÉΓòÉ
  230.  
  231. This dialog contains the information harvested from the window or window handle 
  232. under the mouse (see discussion on modes).  The number of extra window bytes is 
  233. presented here and is displayed in the Window Data dialog. 
  234.  
  235.  
  236. ΓòÉΓòÉΓòÉ 6. Help for information dialog. ΓòÉΓòÉΓòÉ
  237.  
  238. This dialog contains the information harvested from the window or window handle 
  239. under the mouse (see discussion on modes).  The number of extra window bytes is 
  240. presented here and is displayed in the Window Data dialog. 
  241.  
  242.  
  243. ΓòÉΓòÉΓòÉ 7. Help for information dialog. ΓòÉΓòÉΓòÉ
  244.  
  245. This dialog contains the information harvested from the window or window handle 
  246. under the mouse (see discussion on modes).  The number of extra window bytes is 
  247. presented here and is displayed in the Window Data dialog. 
  248.  
  249.  
  250. ΓòÉΓòÉΓòÉ 8. Help for information dialog. ΓòÉΓòÉΓòÉ
  251.  
  252. This dialog contains the information harvested from the window or window handle 
  253. under the mouse (see discussion on modes).  The number of extra window bytes is 
  254. presented here and is displayed in the Window Data dialog. 
  255.  
  256.  
  257. ΓòÉΓòÉΓòÉ 8.1. Help for mode dialog. ΓòÉΓòÉΓòÉ
  258.  
  259. This dialog defines the mode in which BugAlert will operate.  There are five 
  260. groupings labeled, Level, Source, Breakpoint, Highlight, and File Names. 
  261.  
  262. The Level group defines at what window level BugAlert harvests the information. 
  263. Selecting Frame implies that it will harvest the information from the frame 
  264. window which is under the mouse. Selecting Child level implies that it will 
  265. harvest the information from the lowest level of window under the mouse within 
  266. the frame window, e.g., individual controls. 
  267.  
  268. The Source group defines where BugAlert harvests the information.  Selecting 
  269. Handle implies that it will try to evaluate all text strings as window handles 
  270. and if successful, the information will be harvested from that window.  If not 
  271. or if Window is selected, the information will be harvested from the window 
  272. itself. 
  273.  
  274. The Breakpoint group has to do with the setting of breakpoints in the debugger. 
  275. (These are queried when trying to set a breakpoint and if Child and Handle are 
  276. not selected, a breakpoint will not be set.)  Checking Set will cause the 
  277. breakpoint address dialog to appear with the window procedure address loaded. 
  278. Checking Verify will require the user to click the "OK" button on this dialog 
  279. to verify the breakpoint, whereas, if this item is not checked, BugAlert clicks 
  280. the "OK" button and the user is required to do nothing. 
  281.  
  282. The Highlight group has to do with the way BugAlert highlights the windows it 
  283. encounters.  Selecting Outline will place a dashed rectangle around the 
  284. selected window.  Selecting Fill will invert the interior of the selected 
  285. window.  Selecting Both will both outline and invert the selected.  Selecting 
  286. None will do nothing to the selected window. 
  287.  
  288. The File Names group tells BugAlert where to get the required file names. 
  289. Checking these boxes implies that the associated file names have already been 
  290. stored in the .ini file.  If they are not checked dialogs will come up 
  291. requesting the file information.  If they are checked and no file information 
  292. has been previously stored, dialogs will come up requesting the file 
  293. information. 
  294.  
  295.  
  296. ΓòÉΓòÉΓòÉ 8.2. Help for the Mode dialog. ΓòÉΓòÉΓòÉ
  297.  
  298. This dialog defines the mode in which BugAlert will operate.  There are five 
  299. groupings labeled, Level, Source, Breakpoint, Highlight, and File Names. 
  300.  
  301. The Level group defines at what window level BugAlert harvests the information. 
  302. Selecting Frame implies that it will harvest the information from the frame 
  303. window which is under the mouse. Selecting Child level implies that it will 
  304. harvest the information from the lowest level of window under the mouse within 
  305. the frame window, e.g., individual controls. 
  306.  
  307. The Source group defines where BugAlert harvests the information.  Selecting 
  308. Handle implies that it will try to evaluate all text strings as window handles 
  309. and if successful, the information will be harvested from that window.  If not 
  310. or if Window is selected, the information will be harvested from the window 
  311. itself. 
  312.  
  313. The Breakpoint group has to do with the setting of breakpoints in the debugger. 
  314. (These are queried when trying to set a breakpoint and if Child and Handle are 
  315. not selected, a breakpoint will not be set.)  Checking Set will cause the 
  316. breakpoint address dialog to appear with the window procedure address loaded. 
  317. Checking Verify will require the user to click the "OK" button on this dialog 
  318. to verify the breakpoint, whereas, if this item is not checked, BugAlert clicks 
  319. the "OK" button and the user is required to do nothing. 
  320.  
  321. The Highlight group has to do with the way BugAlert highlights the windows it 
  322. encounters.  Selecting Outline will place a dashed rectangle around the 
  323. selected window.  Selecting Fill will invert the interior of the selected 
  324. window.  Selecting Both will both outline and invert the selected.  Selecting 
  325. None will do nothing to the selected window. 
  326.  
  327. The File Names group tells BugAlert where to get the required file names. 
  328. Checking these boxes implies that the associated file names have already been 
  329. stored in the .ini file.  If they are not checked dialogs will come up 
  330. requesting the file information.  If they are checked and no file information 
  331. has been previously stored, dialogs will come up requesting the file 
  332. information. 
  333.  
  334.  
  335. ΓòÉΓòÉΓòÉ 8.3. Help for the Mode dialog. ΓòÉΓòÉΓòÉ
  336.  
  337. This dialog defines the mode in which BugAlert will operate.  There are five 
  338. groupings labeled, Level, Source, Breakpoint, Highlight, and File Names. 
  339.  
  340. The Level group defines at what window level BugAlert harvests the information. 
  341. Selecting Frame implies that it will harvest the information from the frame 
  342. window which is under the mouse. Selecting Child level implies that it will 
  343. harvest the information from the lowest level of window under the mouse within 
  344. the frame window, e.g., individual controls. 
  345.  
  346. The Source group defines where BugAlert harvests the information.  Selecting 
  347. Handle implies that it will try to evaluate all text strings as window handles 
  348. and if successful, the information will be harvested from that window.  If not 
  349. or if Window is selected, the information will be harvested from the window 
  350. itself. 
  351.  
  352. The Breakpoint group has to do with the setting of breakpoints in the debugger. 
  353. (These are queried when trying to set a breakpoint and if Child and Handle are 
  354. not selected, a breakpoint will not be set.)  Checking Set will cause the 
  355. breakpoint address dialog to appear with the window procedure address loaded. 
  356. Checking Verify will require the user to click the "OK" button on this dialog 
  357. to verify the breakpoint, whereas, if this item is not checked, BugAlert clicks 
  358. the "OK" button and the user is required to do nothing. 
  359.  
  360. The Highlight group has to do with the way BugAlert highlights the windows it 
  361. encounters.  Selecting Outline will place a dashed rectangle around the 
  362. selected window.  Selecting Fill will invert the interior of the selected 
  363. window.  Selecting Both will both outline and invert the selected.  Selecting 
  364. None will do nothing to the selected window. 
  365.  
  366. The File Names group tells BugAlert where to get the required file names. 
  367. Checking these boxes implies that the associated file names have already been 
  368. stored in the .ini file.  If they are not checked dialogs will come up 
  369. requesting the file information.  If they are checked and no file information 
  370. has been previously stored, dialogs will come up requesting the file 
  371. information. 
  372.  
  373.  
  374. ΓòÉΓòÉΓòÉ 8.4. Help for the Mode dialog. ΓòÉΓòÉΓòÉ
  375.  
  376. This dialog defines the mode in which BugAlert will operate.  There are five 
  377. groupings labeled, Level, Source, Breakpoint, Highlight, and File Names. 
  378.  
  379. The Level group defines at what window level BugAlert harvests the information. 
  380. Selecting Frame implies that it will harvest the information from the frame 
  381. window which is under the mouse. Selecting Child level implies that it will 
  382. harvest the information from the lowest level of window under the mouse within 
  383. the frame window, e.g., individual controls. 
  384.  
  385. The Source group defines where BugAlert harvests the information.  Selecting 
  386. Handle implies that it will try to evaluate all text strings as window handles 
  387. and if successful, the information will be harvested from that window.  If not 
  388. or if Window is selected, the information will be harvested from the window 
  389. itself. 
  390.  
  391. The Breakpoint group has to do with the setting of breakpoints in the debugger. 
  392. (These are queried when trying to set a breakpoint and if Child and Handle are 
  393. not selected, a breakpoint will not be set.)  Checking Set will cause the 
  394. breakpoint address dialog to appear with the window procedure address loaded. 
  395. Checking Verify will require the user to click the "OK" button on this dialog 
  396. to verify the breakpoint, whereas, if this item is not checked, BugAlert clicks 
  397. the "OK" button and the user is required to do nothing. 
  398.  
  399. The Highlight group has to do with the way BugAlert highlights the windows it 
  400. encounters.  Selecting Outline will place a dashed rectangle around the 
  401. selected window.  Selecting Fill will invert the interior of the selected 
  402. window.  Selecting Both will both outline and invert the selected.  Selecting 
  403. None will do nothing to the selected window. 
  404.  
  405. The File Names group tells BugAlert where to get the required file names. 
  406. Checking these boxes implies that the associated file names have already been 
  407. stored in the .ini file.  If they are not checked dialogs will come up 
  408. requesting the file information.  If they are checked and no file information 
  409. has been previously stored, dialogs will come up requesting the file 
  410. information. 
  411.  
  412.  
  413. ΓòÉΓòÉΓòÉ 8.5. Help for the Mode dialog. ΓòÉΓòÉΓòÉ
  414.  
  415. This dialog defines the mode in which BugAlert will operate.  There are five 
  416. groupings labeled, Level, Source, Breakpoint, Highlight, and File Names. 
  417.  
  418. The Level group defines at what window level BugAlert harvests the information. 
  419. Selecting Frame implies that it will harvest the information from the frame 
  420. window which is under the mouse. Selecting Child level implies that it will 
  421. harvest the information from the lowest level of window under the mouse within 
  422. the frame window, e.g., individual controls. 
  423.  
  424. The Source group defines where BugAlert harvests the information.  Selecting 
  425. Handle implies that it will try to evaluate all text strings as window handles 
  426. and if successful, the information will be harvested from that window.  If not 
  427. or if Window is selected, the information will be harvested from the window 
  428. itself. 
  429.  
  430. The Breakpoint group has to do with the setting of breakpoints in the debugger. 
  431. (These are queried when trying to set a breakpoint and if Child and Handle are 
  432. not selected, a breakpoint will not be set.)  Checking Set will cause the 
  433. breakpoint address dialog to appear with the window procedure address loaded. 
  434. Checking Verify will require the user to click the "OK" button on this dialog 
  435. to verify the breakpoint, whereas, if this item is not checked, BugAlert clicks 
  436. the "OK" button and the user is required to do nothing. 
  437.  
  438. The Highlight group has to do with the way BugAlert highlights the windows it 
  439. encounters.  Selecting Outline will place a dashed rectangle around the 
  440. selected window.  Selecting Fill will invert the interior of the selected 
  441. window.  Selecting Both will both outline and invert the selected.  Selecting 
  442. None will do nothing to the selected window. 
  443.  
  444. The File Names group tells BugAlert where to get the required file names. 
  445. Checking these boxes implies that the associated file names have already been 
  446. stored in the .ini file.  If they are not checked dialogs will come up 
  447. requesting the file information.  If they are checked and no file information 
  448. has been previously stored, dialogs will come up requesting the file 
  449. information. 
  450.  
  451.  
  452. ΓòÉΓòÉΓòÉ 8.6. Help for the Mode dialog. ΓòÉΓòÉΓòÉ
  453.  
  454. This dialog defines the mode in which BugAlert will operate.  There are five 
  455. groupings labeled, Level, Source, Breakpoint, Highlight, and File Names. 
  456.  
  457. The Level group defines at what window level BugAlert harvests the information. 
  458. Selecting Frame implies that it will harvest the information from the frame 
  459. window which is under the mouse. Selecting Child level implies that it will 
  460. harvest the information from the lowest level of window under the mouse within 
  461. the frame window, e.g., individual controls. 
  462.  
  463. The Source group defines where BugAlert harvests the information.  Selecting 
  464. Handle implies that it will try to evaluate all text strings as window handles 
  465. and if successful, the information will be harvested from that window.  If not 
  466. or if Window is selected, the information will be harvested from the window 
  467. itself. 
  468.  
  469. The Breakpoint group has to do with the setting of breakpoints in the debugger. 
  470. (These are queried when trying to set a breakpoint and if Child and Handle are 
  471. not selected, a breakpoint will not be set.)  Checking Set will cause the 
  472. breakpoint address dialog to appear with the window procedure address loaded. 
  473. Checking Verify will require the user to click the "OK" button on this dialog 
  474. to verify the breakpoint, whereas, if this item is not checked, BugAlert clicks 
  475. the "OK" button and the user is required to do nothing. 
  476.  
  477. The Highlight group has to do with the way BugAlert highlights the windows it 
  478. encounters.  Selecting Outline will place a dashed rectangle around the 
  479. selected window.  Selecting Fill will invert the interior of the selected 
  480. window.  Selecting Both will both outline and invert the selected.  Selecting 
  481. None will do nothing to the selected window. 
  482.  
  483. The File Names group tells BugAlert where to get the required file names. 
  484. Checking these boxes implies that the associated file names have already been 
  485. stored in the .ini file.  If they are not checked dialogs will come up 
  486. requesting the file information.  If they are checked and no file information 
  487. has been previously stored, dialogs will come up requesting the file 
  488. information. 
  489.  
  490.  
  491. ΓòÉΓòÉΓòÉ 8.7. Help for the Mode dialog. ΓòÉΓòÉΓòÉ
  492.  
  493. This dialog defines the mode in which BugAlert will operate.  There are five 
  494. groupings labeled, Level, Source, Breakpoint, Highlight, and File Names. 
  495.  
  496. The Level group defines at what window level BugAlert harvests the information. 
  497. Selecting Frame implies that it will harvest the information from the frame 
  498. window which is under the mouse. Selecting Child level implies that it will 
  499. harvest the information from the lowest level of window under the mouse within 
  500. the frame window, e.g., individual controls. 
  501.  
  502. The Source group defines where BugAlert harvests the information.  Selecting 
  503. Handle implies that it will try to evaluate all text strings as window handles 
  504. and if successful, the information will be harvested from that window.  If not 
  505. or if Window is selected, the information will be harvested from the window 
  506. itself. 
  507.  
  508. The Breakpoint group has to do with the setting of breakpoints in the debugger. 
  509. (These are queried when trying to set a breakpoint and if Child and Handle are 
  510. not selected, a breakpoint will not be set.)  Checking Set will cause the 
  511. breakpoint address dialog to appear with the window procedure address loaded. 
  512. Checking Verify will require the user to click the "OK" button on this dialog 
  513. to verify the breakpoint, whereas, if this item is not checked, BugAlert clicks 
  514. the "OK" button and the user is required to do nothing. 
  515.  
  516. The Highlight group has to do with the way BugAlert highlights the windows it 
  517. encounters.  Selecting Outline will place a dashed rectangle around the 
  518. selected window.  Selecting Fill will invert the interior of the selected 
  519. window.  Selecting Both will both outline and invert the selected.  Selecting 
  520. None will do nothing to the selected window. 
  521.  
  522. The File Names group tells BugAlert where to get the required file names. 
  523. Checking these boxes implies that the associated file names have already been 
  524. stored in the .ini file.  If they are not checked dialogs will come up 
  525. requesting the file information.  If they are checked and no file information 
  526. has been previously stored, dialogs will come up requesting the file 
  527. information. 
  528.  
  529.  
  530. ΓòÉΓòÉΓòÉ 8.8. Help for the Mode dialog. ΓòÉΓòÉΓòÉ
  531.  
  532. This dialog defines the mode in which BugAlert will operate.  There are five 
  533. groupings labeled, Level, Source, Breakpoint, Highlight, and File Names. 
  534.  
  535. The Level group defines at what window level BugAlert harvests the information. 
  536. Selecting Frame implies that it will harvest the information from the frame 
  537. window which is under the mouse. Selecting Child level implies that it will 
  538. harvest the information from the lowest level of window under the mouse within 
  539. the frame window, e.g., individual controls. 
  540.  
  541. The Source group defines where BugAlert harvests the information.  Selecting 
  542. Handle implies that it will try to evaluate all text strings as window handles 
  543. and if successful, the information will be harvested from that window.  If not 
  544. or if Window is selected, the information will be harvested from the window 
  545. itself. 
  546.  
  547. The Breakpoint group has to do with the setting of breakpoints in the debugger. 
  548. (These are queried when trying to set a breakpoint and if Child and Handle are 
  549. not selected, a breakpoint will not be set.)  Checking Set will cause the 
  550. breakpoint address dialog to appear with the window procedure address loaded. 
  551. Checking Verify will require the user to click the "OK" button on this dialog 
  552. to verify the breakpoint, whereas, if this item is not checked, BugAlert clicks 
  553. the "OK" button and the user is required to do nothing. 
  554.  
  555. The Highlight group has to do with the way BugAlert highlights the windows it 
  556. encounters.  Selecting Outline will place a dashed rectangle around the 
  557. selected window.  Selecting Fill will invert the interior of the selected 
  558. window.  Selecting Both will both outline and invert the selected.  Selecting 
  559. None will do nothing to the selected window. 
  560.  
  561. The File Names group tells BugAlert where to get the required file names. 
  562. Checking these boxes implies that the associated file names have already been 
  563. stored in the .ini file.  If they are not checked dialogs will come up 
  564. requesting the file information.  If they are checked and no file information 
  565. has been previously stored, dialogs will come up requesting the file 
  566. information. 
  567.  
  568.  
  569. ΓòÉΓòÉΓòÉ 8.9. Help for the Mode dialog. ΓòÉΓòÉΓòÉ
  570.  
  571. This dialog defines the mode in which BugAlert will operate.  There are five 
  572. groupings labeled, Level, Source, Breakpoint, Highlight, and File Names. 
  573.  
  574. The Level group defines at what window level BugAlert harvests the information. 
  575. Selecting Frame implies that it will harvest the information from the frame 
  576. window which is under the mouse. Selecting Child level implies that it will 
  577. harvest the information from the lowest level of window under the mouse within 
  578. the frame window, e.g., individual controls. 
  579.  
  580. The Source group defines where BugAlert harvests the information.  Selecting 
  581. Handle implies that it will try to evaluate all text strings as window handles 
  582. and if successful, the information will be harvested from that window.  If not 
  583. or if Window is selected, the information will be harvested from the window 
  584. itself. 
  585.  
  586. The Breakpoint group has to do with the setting of breakpoints in the debugger. 
  587. (These are queried when trying to set a breakpoint and if Child and Handle are 
  588. not selected, a breakpoint will not be set.)  Checking Set will cause the 
  589. breakpoint address dialog to appear with the window procedure address loaded. 
  590. Checking Verify will require the user to click the "OK" button on this dialog 
  591. to verify the breakpoint, whereas, if this item is not checked, BugAlert clicks 
  592. the "OK" button and the user is required to do nothing. 
  593.  
  594. The Highlight group has to do with the way BugAlert highlights the windows it 
  595. encounters.  Selecting Outline will place a dashed rectangle around the 
  596. selected window.  Selecting Fill will invert the interior of the selected 
  597. window.  Selecting Both will both outline and invert the selected.  Selecting 
  598. None will do nothing to the selected window. 
  599.  
  600. The File Names group tells BugAlert where to get the required file names. 
  601. Checking these boxes implies that the associated file names have already been 
  602. stored in the .ini file.  If they are not checked dialogs will come up 
  603. requesting the file information.  If they are checked and no file information 
  604. has been previously stored, dialogs will come up requesting the file 
  605. information. 
  606.  
  607.  
  608. ΓòÉΓòÉΓòÉ 8.10. Help for the Mode dialog. ΓòÉΓòÉΓòÉ
  609.  
  610. This dialog defines the mode in which BugAlert will operate.  There are five 
  611. groupings labeled, Level, Source, Breakpoint, Highlight, and File Names. 
  612.  
  613. The Level group defines at what window level BugAlert harvests the information. 
  614. Selecting Frame implies that it will harvest the information from the frame 
  615. window which is under the mouse. Selecting Child level implies that it will 
  616. harvest the information from the lowest level of window under the mouse within 
  617. the frame window, e.g., individual controls. 
  618.  
  619. The Source group defines where BugAlert harvests the information.  Selecting 
  620. Handle implies that it will try to evaluate all text strings as window handles 
  621. and if successful, the information will be harvested from that window.  If not 
  622. or if Window is selected, the information will be harvested from the window 
  623. itself. 
  624.  
  625. The Breakpoint group has to do with the setting of breakpoints in the debugger. 
  626. (These are queried when trying to set a breakpoint and if Child and Handle are 
  627. not selected, a breakpoint will not be set.)  Checking Set will cause the 
  628. breakpoint address dialog to appear with the window procedure address loaded. 
  629. Checking Verify will require the user to click the "OK" button on this dialog 
  630. to verify the breakpoint, whereas, if this item is not checked, BugAlert clicks 
  631. the "OK" button and the user is required to do nothing. 
  632.  
  633. The Highlight group has to do with the way BugAlert highlights the windows it 
  634. encounters.  Selecting Outline will place a dashed rectangle around the 
  635. selected window.  Selecting Fill will invert the interior of the selected 
  636. window.  Selecting Both will both outline and invert the selected.  Selecting 
  637. None will do nothing to the selected window. 
  638.  
  639. The File Names group tells BugAlert where to get the required file names. 
  640. Checking these boxes implies that the associated file names have already been 
  641. stored in the .ini file.  If they are not checked dialogs will come up 
  642. requesting the file information.  If they are checked and no file information 
  643. has been previously stored, dialogs will come up requesting the file 
  644. information. 
  645.  
  646.  
  647. ΓòÉΓòÉΓòÉ 8.11. Help for the Mode dialog. ΓòÉΓòÉΓòÉ
  648.  
  649. This dialog defines the mode in which BugAlert will operate.  There are five 
  650. groupings labeled, Level, Source, Breakpoint, Highlight, and File Names. 
  651.  
  652. The Level group defines at what window level BugAlert harvests the information. 
  653. Selecting Frame implies that it will harvest the information from the frame 
  654. window which is under the mouse. Selecting Child level implies that it will 
  655. harvest the information from the lowest level of window under the mouse within 
  656. the frame window, e.g., individual controls. 
  657.  
  658. The Source group defines where BugAlert harvests the information.  Selecting 
  659. Handle implies that it will try to evaluate all text strings as window handles 
  660. and if successful, the information will be harvested from that window.  If not 
  661. or if Window is selected, the information will be harvested from the window 
  662. itself. 
  663.  
  664. The Breakpoint group has to do with the setting of breakpoints in the debugger. 
  665. (These are queried when trying to set a breakpoint and if Child and Handle are 
  666. not selected, a breakpoint will not be set.)  Checking Set will cause the 
  667. breakpoint address dialog to appear with the window procedure address loaded. 
  668. Checking Verify will require the user to click the "OK" button on this dialog 
  669. to verify the breakpoint, whereas, if this item is not checked, BugAlert clicks 
  670. the "OK" button and the user is required to do nothing. 
  671.  
  672. The Highlight group has to do with the way BugAlert highlights the windows it 
  673. encounters.  Selecting Outline will place a dashed rectangle around the 
  674. selected window.  Selecting Fill will invert the interior of the selected 
  675. window.  Selecting Both will both outline and invert the selected.  Selecting 
  676. None will do nothing to the selected window. 
  677.  
  678. The File Names group tells BugAlert where to get the required file names. 
  679. Checking these boxes implies that the associated file names have already been 
  680. stored in the .ini file.  If they are not checked dialogs will come up 
  681. requesting the file information.  If they are checked and no file information 
  682. has been previously stored, dialogs will come up requesting the file 
  683. information. 
  684.  
  685.  
  686. ΓòÉΓòÉΓòÉ 8.12. Help for the Mode dialog. ΓòÉΓòÉΓòÉ
  687.  
  688. This dialog defines the mode in which BugAlert will operate.  There are five 
  689. groupings labeled, Level, Source, Breakpoint, Highlight, and File Names. 
  690.  
  691. The Level group defines at what window level BugAlert harvests the information. 
  692. Selecting Frame implies that it will harvest the information from the frame 
  693. window which is under the mouse. Selecting Child level implies that it will 
  694. harvest the information from the lowest level of window under the mouse within 
  695. the frame window, e.g., individual controls. 
  696.  
  697. The Source group defines where BugAlert harvests the information.  Selecting 
  698. Handle implies that it will try to evaluate all text strings as window handles 
  699. and if successful, the information will be harvested from that window.  If not 
  700. or if Window is selected, the information will be harvested from the window 
  701. itself. 
  702.  
  703. The Breakpoint group has to do with the setting of breakpoints in the debugger. 
  704. (These are queried when trying to set a breakpoint and if Child and Handle are 
  705. not selected, a breakpoint will not be set.)  Checking Set will cause the 
  706. breakpoint address dialog to appear with the window procedure address loaded. 
  707. Checking Verify will require the user to click the "OK" button on this dialog 
  708. to verify the breakpoint, whereas, if this item is not checked, BugAlert clicks 
  709. the "OK" button and the user is required to do nothing. 
  710.  
  711. The Highlight group has to do with the way BugAlert highlights the windows it 
  712. encounters.  Selecting Outline will place a dashed rectangle around the 
  713. selected window.  Selecting Fill will invert the interior of the selected 
  714. window.  Selecting Both will both outline and invert the selected.  Selecting 
  715. None will do nothing to the selected window. 
  716.  
  717. The File Names group tells BugAlert where to get the required file names. 
  718. Checking these boxes implies that the associated file names have already been 
  719. stored in the .ini file.  If they are not checked dialogs will come up 
  720. requesting the file information.  If they are checked and no file information 
  721. has been previously stored, dialogs will come up requesting the file 
  722. information. 
  723.  
  724.  
  725. ΓòÉΓòÉΓòÉ 8.13. Help for the Mode dialog. ΓòÉΓòÉΓòÉ
  726.  
  727. This dialog defines the mode in which BugAlert will operate.  There are five 
  728. groupings labeled, Level, Source, Breakpoint, Highlight, and File Names. 
  729.  
  730. The Level group defines at what window level BugAlert harvests the information. 
  731. Selecting Frame implies that it will harvest the information from the frame 
  732. window which is under the mouse. Selecting Child level implies that it will 
  733. harvest the information from the lowest level of window under the mouse within 
  734. the frame window, e.g., individual controls. 
  735.  
  736. The Source group defines where BugAlert harvests the information.  Selecting 
  737. Handle implies that it will try to evaluate all text strings as window handles 
  738. and if successful, the information will be harvested from that window.  If not 
  739. or if Window is selected, the information will be harvested from the window 
  740. itself. 
  741.  
  742. The Breakpoint group has to do with the setting of breakpoints in the debugger. 
  743. (These are queried when trying to set a breakpoint and if Child and Handle are 
  744. not selected, a breakpoint will not be set.)  Checking Set will cause the 
  745. breakpoint address dialog to appear with the window procedure address loaded. 
  746. Checking Verify will require the user to click the "OK" button on this dialog 
  747. to verify the breakpoint, whereas, if this item is not checked, BugAlert clicks 
  748. the "OK" button and the user is required to do nothing. 
  749.  
  750. The Highlight group has to do with the way BugAlert highlights the windows it 
  751. encounters.  Selecting Outline will place a dashed rectangle around the 
  752. selected window.  Selecting Fill will invert the interior of the selected 
  753. window.  Selecting Both will both outline and invert the selected.  Selecting 
  754. None will do nothing to the selected window. 
  755.  
  756. The File Names group tells BugAlert where to get the required file names. 
  757. Checking these boxes implies that the associated file names have already been 
  758. stored in the .ini file.  If they are not checked dialogs will come up 
  759. requesting the file information.  If they are checked and no file information 
  760. has been previously stored, dialogs will come up requesting the file 
  761. information. 
  762.  
  763.  
  764. ΓòÉΓòÉΓòÉ 9. Help for registration dialog ΓòÉΓòÉΓòÉ
  765.  
  766. This dialog contains two entry fields.  In the first one enter your name.  In 
  767. the second enter the product's serial number (BUGyymdd.xx, where "yymdd" refers 
  768. to the date upon which your diskette was shipped.  "yy" is the last two digits 
  769. of the year, "m" is the month number in hex, "dd" is the day of the month. "xx" 
  770. is an arbitrary number assigned to the diskette.).  This is listed on the 
  771. diskette.  The OK button accepts and the Cancel button ignores the information. 
  772.  
  773.  
  774. ΓòÉΓòÉΓòÉ 10. Help for Windows dialog ΓòÉΓòÉΓòÉ
  775.  
  776. This dialog lists all the windows currently open in the system.  If an item in 
  777. the list box is selected it is the window whose information is currently shown 
  778. in the main dialog.  If you select or change the selection the information 
  779. about that window will be shown in the main dialog upon closing. 
  780.  
  781.  
  782. ΓòÉΓòÉΓòÉ 10.1. Help for "Action" menu, item "Browse". ΓòÉΓòÉΓòÉ
  783.  
  784. This menu item starts BugAlert harvesting information as the mouse moves around 
  785. the desktop. 
  786.  
  787.  
  788. ΓòÉΓòÉΓòÉ 10.2. Help for "Action" menu, item "Debug start(stop)". ΓòÉΓòÉΓòÉ
  789.  
  790. This menu item starts or stops the debugging process.  When debugging this menu 
  791. item reads "Debug stop" and when not debugging it reads "Debug start". 
  792.  
  793.  
  794. ΓòÉΓòÉΓòÉ 10.3. Help for "Action" menu, item "Enum". ΓòÉΓòÉΓòÉ
  795.  
  796. This menu item brings up another dialog with a listbox that contains all the 
  797. windows currently on the desktop whether they're visible or not.  This dialog 
  798. takes a moment or two to become visible.  If a window has already been selected 
  799. during the Browse operation it is selected in the list box.  If you select 
  800. another window in the list box that window is selected and its information 
  801. listed when the dialog is closed down. 
  802.  
  803.  
  804. ΓòÉΓòÉΓòÉ 10.4. Help for "Action" menu, item "Exit". ΓòÉΓòÉΓòÉ
  805.  
  806. This menu item saves the profile information and then exits BugAlert as opposed 
  807. to Alt+F4 which exits without saving the profile information. 
  808.  
  809.  
  810. ΓòÉΓòÉΓòÉ 10.5. Help for "Settings" menu, item "Application". ΓòÉΓòÉΓòÉ
  811.  
  812. This menu item sets an application for debugging.  The application need not be 
  813. set here.  It will be set when starting the debugger in the following 
  814. conditions: 
  815.  
  816.    The application has not been set. 
  817.  
  818.    The mode dialog, item Default Application has not been checked. 
  819.  
  820.  
  821. ΓòÉΓòÉΓòÉ 10.6. Help for "Settings" menu, item "Debug". ΓòÉΓòÉΓòÉ
  822.  
  823. This menu item sets a debugger to use for debugging an application.  The 
  824. debugger need not be set here.  It will be set when starting the debugger in 
  825. the following conditions: 
  826.  
  827.    The debugger has not been set. 
  828.  
  829.    The mode dialog, item Default Debugger has not been checked. 
  830.  
  831.  
  832. ΓòÉΓòÉΓòÉ 10.7. Help for "Settings" menu, item "Register". ΓòÉΓòÉΓòÉ
  833.  
  834. This menu item brings up the registration dialog for the registered copy of 
  835. BugAlert.