home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c500 / 4.ddi / BENCH.WPK / BENCH.HLP
Encoding:
Text File  |  1992-05-28  |  36.6 KB  |  895 lines

  1. ::::BENCH_CONFIGURATION
  2.                Configuring your system
  3.                ═══════════════════════
  4.  
  5. The WCONFIG program is used to configure the InfoBench system.
  6. Additionally, specific tools may provide tool-specific configuration.
  7. The "Editor and Configuration" manual describes how to use the WCONFIG
  8. program.
  9.  
  10. The following aspects may be configured:
  11.        * screen colours (for colour monitors)
  12.        * screen shades (for monitors which have shades of grey)
  13.        * screen attributes (for monochrome monitors)
  14.        * printers
  15.        * what is displayed during file browsing
  16. ::::BROWSE_WINDOW
  17.                Browsing Window
  18.                ═══════════════
  19.  
  20. A browsing window is used to select or view items. The general format
  21. of the window is as follows:
  22.    ┌──────────────title────────────────────┐
  23.    │                       │
  24.    │   list of scrolling items           │
  25.    │                       │
  26.    │Escape=Cancel           Enter=Select│
  27.    └───────────────────────────────────────┘
  28. There will be a scroll bar (see <SCROLL_BAR>) on the right of the
  29. window if the number of items is greater than the capacity of the
  30. window.
  31.  
  32. You can cancel the window by pressing the Escape (Esc) key.
  33.  
  34. When the "Enter=Select" hotspot is present, you can select an item in
  35. the scrolling area by making that item the current item and then
  36. pressing the Enter key (the Enter key is ignored when the window is to
  37. be used for viewing only). You can change the current item by pressing
  38. the CURSOR-UP or the CURSOR-DOWN keys.
  39.  
  40. When the scroll bar is present, the list of items will scroll in the
  41. window when you press the CURSOR-UP (CURSOR-DOWN) key when the current
  42. item is at the top (bottom) of the window. You can also display the
  43. next (last) window of items by pressing the PgDn (PgUp) keys. You can
  44. position to the start (end) of the list of items by pressing the Ctrl
  45. and PgUp (Ctrl and PgDn) keys simultaneously.
  46.  
  47. If your computer has a mouse attached to it, you can use the scroll
  48. bar (see <SCROLL_BAR>) to reposition what is being displayed. You can
  49. select an item by pressing and releasing the leftmost button of the
  50. mouse while the mouse cursor is positioned within that item.
  51. ::::CHECK_FIELD
  52.                  Check Field
  53.                  ═══════════
  54.  
  55. A check field appears as follows:
  56.    [ ] field name
  57. or
  58.    [X] field name
  59. When there is an "X" between the square brackets, the field is true.
  60. It is false when there is a space between the square brackets.
  61.  
  62. Setting a check field with the keyboard
  63. ═══════════════════════════════════════
  64.  
  65. You can set a check field by positioning to that field and then
  66. pressing the space bar.
  67.  
  68. Setting a check field with the mouse
  69. ════════════════════════════════════
  70.  
  71. You can set a check field by clicking the mouse while the mouse cursor
  72. is within that field. The check field becomes the current field.
  73. ::::DIRECTORY_BROWSE
  74.               Directory Browser
  75.               ═════════════════
  76.  
  77. A directory can be selected using a Directory Browsing window which
  78. appears as follows:
  79.    ┌───────────────────────────────────────┐
  80.    │   Directory Field               │
  81.    ├───────────────────────────────────────┤
  82.    │                       │
  83.    │                       │
  84.    │   Scrolling list of directories       │
  85.    │                       │
  86.    │                       │
  87.    │Escape=Cancel   ....       Enter=Select│
  88.    └───────────────────────────────────────┘
  89. Initially, the cursor is positioned at the start of the scrolling
  90. directory field at the top of the form. This field contains the
  91. current directory to be selected. You can switch between the directory
  92. field and the scrolling area by using the TAB key.
  93.  
  94. You can press the Escape (Esc) key to cancel the directory browser.
  95.  
  96. You can press the F2 function key to receive a list of the drives on
  97. your computer (see <DRIVE_BROWSE>). You can select one of these drives
  98. to become the drive from which directories are displayed by the
  99. directory browser.
  100.  
  101. Directory Field
  102. ═══════════════
  103.  
  104. The directory name that is displayed in the directory field determines
  105. the directory to be selected. When the directory browser was initiated
  106. from the file browser, the directory field will contain the name of
  107. the directory from which files were being displayed by the file
  108. browser.
  109.  
  110. You select this directory by pressing the Enter key when the current
  111. field is the directory field.
  112.  
  113. You can type a DOS directory name (see <DIRECTORY_NAME>) in this field
  114. or you can select one of the directories in the scrolling area to be
  115. placed in this area.
  116.  
  117. Scrolling Area
  118. ══════════════
  119.  
  120. The scrolling area shows the directories on the current drive. The
  121. scrolling area scrolls in the usual way using the cursor keys, PgUp
  122. (display previous page), PgDn (display next page), Ctrl/PgUp (display,
  123. starting at beginning), and Ctrl/PgDn (display, last portion).
  124.  
  125. The directories are shown with lines preceding them to denote the
  126. hierarchical structure of the sub-directories. Each line corresponds
  127. to one sub-directory.
  128.  
  129. You can select a directory in the scrolling area by pressing the Enter
  130. key when that directory name is the current field. The full directory
  131. name will be copied to the directory field which will become the
  132. current field.
  133.  
  134. Mouse
  135. ═════
  136.  
  137. If there is a mouse attached to your computer (see <MOUSE>), then you
  138. can position to the directory field by pressing and releasing the
  139. leftmost mouse button while the mouse cursor is positioned on that
  140. field.
  141.  
  142. If you press and release the mouse while the mouse cursor is
  143. positioned on a directory in the scrolling area, then that directory
  144. will be selected into the directory field. You can also use the mouse
  145. in conjunction with the scroll bar (see <SCROLL_BAR>) to change the
  146. directory names displayed in the scrolling area.
  147.  
  148. If you "double-click" on a directory field, then that directory will
  149. be the one selected. You "double-click" the mouse by pressing and
  150. releasing the leftmost mouse button two times, within a short time
  151. interval.
  152. ::::DIRECTORY_DIALOGUE
  153.               Directory Dialogue
  154.               ══════════════════
  155.  
  156. The directory window contains fields for the device and directory for
  157. which files are to be displayed in the file browsing window. You can
  158. change these fields. When you press Enter, the window will disappear
  159. and file names from the new directory will appear. If you press the
  160. Esc (escape) key, the window is cancelled and the directory from which
  161. files are displayed is unchanged.
  162.  
  163. Directory browsing
  164. ══════════════════
  165.  
  166. Alternately, you can reset the device and directory fields by using
  167. the path browser (press F2) or the directory browser (press F3). The
  168. directory browser shows a full tree representation of the directories
  169. on the current disk drive (see <DIRECTORY_BROWSE>). The path browser
  170. shows only the path to the current directory and the sub-directories
  171. found within the current directory (see <PATH_BROWSE>). If you have
  172. many directories on your disk drive, you may find excessive the time
  173. that is required to build the full display shown by the directory
  174. browser (all directories on the drive need to be read).
  175. ::::DIRECTORY_NAME
  176.                Directory names
  177.                ═══════════════
  178.  
  179. Valid directory names have the following format:
  180.    [ drive: ] [\] [ name ] [ \name ] ... [ \name ]
  181. where "name" is an existing sub-directory name. Some examples are:
  182.    C:\PROJECT1
  183.    C:\PROJECT1\DATA
  184.    C:\PROJECT1\DATA\BUDGET
  185. When the drive is omitted, the current drive is used. The following
  186. names are equivalent to the preceding names when the current drive is
  187. "C":
  188.    \PROJECT1
  189.    \PROJECT1\DATA
  190.    \PROJECT1\DATA\BUDGET
  191. When there is no "\" preceding the first sub-directory name, the
  192. entered sub-directories are assumed to be sub-directories of the
  193. current working directory on the indicated drive. Thus, if the current
  194. working directory on drive "C" is "PROJECT", then the three
  195. directories could have been given as:
  196.    C:
  197.    C:DATA
  198.    C:DATA\BUDGET
  199. The special directory named "."
  200. ═══════════════════════════════
  201.  
  202.  
  203. With DOS, each drive has a special directory termed the "current
  204. working directory" to which file names apply when there is no path
  205. specification preceding the file name. This directory can be
  206. referenced by ".". Thus, if your current working directory is
  207. C:\PROJECT1\DATA, then, the following are equivalent:
  208.    .           C:\PROJECT1\DATA
  209.    .\JUNE      C:\PROJECT1\DATA\JUNE
  210. The special directory name ".."
  211. ═══════════════════════════════
  212.  
  213. When ".." is used as a directory name, then, it refers to the parent
  214. directory of in the directory path to that point (or the parent
  215. directory of the current directory at the start). Thus, the following
  216. are equivalent when the current directory is C:\PROJECT1\DATA
  217.    ..               C:\PROJECT1
  218.    ..\REPORT           C:\PROJECT1\REPORT
  219.    ..\..\PROJECT2\DATA c:\PROJECT2\DATA
  220. ::::DOS_SERVICES
  221.                  DOS Services
  222.                  ════════════
  223.  
  224. The Control menus all contain an item "DOS Services" which, when
  225. chosen, causes the following actions to occur:
  226.    * the current application is suspended
  227.    * the DOS command interpreter is activated
  228.    * DOS commands can now be entered
  229. The current application resumes when the DOS "EXIT" command is
  230. entered.
  231. ::::DRIVE_BROWSE
  232.                  DRIVE_BROWSE
  233.                  ════════════
  234.  
  235. A drive is selected using a Drive Browsing window which appears as
  236. follows:
  237.    ┌───────────────────────────────────────┐
  238.    │   current drive               │
  239.    ├───────────────────────────────────────┤
  240.    │                       │
  241.    │                       │
  242.    │   scrolling list of drives        │
  243.    │                       │
  244.    │                       │
  245.    │Escape=Cancel           Enter=Select│
  246.    └───────────────────────────────────────┘
  247. Initially, the cursor is positioned at the drive field at the top of
  248. the form. This field contains the current drive to be selected. You
  249. can switch between the drive field and the scrolling area by using the
  250. TAB key.
  251.  
  252. You can press the Escape (Esc) key to cancel the drive browser.
  253.  
  254. When the drive is for removable media (such as a diskette drive), the
  255. text "-removable" is shown following the drive letter. Otherwise, the
  256. volume identification for that drive is displayed.
  257.  
  258. Drive Field
  259. ═══════════
  260.  
  261. The drive name that is displayed in the drive field determines the
  262. drive to be selected. When the drive browser is initiated from the
  263. directory browser, the drive field will contain the drive for which
  264. directories were being displayed.
  265.  
  266. You select this drive by pressing the Enter key when the current field
  267. is the drive field.
  268.  
  269. You can type a valid DOS drive letter in this field or you can select
  270. one of the drives in the scrolling area to be placed in this field.
  271.  
  272. Scrolling Area
  273. ══════════════
  274.  
  275. The scrolling area shows the drives on your computer. The scrolling
  276. area scrolls in the usual way using the cursor keys, PgUp (display
  277. previous page), PgDn (display next page), Ctrl/PgUp (display, starting
  278. at beginning), and Ctrl/PgDn (display, last portion).
  279.  
  280. You can select a drive in the scrolling area by pressing the Enter key
  281. when that drive is the current field.
  282.  
  283. Drive names are followed by:
  284.    - removable       (for diskette drives)
  285.    volume label    (for hard disk drives)
  286. Mouse
  287. ═════
  288.  
  289. If there is a mouse attached to your computer (see <MOUSE>), then you
  290. can position to the drive field by pressing and releasing the leftmost
  291. mouse button while the mouse cursor is positioned on that field.
  292.  
  293. If you press and release the mouse while the mouse cursor is
  294. positioned on a drive in the scrolling area, then that drive will be
  295. selected into the drive field. You can also use the mouse in
  296. conjunction with the scroll bar (see <SCROLL_BAR>) to change the drive
  297. names displayed in the scrolling area.
  298.  
  299. If you "double-click" on a drive field, then that drive will be the
  300. one selected. You "double-click" the mouse by pressing and releasing
  301. the leftmost mouse button two times, within a short time interval.
  302. ::::FILE_BROWSER
  303.  ->FileBrowser
  304. ::::FILE_DISPLAY_OPTIONS
  305.        Setting the display options for the File Browser
  306.        ════════════════════════════════════════════════
  307.  
  308. Display options
  309. ═══════════════
  310.  
  311. Display options are check fields (see <CHECK_FIELD>) which determine
  312. what can be displayed about a file name. When the option is true (an
  313. "X" is shown), the file browser will display the corresponding
  314. information for each file. The options are:
  315.    Time:    the time that the file was last updated
  316.    Date:    the date that the file was last updated
  317.    File Size:    the size of the file
  318.    Attribute:    the file attributes
  319.    Description: a file description for the extension
  320. Attributes are shown as letters where
  321.    A: file has not been archived
  322.    R: file is read/only
  323. Descriptions are based upon the file extension and indicate the
  324. probable use of that file. For example, the WP word processor uses
  325. files with an extension of "DOC" and the WATCOM Spreadsheet uses an
  326. extension of "WSS".
  327.  
  328. Directory Browsing
  329. ══════════════════
  330.  
  331. There are three radio buttons (see <RADIO_BUTTON>) to determine what
  332. type of directory browsing should be obtained from the file browsing
  333. window:
  334.    Path Browsing       (see <PATH_BROWSE>)
  335.    Directory Browsing  (see <DIRECTORY_BROWSE>)
  336.    Directory Dialogue  (see <DIRECTORY_DIALOGUE>)
  337. File Pattern
  338. ════════════
  339.  
  340. The window also contains a field for the file pattern used to select
  341. file names to be displayed. This field shows the pattern used to
  342. restrict the files to be displayed. An application may set a pattern
  343. to restrict the display to only files with a particular file
  344. extension. You can change this pattern if you wish only certain files
  345. to be displayed.
  346.  
  347. A pattern "*.*" will cause all files to be displayed.
  348.  
  349. A file name consists of up to eight characters followed by an optional
  350. period and an optional file extension of up to three characters. Some
  351. valid file names are:
  352.    MYDATA
  353.    MYDATA.DAT
  354.    BUDGET.DAT
  355.    MORE.DAT
  356. A file name which matches the pattern will be displayed.
  357.  
  358. The pattern can contain special characters "?" and "*". Characters in
  359. the pattern and the file name are compared one at a time according to
  360. the following rules:
  361.   (1) A "?" matches any character in a file name.
  362.   (2) A "*" causes the remaining characters in a file name or
  363.       extension to match.
  364.   (3) Any other character must match the corresponding character in
  365.       the file name.
  366. Some examples are:
  367.            *.*     *.dat   mydata.*    m*.dat  m?data.*
  368.    MYDATA      match           match           match
  369.    MYDATA.DAT  match   match   match       match   match
  370.    MODATA.DAT  match   match           match   match
  371.    BUDGET.DAT  match   match
  372.    MONDAY.DAT  match   match           match
  373. Include sub-directories in Browse window
  374. ════════════════════════════════════════
  375.  
  376. When this check field (see <CHECK_FIELD>) is set (an asterisk (*)
  377. appears), the parent directory (unless you are at the root of the
  378. device) and any sub-directories will be displayed in the scrolling
  379. area of the file browser. The parent directory is shown as:
  380.    * parent directory
  381. and a sub-directory "XXXX" is shown as
  382.    * sub-directory: XXXX
  383. Remember last directory browsed.
  384. ════════════════════════════════
  385.  
  386. When this check field (see <CHECK_FIELD>) is set (an asterisk (*)
  387. appears), the system will remember the directory in which you were
  388. browsing. This directory will be used as the starting directory the
  389. next time that the file browser is activated during your current
  390. session.
  391.  
  392. When the field is not set, the initial directory is your current
  393. working directory.
  394.  
  395. Configuration
  396. ═════════════
  397.  
  398. The Infobench configuration program (WCONFIG) can be used to configure
  399. the file browser for all WATCOM tools (see <BENCH_CONFIGURATION> for a
  400. description.
  401.  
  402. ::::FileBrowser
  403.                  File Browser
  404.                  ════════════
  405.  
  406. A file is selected using a File Browsing window which appears as
  407. follows:
  408.    ┌───────────────────────────────────────┐
  409.    │   current file               │
  410.    ├───────────────────────────────────────┤
  411.    │                       │
  412.    │                       │
  413.    │   scrolling list of files           │
  414.    │                       │
  415.    │                       │
  416.    │Escape=Cancel   ....       Enter=Select│
  417.    └───────────────────────────────────────┘
  418. Depending upon the application that is displaying the browsing window,
  419. there may be extra fields at the top of the window and/or extra fields
  420. before the hot spots at the bottom of the window.
  421.  
  422. You can cancel the file selection process by pressing the Escape (Esc)
  423. key.
  424.  
  425. Initially, the cursor is positioned at the start of the scrolling file
  426. field at the top of the display window. You can switch between the
  427. file field and the scrolling area by using the TAB key.
  428.  
  429. You can press the F2 function key to obtain a window in which you can
  430. change the directory from which files are displayed. Depending upon
  431. how file browsing is configured, one of the following hotspots will be
  432. shown at the bottom of file-browsing window:
  433.        F2=Set-directory    (see <DIRECTORY_DIALOGUE>)
  434.        F2=Path-Browsing    (see <PATH_BROWSE>)
  435.        F2=Direct.-Browsing (see <DIRECTORY_BROWSE>)
  436.  
  437. You can press the F3 function key to receive a window in which your
  438. current file-display options are listed (see <FILE_DISPLAY_OPTIONS>).
  439. You can change these options to
  440.        * alter the format of file entries which are displayed
  441.        * set the method to change directories
  442.        * remember the last browse directory
  443.        * include or exclude sub-directories in the scrolling
  444.      area
  445.        * restrict the displayed file names to match a given
  446.      pattern
  447.  
  448. The Infobench configuration program (WCONFIG) can be used to configure
  449. the file browser for all WATCOM tools (see <BENCH_CONFIGURATION> for a
  450. description.
  451.  
  452. File Field
  453. ══════════
  454.  
  455. The file name that is displayed in the file field determines the file
  456. to be selected. Initially, this field is blank. You select this file
  457. by pressing the Enter key when the current field is the file field.
  458.  
  459. You can type a valid DOS file name in this field or you can select one
  460. of the files in the scrolling area to be placed in this area.
  461.  
  462. Scrolling Area
  463. ══════════════
  464.  
  465. The scrolling area shows any files in the current directory which
  466. match the file pattern. The file pattern is described in
  467. <FILE_DISPLAY_OPTIONS>. The scrolling area scrolls in the usual way
  468. using the cursor keys, PgUp (display previous page), PgDn (display
  469. next page), Ctrl/PgUp (display, starting at beginning), and Ctrl/PgDn
  470. (display, last portion).
  471.  
  472. You can select a file name in the scrolling area by pressing the Enter
  473. key when that file name is the current field. The file name will be
  474. copied to the file field which will become the current field.
  475.  
  476. If the file browser is configured to include sub-directories within
  477. the scrolling area, then selecting one those directories will change
  478. the directory from which files are displayed.
  479.  
  480. Mouse
  481. ═════
  482.  
  483. If there is a mouse attached to your computer (see <MOUSE>), then you
  484. can position to the file field by pressing and releasing the leftmost
  485. mouse button while the mouse cursor is positioned on that field.
  486.  
  487. If you press and release the mouse while the mouse cursor is
  488. positioned on a file in the scrolling area, then that file will be
  489. selected into the file field. You can also use the mouse in
  490. conjunction with the scroll bar (see <SCROLL_BAR>) to change the file
  491. names displayed in the scrolling area.
  492.  
  493. If you "double-click" on a file field, then that file will be the one
  494. selected. You "double-click" the mouse by pressing and releasing the
  495. leftmost mouse button two times, within a short time interval.
  496. ::::HelpAboutHelp
  497.               How to use the HELP System
  498.               ══════════════════════════
  499.  
  500. You are now looking at Help text which can be used to help you
  501. understand the particular component that you are now using.
  502.  
  503. When the text is too long to be displayed, you can view the next
  504. screenful by pressing the key labelled "PgDn" or "Page Down".
  505. Similarly, the preceding screenful can be viewed by pressing "PgUp" or
  506. "PageUp".
  507.  
  508. Sometimes the Help text contains references to other text such as
  509. <INDEX> which will allow you to obtain Help about another topic (in
  510. this case, to display the index of help topics for your current
  511. software package). When there is only one such reference visible on
  512. the screen, pressing the Enter key will cause that Help topic to be
  513. displayed. When there is a number of references, the current topic
  514. will be displayed when the Enter key is pressed. You can change the
  515. current topic by successively pressing the TAB-FORWARD, TAB_BACKWARD,
  516. or any of the cursor-positioning keys (denoted with arrows on your
  517. keyboard).
  518.  
  519. While Help text is being displayed, you can obtain this Help text by
  520. pressing the F1 key. Similarily, if you press the F2 key, then an
  521. index for your software will be displayed.
  522.  
  523. When you have displayed more than one topic, you can switch from topic
  524. to topic by pressing the F3 (view the next topic) or the F4 (view the
  525. last topic) keys.
  526.  
  527. If your computer has a mouse attached to it, the mouse can be used in
  528. the Help system, with the scroll bar on the right (see <SCROLL_BAR>)
  529. or to select a topic (press and release the leftmost button of the
  530. mouse while the mouse cursor is located on the topic). A scroll bar is
  531. visible only when the current topic is too long to be displayed on the
  532. screen.
  533. ::::HelpMenu
  534.                How to use the InfoBench
  535.                ════════════════════════
  536.  
  537. If you do not know how to use the Help system, press the Help key (F1)
  538. and a description of how to use Help will be displayed.
  539.  
  540. Across the top of your screen you will see the menu bar which consists
  541. of a number of menu names (the first menu is "Control"). There is a
  542. number of actions available for each of these menus. If you wish to
  543. learn more about how to use the menus, see <MENUS>.
  544.  
  545. You can learn more about this application by examining the information
  546. for the topics in the index (press F2 to obtain the index) or by
  547. selecting the "Help" item in "Control" menu.
  548.  
  549. There may also be information that is specific to your installation.
  550. See <INSTALLATION_HELP> for details.
  551. ::::HOT_SPOTS
  552. Hot spots are areas on the screen which contain text indicating
  553. function keys or special keys such as Escape or Enter. You can see a
  554. number areas at the bottom of the area for this help text.
  555.  
  556. If you have a mouse, clicking the mouse on a hot spot is equivalent to
  557. pressing the indicated key. If you don't have a mouse, then these
  558. areas cannot be used (instead, use the indicated keys from the
  559. keyboard to activate the function).
  560.  
  561. ::::MENUS
  562.                How to use Menus
  563.                ════════════════
  564.  
  565. When you start an application, you are presented with a "menu bar" on
  566. the first line of the screen. Each of the names on that line
  567. represents a menu of actions that you can request.
  568.  
  569. Using the keyboard
  570. ══════════════════
  571.  
  572. You can activate the menu bar by pressing and releasing the Alt key.
  573. You can then cycle through the menu names on the menu bar by pressing
  574. the cursor-right or cursor-left keys. You can deactivate the menu bar
  575. by pressing the Escape key.
  576.  
  577. When the menu bar is active, each name has a unique "hot letter" which
  578. is high-lighted within the menu-bar name. If you press the key for one
  579. of those letters, the associated menu will be pulled down. When the
  580. menu bar is active, you can also pull down a menu by pressing any of
  581. the cursor-down, cursor-up, or Enter keys.
  582.  
  583. When a menu is pulled down, you can then cycle through the menus by
  584. pressing the cursor-right or cursor-left keys.
  585.  
  586. When a menu is first pulled down, the first item in the menu is
  587. highlighted to indicate that it is the current item. You can press the
  588. cursor-down or the cursor-up keys to change the current item.
  589.  
  590. If you wish to cancel the menu-selection process, press the Escape key
  591. (Esc) and the current menu will disappear.
  592.  
  593. If you wish to select one of the actions, use the cursor-up and/or
  594. cursor-down keys to make that action the current item (the
  595. high-lighted one) and then press the Enter key. Alternatively, you can
  596. type the "hot letter" which is high-lighted within the menu item.
  597.  
  598. Using the mouse (see also <MOUSE>)
  599. ══════════════════════════════════
  600.  
  601. The menu for an item on the menu bar will be pulled down when you
  602. press the leftmost mouse button while the mouse cursor is within that
  603. item, and then drag downwards (without releasing the mouse button ).
  604. To select an item from the menu, drag the mouse (move the mouse
  605. without releasing the mouse button) so that the mouse cursor is within
  606. the item to be selected and then release the mouse button.
  607.  
  608. If you drag the mouse to another menu name on the menu bar, then the
  609. menu for the new name is pulled down. The menu for the old name will
  610. disappear.
  611.  
  612. If you decide that you wish to cancel the menu-selection process, be
  613. careful to release the mouse button while the mouse cursor is not
  614. positioned within either the menu bar or within a menu.
  615.  
  616. If you wish to pull down a menu, press and release the leftmost mouse
  617. button, while the mouse cursor is within that menu name on the menu
  618. bar.
  619.  
  620. If you wish to cancel a pulled-down menu, press and release the
  621. leftmost mouse button, while the mouse cursor is within the name of
  622. the menu on the menu bar.
  623.  
  624. ::::MOUSE
  625.                Using the Mouse
  626.                ═══════════════
  627.  
  628. General Information
  629. ═══════════════════
  630.  
  631. The mouse is a pointing device. As you move the mouse, the mouse
  632. cursor (a rectangular box) will move correspondingly about the screen.
  633. Moving the mouse, without pressing any of the button(s) on it has no
  634. effect except to move the mouse cursor.
  635.  
  636. The first mouse button (the leftmost one) or the only one, depending
  637. upon the particular mouse that you have, is used to signal the
  638. pointing interaction. When you press the button, you are starting a
  639. mouse interaction that is completed when you release that button. The
  640. particular interaction depends on the location of the mouse cursor
  641. when you press the mouse.
  642.  
  643. The term "click the mouse" means to press and then to immediately
  644. release the leftmost button on the mouse without moving it. Typically,
  645. you click the mouse to select an item, to invert the value of a check
  646. field (see <CHECK_FIELD>), or to set a radio button (see
  647. <RADIO_BUTTON>).
  648.  
  649. The term "drag the mouse" means to move the mouse while the mouse
  650. button is depressed. Typically, you drag the mouse while a mouse
  651. interaction is not yet complete.
  652.  
  653. Using the mouse with menus (see also <MENUS>)
  654. ═════════════════════════════════════════════
  655.  
  656. The menu for an item on the menu bar will be pulled down when you
  657. press the leftmost mouse button while the mouse cursor is within that
  658. item, and then drag downwards (without releasing the mouse button ).
  659. To select an item from the menu, drag the mouse (move the mouse
  660. without releasing the mouse button) so that the mouse cursor is within
  661. the item to be selected and then release the mouse button.
  662.  
  663. If you drag the mouse to another menu name on the menu bar, then the
  664. menu for the new name is pulled down. The menu for the old name will
  665. disappear.
  666.  
  667. If you decide that you wish to cancel the menu-selection process, be
  668. careful to release the mouse button while the mouse cursor is not
  669. positioned within either the menu bar or within a menu.
  670.  
  671. If you wish to pull down a menu, press and release the leftmost mouse
  672. button, while the mouse cursor is within that menu name on the menu
  673. bar.
  674.  
  675. If you wish to cancel a pulled-down menu, press and release the
  676. leftmost mouse button, while the mouse cursor is within the name of
  677. the menu on the menu bar.
  678.  
  679. Using the mouse with Hot Spots
  680. ══════════════════════════════
  681.  
  682. Hot spots are areas on the screen which contain text indicating
  683. function keys or special keys such as Escape or Enter. You can see a
  684. number areas at the bottom of the area for this help text.
  685.  
  686. If you have a mouse, clicking the mouse on a hot spot is equivalent to
  687. pressing the indicated key. If you don't have a mouse, then these
  688. areas cannot be used (instead, use the indicated keys from the
  689. keyboard to activate the function).
  690.  
  691. Using the mouse while editing
  692. ═════════════════════════════
  693.  
  694. If you click the mouse on an editable field into which data can be
  695. typed, the keyboard cursor is positioned to the field. The keyboard
  696. position is identical to the position of the mouse cursor if there is
  697. a non-blank character at that position or to the right of that
  698. position; otherwise, the keyboard cursor is positioned immediately
  699. following the right-most non-blank character.
  700.  
  701. If you click the mouse on a check field, the value of the field is
  702. changed. A check field is preceded by "[X]" to indicate that the value
  703. is true and by "[ ]" to indicate a false value. See <CHECK_FIELD> for
  704. more details.
  705.  
  706. If you click the mouse on a radio button, that button becomes the
  707. active button (and the previous active button becomes inactive). The
  708. active radio button is indicated by "(*)" at the start of the field;
  709. other buttons in that set of radio buttons will start with "( )". See
  710. <RADIO_BUTTON> for more details.
  711.  
  712. In these cases, you don't actually have to click the mouse, although
  713. this is what you would normally do. To be more precise, you must press
  714. the mouse button while the mouse cursor is within the framed window
  715. containing the field in question. The button is released while the
  716. mouse cursor is within the field in question (the mouse could have
  717. been dragged to that field).
  718. ::::PATH_BROWSE
  719.                  Path Browser
  720.                  ════════════
  721.  
  722. A directory can be selected using the Path Browsing window which
  723. appears as follows:
  724.    ┌───────────────────────────────────────┐
  725.    │   current directory           │
  726.    ├───────────────────────────────────────┤
  727.    │                       │
  728.    │                       │
  729.    │   scrolling list of directories       │
  730.    │   in path                   │
  731.    │                       │
  732.    │Escape=Cancel   ....       Enter=Select│
  733.    └───────────────────────────────────────┘
  734. Initially, the cursor is positioned at the start of the scrolling
  735. directory field at the top of the form. This field contains the
  736. current directory to be selected. You can switch between the directory
  737. field and the scrolling area by using the TAB key.
  738.  
  739. You can press the Escape (Esc) key to cancel the path browser.
  740.  
  741. You can press the F2 function key to receive a list of the drives on
  742. your computer (see <DRIVE_BROWSE>). You can select one of these drives
  743. to become the drive from which directories are displayed by the
  744. directory browser.
  745.  
  746. Directory Field
  747. ═══════════════
  748.  
  749. The directory name that is displayed in the directory field determines
  750. the directory to be selected. When the path browser was initiated from
  751. the directory window, the directory field will contain the name of the
  752. directory on the drive displayed on that window.
  753.  
  754. You select this directory by pressing the Enter key when the current
  755. field is the directory field.
  756.  
  757. You can type a DOS directory name (see <DIRECTORY_NAME>) in this field
  758. or you can select one of the directories in the scrolling area to be
  759. placed in this area. In either case, the display will change to
  760. reflect the path selected.
  761.  
  762. Scrolling Area
  763. ══════════════
  764.  
  765. The scrolling area shows the path to the directory in the directory
  766. field and the sub-directories of that directory. If you select any of
  767. the directories that are displayed, that directory replaces the
  768. directory in the directory field and the scrolling area is re-drawn
  769. for the selected directory. Thus, with successive selections, you can
  770. quickly change the displayed path and locate the directory for which
  771. you are searching.
  772.  
  773. The scrolling area scrolls in the usual way using the cursor keys,
  774. PgUp (display previous page), PgDn (display next page), Ctrl/PgUp
  775. (display, starting at beginning), and Ctrl/PgDn (display, last
  776. portion).
  777.  
  778. Mouse
  779. ═════
  780.  
  781. If there is a mouse attached to your computer (see <MOUSE>), then you
  782. can position to the directory field by pressing and releasing the
  783. leftmost mouse button while the mouse cursor is positioned on that
  784. field.
  785.  
  786. If you press and release the mouse while the mouse cursor is
  787. positioned on a directory in the scrolling area, then that directory
  788. will be selected into the directory field and the scrolling area will
  789. be re-drawn. You can also use the mouse in conjunction with the scroll
  790. bar (see <SCROLL_BAR>) to change the directory names displayed in the
  791. scrolling area.
  792.  
  793. If you "double-click" on a directory field, then that directory will
  794. be the one selected. You "double-click" the mouse by pressing and
  795. releasing the leftmost mouse button two times, within a short time
  796. interval.
  797. ::::RADIO_BUTTON
  798.                 Radio Buttons
  799.                 ═════════════
  800.  
  801. A set of radio buttons appears as follows:
  802.        ( ) button-1
  803.        ( ) button-2
  804.        . . .
  805.        ( ) button-N
  806. The fields may be arranged horizontally, vertically, or in a
  807. rectangle, depending upon their usage in a particular window. At most
  808. one of the fields is true and is preceded by (*). When you set a radio
  809. button to be true, the button that was previously true is set to be
  810. false.
  811.  
  812. When you cycle through the fields on a form using the TAB keys, only
  813. the current radio button (the one which is true) is visited.
  814.  
  815. When the current field is a radio button and the buttons occur on more
  816. than one line, then the CURSOR-UP and the CURSOR-DOWN keys will cycle
  817. around the set of radio buttons in a vertical manner. When the current
  818. button is on a line containing more than one button from the current
  819. set, then the CURSOR-RIGHT and CURSOR-LEFT keys will cycle around the
  820. buttons in the current set on that line. The current radio button is
  821. always set to be true.
  822.  
  823. Setting a radio button with the keyboard
  824. ════════════════════════════════════════
  825.  
  826. You can set a radio button by positioning to that field.
  827.  
  828. Setting a radio button with the mouse
  829. ═════════════════════════════════════
  830.  
  831. You can set a radio button by clicking the mouse while the mouse
  832. cursor is within that radio button. The radio button becomes the
  833. current field.
  834. ::::SCROLL_BAR
  835.                  Scroll Bars
  836.                  ═══════════
  837.  
  838. A scroll bar is used when the information to be displayed is too large
  839. to fit in a display area. A scroll bar can be vertical (displayed up
  840. and down) when the information is too long and can be horizontal
  841. (displayed left and right) when the information is too wide.
  842.  
  843. The bar contains two symbols (called icons) at each end plus an area
  844. in the middle which contains a slider that is used to indicate the
  845. relative position of the information being displayed to the total
  846. information. When the display area is too small, the middle area and
  847. the page-up and page-down icons may be eliminated from the scroll bar.
  848.  
  849. If your computer does not have a mouse attached to it, the scroll bar
  850. is for display purposes only: it will indicate the relative position
  851. of the text being displayed. You can reposition the display text by
  852. pressing the PgUp, PgDn (TAB-FORWARD, TAB-BACKWARD) and the
  853. cursor-positioning keys (denoted with arrows on the keyboard).
  854.  
  855. When you can use a mouse, the scroll bar can be used to reposition the
  856. information being displayed. First, you must press the leftmost button
  857. of the mouse while the mouse cursor is located on the scroll bar. The
  858. position of the mouse cursor when you release the mouse, determines
  859. the repositioning. If the mouse cursor is not on the scroll bar at
  860. this point, no repositioning will take place. If the cursor is on the
  861. first icon at the top (left) of the scroll bar, the information will
  862. scroll down (right) one line (column). If the cursor is on the first
  863. icon at the bottom (right) of the scroll bar, the information will
  864. scroll up (left) one line (column). If the cursor is on the second
  865. icon at the top (left) of the scroll bar, the information will scroll
  866. down (right) by the size of the display area. If the cursor is on the
  867. second icon at the bottom (right) of the scroll bar, the information
  868. will scroll up (left) by the size of the display area. If the cursor
  869. is in the middle area of the scroll bar, the slider is positioned to
  870. indicate the position of the information to be displayed when the
  871. mouse button is released.
  872. ::::SELECT_PRINTER
  873.             Select current printer
  874.             ══════════════════════
  875.  
  876. The current printer is the device to which printed output is directed.
  877. The InfoBench system can be configured to have more than one such
  878. printer if there is more than one printer attached to your computer. A
  879. physical printer can also be configured in a number of different ways.
  880.  
  881. The printer selection window shows the names of printers that have
  882. been configured as a list of radio buttons (see <RADIO_BUTTON>). The
  883. current printer is the one with "(*)" at the start of the name.
  884.  
  885. You can change the radio button to another printer by making that
  886. field the current field and then pressing the space bar. If there is a
  887. mouse attached to your computer, you can accomplish the same by
  888. positioning the mouse cursor within the field and then pressing and
  889. releasing the leftmost mouse button.
  890.  
  891. The current printer is changed (and the selection window is removed)
  892. when you press the Enter key. If you press the Esc (escape) key, the
  893. selection window is cancelled and the current printer will be
  894. unchanged.
  895.