home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / warptlk3.zip / TOOLKIT / HELP / KWIKINF.HLP (.txt) < prev    next >
OS/2 Help File  |  1995-08-30  |  15KB  |  413 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. KwikINF overview ΓòÉΓòÉΓòÉ
  3.  
  4. KwikINF provides you with a quick and convenient method of accessing 
  5. information in online documents stored in the OS/2* 2.x BOOKSHELF from anywhere 
  6. on the desktop, with the exception of DOS or WIN-OS/2 sessions. When KwikINF 
  7. has been started, you can open a dialog with KwikINF by pressing a 
  8. user-selectable hot key.  Until you configure KwikINF, your KwikINF hot key is 
  9. ALT+Q. The KwikINF window includes a Configure push button.  This opens another 
  10. dialog with KwikINF:  the Configure KwikINF window. The KwikINF window also 
  11. allows you to initiate searches for text strings in online documents of choice. 
  12.  
  13.  
  14. ΓòÉΓòÉΓòÉ 1.1. Automatic text-retrieval ΓòÉΓòÉΓòÉ
  15.  
  16. The KwikINF window includes a Search String entry field.  You can specify the 
  17. text string you want KwikINF to search for.  Or, under certain conditions, this 
  18. entry field automatically contains the word located under the cursor when you 
  19. press your KwikINF hot key. This text retrieval feature is available from OS/2 
  20. full-screen and Presentation Manager (PM) multi-line entry (MLE) fields.  This 
  21. feature is also available from PM AVIO and VIO windows. Communication Manager's 
  22. 3270 emulator is a common example of a PM AVIO window.  An OS/2 Window is a VIO 
  23. window.  This means that, if, for example, you open an OS/2 Window and start an 
  24. OS/2 text-based application, KwikINF will automatically retrieve the word under 
  25. the cursor when you press your KwikINF hot key. This automatic text-retrieval 
  26. feature is not available from graphic-text PM windows. 
  27.  
  28.  
  29. ΓòÉΓòÉΓòÉ 1.2. Online documents in the BOOKSHELF ΓòÉΓòÉΓòÉ
  30.  
  31. The KwikINF window includes a Volume to Search list box of all online documents 
  32. stored in the OS/2 BOOKSHELF subdirectories.  KwikINF initiates searches for 
  33. information in any online document in this list. 
  34.  
  35. The BOOKSHELF is an environment variable, set in CONFIG.SYS, that contains a 
  36. list of subdirectories containing online documents created as viewable .INF 
  37. files with the Information Presentation Facility (IPF). The BOOKSHELF 
  38. environment variable is set as follows: 
  39.  
  40. SET BOOKSHELF=<subdirectory>;...;<subdirectory>;
  41.  
  42. Online documents for OS/2 (for example, the Command Reference) are stored in 
  43. the \OS2\BOOK subdirectory of the drive on which OS/2 is installed.  Online 
  44. documents for the OS/2 Toolkit (for example, the Programming References) are 
  45. stored in the \TOOLKIT\BOOK subdirectory of the drive specified during 
  46. installation of the online programming information.  As an example, after 
  47. installation of OS/2 and the OS/2 Toolkit, the BOOKSHELF environment variable 
  48. is set as follows: 
  49.  
  50. SET BOOKSHELF=C:\OS2\BOOK;C:\TOOLKIT\BOOK;
  51.  
  52. The online document where KwikINF looks for the Search String is selected from 
  53. the Volume to Search list box by KwikINF or by you.  KwikINF selects the Volume 
  54. to Search by looking for the text string that has a matching entry in the 
  55. KwikINF index file or, if there is no matching entry in the index file, in the 
  56. Default Volume you have selected in the Configure KwikINF window. 
  57.  
  58.  
  59. ΓòÉΓòÉΓòÉ 1.3. Index files for rapid-searches ΓòÉΓòÉΓòÉ
  60.  
  61. The KwikINF index file provides a rapid-search mechanism for locating specific 
  62. kinds of information in online documents in the BOOKSHELF. The KwikINF index 
  63. file consists of one or more concatenated files stored in the BOOKSHELF and 
  64. defined by the HELPNDX variable in CONFIG.SYS as shown in the following 
  65. example: 
  66.  
  67. SET HELPNDX=EPMKWHLP.NDX
  68.  
  69. where EPMKWHLP.NDX is the KwikINF index file for the OS/2 Toolkit. 
  70.  
  71. As an example, the following excerpt from the KwikINF index file for the OS/2 
  72. Toolkit: 
  73.  
  74. EXTENSIONS: *
  75. DESCRIPTION: IBM Developer's Toolkit for OS/2
  76. (IPF*, view ipf.inf ~)
  77. (WinCreateWindow, view pmref.inf ~)
  78.  
  79. is used by KwikINF to quickly locate Search String entries with the prefix IPF 
  80. in the IPF-viewable file IPF.INF. and to quickly locate the specific Search 
  81. String entry WinCreateWindow in the IPF-viewable file PMREF.INF. 
  82.  
  83. The first token in a rapid-search string is a specific text string (for 
  84. example, WinCreateWindow) or prefix wildcard (for example, IPF*).  The second 
  85. token is the name of the IPF file viewer (VIEW.EXE).  The third and fourth 
  86. tokens are parameters for VIEW.EXE:  the name of the .INF file that contains 
  87. the online document and the text-string you want VIEW.EXE to locate within the 
  88. online document.  The ~ character tells KwikINF to use the first token in the 
  89. rapid-search string as the text-string to locate within the online document. 
  90.  
  91.  
  92. ΓòÉΓòÉΓòÉ 1.4. Enabling any online document for KwikINF ΓòÉΓòÉΓòÉ
  93.  
  94. You can enable any online document for KwikINF by: 
  95.  
  96.    1. Creating the online document as a viewable .INF file using the 
  97.       Information Presentation Facility (IPF). 
  98.    2. Adding the name of the subdirectory where it is stored to the PATH 
  99.       statement in CONFIG.SYS 
  100.    3. Appending the name of the subdirectory where it is stored to the 
  101.       BOOKSHELF in CONFIG.SYS 
  102.    4. Creating an index file to support the KwikINF rapid-search mechanism, 
  103.       storing it in the BOOKSHELF, and adding it to the HELPNDX variable in 
  104.       CONFIG.SYS. 
  105.  
  106.  For example, you can enable your online document MYDOC stored in MYSUBDIR 
  107.  subdirectory for KwikINF by: 
  108.  
  109.    1. Compiling the tagged source for MYDOC with the IPF compiler by entering: 
  110.  
  111.             IPFC MYDOC /INF
  112.  
  113.    2. Modifying the PATH statement in CONFIG.SYS as follows: 
  114.  
  115.             SET PATH=...;C:\MYSUBDIR;
  116.  
  117.    3. Modifying the BOOKSHELF statement in CONFIG.SYS as follows: 
  118.  
  119.             SET BOOKSHELF=...;C:\MYSUBDIR;
  120.  
  121.    4. Creating MYINDEX file in MYSUBDIR as shown below: 
  122.  
  123.             /* C style comments and blank lines are acceptable */
  124.             /* specific file extensions may be specified here  */
  125.             EXTENSIONS: *
  126.             /* a title may be placed here                      */
  127.             DESCRIPTION: Any custom KwikINF index file
  128.             /* rapid-search strings                            */
  129.             (thisfunction, view mydoc.inf ~)
  130.             (my*, view mydoc.inf ~)
  131.  
  132.    5. Modifying the HELPNDX variable in CONFIG.SYS as follows: 
  133.  
  134.             SET HELPNDX=EPMKWHLP.NDX+MYINDEX.NDX
  135.  
  136.  For more information on creating an IPF-viewable online document, see the IPF 
  137.  Reference in the Toolkit Development Tools folder. 
  138.  
  139.  
  140. ΓòÉΓòÉΓòÉ 2. Using KwikINF ΓòÉΓòÉΓòÉ
  141.  
  142. KwikINF is installed as a program object in the OS/2 Toolkit Development Tools 
  143. folder.  You start KwikINF by double-clicking on the KwikINF object or by 
  144. entering KwikINF from the command line of an OS/2 Window. You can start KwikINF 
  145. automatically when you start OS/2 by placing a shadow of the KwikINF object in 
  146. the Startup folder in the OS/2 System folder on the desktop. You shadow an 
  147. object by pressing CTRL + SHIFT while dragging the object. 
  148.  
  149. KwikINF installs a PM system hook to monitor keystrokes in PM sessions and OS/2 
  150. character device monitors to monitor keystrokes in OS/2 full-screen sessions. 
  151. KwikINF will install only one copy of the hook and monitors, even if you 
  152. attempt to re-start KwikINF. 
  153.  
  154. When KwikINF has been started, you can initiate searches for text strings in 
  155. online documents of choice by pressing a user-selectable hot key. 
  156.  
  157. Note:   You cannot initiate searches for text strings in online documents from 
  158.         DOS or WIN-OS/2 sessions. 
  159.  
  160.  Until you configure KwikINF, your KwikINF hot key is ALT+Q.  You configure 
  161.  KwikINF by pressing your KwikINF hot key and then pressing the Configure push 
  162.  button to open the Configure KwikINF window. 
  163.  
  164.  Note:   When you start KwikINF by double-clicking on the KwikINF object in the 
  165.          Toolkit Development Tools folder, a message box tells you what hot key 
  166.          opens the KwikINF window.  This technique can also be used to 
  167.          determine what your current KwikINF hot key is, after KwikINF has been 
  168.          started. 
  169.  
  170.  How you initiate a search for information in online documents is dependent on 
  171.  where you are on the desktop when you press the KwikINF hot key: 
  172.  
  173.      From an OS/2 full-screen session, a PM VIO or AVIO window, or PM MLE: 
  174.       position the cursor on the string you want to search for and press the 
  175.       KwikINF hot key. KwikINF retrieves the word at the cursor.  If you have 
  176.       configured KwikINF to display the KwikINF window when the KwikINF hot key 
  177.       is pressed, KwikINF automatically places the retrieved word in the Search 
  178.       String entry field of the KwikINF window. When you press the Search push 
  179.       button or Enter, KwikINF displays the information. If you have configured 
  180.       KwikINF to bypass the KwikINF window when the KwikINF hot key is pressed, 
  181.       KwikINF automatically displays the information. 
  182.  
  183.       If no word is under the cursor, the previous Search String is used. If no 
  184.       previous Search String exists, KwikINF displays the Contents of the 
  185.       Default volume to search. 
  186.  
  187.      From a graphic-text PM window: press the KwikINF hot key, then type the 
  188.       string you want to search for in the Search String entry field of the 
  189.       KwikINF window. The KwikINF text-retrieval feature is not available from 
  190.       graphic-text PM windows. 
  191.  
  192.  The online document where KwikINF looks for the text string is selected from 
  193.  the Volume to Search list box by KwikINF or by you. To open the online 
  194.  document to the panel that contains the information, press the Search push 
  195.  button or press Enter. 
  196.  
  197.  
  198. ΓòÉΓòÉΓòÉ 3. Invoking KwikINF from a command line ΓòÉΓòÉΓòÉ
  199.  
  200. You can start, terminate, and configure KwikINF from a command line in an OS/2 
  201. Window by entering: 
  202.  
  203. KwikINF [no options] [/C] [/T] [/?]
  204.  
  205. where: 
  206.  
  207.  no options 
  208.    starts KwikINF. After entering this command, the default KwikINF hot key 
  209.    (ALT + Q) is enabled. 
  210.  
  211.  /T 
  212.    terminates KwikINF and disables the KwikINF hot key. 
  213.  
  214.  /C 
  215.    opens the Configure KwikINF window. Use this window to select another 
  216.    KwikINF hot key, to select a default online document from the BOOKSHELF to 
  217.    search, and to select the activation behavior of the KwikINF window. 
  218.  
  219.  /? 
  220.    displays the following information. 
  221.  
  222.        Usage: KwikINF [Option]
  223.         Option    Description
  224.           /C      Configure KwikINF
  225.           /T      Terminate KwikINF
  226.           /?      This short help list
  227.  
  228.  
  229. ΓòÉΓòÉΓòÉ 4. Configuring KwikINF ΓòÉΓòÉΓòÉ
  230.  
  231. You configure KwikINF through the Configure KwikINF window. KwikINF displays 
  232. this window when you press the Configure push button on the KwikINF window or 
  233. when you enter the following from the command line of an OS/2 Window: 
  234.  
  235. KwikINF /C
  236.  
  237. The Configure KwikINF window allows you to: 
  238.  
  239.      Select another KwikINF hot key 
  240.      Specify the number of OS/2 full-screen sessions enabled for KwikINF 
  241.      Specify the name of the default online document KwikINF searches 
  242.      Select the activation behavior of the KwikINF window. 
  243.  
  244.  Use the push buttons on the Configure KwikINF window as follows: 
  245.  
  246.      Press OK to enable your configuration choices. 
  247.      Press Cancel to cancel your configuration choices. This closes the 
  248.       Configure KwikINF window. 
  249.      Press Help to get general help for the current window. 
  250.  
  251.  
  252. ΓòÉΓòÉΓòÉ 4.1. Activation Key Sequence ΓòÉΓòÉΓòÉ
  253.  
  254. The Activation Key Sequence provides a selectable list of KwikINF hot keys. To 
  255. access the list, single-click on the down arrow. Select the KwikINF hot key of 
  256. your choice from the following list: 
  257.  
  258.       CTRL + A 
  259.       CTRL + H 
  260.       CTRL + Q 
  261.       ALT + A 
  262.       ALT + Q (this is the default hot key) 
  263.  
  264.  The KwikINF hot key initiates searches for information in online documents 
  265.  from anywhere on the desktop, with the exception of DOS or WIN-OS/2 sessions. 
  266.  
  267.  
  268. ΓòÉΓòÉΓòÉ 4.2. Full Screen Sessions ΓòÉΓòÉΓòÉ
  269.  
  270. Use the Number of Fullscreen Sessions to Monitor spin button to specify the 
  271. number of OS/2 full-screen sessions enabled for KwikINF.  KwikINF is 
  272. implemented as a PM system hook to monitor keystrokes in PM sessions and as 
  273. OS/2 character device monitors to monitor keystrokes in OS/2 full-screen 
  274. sessions.  For OS/2 full-screen sessions,  KwikINF will monitor only the number 
  275. of sessions specified here. 
  276.  
  277.  
  278. ΓòÉΓòÉΓòÉ 4.3. Default Volume to Search ΓòÉΓòÉΓòÉ
  279.  
  280. Use the Default Volume to Search single selection list box to specify which 
  281. online document in the BOOKSHELF you want KwikINF to search by default. 
  282. KwikINF looks for the Search String in this online document, when there is no 
  283. matching entry in the KwikINF index file. Select the online document, then 
  284. select the OK push button to activate the selection. 
  285.  
  286.  
  287. ΓòÉΓòÉΓòÉ 4.4. Activation Behavior ΓòÉΓòÉΓòÉ
  288.  
  289. Use the Activation Behavior radio buttons to select the behavior of the KwikINF 
  290. window. The KwikINF window can be displayed or bypassed when the user presses 
  291. the KwikINF hot key after KwikINF has been installed. 
  292.  
  293.      Select the Display KwikINF Window radio button to tell KwikINF that you 
  294.       always want the KwikINF window to be displayed when you press the KwikINF 
  295.       hot key to initiate searches for information.  This is the default 
  296.       behavior of the KwikINF window. 
  297.  
  298.       When the you press the KwikINF hot key, you can initiate a search for the 
  299.       text string that may be automatically displayed in the Search String 
  300.       entry field or for the text string that you enter into this field. You 
  301.       can also specify which online document in the BOOKSHELF KwikINF searches 
  302.       for the text string. 
  303.  
  304.      Select the Bypass KwikINF Window radio button to tell KwikINF that you do 
  305.       not want the KwikINF window to be displayed when you press the KwikINF 
  306.       hot key to initiate searches for information. This is typically used when 
  307.       working under conditions where the KwikINF automatic text-retrieval 
  308.       feature is available. 
  309.  
  310.       When you press the KwikINF hot key, KwikINF automatically looks for the 
  311.       text string under the cursor in the online document that has a matching 
  312.       entry in the KwikINF index file or, if there is no matching entry in the 
  313.       index file, in the Default volume selected from the Configure KwikINF 
  314.       window. 
  315.  
  316.       You configure KwikINF by pressing the Configure push button in the 
  317.       KwikINF window.  To configure KwikINF when this window is bypassed, press 
  318.       SHIFT + your KwikINF hotkey to display the Configure KwikINF window. 
  319.  
  320.  
  321. ΓòÉΓòÉΓòÉ 5. Searching for information using the KwikINF window ΓòÉΓòÉΓòÉ
  322.  
  323. If you have configured KwikINF to display the KwikINF window (this is the 
  324. default condition), the KwikINF window is displayed when you press your KwikINF 
  325. hot key. 
  326.  
  327. The KwikINF window allows you to search for a text string in an online document 
  328. in the OS/2 BOOKSHELF.  The text string is typed by you in the Search String 
  329. entry field or is automatically retrieved by KwikINF, under certain conditions, 
  330. from under the cursor when you press your KwikINF hot key. 
  331.  
  332. The online document that KwikINF searches for the text string is selected from 
  333. the Volume to Search list box by KwikINF or by you.  KwikINF selects the Volume 
  334. to Search by looking for the text string that has a matching entry in the 
  335. KwikINF index file or, if there is no matching entry in the index file, in the 
  336. Default Volume you have selected in the Configure KwikINF window.  Or you can 
  337. override KwikINF's selection of the Volume to Search by making your own 
  338. selection from the list box. 
  339.  
  340. To initiate the search for the text string in the online document, press the 
  341. Search push button or press Enter. If the search is successful, KwikINF opens 
  342. the online document to the online panel that contains the information and 
  343. displays a window with a title bar that matches the search string. 
  344.  
  345. If the search is not successful, you can search any online document for the 
  346. information by following this procedure: 
  347.  
  348.      Clear the Search String entry field. 
  349.      Select an online document from the Volume to Search list box.  The 
  350.       Contents window of the online document appears. 
  351.      Select Services from the menu bar. 
  352.      Select Searchfrom the Services pull down menu.  The Search help window 
  353.       appears. 
  354.      Type the text string, then select the All libraries radio button. 
  355.      Select the Search push button or press Enter. 
  356.  
  357.  Use the push buttons on the KwikINF window as follows: 
  358.  
  359.      Press Search to initiate the search for the text string in the Search 
  360.       String entry field in the selected online document. 
  361.      Press Cancel to cancel the request to search for the text string and to 
  362.       close the KwikINF window. 
  363.      Press Configure to display the Configure KwikINF window. 
  364.      Press Help to get general help for the current window. 
  365.  
  366.  
  367. ΓòÉΓòÉΓòÉ 5.1. Search String entry field ΓòÉΓòÉΓòÉ
  368.  
  369. KwikINF searches for the text string in this entry field in the selected online 
  370. document in the OS/2 BOOKSHELF. 
  371.  
  372. Under certain conditions, KwikINF automatically retrieves the word under the 
  373. cursor when you press your KwikINF hot key. Letters, numbers, underscores, and 
  374. the pound sign are retrievable by KwikINF. Blank spaces and other special 
  375. characters are used as delimiters and are not retrievable by KwikINF. 
  376.  
  377. You may also type any text string you want into this field.  All characters are 
  378. valid in the entry field to allow for special search criteria. 
  379.  
  380.  
  381. ΓòÉΓòÉΓòÉ 5.2. Volume to Search list box ΓòÉΓòÉΓòÉ
  382.  
  383. The KwikINF window includes a list box of all online documents stored in the 
  384. OS/2 BOOKSHELF subdirectories.  KwikINF initiates searches for information in 
  385. any online document in this list.  The online document where KwikINF looks for 
  386. the Search String is selected from the Volume to Search list box by KwikINF or 
  387. by you.  KwikINF selects the Volume to Search by looking for the text string 
  388. that has a matching entry in the KwikINF index file or, if there is no matching 
  389. entry in the index file, in the Default Volume you have selected in the 
  390. Configure KwikINF window.  Or you can override KwikINF's selection of the 
  391. Volume to Search by making your own selection from the list box. 
  392.  
  393. You can also open and display the Contents of an online document by 
  394. double-clicking on an entry in this list box. 
  395.  
  396.  
  397. ΓòÉΓòÉΓòÉ <hidden> IBM Trademark ΓòÉΓòÉΓòÉ
  398.  
  399. Trademark of the IBM Corporation. 
  400.  
  401.  
  402. ΓòÉΓòÉΓòÉ <hidden> KwikINF Keys Help ΓòÉΓòÉΓòÉ
  403.  
  404. Use your KwikINF hot key (ALT+Q or the hot key you select from the Configure 
  405. KwikINF window) to display the KwikINF window.  You can also use your KwikINF 
  406. hot key to initiate a search for a text string automatically, when you 
  407. configure KwikINF to bypass the KwikINF window. 
  408.  
  409. To re-configure KwikINF, when you have configured KwikINF to bypass the KwikINF 
  410. window, press SHIFT + your KwikINF hot key. 
  411.  
  412. To determine what your KwikINF hot key is, double-click on the KwikINF program 
  413. object in the OS/2 Toolkit Development Tools folder.