home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / tools / tooldrv / tooldriv.doc < prev    next >
Text File  |  1992-09-30  |  80KB  |  1,786 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  T o o l D r i v e r
  9.  Version 2.0
  10.  ────────────────────
  11.  User's Guide
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  Organizing files and naming conventions /
  19.    Professional Tools /
  20.        for Software Developers and Consultants
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                  ┌───────┐
  30.                             ┌───────┐    │                (R)
  31.                           ──│       │    │───────────────────
  32.                             │  ┌───────┐ │  Association of
  33.  ConVal Software, Inc.      │  │       │─┘  Shareware
  34.                             └──│   o   │    Professionals
  35.                           ─────│   |   │─────────────────────
  36.                                └───┴───┘    MEMBER
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  T o o l D r i v e r
  54.  Version 2.0
  55.  ────────────────────
  56.  User's Guide
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  Organizing files and naming conventions /
  64.    Professional Tools /
  65.       for Software Developers and Consultants
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.                                  ┌───────┐
  75.                             ┌───────┐    │                (R)
  76.                           ──│       │    │───────────────────
  77.                             │  ┌───────┐ │  Association of
  78.  ConVal Software, Inc.      │  │       │─┘  Shareware
  79.                             └──│   o   │    Professionals
  80.                           ─────│   |   │─────────────────────
  81.                                └───┴───┘    MEMBER
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  Copyright 1990-1992 ConVal Software, Inc.
  102.  All rights reserved.
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116. This program is produced by a member of the Association of Shareware
  117. Professionals (ASP).  ASP wants to make sure that the shareware principle
  118. works for you. If you are unable to resolve a shareware-related problem with
  119. an ASP member by contacting the member directly, ASP may be able to help.
  120. The ASP Ombudsman can help you resolve a dispute or problem with an ASP
  121. member, but does not provide technical support for members' products.
  122.  
  123. Please write to the ASP Ombudsman at:
  124.  
  125.  ASP Ombudsman
  126.  545 Grover Road
  127.  Muskegon, MI  49442-9427
  128.  U.S.A.
  129.  
  130. or send a CompuServe message via CompuServe MAIL to ASP Ombudsman
  131. 70007,3536.
  132.  
  133. The ombudsman may be contacted by FAX by sending to the ASP FAX number:
  134. (616) 788-2765. In communication with the ombudsman please include a
  135. telephone number and/or FAX if available.
  136.  
  137. TABLE OF CONTENTS
  138.  
  139.  
  140.  
  141.  Preface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  viii
  142.  
  143.  SECTION 1: Introduction. . . . . . . . . . . . . . . . . . . . . . . . . 9
  144.  What's in ToolDriver?. . . . . . . . . . . . . . . . . . . . . . . . . . 9
  145.  Hardware and software requirements . . . . . . . . . . . . . . . . . . . 9
  146.  How to contact ConVal Software . . . . . . . . . . . . . . . . . . . . . 9
  147.  The ToolDriver package . . . . . . . . . . . . . . . . . . . . . . . .  10
  148.  
  149.  SECTION 2: Installing ToolDriver . . . . . . . . . . . . . . . . . . .  10
  150.  
  151.  SECTION 3: ToolDriver Basics . . . . . . . . . . . . . . . . . . . . .  11
  152.  Starting ToolDriver. . . . . . . . . . . . . . . . . . . . . . . . . .  11
  153.  Exiting ToolDriver . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  154.  The User Interface . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  155.     The menu bar and menus. . . . . . . . . . . . . . . . . . . . . . .  12
  156.     Working with windows. . . . . . . . . . . . . . . . . . . . . . . .  14
  157.     The status line . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  158.     Dialog boxes. . . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  159.     Action buttons. . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  160.     Radio Buttons and check boxes . . . . . . . . . . . . . . . . . . .  19
  161.     Input boxes and list boxes. . . . . . . . . . . . . . . . . . . . .  19
  162.  
  163.  SECTION 4: Menus and options reference . . . . . . . . . . . . . . . .  20
  164.  ≡ (System) menu. . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  165.     Register. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  166.     Product Information . . . . . . . . . . . . . . . . . . . . . . . .  20
  167.  File menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  168.     View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  169.     Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  170.     Change Dir. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  171.     DOS Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  172.     Quit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  24
  173.  Edit menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  24
  174.     Cut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  25
  175.     Copy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  25
  176.     Paste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  25
  177.     Show Clipboard. . . . . . . . . . . . . . . . . . . . . . . . . . .  25
  178.  Search menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  26
  179.     Find. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  26
  180.     Replace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  27
  181.     Search Again. . . . . . . . . . . . . . . . . . . . . . . . . . . .  27
  182.  FileXref . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  28
  183.     Files to cross reference. . . . . . . . . . . . . . . . . . . . . .  28
  184.     Words to cross reference. . . . . . . . . . . . . . . . . . . . . .  29
  185.     Start cross referencing . . . . . . . . . . . . . . . . . . . . . .  29
  186.        Condensed Reports. . . . . . . . . . . . . . . . . . . . . . . .  31
  187.        Extended Reports . . . . . . . . . . . . . . . . . . . . . . . .  32
  188.        Export files . . . . . . . . . . . . . . . . . . . . . . . . . .  33
  189.     View the output log . . . . . . . . . . . . . . . . . . . . . . . .  34
  190.  
  191.  NameChanger menu . . . . . . . . . . . . . . . . . . . . . . . . . . .  34
  192.     Files to process. . . . . . . . . . . . . . . . . . . . . . . . . .  35
  193.     Names to be changed . . . . . . . . . . . . . . . . . . . . . . . .  36
  194.     Start name changing . . . . . . . . . . . . . . . . . . . . . . . .  36
  195.     View the output files . . . . . . . . . . . . . . . . . . . . . . .  37
  196.  Window menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  197.     Size/Move . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  198.     Zoom. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  199.     Tile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  200.     Cascade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  201.     Next. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  202.     Previous. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  203.     Close . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  204.  Help menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  39
  205.     Contents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  39
  206.     Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  39
  207.  
  208.  INDEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  40
  209.  
  210.  
  211.  
  212.                                  FIGURES
  213.  
  214.  
  215. Figure 1: A typical window . . . . . . . . . . . . . . . . . . . . . . . 15
  216. Figure 2: View a File dialog box . . . . . . . . . . . . . . . . . . . . 21
  217. Figure 3: Change Directory dialog box. . . . . . . . . . . . . . . . . . 23
  218. Figure 4: The Find Text dialog box . . . . . . . . . . . . . . . . . . . 26
  219. Figure 5: The Replace Text dialog box. . . . . . . . . . . . . . . . . . 27
  220. Figure 6: Files to cross reference . . . . . . . . . . . . . . . . . . . 28
  221. Figure 7: The Cross reference files dialog . . . . . . . . . . . . . . . 30
  222. Figure 8: Condensed File Cross Reference Report. . . . . . . . . . . . . 31
  223. Figure 9: Condensed Word Usage Report. . . . . . . . . . . . . . . . . . 31
  224. Figure 10: List of Unreferenced Files. . . . . . . . . . . . . . . . . . 32
  225. Figure 11: Extended File Cross Reference Report. . . . . . . . . . . . . 32
  226. Figure 12: Extended Word Usage Report. . . . . . . . . . . . . . . . . . 33
  227. Figure 13: Cross reference export data . . . . . . . . . . . . . . . . . 34
  228. Figure 14: Unreferenced files export data. . . . . . . . . . . . . . . . 34
  229. Figure 15: NameChanger Files dialog. . . . . . . . . . . . . . . . . . . 35
  230. Figure 16: The Change names dialog . . . . . . . . . . . . . . . . . . . 36
  231. Figure 17: View the name-changed files dialog box. . . . . . . . . . . . 37
  232.  
  233.  
  234.  
  235.                                   TABLES
  236.  
  237.  
  238. Table 1: General hot keys. . . . . . . . . . . . . . . . . . . . . . . . 13
  239. Table 2: Menu hot keys . . . . . . . . . . . . . . . . . . . . . . . . . 13
  240. Table 3: Editing hot keys. . . . . . . . . . . . . . . . . . . . . . . . 13
  241. Table 4: Window management hot keys. . . . . . . . . . . . . . . . . . . 14
  242. Table 5: Online help hot keys. . . . . . . . . . . . . . . . . . . . . . 14
  243. Table 6: How to use windows. . . . . . . . . . . . . . . . . . . . . . . 17
  244. Table 7: Export file flags . . . . . . . . . . . . . . . . . . . . . . . 33
  245.  
  246.     Preface
  247.      ──────────────────────────────────────
  248.     Welcome to this user guide to ToolDriver. It describes how you can
  249.     better organize your files and names. This information will be
  250.     useful to anyone responsible for developing, managing, or
  251.     maintaining application software.
  252.  
  253.     You will learn:
  254.      ■ The value of understanding the relationships of source files.
  255.  
  256.      ■ How planning your naming conventions can assist in debugging.
  257.  
  258.      ■ How to uncover obsolete components.
  259.  
  260.      ■ An easy way to change old programs to your current naming style.
  261.  
  262.      ■ Organizing tricks that eliminate entire classes of problems.
  263.  
  264.      ■ Characteristics of a well organized application.
  265.  
  266.      ■ Ways to prevent unanticipated naming problems.
  267.  
  268.     Software applications require careful planning and thoughtful
  269.     implementation. The information provided here will help you
  270.     understand the detailed organization of your application and
  271.     communicate that understanding to others, making your job much
  272.     easier.
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.                                                                     Page   9
  282. SECTION 1: Introduction
  283.  ──────────────────────────────────────
  284.  
  285. What's in ToolDriver?
  286.  ■ An integrated environment for running the ConVal programming tools.
  287.  
  288.  ■ FileXref - cross references your files and names. It reads text files and
  289.    documents their use of other files and words you've selected. It works on
  290.    many languages including C, C++, Pascal, COBOL, BAS, MASM, SQL, Fortran,
  291.    and xBase. And it works on all documentation in text file form.
  292.  
  293.  ■ NameChanger - transforms names in the files associated with your
  294.    application.
  295.  
  296.  ■ FileList - reads your disk and creates a list of file names to be cross
  297.    referenced.
  298.  
  299.  ■ Cre8FSL - A tool like FileList. It creates a list of file names to be
  300.    name-changed.
  301.  
  302. Hardware and software requirements
  303. ToolDriver runs on machines with an 80286 or higher processor and running
  304. DOS 3.1 or higher.  A hard disk, and at least one floppy drive are also
  305. required to run ToolDriver.
  306.  
  307. ToolDriver supports (but does not require) any Windows-compatible mouse.
  308.  
  309.  
  310. How to contact ConVal Software
  311. ConVal Software, Inc.
  312. 11607 E. Butter Creek Road
  313. Moorpark, CA 93021-2412
  314.  
  315. Sales and
  316. technical support:        Monday - Friday
  317.  
  318. Voice      (805) 529-6847 9 AM - 5 PM Pacific Time
  319. Fax        (805) 529-4314
  320. CompuServe 72330,1621
  321.                                                                     Page  10
  322. The ToolDriver package
  323. Your ToolDriver package consists of a set of disks, a ToolDriver User's
  324. Guide (this manual), FileXref User's Guide, and a NameChanger User's Guide.
  325. The FileXref and NameChanger user guide documents will only be needed if you
  326. want to run these tools outside of the ToolDriver environment (directly from
  327. DOS).
  328.  
  329. The disks contain all the programs and files you need to cross reference
  330. your disk files and make changes to your naming conventions.
  331.  
  332.  
  333. SECTION 2: Installing ToolDriver
  334.  ──────────────────────────────────────
  335. Users who downloaded ToolDriver from a BBS see README.DOC for installation
  336. instructions.
  337.  
  338. The ToolDriver installation procedure will verify that you have enough space
  339. on your hard drive, create directories as needed and transfer files from
  340. the distribution diskette to your hard disk. It will let you print out the
  341. documentation and read pertinent information about ToolDriver. Its actions
  342. are self-explanatory; the following instructions tell you all you need to
  343. know.
  344.  
  345. To install ToolDriver:
  346.  1.   Insert the installation disk into drive A. Type the following command,
  347.       then press Enter.
  348.  
  349.          A:INSTALL
  350.  
  351.  2.   Follow the prompts.
  352.  
  353.  3.   At the end of installation, you may want to add this line to your
  354.          CONFIG.SYS file: FILES=20
  355.  
  356.  4.   Insure that DOS is in the PATH statement in your AUTOEXEC.BAT file.
  357.  
  358.  
  359. Running ToolDriver
  360.  
  361. Once you've installed ToolDriver, and if you're anxious to get up and
  362. running, change to the TOOLDRIV directory (if you didn't pick another name
  363. yourself), type TD and press Enter.  Otherwise, continue reading this
  364. documentation to see what you can do with ToolDriver.  
  365.                                                                     Page  11
  366. SECTION 3: ToolDriver Basics
  367.  ──────────────────────────────────────
  368. The ToolDriver platform for organizing files and names was developed using
  369. Borland's Turbo Vision for C++. It has everything you need to setup, run,
  370. view and print output from cross referencing as well as name-changing
  371. functions.
  372.  
  373. It provides:
  374.  ■ multiple resizable windows that can be moved
  375.  ■ mouse support and dialog boxes
  376.  ■ cut, paste, and copy commands using a clipboard
  377.  ■ a small, fast editor for preparing and revising input files
  378.  ■ online Help
  379.  ■ quick access to other programs and back again
  380.  
  381. This section explains the following topics:
  382.  ■ starting and exiting ToolDriver
  383.  ■ working with windows
  384.  ■ using dialog boxes to communicate with ToolDriver
  385.  
  386. Starting ToolDriver
  387. To start ToolDriver, go to the ToolDriver directory ( C:\TOOLDRIV by default
  388. ), type TD and press Enter at the DOS prompt.
  389.  
  390. Exiting ToolDriver
  391. There are two ways to leave ToolDriver:
  392.  ■ Choose File│Quit to leave ToolDriver completely; you have to type TD
  393.    again to reenter it. You'll be prompted to save your work before exiting,
  394.    if you haven't already done so.
  395.  
  396.  ■ Choose File│DOS Shell to shell out from ToolDriver to enter commands at
  397.    the DOS command line. When you're ready to return to ToolDriver, type
  398.    EXIT at the command line and press Enter. You will be able to resume work
  399.    just as you left it.
  400.  
  401. The User Interface
  402. ToolDriver has three visible objects: a menu bar at the top of the screen, a
  403. window area in the middle, and a status line at the bottom of the screen.
  404.  
  405. If you are already familiar with the Borland IDE interface, then you may
  406. want to skip the rest of this section and read the sections on cross
  407. referencing (see FileXref, page 28) and changing names (see NameChanger,
  408. page 34).
  409.  
  410.                                                                     Page  12
  411. The menu bar and menus
  412. The menu bar is your primary access to all the commands on the menu. It is
  413. always visible except when you're viewing your program's output or
  414. transferring to another program.
  415.  
  416. Here is how you choose menu commands using the keyboard:
  417.  
  418. 1.   Press F10. This makes the menu bar active. The next thing you type will
  419.      relate to items on the menu bar.
  420.  
  421. 2.   Use the left and right arrow keys to select the menu you want to
  422.      display. Then press Enter.
  423.  
  424.      As a shortcut for this step, you can just press the highlighted letter
  425.      of the menu title. For example, when the menu bar is active press N to
  426.      move to and display the NameChanger menu.
  427.  
  428.      A third way of doing this step is to hold down the Alt key and then
  429.      press a highlighted letter from the menu bar titles (such as Alt+N) to
  430.      display the menu you want.
  431.  
  432. 3.   Use the up and down arrows now to select a command from the menu
  433. displayed.
  434.  
  435. At this point ToolDriver either carries out the command or displays a dialog
  436. box.
  437.  
  438. There are two ways to choose menu commands with a mouse:
  439. 1.   Click the desired menu title to display the menu and click the desired
  440.      command from the menu.
  441.  
  442. 2.   Or, drag straight from the menu title down to the menu command. Release
  443.      the mouse button on the command you want. (If you change your mind,
  444.      just drag off the menu and no command will be chosen.)
  445.  
  446. Some menus and menu commands are unavailable when it would make no sense to
  447. choose them.
  448.  
  449. Following are lists of keyboard shortcuts (or hot keys) for accessing the
  450. menu bar, choosing menu commands, and working with dialog boxes.  
  451.                                                                     Page  13
  452. Table 1: General hot keys
  453.  
  454.  Hot Key    Menu command      Function
  455.   ──────────────────────────────────────
  456.  F1         Help              Displays a context-sensitive help screen
  457.  F2         File│View         Brings up a dialog box for viewing a file
  458.  F4         Window│Close      Closes the active window
  459.  F5         Window│Zoom       Toggles the active window's size
  460.  F10        (none)            Takes you to the menu bar
  461.   ──────────────────────────────────────
  462.  
  463.  
  464. Table 2: Menu hot keys
  465.  
  466.  Hot Key    Menu              Function
  467.   ──────────────────────────────────────
  468.  Alt+Spacebar  ≡              Takes you to the ≡(Product Info) menu
  469.  Alt+E      Edit              Takes you to the Edit menu
  470.  Alt+F      File              Takes you to the File menu
  471.  Alt+H      Help              Takes you to the Help menu
  472.  Alt+N      NameChanger       Takes you to the NameChanger menu
  473.  Alt+S      Search            Takes you to the Search menu
  474.  Alt+W      Window            Takes you to the Window menu
  475.  Alt+X      FileXref          Takes you to the FileXref menu
  476.  ───────────────────────────────────────
  477.  
  478. Table 3: Editing hot keys
  479.  
  480.  Hot Key    Command                 Function
  481.  ─────────────────────────       ──────────────
  482.  Ctrl+Ins   Edit│Copy            Copies selected text to the clipboard
  483.  Shift+Del  Edit│Cut             Places selected text in the clipboard,
  484.                                  deletes selected text
  485.  Shift+Ins  Edit│Paste           Pastes text from the clipboard into the
  486.                                  active window
  487.  Ctrl+Del   Edit│Clear           Removes selected text from a window, but
  488.                                  doesn't put it in the clipboard
  489.  Ctrl+L     Search│Search Again  Repeats last find or replace
  490.  F3         File│Save            Saves the file in the active edit window
  491.   ──────────────────────────────────────
  492.                                                                     Page  14
  493. Table 4: Window management hot keys
  494.  
  495.  Hot Key    Menu command         Function
  496.   ────────────────────────       ──────────────
  497.  Alt+n      (none)               Displays window n, where n is the number
  498.                                  of the window you want to see
  499.  F4         Window│Close         Closes the active window
  500.  F5         Window│Zoom          Toggles the size of the active window
  501.  Ctrl+F5    Window│Size/Move     Changes the size or position of the active
  502.                                  window
  503.  F6         Window│Next          Makes the next window the active one
  504.  Shift+F6   Window│Previous      Makes the prior window the active one
  505.   ──────────────────────────────────────
  506.  
  507. Table 5: Online help hot keys
  508.  
  509.  Hot Key    Function
  510.   ──────────────────────────────────────
  511.  F1         Opens a context-sensitive help screen
  512.  Alt+F1     Displays the previous help screen
  513.   ──────────────────────────────────────
  514.  
  515. Working with windows
  516. Most of what you see and do in ToolDriver happens in a window. A window is a
  517. screen area that you can open, close, move, resize, zoom, tile, and overlap.
  518.  
  519. You can have many windows open in ToolDriver, but only one window can be
  520. active at any time. Any menu command you choose or text you type generally
  521. applies only to the active window.
  522.  
  523. You can easily spot the active window - it's the one with the double-lined
  524. border around it.  The active window always has a close box, a zoom box, and
  525. scroll bars. If your windows are overlapping, the active window is always on
  526. top of all the others.
  527.  
  528. There are several types of windows, but most of them have these things in
  529. common:
  530.  ■ a title bar
  531.  ■ a close box
  532.  ■ scroll bars
  533.  ■ a zoom box
  534.  ■ a window number (1 to 9)
  535.  
  536. An edit window also displays the current line and column numbers in the
  537. lower left corner.  If you've modified your file, an asterisk (*) appears to
  538. the left of the column and line numbers.
  539.                                                                     Page  15
  540. The following figure shows a typical window:
  541.  
  542. Figure 1: A typical window
  543.  
  544.                  ┌────────────────────────┐
  545.                  │ The title bar contains │
  546.                  │ the name of the window │
  547.                  └───────────┬────────────┘
  548.                              │
  549.   ┌───────────────┐          │      ┌───────────────────────┐
  550.   │ Click the     │          │      │ Click on the zoom box │
  551.   │ close box to  │          │      │ to either enlarge or  │
  552.   │ quickly close │          │      │ shrink the window     │
  553.   │ the window    │          │      └─────────────┬─────────┘
  554.   └──────┬────────┘          │                    │
  555.          │                   │                    │
  556.                                                 
  557.  ┌─ ╔══[■}════════════ Window Title ════════ 4 ═[]══╗ ─┐
  558.  │   ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║   │
  559.  │   ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░   │
  560.  │   ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│░░░░░░░▓   │
  561.  │   ║░░░░░░░░░░░░░░░░░░░┌────────────────────┴────┐░░▓   │
  562.  │   ║░░░░░░░░░░░░░░░░░░░│ The first 9 open        │░░▓   │
  563.  │   ║░░░░░░░░░░░░░░░░░░░│ windows have a window   │░░■   │
  564.  │   ║░░░░░░░░░░░░░░░░░░░│ number. Use Alt and n   │░░▓   │
  565.  │   ║░░░░░░░░░░░░░░░░░░░│ to make window n active │░░▓   │
  566.  │   ║░░░░░░░░░░░░░░░░░░░└─────────────────────────┘░░▓   │
  567.  │   ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓   │
  568.  │   ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓   │
  569.  │   ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓   │
  570.  │   ║░░░░░░░░┌───────────────────────────┐░░░░░░░░░░░▓   │
  571.  │   ║░░░░░░░░│ Use a mouse to scroll the ├─────────░▓   │
  572.  │   ║░░░░░░░░│ contents of the window    │░░░░░░░░░░░▓   │
  573.  │   ║░░░░░░░░└─────────┬─────────────────┘░░░░░░░░░░░▓   │
  574.  │   ║░░░░░░░░░░░░░░░░░░│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓   │
  575.  │   ║░░░░░░░░░░░░░░░░░░│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓   │
  576.  │   ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░   │
  577.  │   ╚═▓▓▓▓▓▓▓▓▓■▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓─┘   │
  578.  │                                                      │
  579.  │   │            ┌────────────────────────────┐      │   │
  580.  └───┴────────────│ Drag any corner to make    │──────┴───┘
  581.                   │ windows larger or smaller. │
  582.                   └────────────────────────────┘
  583.  
  584. The close box of a window is the box in the upper left corner. Click this
  585. box to quickly close the window. (Or choose Window│Close.) The help windows
  586. are considered temporary. You can close them by pressing Esc.
  587.                                                                      Page 16
  588.  
  589. The title bar, the topmost horizontal bar of a window, contains the name of
  590. the window and the window number. Double-clicking the title bar zooms the
  591. window. You can also drag the title bar to move the window around.
  592.  
  593. The zoom box of a window appears in the upper right corner. If the icon in
  594. that corner is an up arrow(), you can click the arrow to enlarge the window
  595. to the largest possible size. If the icon is a double-headed arrow(), the
  596. window is already at its maximum size. In that case, clicking it returns the
  597. window to its previous size. To zoom a window from the keyboard, choose
  598. Window│Zoom.
  599.  
  600. The first nine windows you open in ToolDriver have a window number in the
  601. upper right border. You can make a window active (and bring it to the top)
  602. by pressing Alt and the window number. For example if the FileXref output
  603. report window is window number 4 and it's behind other windows, then Alt+4
  604. brings it to the top so it's fully visible.
  605.  
  606. Scroll bars are horizontal or vertical bars that look like this:
  607.  
  608.  ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓■▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  609.  
  610. Scroll bars show you where you are in relation to what you're viewing. You
  611. use these bars with a mouse to scroll the contents of the window. Click the
  612. arrow at either end to scroll one line at a time. (Keep the mouse button
  613. pressed to scroll continuously.) You can click the shaded area to either
  614. side of the scroll box to scroll a page at a time.
  615.  
  616. Finally, you can drag the scroll box to any spot on the bar to quickly move
  617. to a spot in the window relative to the position of the scroll box.
  618.  
  619. You can drag the bottom right corner to make a window larger or smaller. To
  620. resize from the keyboard, choose Size/Move from the Window menu. Use the
  621. arrow keys alone to move or hold down the shift key while using the arrow
  622. keys to resize the window.  Press enter when finished to get out of the
  623. sizing/moving mode.
  624.  
  625. Table 6 is a quick reference for using windows in ToolDriver. Note that you
  626. don't need a mouse to perform these actions - a keyboard works fine too.
  627.                                                                     Page  17
  628.  
  629. Table 6: How to use windows
  630.  
  631.  To do this             Use one of these techniques
  632.  ───────────────────────────────────────────────────────────────────────────
  633.  Open a file viewer     Choose File│View to open a file and scroll it in a
  634.                         window.
  635.  
  636.  Open other windows     Choose the desired window from the Window menu.
  637.  
  638.  Close a window         Choose Close from the Window menu or click the close
  639.                         box of the window or Press F4.
  640.  
  641.  Activate a window      Click anywhere in the window, or
  642.  
  643.                         Press Alt plus the window number (1 to 9), or
  644.  
  645.                         Choose Window│Next (F6 is the hot key) to step
  646.                         through the windows in the order you created them,
  647.                         or
  648.                         Choose Window│Previous (Shift+F6 is the hot key)
  649.                         to step through the windows in the reverse of the
  650.                         order you created them.
  651.  
  652.  Move an active window  Drag its title bar. Or choose Window│Size/Move
  653.                         and use the arrow keys to place the window where you
  654.                         want it, then press Enter.
  655.  
  656.  Resize the active      Drag the bottom right corner. Or choose
  657.  window                 Window│Size/Move and press Shift while you use the
  658.                         arrow keys to resize the window, then press Enter.
  659.  
  660.  Zoom the active        Click the zoom box in the upper right corner of the
  661.  window                 window, or
  662.  
  663.                         Double-click the window's title bar, or
  664.  
  665.                         Choose Window│Zoom (F5 is the hot key)
  666.  ───────────────────────────────────────────────────────────────────────────
  667.  
  668. The status line
  669. The status line appears at the bottom of the screen to
  670.  ■ remind you of basic keystrokes and shortcuts (or hot keys) applicable in
  671.    the active window.
  672.  ■ let you use the mouse to click on a command to perform the action instead
  673.    of choosing the action from the menu or pressing the shortcut keystroke.
  674.  
  675.                                                                     Page  18
  676.  
  677. Here is what the status line looks like:
  678.  
  679.  ┌───────────┬───────────────────────────────────────────┬──┐
  680.  │ToolDriver │ F1 Help F2 View F4 Close F5 Zoom F10 Menu │Id│
  681.  └───────────┴───────────────────────────────────────────┴──┘
  682.  
  683. Where Id is the serial number of your registered software.
  684.  
  685. Dialog boxes
  686. A menu command with an ellipsis (...) after it leads to a dialog box. Dialog
  687. boxes offer a convenient way to view and set multiple options. When you're
  688. making settings in dialog boxes, you work with five basic types of onscreen
  689. controls: action buttons, radio buttons, check boxes, input boxes, and list
  690. boxes.
  691.  
  692. Action buttons
  693.  │  OK     │
  694.  
  695.   │  Cancel │
  696.  
  697. Above are two action buttons, OK and Cancel. If you choose OK, the choices
  698. in the dialog box are accepted; if you choose Cancel, nothing changes, no
  699. action takes place, and the dialog box is put away. Choose Help to open a
  700. Help window about this dialog box. Esc is always a keyboard shortcut for
  701. Cancel (even if no Cancel button appears).
  702.  
  703. If you're using a mouse, click the dialog-box button you want. When you're
  704. using the keyboard, press Alt and the highlighted letter of a command to
  705. activate it. For example Alt+C selects the Cancel button because the C in
  706. Cancel is highlighted. Press Tab or Shift+Tab to move forward or back from
  707. one item to another in a dialog box. Each element is highlighted when it
  708. becomes active.
  709.  
  710. In this dialog box, OK is the default button, which means you need only
  711. press Enter to choose the button. (On monochrome systems, arrows indicate
  712. the default; on color monitors default buttons are highlighted.) Be aware
  713. that tabbing to a button makes that button the default.
  714.                                                                     Page  19
  715.  
  716. Radio Buttons and check boxes
  717.  ┌───────────────────────────────────┐
  718.  │ Radio Buttons        Check Boxes  │
  719.  │ ( ) Option 1         ( ) Option A │
  720.  │ ( ) Option 2         (X) Option B │
  721.  │ (■) Option 3         ( ) Option C │
  722.  │                      (X) Option D │
  723.  └───────────────────────────────────┘
  724.  
  725. Radio buttons are like car-radio buttons. They come in groups, and only one
  726. radio button in the group can be on at any one time. To choose a radio
  727. button, click it or its text. From the keyboard, select Alt and the
  728. highlighted letter, or press Tab until the group is highlighted, and then
  729. use the arrow keys to choose a particular radio button. Press Tab or
  730. Shift+Tab again to leave the group with the new radio button chosen. Check
  731. boxes differ from radio buttons in that you can have any number of check
  732. boxes checked at any time.  When you select a check box, an X appears in it
  733. to show you it's on. An empty box indicates it's off. To change the status
  734. of a check box, click it or its text, press Tab until the check box is
  735. highlighted and then press Spacebar, or select Alt plus the highlighted
  736. letter.
  737.  
  738. If several check boxes apply to a topic, they appear as a group. In that
  739. case, tabbing moves to the group. Once the group is selected, use the arrow
  740. keys to select the item you want, and then press Spacebar to check or
  741. uncheck it. On monochrome monitors, the active check box or group of check
  742. boxes will have a chevron symbol (») to the left and right. When you press
  743. Tab, the chevrons move to the next group of check boxes or radio buttons.
  744.  
  745. Input boxes and list boxes
  746. Input boxes let you type in text. Most basic text-editing keys work in the
  747. text box (for example, arrow keys, Home, End, and Ins). If you continue to
  748. type once you reach the end of the box, the contents automatically scroll.
  749. If there's more text than shows in the box, arrowheads appear at the end (
  750. and ). You can click the arrowheads to scroll or drag the text. If you need
  751. to enter control characters (such as ^L or ^M) in the input box, then prefix
  752. the character with a ^P. So, for example, to enter ^M into the input box,
  753. hold down the Ctrl key and press PM. (This capability is useful for search
  754. strings.)
  755.  
  756. If an input box has a down arrow () icon to its right, there is an
  757. associated history list. Click the icon to display the list. You'll find
  758. text you typed the last few times you used the input box. Press Enter to
  759. choose an item from this list. The Find box, for example, has such a history
  760. list, which keeps track of the text you searched for previously. Try
  761. choosing a previous search string. You can also edit an entry in the history
  762. list. Press Esc to exit from the history list without making a selection
  763. or Enter to continue.  
  764.                                                                     Page  20
  765.  
  766. A final component of many dialog boxes is a list box, which lets you scroll
  767. through and select from variable-length lists (often file names) without
  768. leaving a dialog box.
  769.  
  770. You make a list box active by clicking it or by choosing the highlighted
  771. letter of the list title (or press Tab until it's highlighted). Once a list
  772. box is displayed, you can use the scroll box to move through the list or
  773. press the up and down arrows from the keyboard.
  774.  
  775.  
  776. SECTION 4: Menus and options reference
  777.  ──────────────────────────────────────
  778.  
  779. This section provides a reference to each ToolDriver menu option. It's
  780. arranged in the order that the menus appear on the screen. For information
  781. on starting and exiting ToolDriver, and general information on how the user
  782. interface works, see Section 1.
  783.  
  784. Next to some of the menu option descriptions in this reference you'll see
  785. keyboard shortcuts, or hot keys.
  786.  
  787. ≡ (System) menu  Alt+Spacebar
  788. The ≡ menu appears on the far left of the menu bar. Alt+Spacebar is the
  789. fastest way to get there. When you pull down the menu (by using the down
  790. arrow) you see two commands, Register and Product Information.
  791.  
  792. Register
  793. Choose ≡│Register to print information about the advantages of registering
  794. and to print a ToolDriver Registration form. A file print dialog will be
  795. presented, with the file REGISTER.DOC selected. Just press enter to print
  796. the file.
  797.  
  798. Product Information
  799. The ≡│Product Information menu command displays the version of ToolDriver
  800. you are running. The same information displays when you initially bring up
  801. ToolDriver. Put this information away by pressing enter.
  802.  
  803. File menu  Alt+F
  804. The file menu lets you open and view files in a file viewer window. It also
  805. lets you print files, change the working directory, shell to DOS and exit
  806. the ToolDriver environment.  
  807.                                                                     Page  21
  808.  
  809. View F2
  810. The File│View command displays a file-selection dialog box for you to select
  811. a text file to open in a file viewer window. Here is what the box looks
  812. like:
  813.  
  814. Figure 2: View a File dialog box
  815.  
  816.  ╔══[■}═════════════════ View a File ═══════════════════╗
  817.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  818.  ║░░ Name░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  819.  ║░░░ *.*                              ░░░░░ Open  ░░║
  820.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  821.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  822.  ║░░ Files                               ░░░░░░░░░░░░░░░║
  823.  ║░░░ CRE8FSL.EXE       │  FILEXREF.WSL  ░░░░  Cancel ░░║
  824.  ║░░░ FILELIST.EXE      │  FILEXREF.XRF  ░░░░░░░░░░░░░░░║
  825.  ║░░░ FILEXREF.BAK      │  HISTORY.DOC   ░░░░░░░░░░░░░░░║
  826.  ║░░░ FILEXREF.EXE      │  NAMEC.EXE     ░░░░░░░░░░░░░░░║
  827.  ║░░░ FILEXREF.FEI      │  NAMEC.FSL     ░░░░░░░░░░░░░░░║
  828.  ║░░░ FILEXREF.FSL      │  NAMEC.MSG     ░░░░░░░░░░░░░░░║
  829.  ║░░░ FILEXREF.MSG      │  NAMEC.SRL     ░░░░░░░░░░░░░░░║
  830.  ║░░░»FILEXREF.RPT«     │  \WORK         ░░░░░░░░░░░░░░░║
  831.  ║░░░ ■▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓     ░░░░░░░░░░░░░░░║
  832.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  833.  ║░░░C:\TOOLDRIV\*.*                                    ║
  834.  ║░░░FILEXREF.RPT 133153          Sep 01,1992   09:15a  ║
  835.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  836.  ╚══════════════════════════════════════════════════════╝
  837.  
  838. The dialog box contains an input box, a file list, buttons labeled Open and
  839. Cancel, and an information panel that describes the selected file. Now you
  840. can do any of these actions:
  841.  ■ Type in a full file name and choose Open.  Open loads the file into a
  842.    file viewer window.
  843.  
  844.  ■ Type in a file name with wildcards, which filters the file list to match
  845.    your specifications.
  846.  
  847.  ■ Press  to choose a file specification from a history list of file
  848.    specifications you've entered earlier.
  849.  
  850.  ■ View the contents of different directories by selecting a directory name
  851.    in the file list.
  852.  
  853. The input box lets you enter a file name explicitly or enter a file name
  854. with standard DOS wildcards (* and ?) to filter the names appearing in the
  855. history list box. If you enter the entire name and press enter, ToolDriver
  856. opens it for viewing.
  857.  
  858. If you press  when the cursor is blinking in the input box, a history list
  859.                                                                     Page  22
  860.  
  861. drops down below the box. This list displays the last 15 file names or
  862. file name masks you've entered. Choose a name from the list by
  863. double-clicking it or selecting it with the arrow keys and pressing Enter.
  864.  
  865. Once you've typed in or selected the file you want, choose the Open button
  866. (choose Cancel if you change your mind). You can also just press Enter once
  867. the file is selected, or you can double-click the file name in the file
  868. list.
  869.  
  870. The file viewer will view text files up to about 40K in length.
  871.  
  872. Using the file list box
  873. The File list box displays all file names in the current directory that
  874. match the specifications in the input box, displays the parent directory,
  875. and displays all subdirectories. Click the list box or press Tab until the
  876. list box name is highlighted. You can now press  or  to select a filename
  877. and then press Enter to open it. You can also double-click any file name in
  878. the box to open it. You might have to scroll the box to see all the names.
  879. If you have more than one panel of names, you can also use the left and
  880. right arrows.
  881.  
  882. The file information panel at the bottom of the View a File dialog box
  883. displays path name, file name, date, time and size of the file you've
  884. selected in the list box. As you scroll through the list box, the panel is
  885. updated for each file.
  886.  
  887. Print
  888. The File│Print command displays a file-selection dialog box for you to
  889. select a text file to be printed. It looks and functions like the File│View
  890. command except that the output will be routed to your printer instead of a
  891. file viewer.
  892.  
  893. Change Dir
  894. The File│Change Dir command lets you specify a drive and a directory to make
  895. current.  The current directory is the one ToolDriver uses for viewing and
  896. printing files.
  897.  
  898. Here is what the Change Directory dialog box looks like:
  899.                                                                     Page  23
  900.  
  901. Figure 3: Change Directory dialog box
  902.  
  903.  ╔══[■}═══════════════ Change Directory ════════════════╗
  904.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  905.  ║░░ Directory Name ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  906.  ║░░░ C:\TOOLDRIV                      ░░░░░░░░░░░░░░░░║
  907.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  908.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  909.  ║░░ Directory Tree                      ░░░░░░░░░░░░░░░║
  910.  ║░░░ Drives                            ░░░░  OK     ░░║
  911.  ║░░░        C:\                   ▓     ░░░░░░░░░░░░░░░║
  912.  ║░░░        └─TOOLDRIV            ▓     ░░░░  Chdir  ░░║
  913.  ║░░░          └─WORK              ▓     ░░░░░░░░░░░░░░░║
  914.  ║░░░                              ■     ░░░░  Revert ░░║
  915.  ║░░░                              ▓     ░░░░░░░░░░░░░░░║
  916.  ║░░░                              ▓     ░░░░░░░░░░░░░░░║
  917.  ║░░░                                   ░░░░░░░░░░░░░░░║
  918.  ║░░░                                    ░░░░░░░░░░░░░░░║
  919.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  920.  ╚══════════════════════════════════════════════════════╝
  921.  
  922.  
  923. There are two ways to change directories:
  924.  ■ Type in the path of the new directory in the input box and press Enter
  925.  
  926.  ■ Choose the directory you want in the directory tree (if you're using the
  927.    keyboard, press Enter to make it the current directory), then choose OK
  928.    or press Esc.
  929.  
  930. If you choose the OK button, your changes are made and the dialog box is
  931. closed. If you choose the Chdir button, the Directory Tree list box changes
  932. to the selected directory and displays the subdirectories of the currently
  933. highlighted directory (pressing Enter or double-clicking on that entry
  934. gives you the same result). If you change your mind about the directory
  935. you've picked and you want to go back to the previous one (and you've yet to
  936. exit the dialog box), choose the Revert button.
  937.  
  938. Running commands under the FileXref and NameChanger menus automatically
  939. changes the directory to ToolDriver's installation directory where its
  940. program and help files reside.
  941.  
  942. DOS Shell
  943. The File│DOS Shell command lets you temporarily exit ToolDriver to enter a
  944. DOS command or program. To return to ToolDriver, type EXIT and press Enter.
  945.  
  946. Don't install any TSR programs (like SideKick) or print a file with the DOS
  947. print command while you've shelled to DOS, because memory may be
  948. misallocated.
  949.                                                                     Page  24
  950.  
  951. Quit    Alt+Q
  952. The File│Quit command exits ToolDriver and removes it from memory. If you
  953. have made any changes you haven't saved, ToolDriver asks if you want to save
  954. them before exiting.
  955.  
  956. Edit menu     Alt+E
  957. The Edit menu lets you cut, copy, and paste text in edit windows. You can
  958. also open a Clipboard window to view or edit its contents.
  959.  
  960. ToolDriver does not offer a general purpose editor.  An edit window is only
  961. created to support the modification of input files used by the FileXref and
  962. NameChanger utilities.  Edit (and Search) menu commands are disabled
  963. otherwise.
  964.  
  965. A file edit window is presented in four cases:
  966.  ■ after processing the FileXref│Files dialog (This allows you to modify
  967.    the list of files to be cross referenced.)
  968.  
  969.  ■ after choosing the FileXref│Words command (This allows you to modify a
  970.    list of words to be cross referenced.) (You do not need to list the names
  971.    of any files here - they are automatically cross referenced.)
  972.  
  973.  ■ after processing the NameChanger│Files dialog (This allows you to
  974.    modify the list of files to be name-changed.)
  975.  
  976.  ■ after choosing the NameChanger│Names command (This allows you to specify
  977.    the names to be changed and what they are to be changed to.) (Names may
  978.    be file names; variable names; i.e. any complete symbol)
  979.  
  980. Before you can use most of the commands on the edit menu, you need to know
  981. about selecting text (because most editor actions apply to selected text).
  982. Selecting text means highlighting it. You can select text either with
  983. keyboard commands or with a mouse; the principle is the same even though the
  984. actions are different.
  985.  
  986. From the keyboard
  987.  ■ Press Shift while pressing any key that moves the cursor.
  988.  
  989. Using a mouse
  990.  ■ To select text with a mouse, drag the mouse pointer over the desired text
  991.    If you need to continue the selection past a window's edge, just drag off
  992.    the side and the window automatically scrolls.
  993.  
  994.  ■ To select a single word, double-click it.
  995.                                                                     Page  25
  996.  
  997.  ■ To extend or reduce the selection, Shift-click anywhere in the document
  998.    (that is, hold Shift and click). Once you've selected text, the Cut and
  999.    Copy commands in the Edit menu become available.
  1000.  
  1001. The Clipboard is the magic behind cutting and pasting. It's a special window
  1002. that holds text you cut or copied, so you can paste it elsewhere. The
  1003. Clipboard works in close concert with the commands in the Edit menu.
  1004.  
  1005. Here's an explanation of each command in the Edit menu.
  1006.  
  1007. Cut    Shift+Del
  1008. The Edit│Cut command removes the selected text from your document and places
  1009. the text in the Clipboard. You can then paste that text into any other
  1010. document (or somewhere else in the same document) by choosing Paste. The
  1011. text remains selected in the Clipboard so that you can paste the same text
  1012. many times.
  1013.  
  1014. Copy Ctrl+Ins
  1015. The Edit│Copy command leaves the selected text intact but places an exact
  1016. copy of it in the Clipboard. You can then paste that text into any other
  1017. document by choosing Paste.
  1018.  
  1019. Paste   Shift+Ins
  1020. The Edit│Paste command inserts from the Clipboard into the current edit
  1021. window at the cursor position. The text that is pasted is the currently
  1022. marked block in the Clipboard window.
  1023.  
  1024. Show Clipboard
  1025. The Edit│Show Clipboard command opens the Clipboard window, which stores the
  1026. text you cut and copy from other windows. The text that's currently selected
  1027. (highlighted) is the text ToolDriver uses when you choose Paste.
  1028.  
  1029. You can think of the Clipboard window as a history list of your cuts and
  1030. copies. You can edit the Clipboard so that the text you paste is precisely
  1031. the text you want. ToolDriver uses whatever text is selected in the
  1032. Clipboard when you choose Paste.
  1033.  
  1034. The Clipboard window is just like other edit windows; you can move it,
  1035. resize it, and scroll and edit its contents. The only difference you'll find
  1036. in the Clipboard window is when you choose to cut or copy text. When you
  1037. select text in the Clipboard window and choose Cut or Copy, the selected
  1038. text immediately appears at the bottom of the window. (Remember, any text
  1039. you cut or copy is appended to the end of the Clipboard and highlighted - so
  1040. you can paste it later.
  1041.                                                                     Page  26
  1042.  
  1043. Search menu   Alt+S
  1044. The Search menu lets you search and replace text in edit windows.
  1045.  
  1046. Find Ctrl+Q+F
  1047. The Search│Find command displays the Find Text dialog box, which lets you
  1048. type in the text you want to search for and set options that affect the
  1049. search.
  1050.  
  1051. Figure 4: The Find Text dialog box
  1052.  ╔══[■}════════════  Find Text  ════════════════╗
  1053.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1054.  ║░» Text to Find ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1055.  ║░░░aardvark                               ░░░║
  1056.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1057.  ║░░ Options                  ░░░░░░░░░░░░░░░░░░║
  1058.  ║░░░ (X) Case Sensitive      ░░░░░░░░░░░░░░░░░░║
  1059.  ║░░░ ( ) Whole words only    ░░░░░░░░░░░░░░░░░░║
  1060.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1061.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1062.  ║░░░░░░░░░░░░░░░░░░░»  OK  «░░  Cancel  ░░░░░░░║
  1063.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1064.  ╚══════════════════════════════════════════════╝
  1065.  
  1066. The Find Text dialog box contains several buttons and check boxes:
  1067.  
  1068.  ┌────────────────────┐    Check the Case Sensitive box if
  1069.  │ (X) Case sensitive │    you do want ToolDriver to
  1070.  └────────────────────┘    differentiate uppercase from
  1071.                            lowercase.
  1072.  
  1073.  ┌──────────────────────┐  Check the Whole words Only box if
  1074.  │ ( ) Whole words only │  you want ToolDriver to search for
  1075.  └──────────────────────┘  whole words only. (that is, the
  1076.                            string must have punctuation or
  1077.                            space characters on both sides)
  1078.                                                                     Page  27
  1079.  
  1080. Replace Ctrl+Q+A
  1081. Following is the dialog for replacing text.
  1082.  
  1083. Figure 5: The Replace Text dialog box
  1084.  
  1085.  ╔══[■}═════════  Replace Text  ════════════════╗
  1086.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1087.  ║░» Text to Find ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1088.  ║░░░aardvark                               ░░░║
  1089.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1090.  ║░  New text     ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1091.  ║░░░platypus                               ░░░║
  1092.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1093.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1094.  ║░░ Options                  ░░░░░░░░░░░░░░░░░░║
  1095.  ║░░░ (X) Case Sensitive      ░░░░░░░░░░░░░░░░░░║
  1096.  ║░░░ ( ) Whole words only    ░░░░░░░░░░░░░░░░░░║
  1097.  ║░░░ ( ) Prompt on replace   ░░░░░░░░░░░░░░░░░░║
  1098.  ║░░░ ( ) Replace all         ░░░░░░░░░░░░░░░░░░║
  1099.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1100.  ║░░░░░░░░░░░░░░░░░░░»  OK  «░░  Cancel  ░░░░░░░║
  1101.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1102.  ╚══════════════════════════════════════════════╝
  1103.  
  1104. The Replace Text dialog box contains several radio buttons and check boxes -
  1105. many of which are identical to the Find Text dialog box, just discussed.  An
  1106. additional checkbox, Prompt on Replace, controls whether you want to be
  1107. prompted for each change.
  1108.  
  1109. Enter the search string and the replacement string in the input boxes and
  1110. choose OK to begin the search or Cancel to not do it. If you want to enter a
  1111. string you used previously, press  to show a history list to choose from.
  1112.  
  1113. If ToolDriver finds the specified text and Prompt on Replace is on, it asks
  1114. you if you want to make the replacement. If you choose OK, it will find and
  1115. replace the first instance of the search item.
  1116.  
  1117. Search Again  Ctrl+L
  1118. The Search│Search Again command repeats the last Find or Replace command.
  1119. All settings you made in the last dialog box used (Find or Replace) remain
  1120. in effect when you choose Search Again.
  1121.                                                                     Page  28
  1122.  
  1123. FileXref   Alt+X
  1124. The FileXref menu item is the place to go when you want to see how your text
  1125. files relate to one another. It is also where you can find the global usage
  1126. of words (data names, function names, language verbs, etc.) throughout your
  1127. source and documentation files. It may be used with any text file.
  1128.  
  1129. The menu item is named FileXref since it uses the ConVal FILEXREF.EXE
  1130. program to do the cross referencing. This program may also be used
  1131. independently of the ToolDriver environment (see the separate FileXref
  1132. User's Guide in text file FILXRF.DOC).
  1133.  
  1134. There are four supporting options on this menu:
  1135.  ■ Files to cross reference
  1136.  ■ Words to cross reference
  1137.  ■ Start cross referencing
  1138.  ■ View the output log
  1139.  
  1140. Files to cross reference
  1141. Here you identify the files you want to cross reference. You do this by
  1142. creating a list of those file names. The dialog box you use looks like this:
  1143.  
  1144. Figure 6: Files to cross reference
  1145.  
  1146.  ╔══[■}══  Files to be cross referenced ══════════╗
  1147.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1148.  ║░[X]  Generate a file list for me ░░░░░░░░░░░░░░║
  1149.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1150.  ║░     using the directory tree starting with: ░░║
  1151.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1152.  ║░»C:\PROJECT1                             ░░░░░║
  1153.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1154.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1155.  ║░░░░░░░░░░░░░░░░░░░»  OK  «░░  Cancel  ░░░░░░░░░║
  1156.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1157.  ╚════════════════════════════════════════════════╝
  1158.  
  1159.  
  1160. If you check the check box and enter a directory (as above) or drive (like
  1161. C:), then a list will be prepared for you. It will be written to file
  1162. FILEXREF.FSL, the File Specification List. The list will include files in
  1163. the directory entered and in its subdirectories and their subdirectories
  1164. (the directory tree).
  1165.  
  1166. In any case you will be presented with an edit window for this file. The
  1167. contents of the file edit window will be what was just generated if you
  1168. checked the check box, or as most recently edited by you, or it will be as
  1169. delivered on the installation disk.  
  1170.                                                                     Page  29
  1171.  
  1172. Following are representative entries in the file specification list:
  1173. ────────────────────────────────────
  1174. C:\PROJECT1\SOURCE\SAMPLE01.C
  1175. C:\PROJECT1\SOURCE\SAMPLE02.C
  1176. C:\PROJECT1\INCLUDE\MYSAMP.H
  1177. D:\PROJECT1\DOCS\OVERVIEW.DOC
  1178. ────────────────────────────────────
  1179. Start each line in column one and press Enter for each line.
  1180.  
  1181. Press F3 to save your changes or F4 to close the window (this will cause a
  1182. prompt to save).
  1183.  
  1184. NOTE: The editor will handle files to about 64K. This will handle hundreds
  1185. of file names. If your application is larger than this we assume you have an
  1186. editor! Drop out of ToolDriver, edit the list with that editor, and return
  1187. to ToolDriver to do the cross referencing.
  1188.  
  1189. Words to cross reference
  1190. ToolDriver, as installed, provides a starter file of words to cross
  1191. reference. This file is named FILEXREF.WSL (Word Specification List). When
  1192. you first select this option you will see the starter list. It contains
  1193. entries like
  1194. ─────────────────────────
  1195.   I  re*
  1196.   X  return
  1197.   X  break
  1198. ─────────────────────────
  1199. The I/X means to Include or eXclude the word or word prefix.  The entry "I
  1200. re*" asks that words starting with the characters re be included in the word
  1201. usage report. The entry "X return" says to exclude the word "return". (The
  1202. starter list excludes the C keywords. The last entry shown is not required
  1203. (break does not start with "re"). However, it is not considered an error.
  1204. This allows you to keep a list of words to be excluded (like language
  1205. keywords) regardless of the words you are currently including.
  1206.  
  1207. Start cross referencing
  1208. Once you've set up the list of files to be examined and (optionally) the
  1209. words to search for, select this menu item to initiate cross referencing.
  1210.                                                                     Page  30
  1211.  
  1212. This is what the associated dialog looks like:
  1213.  
  1214. Figure 7: The Cross reference files dialog
  1215.  
  1216.  ╔══[■}═════ Cross reference files (and words) ═══════════╗
  1217.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1218.  ║ Type of output         ░ Optional output            ░░░║
  1219.  ║░ (■) Condensed reports ░░ [ ] Cross reference words ░░░║
  1220.  ║░ ( ) Extended reports  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1221.  ║░ ( ) Export file       ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1222.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1223.  ║░░░░░░░░░░░░░░░░░░ »  OK  « ░░ Cancel ░░░░░░░░░░░░░░░░░░║
  1224.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1225.  ╚════════════════════════════════════════════════════════╝
  1226.  
  1227. Three types of output are available. The condensed report format displays
  1228. file names only, without the path or file extension. It packs the most
  1229. information in the smallest number of pages. The extended report format
  1230. displays the full file specification (drive, path, file name and extension).
  1231. Export file format provides a means for you to take the cross reference
  1232. information and use it with other software (e.g. a database program).
  1233.  
  1234. If you click on the optional output of Cross reference words, then the words
  1235. you picked for inclusion and exclusion will be used and a Word Usage Report
  1236. will be produced.  Otherwise the list of words will be ignored.
  1237.  
  1238. Use File│Print to print file FILEXREF.RPT, the report file. Note: The
  1239. reports require 132 print positions.
  1240.  
  1241. When you select condensed reports, the following reports
  1242.  
  1243.  ■ Condensed File Cross Reference Report,
  1244.  ■ Condensed Word Usage Report, and
  1245.  ■ List of Unreferenced Files
  1246.  
  1247. will be written to file FILEXREF.RPT.
  1248.  
  1249. Choosing extended reports will cause these reports
  1250.  ■ Extended File Cross Reference Report,
  1251.  ■ Extended Word Usage Report, and
  1252.  ■ List of Unreferenced Files
  1253.  
  1254. to be written to file FILEXREF.RPT.
  1255.  
  1256. Picking export files will create two text data files:
  1257.  ■ cross reference data on file FILEXREF.XRF, and
  1258.  ■ unused file data on file FILEXREF.FEI   
  1259.                                                                     Page  31
  1260.  
  1261. Condensed Reports
  1262. The condensed style of reports identify files by their filename alone,
  1263. without the drive, path, or file extension. Figure 8 shows a condensed file
  1264. cross reference report (showing less columns to the left and right for
  1265. reasons of space in this manual).  The center column lists every file
  1266. examined, sorted by file name. To the left are the files that reference it
  1267. and to the right are those that it references.
  1268.  
  1269.  
  1270. Figure 8: Condensed File Cross Reference Report
  1271. ────────────────────────────────────────────────────────────────────────────
  1272.  09/19/92  FileXref     CONDENSED FILE CROSS REFERENCE REPORT      Page   1
  1273.  
  1274.  
  1275.  LIST OF REFERENCING FILES      FILENAME    LIST OF REFERENCED FILES
  1276.  ----------------------------   ========    -------------------------------
  1277.                               - FILEXRF  -
  1278.            PACKLIST  TOOLDRIV - HISTORY  -
  1279.                               - NAMECHNG -  README
  1280.                               - PACKLIST -  HISTORY   README    REGISTER
  1281.                                             TOOLDRIV
  1282.  NAMECHNG  PACKLIST  TOOLDRIV - README   -
  1283.            PACKLIST  TOOLDRIV - REGISTER -
  1284.                      PACKLIST - TOOLDRIV -  HISTORY   README    REGISTER
  1285.  
  1286.   *** END OF REPORT
  1287. ────────────────────────────────────────────────────────────────────────────
  1288.  
  1289. In Figure 9 you see the optional condensed word usage report. This shows
  1290. each word (and word prefix) requested, and the files that reference them.
  1291.  
  1292. Figure 9: Condensed Word Usage Report
  1293.  
  1294. ────────────────────────────────────────────────────────────────────────────
  1295.  09/19/92 05:33:38 FileXref  CONDENSED WORD USAGE REPORT             Page 1
  1296.  
  1297.  WORD                            IS REFERENCED BY FILENAME(S):
  1298.  ------------------------------  -------------------------------------------
  1299.  However                         FILEXRF
  1300.  Hungarian                       NAMECHNG
  1301.  I                               FILEXRF  HISTORY  NAMECHNG README  REGISTER
  1302.                                  TOOLDRIV
  1303.  IBM                             NAMECHNG TOOLDRIV
  1304.  IBM-compatible                  TOOLDRIV
  1305.  IBMPRO                          HISTORY
  1306.  ID                              NAMECHNG
  1307.  IDE                             TOOLDRIV
  1308.  IMS                             NAMECHNG
  1309.  INCLUDE                         FILEXRF  NAMECHNG TOOLDRIV
  1310.  
  1311.   *** END OF REPORT
  1312. ────────────────────────────────────────────────────────────────────────────
  1313.      
  1314.                                                                     Page  32
  1315.  
  1316. In figure 10 we see a list of files that were referenced by no other files.
  1317. So this list will contain top level components (and old obsolete components)
  1318. of the application.
  1319.  
  1320. Figure 10: List of Unreferenced Files
  1321.  
  1322. ────────────────────────────────────────────────────────────────────────────
  1323.  09/19/92  05:33:39  FileXref         LIST OF UNREFERENCED FILES     Page  1
  1324.  
  1325.  
  1326.               FILENAME  TYPE    PATH
  1327.               --------  ---    -------------------------
  1328.               FILEXRF   DOC     C:\TOOLDRIV\
  1329.               NAMECHNG  DOC     C:\TOOLDRIV\
  1330.               PACKLIST  DOC     C:\TOOLDRIV\
  1331.  
  1332.   *** END OF REPORT
  1333. ────────────────────────────────────────────────────────────────────────────
  1334.  
  1335. Extended Reports
  1336. The extended report style identifies files with their full file
  1337. specification. If your filenames alone are not unique, then this report
  1338. style may be more useful to you.
  1339.  
  1340.  
  1341. Figure 11: Extended File Cross Reference Report
  1342.  
  1343. ────────────────────────────────────────────────────────────────────────────
  1344.  09/19/92  05:37:40    EXTENDED FILE CROSS REFERENCE REPORT         Page   1
  1345.  
  1346.  
  1347.  FILE SPECIFICATION - REFERS TO: FILE SPECIFICATION   - REFERS TO:  FILENAME
  1348.  --------------------------      ---------------------------------  --------
  1349.                                - C:\TOOLDRIV\FILEXRF.DOC         -
  1350.  C:\TOOLDRIV\PACKLIST.DOC      - C:\TOOLDRIV\HISTORY.DOC         -
  1351.  C:\TOOLDRIV\TOOLDRIV.DOC      -                                 -
  1352.                                - C:\TOOLDRIV\NAMECHNG.DOC        -  README
  1353.                                - C:\TOOLDRIV\PACKLIST.DOC        -  HISTORY
  1354.                                -                                 -  README
  1355.                                -                                 -  REGISTER
  1356.                                -                                 -  TOOLDRIV
  1357.  C:\TOOLDRIV\NAMECHNG.DOC      - C:\TOOLDRIV\README.DOC          -
  1358.  C:\TOOLDRIV\PACKLIST.DOC      -                                 -
  1359.  C:\TOOLDRIV\TOOLDRIV.DOC      -                                 -
  1360.  C:\TOOLDRIV\PACKLIST.DOC      - C:\TOOLDRIV\REGISTER.DOC        -
  1361.  C:\TOOLDRIV\TOOLDRIV.DOC      -                                 -
  1362.  C:\TOOLDRIV\PACKLIST.DOC      - C:\TOOLDRIV\TOOLDRIV.DOC        -  HISTORY
  1363.                                -                                 -  README
  1364.                                -                                 -  REGISTER
  1365.  *** END OF REPORT
  1366. ────────────────────────────────────────────────────────────────────────────
  1367.  
  1368.                                                                     Page  33
  1369.  
  1370. Figure 12: Extended Word Usage Report
  1371.  
  1372. ────────────────────────────────────────────────────────────────────────────
  1373.  09/19/92 05:33:38 FileXref  EXTENDED WORD USAGE REPORT     Page 1
  1374.  
  1375.  WORD                   IS REFERENCED BY FILENAME(S):
  1376.  --------------------   ------------------------------------------
  1377.  However                C:\TOOLDRIV\FILEXRF.DOC
  1378.  Hungarian              C:\TOOLDRIV\NAMECHNG.DOC
  1379.  I                      C:\TOOLDRIV\FILEXRF.DOC
  1380.                         C:\TOOLDRIV\HISTORY.DOC
  1381.                         C:\TOOLDRIV\NAMECHNG.DOC
  1382.                         C:\TOOLDRIV\README.DOC
  1383.                         C:\TOOLDRIV\REGISTER.DOC
  1384.                         C:\TOOLDRIV\TOOLDRIV.DOC
  1385.  IBM                    C:\TOOLDRIV\NAMECHNG.DOC
  1386.  ---------------------  ------------------------------------------
  1387.  
  1388.  *** END OF REPORT
  1389. ────────────────────────────────────────────────────────────────────────────
  1390.  
  1391. Export files
  1392. The quote and comma delimited export files are provided so you can import
  1393. them into your software. You can then further process the data and/or
  1394. produce custom reports of your own design.
  1395.  
  1396. File FILEXREF.XRF is the name of the text file where the cross reference
  1397. export data is written.  It contains a symbol in the first column. The
  1398. second column contains the referencing file's file specification. The last
  1399. column has six flags. Their meaning is shown in the table following.
  1400.  
  1401. Table 7: Export file flags
  1402.  
  1403.  ────────────────────────────────────────────────────-
  1404.  123456
  1405.  ─────-
  1406.       The symbol in the first column is:
  1407.  1.....     a filename.
  1408.  .1....     a whole word.
  1409.  ..1...     a word prefix.
  1410.  ...1..     an expansion of a word prefix.
  1411.  ....1. The symbol was referenced.
  1412.  .....1 The symbol was marked for inclusion.
  1413.  ────────────────────────────────────────────────────-
  1414.  
  1415. Figure 13 shows typical data in the cross reference export data file.  The
  1416. first row shows that the symbol "HISTORY" was referenced by a file named
  1417. PACKLIST.DOC. The flags for this symbol tell that the symbol HISTORY is the
  1418. name of a file, that it was referenced (every entry in this file will be so
  1419. marked), and that it was marked for inclusion. (All file names are
  1420. automatically marked for inclusion by default. 
  1421.                                                                     Page  34
  1422.  
  1423. Figure 13: Cross reference export data
  1424.  
  1425.  ─────────────────────────────────────────────────────-
  1426.  "HISTORY","C:\TOOLDRIV\PACKLIST.DOC","100011"
  1427.  "HISTORY","C:\TOOLDRIV\TOOLDRIV.DOC","100011"
  1428.  "README","C:\TOOLDRIV\NAMECHNG.DOC","100011"
  1429.  "README","C:\TOOLDRIV\PACKLIST.DOC","100011"
  1430.  "README","C:\TOOLDRIV\TOOLDRIV.DOC","100011"
  1431.  "REGISTER","C:\TOOLDRIV\PACKLIST.DOC","100011"
  1432.  "REGISTER","C:\TOOLDRIV\TOOLDRIV.DOC","100011"
  1433.  "TOOLDRIV","C:\TOOLDRIV\PACKLIST.DOC","100011"
  1434.  "re*","C:\TOOLDRIV\FILEXRF.DOC","001101"
  1435.  "re*","C:\TOOLDRIV\HISTORY.DOC","001101"
  1436.  "re*","C:\TOOLDRIV\NAMECHNG.DOC","001101"
  1437.  "re*","C:\TOOLDRIV\README.DOC","001101"
  1438.  "re*","C:\TOOLDRIV\REGISTER.DOC","001101"
  1439.  "re*","C:\TOOLDRIV\TOOLDRIV.DOC","001101"
  1440.  "reach","C:\TOOLDRIV\TOOLDRIV.DOC","000101"
  1441.  "read","C:\TOOLDRIV\FILEXRF.DOC","000101"
  1442.  "read","C:\TOOLDRIV\NAMECHNG.DOC","000101"
  1443.  ─────────────────────────────────────────────────────-
  1444.  
  1445. Figure 14 shows the export data for unreferenced files. This data is stored
  1446. in text file FILEXREF.FEI (for file end items).  None of these files was
  1447. referenced by any other file examined.
  1448.  
  1449. Figure 14: Unreferenced files export data
  1450.  
  1451.  ───────────────────────────────────────────-
  1452.  "C:\TOOLDRIV\FILEXRF.DOC","100001"
  1453.  "C:\TOOLDRIV\NAMECHNG.DOC","100001"
  1454.  "C:\TOOLDRIV\PACKLIST.DOC","100001"
  1455.  ───────────────────────────────────────────-
  1456.  
  1457. View the output log
  1458. This command gives you a file viewer window to browse the messages about the
  1459. cross referencing. These document the scope of the run, listing the files
  1460. and words specified, the options, and record counts. You can use File│Print
  1461. to get a hardcopy of this output log to file with the reports.  The name of
  1462. the log file is FILEXREF.MSG.
  1463.  
  1464. NameChanger menu Alt+N
  1465. Use the NameChanger menu whenever you want to go back and make your naming
  1466. conventions consistent across your application(s). You might decide to do
  1467. this after each revision level is complete to keep order. And, now that you
  1468. have such a tool, you may want to go back to some older code you're still
  1469. maintaining and clean it up, too.
  1470.  
  1471. You will also want to use the NameChanger menu when you have a successful
  1472. product on one platform and want to port it to another. Download the non-DOS
  1473. product to your PC, do the renaming, and recompile on DOS. Or, do renaming,
  1474. upload to a non-DOS platform and recompile there.  This works very well for
  1475. Oracle code where the names may be the ONLY portability issue.
  1476.  
  1477. This command invokes a DOS program - NAMEC.EXE. For information on using
  1478. this directly from a DOS command line, see the separate NameChanger User's
  1479. Guide in the text file NAMECHNG.DOC.
  1480.                                                                     Page  35
  1481.  
  1482. Files to process
  1483. This is where you identify the files to be processed by NameChanger. The
  1484. dialog box you use looks like this:
  1485.  
  1486. Figure 15: NameChanger Files dialog
  1487.  
  1488.  ╔══[■}══  Files with names to be changed ════════╗
  1489.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1490.  ║░[X]  Generate a file list for me ░░░░░░░░░░░░░░║
  1491.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1492.  ║░     using the directory:  ░░░░░░░░░░░░░░░░░░░░║
  1493.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1494.  ║░»C:\PROJECT1                             ░░░░░║
  1495.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1496.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1497.  ║░░░░░░░░░░░░░░░░░░░»  OK  «░░  Cancel  ░░░░░░░░░║
  1498.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1499.  ╚════════════════════════════════════════════════╝
  1500.  
  1501. If you check the check box and enter a directory (as above) or drive (like
  1502. C:), then a list will be prepared for you. It will be written to file
  1503. NAMEC.FSL (File Specification List). The list will include only those files
  1504. in the directory entered.
  1505.  
  1506. In any case you will be presented with an edit window for this file. So the
  1507. content of the file edit window will be what was just generated if you
  1508. checked the check box, or it will be as most recently edited by you, or as
  1509. delivered on the installation disk.
  1510.  
  1511. Typical lines in this file (NAMEC.FSL) look like:
  1512. ──────────────────────────────────────
  1513. V    255   C:\PROJECT1\TST01.CPP
  1514. V    255   C:\PROJECT1\TST02.CPP
  1515. V    255   C:\PROJECT1\TST03.CPP
  1516. F     80   C:\PROJECT2\REPORT01.COB
  1517. F     80   C:\PROJECT2\REPORT02.COB
  1518. ──────────────────────────────────────
  1519. Each line defines one file and contains three columns.  The first column
  1520. defines whether all the lines in the file have to be the same length (F for
  1521. fixed length), or variable length (V).  The second column is the maximum
  1522. length for an output record (or actual in the case of fixed length file
  1523. lines). The last column contains the file specification.
  1524.  
  1525. The line format code ( F or V) must begin in the first column of the line.
  1526. One or more spaces separate the columns. Press Enter after each line.
  1527.  
  1528. Press F3 to save your changes or F4 to close the window (this will cause a
  1529. prompt to save).
  1530.  
  1531. NOTE: The editor will handle files up to about 64K. This will handle
  1532. hundreds of file names.  If your application is larger than this we trust
  1533. that you have an editor! Drop out of ToolDriver, edit the list with that
  1534. editor, and return to ToolDriver to change names.
  1535.                                                                     Page  36
  1536.  
  1537. Names to be changed
  1538. This is where you define the names you want to be changed. A file editor
  1539. window will be displayed so you can add one line for each name change. To
  1540. change "cat", "Cat", and "CAT" to "Dog", type
  1541.  
  1542. I    cat      Dog
  1543.  
  1544. That's all there is to it - The letter "I" tells the program to be
  1545. Insensitive to case.  Type one or more spaces after the case sensitivity
  1546. code, start typing the old word, type one or more spaces, type the new word
  1547. exactly as it is to appear, then press Enter.
  1548.  
  1549. To change "Alpha" to "Beta" , while leaving "ALPHA" (and "AlPhA") unchanged,
  1550. the entry should look like this:
  1551.  
  1552. S Alpha Beta
  1553.  
  1554. This change will be Sensitive to the case of the old name. It will not alter
  1555. the word Alpha unless the case of each letter matches exactly.
  1556.  
  1557. The case sensitivity code (I or S) must start in the first column of each
  1558. line.  When you've entered all the names to be changed, press F3 to save the
  1559. file, and then F4 to close the file editor window. It will be saved as
  1560. filename NAMEC.SRL (Symbol Rename List).
  1561.  
  1562. Start name changing
  1563. After you've defined the files and names to be changed, select the "Start
  1564. name changing" dialog.  It looks like this:
  1565.  
  1566. Figure 16: The Change names dialog
  1567.  
  1568.  ╔══[■}═══════════════ Change names ══════════════════════╗
  1569.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1570.  ║ NOTE: Output files will be written to this  ░░░░░░░░░░░║
  1571.  ║░      directory:                            ░░░░░░░░░░░║
  1572.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1573.  ║░ C:\TOOLDRIV\WORK ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1574.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1575.  ║░░░[ ] Delete prior output░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1576.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1577.  ║░░░░░░░░░░░░░░░░░░ »  OK  « ░░ Cancel ░░░░░░░░░░░░░░░░░░║
  1578.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1579.  ╚════════════════════════════════════════════════════════╝
  1580.  
  1581. Whenever you do name changing, the output files will be written to
  1582. ToolDriver's subdirectory named WORK. This is the WORK directory's only
  1583. purpose. Your files will never be rewritten in place! If you are rerunning a
  1584. name changing task, no work will be performed if any output file already
  1585.                                                                     Page  37
  1586.  
  1587. exists on the ToolDriver WORK subdirectory. To delete ALL files in the
  1588. ToolDriver WORK directory, check the checkbox. As a final precaution, you
  1589. will be asked to confirm the deletion, when the process starts. This is a
  1590. reminder for you to move prior output to a permanent home in another
  1591. directory before renaming other projects. When the changing of names is
  1592. complete, you will be presented with a file viewer window to browse a log of
  1593. the renaming activity. This name of this text file is NAMEC.MSG.  This log
  1594. will identify those files that were not changed at all (those that contained
  1595. none of the names being changed).  It also identifies, by line number, those
  1596. cases where lines needed to be split due to excessive length after renaming.
  1597.  
  1598. To test NameChanger, have it make an exact copy of some of your files. Do
  1599. this by setting the symbol rename list up with one line containing a word
  1600. that doesn't exist in your files, say
  1601.    S  aAbBcC   AABBCC
  1602. Start NameChanger, then use the DOS COMP command to do a character-by-
  1603. character compare.
  1604.  
  1605. NOTE: Trailing blanks in lines are not copied so it's possible for the
  1606. messages to indicate that no words were changed, and still have file
  1607. sizes be different.
  1608.  
  1609. View the output files
  1610. Select this option to inspect the results of your name changing. The
  1611. following dialog lets you select a file on the ToolDriver working directory
  1612. (where NameChanger places its output).
  1613.  
  1614.  
  1615. Figure 17: View the name-changed files dialog box
  1616.  
  1617.  ╔══[■}═════════════════ View a File ═══════════════════╗
  1618.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1619.  ║░░ Name░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1620.  ║░░░ *.*                              ░░░░░ Open  ░░║
  1621.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1622.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1623.  ║░░ Files                               ░░░░░░░░░░░░░░░║
  1624.  ║░░░ FILEXREF.RPT      │  TST01.C       ░░░░  Cancel ░░║
  1625.  ║░░░ FILEXREF.DOC      │  TST02.CPP     ░░░░░░░░░░░░░░░║
  1626.  ║░░░ HISTORY.DOC       │  TST03.H       ░░░░░░░░░░░░░░░║
  1627.  ║░░░ NAMECHNG.DOC      │  TST04.PAS     ░░░░░░░░░░░░░░░║
  1628.  ║░░░ PACKLIST.DOC      │  ..\           ░░░░░░░░░░░░░░░║
  1629.  ║░░░ REGISTER.DOC      │                ░░░░░░░░░░░░░░░║
  1630.  ║░░░ TOOLDRIV.DOC      │                ░░░░░░░░░░░░░░░║
  1631.  ║░░░ ■▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓     ░░░░░░░░░░░░░░░║
  1632.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1633.  ║░░░C:\TOOLDRIV\WORK\*.*                               ║
  1634.  ║░░░FILEXREF.RPT 88722           Sep 18,1992   08:25a  ║
  1635.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1636.  ╚══════════════════════════════════════════════════════╝
  1637.  
  1638.                                                                     Page  38
  1639.  
  1640. See the "View a file" dialog description on page 21 for a review of using
  1641. this dialog.
  1642.  
  1643. Window menu   Alt+W
  1644. The Window menu contains window-management commands. Most of the windows you
  1645. open from this menu have all the standard window elements like scroll bars,
  1646. a close box, and zoom boxes. Refer to page 15 for information on these
  1647. elements and how to use them.
  1648. Size/Move  Ctrl+F5
  1649. Choose Window│Size/Move to change the size or position of the active window.
  1650.  
  1651. When you choose this command, the active window moves in response to the
  1652. arrow keys. When the window is where you want, press Enter. You can also
  1653. move a window by dragging its title bar.
  1654.  
  1655. If you press shift while you use the arrow keys, you can change the size of
  1656. the window. When it's the size you want, press enter. If a window has a
  1657. resize corner, you can drag that corner or any other corner to resize it.
  1658.  
  1659.  
  1660. Zoom F5
  1661. Choose Window│Zoom to resize the active window to the maximum size. If the
  1662. window is already zoomed, you can choose this command again to restore it to
  1663. its previous size. You can also double-click anywhere on the top line
  1664. (except where an icon appears) of a window to zoom or unzoom it.
  1665.  
  1666. Tile
  1667. Choose Window│Tile to arrange all your open windows like tiles on the
  1668. screen.
  1669.  
  1670. Cascade
  1671. Choose Window│Cascade to stack all open windows so the top of each (with its
  1672. window number) shows.
  1673.  
  1674.  
  1675. Next F6
  1676. Choose Window│Next to make the next window active and visible.
  1677.  
  1678. Previous   Shift+F6
  1679. Choose Window│Previous to make the prior window active and visible.
  1680.  
  1681. Close   F4
  1682. To close the current window, press F4.
  1683.  
  1684.                                                                     Page  39
  1685.  
  1686. Help menu  Alt+H
  1687. The help menu gives you access to online help in a special window. There is
  1688. help information on virtually all aspects of the ToolDriver environment. To
  1689. open a Help window, do one of these actions:
  1690.  ■ Press F1 at any time (including from any dialog box or when any menu
  1691.    command is selected).
  1692.  
  1693.  ■ Click Help on the status line.
  1694.  
  1695. To close the Help window, press Esc, click the close box, or choose
  1696. Window│Close.
  1697.  
  1698. Help screens often contain keywords (highlighted text) that you can choose
  1699. to get more information. Press Tab to move to any keyword; press Enter to
  1700. get more detailed help. (As an alternative, move the cursor to the
  1701. highlighted keyword and press Enter.) With a mouse, you can double-click any
  1702. keyword to open the Help text for that item.
  1703.  
  1704. When you're in a detailed help screen (you got there from another help
  1705. screen by selecting a keyword) and you want to go back to the previous help,
  1706. press Alt+F1. By doing this repeatedly you can back-track to the original
  1707. help screen where you selected the first keyword.
  1708.  
  1709. Contents
  1710. The Help│Contents command opens the Help window with the main table of
  1711. contents displayed.  From this window, you can branch to other parts of
  1712. the help system.
  1713.  
  1714. Index
  1715. The Help│Index command displays a full list of Help keywords (the special
  1716. highlighted text in Help screens that let you quickly move to a related
  1717. screen). These are arranged in alphabetical order.
  1718.  
  1719. Double-click or Tab to the item you want and press Enter, or Tab to the
  1720. "next page" keyword and press Enter to see the next page of keywords. Hold
  1721. down Shift and press Tab to move the cursor to a prior entry on the same
  1722. page.
  1723.  
  1724. Use Alt+F1 to get back to the previous help screen.
  1725.  
  1726.                                                                     Page  40
  1727.  
  1728. INDEX
  1729.  ──────────────────────────────────────
  1730.  
  1731.  File
  1732.      export, file cross reference . . . . . . . . . . . . . . . . . . .  33
  1733.      export, selecting. . . . . . . . . . . . . . . . . . . . . . . . .  30
  1734.      export, unreferenced files . . . . . . . . . . . . . . . . . . . .  34
  1735.      list, for cross referencing. . . . . . . . . . . . . . . . . . . .  28
  1736.      list, for name changing. . . . . . . . . . . . . . . . . . . . . .  35
  1737.  FILEXREF.EXE
  1738.      the cross reference tool . . . . . . . . . . . . . . . . . . . . .  28
  1739.  FILEXREF.FEI
  1740.      the unreferenced files export file . . . . . . . . . . . . . . . .  34
  1741.  FILEXREF.FSL
  1742.      the file specification list for FileXref . . . . . . . . . . . . .  28
  1743.  FILEXREF.MSG
  1744.      the cross reference activity log . . . . . . . . . . . . . . . . .  34
  1745.  FILEXREF.RPT
  1746.      the cross reference report file. . . . . . . . . . . . . . . . . .  30
  1747.  FILEXREF.WSL
  1748.      file of words to be cross referenced . . . . . . . . . . . . . . .  29
  1749.  FILEXREF.XRF
  1750.      the cross reference export file. . . . . . . . . . . . . . . . . .  33
  1751.  Hot keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  1752.  Log
  1753.      of cross referencing . . . . . . . . . . . . . . . . . . . . . . .  34
  1754.      of name changing activity. . . . . . . . . . . . . . . . . . . . .  37
  1755.  NAMEC.EXE
  1756.      the name-changing tool . . . . . . . . . . . . . . . . . . . . . .  34
  1757.  NAMEC.FSL
  1758.      file of file names to be name-changed. . . . . . . . . . . . . . .  35
  1759.  NAMEC.MSG
  1760.      file containing a log of the renaming process  . . . . . . . . . .  37
  1761.                                                                     Page  41
  1762.  
  1763.  NAMEC.SRL
  1764.      file of symbol renaming rules  . . . . . . . . . . . . . . . . . .  36
  1765.  report
  1766.      condensed file cross reference, sample. . . . . . . . . . . . . .   31
  1767.      condensed word usage, sample. . . . . . . . . . . . . . . . . . .   31
  1768.      creating . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  30
  1769.      extended file cross reference, sample. . . . . . . . . . . . . . .  32
  1770.      extended word usage, sample. . . . . . . . . . . . . . . . . . . .  33
  1771.      list of unreferenced files, sample . . . . . . . . . . . . . . . .  32
  1772.      printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  30
  1773.      selecting the type of. . . . . . . . . . . . . . . . . . . . . . .  30
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780. ───────────────────────────────────────
  1781.   End of User Guide for ToolDriver
  1782. ───────────────────────────────────────
  1783.  
  1784.  
  1785.  
  1786.