home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / tools / tooldrv / td.hlp (.txt) < prev    next >
Borland Turbo Vision Help  |  1992-09-30  |  150KB  |  2,329 lines
  1. THelpTopic
  2.  Quick Start 
  3. Welcome to ToolDriver, a window environment for organizing files and names using the ConVal FileXref and NameChanger text-mode utilities. M
  4. To put this help window away, press ESC. Then, to exit to DOS, press Alt-Q. ^
  5. For more information on any highlighted topic, Tab to the highlighted field and press Enter: ,
  6.  using
  7. windows
  8.  using
  9. non-help
  10. windows
  11.  registering
  12. ToolDriver
  13. THelpTopic
  14.  Help Window Navigation 
  15. When viewing a help window, non-help keys are disabled. Press Esc when you're finished reading the help information. Now those keys will be active again. 
  16. Since non-help keys are disabled you may not use the menu bar. See zoom or size/move for a instructions on how to zoom, resize or move a help window without the menu bar. 
  17. In many help windows there are items highlighted (like above).  To see more information on a highlighted topic, Tab to it and press Enter or double click on it. l
  18. When you have tabbed too far, use Shift-Tab to back tab or continue tabbing until you can select it again. Y
  19. If you are viewing a help window and want to go back to the previous one, press Alt-F1. 
  20. THelpTopic
  21.  Non-Help Window Navigation 
  22. If you are viewing a help window, press Esc to exit help before trying to use the following non-help functions. k
  23. The menu bar is accessed by pressing F10 and then using the arrows, or by double clicking on a menu item. .
  24. To see product information, press Alt-Space. |
  25. All the other menu items may be quickly accessed by pressing Alt-Z, where Z is one of the highlighted letters on the menu. 7
  26. For example, the "File" menu is pulled down by Alt-F. 
  27. THelpTopic
  28.  File viewer 
  29. A file viewer views the contents of a text file. You can use the arrow keys to move about in the file. A file is loaded via the File
  30. Open menu item. a
  31.   Up         Move up one line
  32.   Down       Move down one line
  33.   Right      Move right one column
  34.   Left       Move left one column
  35.   PgUp       Move one page up
  36.   PgDn       Move one page down
  37.   Home       View right most column of the file
  38.   End        View left most column of the file
  39.   Ctrl-PgUp  View top of file
  40.   Ctrl-PgDn  View bottom of file.
  41. File viewers can be resized and moved using the Window menu. A
  42. The file viewer will view text files up to about 40K in length. 
  43. THelpTopic
  44.  File Types 
  45. The ConVal tools know how to examine the following types of files: <
  46.  Assembler     .ASM    make files       .MAK
  47.  BASIC         .BAS    ORACLE .INP .RPT .SQL
  48.  batch files   .BAT    Pascal           .PAS
  49.  C and   .C    .H      PL/I             .PLI
  50.    C++   .CPP  .HPP    REXX             .REX
  51.  COBOL   .CBL  .COB    text files  .TXT .DOC
  52.  FORTRAN       .FOR    xBase            .PRG
  53. Any other ASCII text files (e.g. documentation) may also be examined. 
  54. THelpTopic
  55.  Problems to be solved 
  56.        more
  57. FileXref addresses the following: S
  58. "Some of these source and documentation files are now obsolete - but which ones?" |
  59. "Before changing this I need to know everything impacted - even the documentation files, batch files, and test scenarios." R
  60. "If I just had a report to show me how all these files relate to one another..." 
  61. THelpTopic
  62.  Problems to be solved 
  63. NameChanger addresses the following problems: g
  64. "I want to change my old programs to use my current naming style. But if I make just one mistake ..." 
  65. "My software is selling well on the DOS platform. Now I want to port it to UNIX, VAX, MVS, etc. But my file names and external variables are all wrong." 
  66. "My application is so well liked in my company another group wants to use it on a different machine. But my names collide with their existing systems there." (CICS, IMS) 
  67. THelpTopic
  68.  Input 
  69. FileXref and NameChanger scan the various types of source files that make up your application. Your files can reside on a single subdirectory of a single disk or diskette or they can be in many subdirectories across several hard disks. 9
  70. FileXref has menu options for you to define its inputs: G
  71.  files
  72. examined, and the optional
  73.  words
  74. cross
  75. referenced.
  76. NameChanger also has two menu items for inputs: 5
  77.  files
  78. changed, and
  79.  names
  80. changed.
  81. THelpTopic
  82.  Output 
  83. FileXref produces cross
  84. reference
  85. reports or export
  86. files. It also creates a log of the processing done. 
  87. NameChanger produces output
  88. files, one for each file selected. It, too, creates a log of the processing done.  The output files are written to ToolDriver's WORK directory. 
  89. THelpTopic
  90.  (System) menu 
  91.     (Alt-Spacebar)
  92. The System menu appears on the far left of the menu bar and is represented by the 
  93.  symbol. (
  94. When you pull down the 
  95.  menu, you see "
  96.   Register
  97.   Product
  98. Information
  99. THelpTopic
  100. Product Information 
  101. When you choose the product information command, a help box appears, showing copyright and version data. G
  102. To close the box, press Esc, Space, or Enter, or click the OK button. 
  103. THelpTopic
  104.  File
  105. Open  (F3) 
  106. The Open command displays the Open a File dialog box. In this dialog box you select the text file you want to browse with a file
  107. viewer. &
  108. The Open
  109. File dialog box contains: 
  110.  an input
  111. box with a history list
  112.  a list
  113. box to browse the directory
  114.  the standard Cancel button
  115.  Open action button
  116.  an information panel that describes the
  117.    selected file
  118. THelpTopic
  119.  Name 
  120.                                  
  121. The Name input box is where you enter the name of the file to load, or the file-name mask to use as a filter for the Files list box (for example, *.*). 
  122. THelpTopic
  123.  Files 
  124.                                  
  125.   FILENM01.PAS  
  126.   FILENM09.PAS  
  127.   FILENM02.PAS  
  128.   FILENM10.PAS  
  129.   FILENM03.PAS  
  130.   FILENM11.PAS  
  131.   FILENM04.PAS  
  132.   FILENM12.PAS  
  133.   FILENM05.PAS  
  134.   ..            
  135.   FILENM06.PAS  
  136.   \MOREXAMP     
  137.   FILENM07.PAS  
  138.   \TOURS        
  139.   FILENM08.PAS  
  140.   \ANSWERS.DIR  
  141. The Files list box lists the names of files in the current directory that match the file-name mask in the Name input box, plus the parent directory and all subdirectories. 
  142.  C:\TP\EXAMPLES\*.PAS                     
  143.  HELLO.PAS       52  Jul 14,1990  12:00pm 
  144. The File information panel shows the path name, file name, date, time, and size of the selected file. =
  145. None of the items on this information panel are selectable. 
  146. THelpTopic
  147.  [ Open ] 
  148. The Open button opens a new Viewer window and places the selected file in that window. 
  149. THelpTopic
  150.  [ Print ] 
  151. The Print button sends the selected text file to the printer. 
  152. THelpTopic
  153.  [ Cancel ] 
  154. If you choose Cancel, nothing changes and no action occurs, and the dialog box is put away. M
  155. (Esc always cancels a dialog box, even if a Cancel button does not appear.) 
  156. THelpTopic
  157.  [ Open ] 
  158. In the Open a File dialog box, if you choose the Open button a new file
  159. viewer window is created. It places the selected file in that window. 
  160. THelpTopic
  161.  Help on the Change Directory dialog box 
  162. The Change Directory dialog box consists of an input box, a list box, the standard OK and Help buttons, and two other buttons (Chdir and Revert). |
  163.  Directory Name 
  164.                                      
  165. The Directory Name input box is where you type in the path of the new directory. 
  166.  Directory Tree 
  167.    Drives                            
  168. C:\                            
  169.      
  170. SOURCE                       
  171.        
  172. INCLUDE                    
  173. The Directory Tree list box enables you to navigate directories by using the selecting bar and pressing Enter. 
  174. If you're using the keyboard, press Enter to make the selected directory be the current directory, then choose OK or press Esc to exit the dialog box. +
  175.  [Chdir ] 
  176. The Chdir button changes the current directory once you've selected or typed in a directory name. +
  177.  [Revert] 
  178. The Revert button goes back to the previous directory, as long as you haven't yet exited the dialog box. 
  179. THelpTopic
  180.  Help on Open a File Dialog Box 
  181. The Open a File dialog box contains an input box, a file
  182. list, a file information panel, the standard button Cancel, one other action button (Open), plus a history list that's attached to the Name
  183. inputbox. 
  184. THelpTopic
  185.  Help on Print a File Dialog Box 
  186. The Print a File dialog box contains an input box, a file
  187. list, a file information panel, the standard button Cancel, one other action button (OK), plus a history list that's attached to the Name
  188. inputbox. 
  189. THelpTopic    
  190.  Text Selection 
  191. Text selection is used to identify text for various functions (cut, copy, paste, find, etc. ) 
  192. USING A MOUSE: 
  193. Move the mouse pointer to the start of the text to be selected. Hold down the left mouse button while dragging the mouse across the string or lines of data to be copied. The text will become highlighted as the mouse is dragged. @
  194. Release the mouse button when all desired text is highlighted. 
  195. USING THE KEYBOARD: :
  196. Move the cursor to the start of the text to be selected. 
  197. Hold down the Shift key while using an arrow key to move the cursor across the string or lines of data to be copied. The text will highlight as the arrow key continues to be pressed. ;
  198. Release the keys when the text is completely highlighted. 
  199. THelpTopic
  200.  Contents 
  201.        Quick
  202. Start
  203.  Problems
  204. solved       
  205.   Input                      
  206.   Output                     
  207.      
  208.      
  209.  ToolDriver                   
  210.          
  211.                               
  212.          
  213.  NameChanger                  
  214.              
  215.                               
  216.              
  217.  FileXref                     
  218.              
  219. THelpTopic
  220.  Index 
  221.                      Page 1 of 8
  222.                      next
  223. Tab to an index item and press Enter for help on that item. 
  224.  Getting
  225. Started
  226.  Cascade,
  227. windows
  228.  Change,
  229. Directory
  230.  Close,
  231. window
  232.  Copy,
  233. clipboard
  234.  Cre8FSL,
  235. utility,
  236. usage
  237. information
  238.  Cut,
  239. text,
  240. window
  241. Shell,
  242. starting
  243. THelpTopic
  244.  Index 
  245.    Tab and           Page 2 of 8
  246.    press Enter       next
  247.  Documentation
  248.  Edit,
  249.  Exit
  250.  File,
  251.  File,
  252. opening
  253.  File,
  254. printing
  255.  File,
  256.  File,
  257. types
  258. handled
  259. utilities
  260.  File,
  261. viewing
  262.                         previous page: Alt+F1
  263. THelpTopic
  264.  Index 
  265.    Tab and           Page 3 of 8
  266.    press Enter       next
  267.  FileList,
  268.  FileList,
  269. usage
  270. information
  271.  FileXref,
  272.  FileXref,
  273. files,
  274. creating
  275.  FileXref,
  276. viewing
  277.  FileXref,
  278.  FileXref,
  279. problems
  280. addressed
  281.  FileXref,
  282. guide
  283.  FileXref,
  284. specification
  285. list,
  286. creating
  287.                         previous page: Alt+F1
  288. THelpTopic
  289.  Index 
  290.    Tab and           Page 4 of 8
  291.    press Enter       next
  292.  Find,
  293. text,
  294. current
  295. window
  296.  Help
  297.  Help,
  298. window
  299. navigation
  300.  Input,
  301. FileXref,
  302. files
  303.  Input,
  304. FileXref,
  305. words
  306.  Input,
  307. NameChanger,
  308. files
  309.  Input,
  310. NameChanger,
  311. names
  312.  Input,
  313. these
  314. Utilities
  315.  Keyboard,
  316. selection
  317.  Keys,
  318. moving
  319. around
  320. viewer
  321.                         previous page: Alt+F1
  322. THelpTopic
  323.  Index 
  324.    Tab and           Page 5 of 8
  325.    press Enter       next
  326.  Mouse,
  327. selection
  328.  Moving,
  329. window
  330.  NameChanger,
  331. list,
  332. creating
  333.  NameChanger,
  334.  NameChanger,
  335.  NameChanger,
  336. output
  337. files,
  338. viewing
  339.  NameChanger,
  340. problems
  341. addressed
  342.  NameChanger,
  343. symbol
  344. rename
  345. list,
  346. creating
  347.  NameChanger,
  348. guide
  349.  Next,
  350. window,
  351. going
  352.                         previous page: Alt+F1
  353. THelpTopic
  354.  Index 
  355.    Tab and           Page 6 of 8
  356.    press Enter       next
  357.  Output,
  358. these
  359. Utilities
  360.  Paste,
  361. text,
  362. window
  363. clipboard
  364.  Previous,
  365. window,
  366. getting
  367.  Print,
  368.  Problems,
  369. addressed
  370. FileXref
  371.  Problems,
  372. addressed
  373. NameChanger
  374.  Quit
  375.  Registering,
  376. printing
  377. registration
  378.                         previous page: Alt+F1
  379. THelpTopic
  380.  Index 
  381.    Tab and           Page 7 of 8
  382.    press Enter       next
  383.  Replace,
  384. text,
  385.  Search
  386. again,
  387. string
  388.  Search,
  389. string
  390.  Select,
  391. text,
  392.  Show
  393. Clipboard
  394.  Sizing
  395. window,
  396.  System
  397.  Tile,
  398. window
  399.  ToolDriver,
  400. guide
  401.  Version,
  402. software
  403.  Window
  404.                         previous page: Alt+F1
  405. THelpTopic
  406.  Index 
  407.    Tab and           Page 8 of 8
  408.    press Enter
  409.  Window,
  410. getting
  411.  Window,
  412. getting
  413. previous
  414.  Window,
  415. close
  416.  Window,
  417. organizing,
  418. cascade
  419.  Window,
  420. organizing,
  421.  Window,
  422. sizing
  423. moving
  424.  Window,
  425. toggle
  426.  Windows,
  427. windows,
  428. using
  429.  Windows,
  430. help,
  431. using
  432.  Word
  433. specification
  434. list,
  435. creating,
  436. FileXref
  437.                         previous page: Alt+F1
  438. THelpTopic
  439. Register 
  440. This window will print out an order form for registering this software. 
  441. Registered users receive: 
  442.  the latest version of ToolDriver
  443.  User's Guides for ToolDriver, FileXref and NameChanger
  444.  phone support
  445.  a 30 day money-back guarantee
  446.  discounts on future software upgrades
  447.  ToolDriver with support for memory above 640K - to 16 megabytes!
  448. THelpTopic
  449.  Cre8FSL 
  450. NameChanger needs an input file containing the list of files it is to process.  That may be created with a text editor directly or the Cre8FSL utility may be used instead. "
  451. Usage:         CRE8FSL path-name {
  452. where path-name is the name of the path containing the files whose names you want in the list for NameChanger to process. 
  453. Examples:      CRE8FSL C: *
  454.                CRE8FSL D:\DEVELOP\SOURCE
  455. THelpTopic
  456.  NameChanger
  457. Edit NAMEC.SRL 
  458. This window lets you create and edit the symbol rename list (SRL).  This is the list of names to be changed, what they are to be changed to and whether or not the software should be sensitive to case in searching for a symbol. 
  459. Example 1:   The entry 
  460.     I  STATE_ARRAY  StateArray
  461. means Look for "STATE_ARRAY" and be insensitive to case.  Raise each word to uppercase before comparing. When found, replace it everywhere with "StateArray". 
  462. Example 2:   The entry: 
  463.     S  EMP-NM   Employee-Name
  464. means Look for "EMP-NM" exactly as shown.  When found, replace it with "Employee-Name". 
  465. THelpTopic
  466.  NameChanger
  467. Start Dialog
  468. This dialog allows you to select the directory for the output files produced by NameChanger. 
  469. THelpTopic
  470.  FileList 
  471. FileList is a tool for creating the list of files for FileXref to process. p
  472. Given a starting path it will recursively scan a directory structure, producing a list of file specifications. ;
  473. It will select all files that FileXref knows how to scan. 
  474.           Usage
  475. Information
  476. THelpTopic
  477.  NameChanger
  478. View NAMEC.MSG 
  479. This window lets you see the activity log of the NameChanger processing. It contains record counts and statistics. Use Viewer keys to navigate. &
  480. Representative output is shown here: x
  481.  NameChanger - Symbol Renaming Utility Version 2.0
  482.  Copyright 1991, 1992 ConVal Software, Inc.    All rights reserved.
  483.  10/01/92  15:11:55
  484.  Invoked with OUTDIR=C:\TOOLDRIV\WORK
  485.  Message File opened as NAMEC.MSG.
  486.  File Specification List opened as NAMEC.FSL.
  487.  Symbol Rename List opened as NAMEC.SRL.
  488.  Items in the Symbol Rename List:
  489.      I  THE                               THe
  490.  Processing C:\TOOLDRIV\FILEXREF.RPT
  491.  Processing C:\TOOLDRIV\FILXRF.DOC
  492.  Processing C:\TOOLDRIV\HISTORY.DOC
  493.  Processing C:\TOOLDRIV\LICENSE.DOC
  494.  Processing C:\TOOLDRIV\NAMECHNG.DOC
  495.  Processing C:\TOOLDRIV\PACKLIST.DOC
  496.  Processing C:\TOOLDRIV\README.DOC
  497.  Processing C:\TOOLDRIV\REGISTER.DOC
  498.  Processing C:\TOOLDRIV\SYSOP.DOC
  499.  Processing C:\TOOLDRIV\TOOLDRIV.DOC
  500.  Processing C:\TOOLDRIV\WARRANTY.DOC
  501.  File C:\TOOLDRIV\FILEXREF.RPT : This file contained no symbols for renaming.
  502.        The output file for it is identical.
  503.  File C:\TOOLDRIV\FILXRF.DOC : The output file was modified as requested.
  504.  File C:\TOOLDRIV\HISTORY.DOC : The output file was modified as requested.
  505.  File C:\TOOLDRIV\LICENSE.DOC : The output file was modified as requested.
  506.  File C:\TOOLDRIV\NAMECHNG.DOC : The output file was modified as requested.
  507.  File C:\TOOLDRIV\PACKLIST.DOC : The output file was modified as requested.
  508.  File C:\TOOLDRIV\README.DOC : The output file was modified as requested.
  509.  File C:\TOOLDRIV\REGISTER.DOC : The output file was modified as requested.
  510.  File C:\TOOLDRIV\SYSOP.DOC : The output file was modified as requested.
  511.  File C:\TOOLDRIV\TOOLDRIV.DOC : The output file was modified as requested.
  512.  File C:\TOOLDRIV\WARRANTY.DOC : The output file was modified as requested.
  513.  RECORD COUNTS
  514.  File Specification List records READ:             11
  515.  Symbol Rename List records READ:                   1
  516.  Characters READ from the input files:        154,407
  517.  Characters WRITTEN to output files:          154,407
  518.  Message records WRITTEN:                          49
  519.  10/01/92  15:12:04
  520. THelpTopic
  521.  FileXref
  522. View FILEXREF.MSG 
  523. This window lets you see the activity log of the FileXref processing. It contains record counts and statistics. Use Viewer keys to navigate. '
  524. This is a sample of the FileXref log: s
  525.  FileXref - Cross Reference Utility  Version 2.0
  526.  Copyright 1990-1992 ConVal Software, Inc.  All rights reserved.
  527.  10/01/92  15:11:06
  528.  Message File opened as FILEXREF.MSG.
  529.  File Specification List opened as FILEXREF.FSL.
  530.  Word Specification List opened as FILEXREF.WSL
  531.  Cross reference file opened as FILEXREF.XRF.
  532.  Unreferenced symbols file opened as FILEXREF.FEI.
  533.  Report file opened as FILEXREF.RPT.
  534.  Processing Option is /RPTC.
  535.  Items in the word specification list:
  536.      X auto
  537.      X break
  538.      X case
  539.      X char
  540.      X const
  541.      X continue
  542.      X default
  543.      X do
  544.      X double
  545.      X else
  546.      X enum
  547.      X extern
  548.      X float
  549.      X for
  550.      X goto
  551.      X if
  552.      X int
  553.      X long
  554.      I re*
  555.      X register
  556.      X return
  557.      X short
  558.      X signed
  559.      X sizeof
  560.      X static
  561.      X struct
  562.      X switch
  563.      X typedef
  564.      X union
  565.      X unsigned
  566.      X void
  567.      X volatile
  568.      X while
  569.  Examining C:\TOOLDRIV\FILXRF.DOC
  570.  Examining C:\TOOLDRIV\HISTORY.DOC
  571.  Examining C:\TOOLDRIV\LICENSE.DOC
  572.  Examining C:\TOOLDRIV\NAMECHNG.DOC
  573.  Examining C:\TOOLDRIV\PACKLIST.DOC
  574.  Examining C:\TOOLDRIV\README.DOC
  575.  Examining C:\TOOLDRIV\REGISTER.DOC
  576.  Examining C:\TOOLDRIV\SYSOP.DOC
  577.  Examining C:\TOOLDRIV\TOOLDRIV.DOC
  578.  Examining C:\TOOLDRIV\WARRANTY.DOC
  579.  RECORD COUNTS
  580.  File Specification List records READ:             10
  581.  Word Specification List records READ:             33
  582.  Characters READ from the input files:        142,096
  583.  Cross Reference Records written:                   0
  584.  Unreferenced symbols written:                      0
  585.  Report Records written:                          134
  586.  Message records written:                          71
  587.  10/01/92  15:11:12
  588. THelpTopic
  589.  FileXref
  590. View FILEXREF.XRF 
  591. This window lets you see the cross reference export file created by FileXref. You may use the File Viewer keys to navigate. This file is in a "quote and comma" delimited format for importing into database software. 
  592. THelpTopic
  593.  FileXref
  594. View FILEXREF.RPT 
  595. This window lets you view the report file created by FileXref. The report file contains two or three reports, one after the other. This is an ASCI print file, so you will see the character 
  596. , a page break control code. Navigate using the File Viewer control keys. 
  597. THelpTopic
  598.  FileXref
  599. Edit FILEXREF.FSL 
  600. This window lets you edit the list of files generated by the FILELIST utility. This will be used by FileXref as the list of files to be scanned and cross referenced. Navigate using the File Viewer control keys as well as those in the Edit and Search menus.  NOTE: You may add any filename to this list as long as it names a text file. (If it will print properly on a printer.)  Having FileXref cross reference other files will produce unpredictable results. 
  601. THelpTopic
  602.  NameChanger
  603. Edit NAMEC.FSL 
  604. This window lets you view, and if necessary, edit the list of files to be processed by NameChanger.  Navigate using the File Viewer control keys as well as those in the Edit menu. 
  605. THelpTopic
  606.  FileXref
  607. Edit FILEXREF.WSL 
  608. This window lets you create and edit the word specification list.  This is the list of words to appear in the optional word usage report. 
  609. THelpTopic
  610.  FileList Usage Information 
  611.                                FILELIST
  612.               Utility to Create a List of File Specifications
  613.                           Version 1.1
  614.                       September, 1990 Release
  615.             Copyright 1990, ConVal Software, Inc.
  616. FILELIST.DOC             File List Generating Utility Copyright ConVal Software, Inc. 1990                        Version 1.1 
  617. Primary input - A path L
  618.    Examples:     FILELIST  c:
  619.                  FILELIST  d:\database\utils
  620. Primary output - a list of file specifications - to the standard 
  621.                  output
  622. For each filename in the directory or subdirectories specified by the path, if the file extention is in the list (ASM BAS BAT C COB CPP FOR H HPP INP PAS PLI PRG PRG REX SQL TXT), then a record is written to the primary output. `
  623. This utility may be used to create the file specification list used by the FileXref utility. L
  624. To cross reference all your source on all your PC disks, do the following: 
  625.        FILELIST  C: C.FSL
  626.        FILELIST  D: D.FSL
  627.        FILELIST  E: E.FSL
  628.        FILELIST  F: F.FSL
  629.        COPY C.FSL+D.FSL+E.FSL+F.FSL  FILEXREF.FSL
  630.          ... ETC.
  631.        FILEXREF
  632. THelpTopic
  633.  NameChanger Documentation 
  634. The ToolDriver window environment integrates the use of NameChanger, the tool for managing naming conventions.  You can define its inputs, run NameChanger and view the transformed files. ;
  635. See the NameChanger
  636. option for complete information. 
  637. NameChanger may also be started from the DOS command line.  This can be done to make additional memory available for processing.  Use the NameChanger
  638. File and NameChanger
  639. Name menu items under ToolDriver to set it up. Then quit ToolDriver and type NAMEC at the DOS prompt. a
  640. See the NameChanger User's Guide for full information. (Print or view the file - NAMECHNG.DOC). 
  641. THelpTopic
  642.  FileXref Documentation 
  643. FileXref, the file and word cross referencing tool, is integrated into the ToolDriver window environment. Here it's easy to define inputs, do the cross referencing, and view or print the outputs. <
  644. See the FileXref
  645. option for full information on this. 
  646. FileXref may also be used directly from the DOS command line. This interface can be used to incorporate cross referencing right into your make file to keep documentation always up to date. You can also use this interface to get more memory for processing. Do this by using the FileXref
  647. File and FileXref
  648. Word options under ToolDriver. Then quit ToolDriver and type FILEXREF. When the processing is done you can print out the reports. See the FileXref User's Guide for full information. (Print or view the file - FILXRF.DOC). 
  649. THelpTopic
  650.  ToolDriver User's Guide 
  651.  Introduction
  652.  Installing
  653. ToolDriver
  654.  ToolDriver
  655. Basics
  656.  Menus
  657. Options
  658. THelpTopic&
  659.  ToolDriver Introduction 
  660.  T o o l D r i v e r
  661.  Version 2.0
  662.  User's Guide
  663.  Organizing files and naming conventions /
  664.    Professional Tools /
  665.       for Software Developers and Consultants
  666.                                  
  667.                             
  668.                 (R)
  669.                           
  670.        
  671.                             
  672.   Association of
  673.  ConVal Software, Inc.      
  674.        
  675.   Shareware
  676.                             
  677.    o   
  678.     Professionals
  679.                           
  680.    |   
  681.                                
  682.     MEMBER
  683.  Copyright 1990-1992 ConVal Software, Inc.
  684.  All rights reserved.
  685. This program is produced by a member of the Association of Shareware Professionals (ASP).  ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help.  The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. '
  686. Please write to the ASP Ombudsman at: C
  687.  ASP Ombudsman
  688.  545 Grover Road
  689.  Muskegon, MI  49442-9427
  690.  U.S.A.
  691. or send a CompuServe message via CompuServe MAIL to ASP Ombudsman 70007,3536. 
  692. The ombudsman may be contacted by FAX by sending to the ASP FAX number: (616) 788-2765. In communication with the ombudsman please include a telephone number and/or FAX if available.     
  693. Preface (
  694. Welcome to this user guide to ToolDriver. It describes how you can better organize your files and names. This information will be useful to anyone responsible for developing, managing, or maintaining application software. 
  695. You will learn: A
  696.  The value of understanding the relationships of source files.
  697.  How planning your naming conventions can assist in debugging.
  698.  How to uncover obsolete components.
  699.  An easy way to change old programs to your current naming style.
  700.  Organizing tricks that eliminate entire classes of problems.
  701.  Characteristics of a well organized application.
  702.  Ways to prevent unanticipated naming problems.
  703. Software applications require careful planning and thoughtful implementation. The information provided here will help you understand the detailed organization of your application and communicate that understanding to others, making your job much easier. 8
  704.  Introduction
  705. What's in ToolDriver? G
  706.  An integrated environment for running the ConVal programming tools.
  707.  FileXref - cross references your files and names. It reads text files
  708.    and documents their use of other files and words you've selected. It
  709.    works on many languages including C, C++, Pascal, COBOL, BAS, MASM,
  710.    SQL, Fortran, and xBase.
  711.  NameChanger - transforms names in the files associated with your
  712.    application.
  713.  FileList - reads your disk and creates a list of file names to be
  714.    cross referenced.
  715.  Cre8FSL - A tool like FileList. It creates a list of file names to be
  716.    name-changed.
  717. Hardware and software requirements 
  718. ToolDriver runs on machines with an 80286 or higher processor and running DOS 3.1 or higher.  A hard disk and at least one floppy drive are also required to run ToolDriver. J
  719. ToolDriver supports (but does not require) any Windows-compatible mouse. n
  720.  How to contact ConVal Software
  721.  ConVal Software, Inc.
  722.  11607 E. Butter Creek Road
  723.  Moorpark, CA 93021-2412
  724.  Sales and
  725.  technical support:        Monday - Friday
  726.  Voice      (805) 529-6847 9 AM - 5 PM Pacific Time
  727.  Fax        (805) 529-4314
  728.  CompuServe 72330,1621
  729. The ToolDriver package 8
  730. Your ToolDriver package consists of a set of disks and a ToolDriver User's Guide (this manual), FileXref User's Guide, and a NameChanger User's Guide. The FileXref and NameChanger user guide documents will only be needed if you want to run these tools outside of the ToolDriver environment (directly from DOS). 
  731. The disks contain all the programs and files you need to cross reference your disk files and make changes to your naming conventions. 
  732. THelpTopic
  733.  Installing ToolDriver 
  734. Installing ToolDriver (
  735. Users who downloaded ToolDriver from a BBS see README.DOC for installation instructions. 
  736. The ToolDriver installation procedure will verify that you have enough space on your hard drive, create directories as needed and transfer files from your distribution diskettes to your hard disk.  It will let you print out the documentation and read pertinent information about ToolDriver. Its actions are self-explanatory; the following instructions tell you all you need to know. 
  737. To install ToolDriver: x
  738.  1.   Insert the installation disk into drive A. Type the
  739.       following command, then press Enter.
  740.          A:INSTALL
  741.  2.   Press Enter at the installation screen.
  742.  3.   Follow the prompts.
  743.  4.   At the end of installation, you may want to add this line to your
  744.          CONFIG.SYS file: FILES=20
  745. Running ToolDriver 
  746. Once you've installed ToolDriver, and if you're anxious to get up and running, change to the TOOLDRIV directory (if you didn't pick another name yourself), type TD and press Enter.  Otherwise, continue reading this documentation to see what you can do with ToolDriver. 
  747. THelpTopic
  748.  ToolDriver Basics 
  749. ToolDriver Basics (
  750. The ToolDriver platform for organizing files and names was developed using Borland's Turbo Vision for C++. It has everything you need to setup, run, view and print output from cross referencing as well as name-changing functions. 
  751. It provides: 
  752.  multiple resizable windows that can be moved
  753.  mouse support and dialog boxes
  754.  cut, paste, and copy commands using a clipboard
  755.  a small, fast editor for preparing and revising input files
  756.  online Help
  757.  quick access to other programs and back again
  758. The following topics provide more information n
  759.  starting
  760. exiting
  761. ToolDriver
  762. interface
  763.  using
  764. dialog
  765. boxes
  766. communicate
  767. ToolDriver
  768. THelpTopic
  769.  Starting ToolDriver 
  770. Starting ToolDriver |
  771. To start ToolDriver, go to the ToolDriver directory ( C:\TOOLDRIV by default ), type TD and press Enter at the DOS prompt. 
  772. Exiting ToolDriver )
  773. There are two ways to leave ToolDriver: 
  774.  Choose File
  775. Quit to leave ToolDriver completely; you have to type TD
  776.    again to reenter it. You'll be prompted to save your work before
  777.    exiting, if you haven't already done so. Use F3 to save.
  778.  Choose File
  779. DOS Shell to shell out from ToolDriver to enter commands
  780.    at the DOS command line. When you're ready to return to ToolDriver,
  781.    type EXIT at the command line and press Enter. You will be able to
  782.    resume work just as you left it.
  783. THelpTopic
  784.  The User Interface 
  785. The User Interface 
  786. ToolDriver has three visible objects: a menu
  787. bar at the top of the screen, a window
  788. area in the middle, and a status
  789. line at the bottom of the screen. 
  790. If you are already familiar with the Borland IDE interface, then you may want to go directly to cross referencing (FileXref) and changing names (NameChanger). 
  791. THelpTopic
  792.  The menu bar and menus 
  793. The menu bar and menus 
  794. The menu bar is your primary access to all the commands on the menu. It is always visible except when you're viewing your program's output or transferring to another program. '
  795. See hot
  796. keys) for keyboard shortcuts. :
  797. Here is how you choose menu commands using the keyboard: I
  798. 1.   Press F10. This makes the menu bar active. The next thing you type +
  799.      will relate to items on the menu bar.
  800. 2.   Use the left and right arrow keys to select the menu you want to  
  801.      display. Then press Enter.
  802.      As a shortcut for this step, you can just press the highlighted
  803.      letter of the menu title. For example, when the menu bar is active
  804.      press N to move to and display the NameChanger menu.
  805.      A third way of doing this step is to hold down the Alt key and then
  806.      press a highlighted letter from the menu bar titles (such as Alt+N)
  807.      to display the menu you want.
  808. 3.   Use the up and down arrows now to select a command from the menu 
  809.      displayed.
  810. At this point ToolDriver either carries out the command or displays a dialog box. :
  811. There are two ways to choose menu commands with a mouse: E
  812. 1.   Click the desired menu title to display the menu and click the $
  813.      desired command from the menu.
  814. 2.   Or, drag straight from the menu title down to the menu command. 
  815.      Release the mouse button on the command you want. (If you change
  816.      your mind, just drag off the menu and no command will be chosen.)
  817. Some menus and menu commands are unavailable when it would make no sense to choose them. 
  818. THelpTopic
  819.  Hot Keys 
  820. There are keyboard shortcuts (or hot keys) for accessing
  821. bar, choosing
  822. commands, editing, online
  823. help and window
  824. management. 
  825. THelpTopic
  826.  General Hot Keys 
  827.  Hot Key    Menu command      Function
  828.  F1         Help              Displays a context-sensitive help screen
  829.  F2         File
  830. View         Brings up a dialog box for viewing a file
  831.  F4         Window
  832. Close      Closes the active window
  833.  F5         Window
  834. Zoom       Toggles the active window's size
  835.  F10        (none)            Takes you to the menu bar
  836. THelpTopic
  837.  Menu Hot Keys 
  838.  Hot Key    Menu              Function
  839.  Alt+Spacebar  
  840.               Takes you to the 
  841. (Product Info) menu
  842.  Alt+E      Edit              Takes you to the Edit menu
  843.  Alt+F      File              Takes you to the File menu
  844.  Alt+H      Help              Takes you to the Help menu
  845.  Alt+N      NameChanger       Takes you to the NameChanger menu
  846.  Alt+S      Search            Takes you to the Search menu
  847.  Alt+W      Window            Takes you to the Window menu
  848.  Alt+X      FileXref          Takes you to the FileXref menu
  849. THelpTopic
  850.  Editing Hot Keys 
  851.  Hot Key    Command                 Function
  852.        
  853.  Ctrl+Ins   Edit
  854. Copy            Copies selected text to the clipboard
  855.  Shift+Del  Edit
  856. Cut             Places selected text in the clipboard,
  857.                                  deletes selected text
  858.  Shift+Ins  Edit
  859. Paste           Pastes text from the clipboard into the
  860.                                  active window
  861.  Ctrl+Del   Edit
  862. Clear           Removes selected text from a window,
  863.                                  but doesn't put it in the clipboard
  864.  Ctrl+L     Search
  865. Search Again  Repeats last find or replace
  866.  F3         File
  867. Save            Saves the file in the active edit
  868.                                  window
  869. THelpTopic
  870.  Window Management Hot Keys 
  871.  Hot Key    Menu command         Function
  872.        
  873.  Alt+n      (none)               Displays window n, where n is the
  874.                                  number of the window you want to see
  875.  F4         Window
  876. Close         Closes the active window
  877.  F5         Window
  878. Zoom          Toggles the size of the active window
  879.  Ctrl+F5    Window
  880. Size/Move     Changes the size or position of the
  881.                                  active window
  882.  F6         Window
  883. Next          Makes the next window the active one
  884.  Shift+F6   Window
  885. Previous      Makes the prior window the active one
  886. THelpTopic
  887.  Online Help Hot Keys 
  888.  Hot Key    Function
  889.  F1         Opens a context-sensitive help screen
  890.  Alt+F1     Displays the previous help screen
  891. THelpTopic
  892.  Working with Windows 
  893. Working with windows 
  894. Most of what you see and do in ToolDriver happens in a window. A window is a screen area that you can open, close, move, resize, zoom, tile, and overlap. 
  895. You can have many windows open in ToolDriver, but only one window can be active at any time. Any menu command you choose or text you type generally applies only to the active window. 
  896. You can easily spot the active window - it's the one with the double-lined border around it.  The active
  897. window always has a close box, a zoom box, and scroll bars. If your windows are overlapping, the active window is always on top of all the others. S
  898. There are several types of windows, but most of them have these things in common: W
  899.  a title
  900.  a close
  901.  scroll
  902.  a zoom
  903.  a window
  904. number (1 to 9)
  905. An edit window also displays the current line and column numbers in the lower left corner.  If you've modified your file, an asterisk (*) appears to the left of the column and line numbers. 
  906. THelpTopic
  907.                  
  908.                  
  909.  The title bar contains 
  910.                  
  911.  the name of the window 
  912.                  
  913.                              
  914.           
  915.       
  916.  Click the     
  917.           
  918.       
  919.  Click on the zoom box 
  920.  close box to  
  921.           
  922.       
  923.  to either enlarge or  
  924.  quickly close 
  925.           
  926.       
  927.  shrink the window     
  928.  the window    
  929.           
  930.       
  931.           
  932.                     
  933.          
  934.                    
  935.                     
  936.          
  937.                    
  938.                     
  939.  Window Title 
  940.  The first 9 open        
  941.  windows have a window   
  942.  number. Use Alt and n   
  943.  to make window n active 
  944.  Use a mouse to scroll the 
  945.  contents of the window    
  946.                                                 
  947.             
  948.       
  949.  Drag any corner to make    
  950.                   
  951.  windows larger or smaller. 
  952.                   
  953. A quick
  954. reference is provided to summarize the use of windows. 
  955. THelpTopic
  956. The close box of a window is the box in the upper left corner. Click this box to quickly close the window. (Or choose Window
  957. Close.) The help windows are considered temporary. You can close them by pressing Esc. 
  958. THelpTopic
  959. The title bar, the topmost horizontal bar of a window, contains the name of the window and the window number. Double-clicking the title bar zooms the window. You can also drag the title bar to move the window around. 
  960. THelpTopic
  961. The zoom box of a window appears in the upper right corner. If the icon in that corner is an up arrow (), you can click the arrow to enlarge the window to the largest possible size. If the icon is a double-headed arrow (), the window is already at its maximum size. In that case, clicking it returns the window to its previous size. To zoom a window from the keyboard, choose Window
  962. Zoom. 
  963. THelpTopic
  964. The first nine windows you open in ToolDriver have a window number in the upper right border. You can make a window active (and bring it to the top) by pressing Alt and the window number. For example if the FileXref output report window is window number 4 and it's behind other windows, then Alt+4 brings it to the top so it's fully visible. 
  965. THelpTopic
  966. Scroll bars are horizontal or vertical bars that look like this: ?
  967. Scroll bars show you where you are in relation to what you're viewing. You use these bars with a mouse to scroll the contents of the window. Click the arrow at either end to scroll one line at a time. (Keep the mouse button pressed to scroll continuously.) You can click the shaded area to either side of the scroll box to scroll a page at a time. 
  968. Finally, you can drag the scroll box to any spot on the bar to quickly move to a spot in the window relative to the position of the scroll box. 
  969. You can drag any corner to make a window larger or smaller. To resize from the keyboard, choose Size/Move from the Window menu. Press Enter when finished to get out of the sizing/moving mode. 
  970. THelpTopic
  971. This is a quick reference for using windows in ToolDriver. Note that you don't need a mouse to perform these actions - a keyboard works fine too. 
  972.  To do this             Use one of these techniques
  973.  Open a file viewer     Choose File
  974. View to open a file and scroll it in
  975.                         a window.
  976.  Open other windows     Choose the desired window from the Window menu.
  977.  Close a window         Choose Close from the Window menu or click the
  978.                         close box of the window or Press F4.
  979.  Activate a window      Click anywhere in the window, or
  980.                         Press Alt plus the window number (1 to 9), or
  981.                         Choose Window
  982. Next (F6 is the hot key) to step
  983.                         through the windows in the order you created
  984.                         them, or
  985.                         Choose Window
  986. Previous (Shift+F6 is the hot key)
  987.                         to step through the windows in the reverse of
  988.                         the order you created them.
  989.  Move an active window  Drag its title bar. Or choose Window
  990. Size/Move
  991.                         and use the arrow keys to place the window where
  992.                         you want it, then press Enter.
  993.  Resize the active      Drag any corner. Or choose Window
  994. Size/Move and
  995.  window                 press Shift while you use the arrow keys to
  996.                         resize the window, then press Enter.
  997.  Zoom the active        Click the zoom box in the upper right corner of
  998.  window                 the window, or
  999.                         Double-click the window's title bar, or
  1000.                         Choose Window
  1001. Zoom (F5 is the hot key)
  1002. THelpTopic
  1003.  The status line 
  1004. The status line 8
  1005. The status line appears at the bottom of the screen to b
  1006.  remind you of basic keystrokes and shortcuts (or hot keys) applicable
  1007.    in the active window.
  1008.  let you use the mouse to click on a command to perform the action
  1009.    instead of choosing the action from the menu or pressing the shortcut
  1010.    keystroke.
  1011. Here is what the status line looks like: 
  1012. ToolDriver 
  1013.  F1 Help F2 View F4 Close F5 Zoom F10 Menu 
  1014. Where Id is the serial number of your registered software. 
  1015. THelpTopic
  1016.  Working with Dialogs 
  1017. Dialog boxes 8
  1018. A menu command with an ellipsis (...) after it leads to a dialog box. Dialog boxes offer a convenient way to view and set multiple options. When you're making settings in dialog boxes, you work with five basic types of onscreen controls: action
  1019. buttons, radio
  1020. buttons, check
  1021. boxes, input
  1022. boxes, and list
  1023. boxes. 
  1024. THelpTopic
  1025. Action buttons 
  1026.   OK     
  1027.   Cancel 
  1028. Above are two action buttons, OK and Cancel. If you choose OK, the choices in the dialog box are accepted; if you choose Cancel, nothing changes, no action takes place, and the dialog box is put away. Choose Help to open a Help window about this dialog box. Esc is always a keyboard shortcut for Cancel (even if no Cancel button appears). 
  1029. If you're using a mouse, click the dialog-box button you want. When you're using the keyboard, press Alt and the highlighted letter of a command to activate it. For example Alt+C selects the Cancel button because the C in Cancel is highlighted. Press Tab or Shift+Tab to move forward or back from one item to another in a dialog box. Each element is highlighted when it becomes active. 
  1030. In this dialog box, OK is the default button, which means you need only press Enter to choose the button. (On monochrome systems, arrows indicate the default; on color monitors, default buttons are highlighted.) Be aware that tabbing to a button makes that button the default. 
  1031. THelpTopic
  1032. Radio Buttons and check boxes 
  1033.  Radio Buttons        Check Boxes  
  1034.  ( ) Option 1         ( ) Option A 
  1035.  ( ) Option 2         (X) Option B 
  1036.  ( ) Option 3         ( ) Option C 
  1037.                       (X) Option D 
  1038. Radio buttons are like car-radio buttons. They come in groups, and only one radio button in the group can be on at any one time. To choose a radio button, click it or its text. From the keyboard, select Alt and the highlighted letter, or press Tab until the group is highlighted, and then use the arrow keys to choose a particular radio button. Press Tab or Shift+Tab again to leave the group with the new radio button chosen. Check boxes differ from radio buttons in that you can have any number of check boxes checked at any time.  When you select a check box, an X appears in it to show you it's on. An empty box indicates it's off. To change the status of a check box, click it or its text, press Tab until the check box is highlighted and then press Spacebar, or select Alt plus the highlighted letter. 
  1039. If several check boxes apply to a topic, they appear as a group. In that case, tabbing moves to the group. Once the group is selected, use the arrow keys to select the item you want, and then press Spacebar to check or uncheck it. On monochrome monitors, the active check box or group of check boxes will have a chevron symbol (
  1040. ) to the left and right. When you press Tab, the chevrons move to the next group of check boxes or radio buttons. 
  1041. THelpTopic
  1042. Input boxes and list boxes h
  1043. Input boxes let you type in text. Most basic text-editing keys work in the text box (for example, arrow keys, Home, End, and Ins). If you continue to type once you reach the end of the box, the contents automatically scroll.  If there's more text than shows in the box, arrowheads appear at the end (
  1044.  and 
  1045. ). You can click the arrowheads to scroll or drag the text. If you need to enter control characters (such as ^L or ^M) in the input box, then prefix the character with a ^P. So, for example, to enter ^M into the input box, hold down the Ctrl key and press PM. (This capability is useful for search strings.) 
  1046. If an input box has a down-arrow icon to its right, there is an associated history list. Click the icon to display the list. You'll find text you typed the last few times you used the input box. Press Enter to choose an item from this list. The Find box, for example, has such a history list, which keeps track of the text you searched for previously. Try choosing a previous search string. You can also edit an entry in the history list. Press Esc to exit from the history list without making a selection. 
  1047. A final component of many dialog boxes is a list box, which lets you scroll through and select from variable-length lists (often file names) without leaving a dialog box. 
  1048. You make a list box active by clicking it or by choosing the highlighted letter of the list title (or press Tab until it's highlighted). Once a list box is displayed, you can use the scroll box to move through the list or press the up and down arrows from the keyboard. 
  1049. THelpTopic
  1050.  Menus and Options 
  1051. Menus and options reference (
  1052. The ToolDriver menu contains the following items. Z
  1053. Next to some of the menu option descriptions you'll see keyboard shortcuts, or hot
  1054. keys. l
  1055. System
  1056.  File
  1057.  Edit
  1058.  Search
  1059.  FileXref
  1060.  NameChanger
  1061.  Window
  1062.  Help
  1063. THelpTopic
  1064.  System Menu 
  1065.  (System) menu  Alt+Spacebar 
  1066.  menu appears on the far left of the menu bar. Alt+Spacebar is the fastest way to get there. When you pull down the menu (by using the down arrow) you see two commands, Register and Product Information. 
  1067. Register 
  1068. Choose 
  1069. Register to print a ToolDriver Registration form. A file print dialog will be presented, with the file REGISTER.DOC selected. Just press Enter to print the registration form. 
  1070. Product Information 
  1071. Product Information menu command displays the version of ToolDriver you are running. The same information displays when you initially bring up ToolDriver. Put this information away by pressing Enter. 
  1072. THelpTopic
  1073.  File  (Alt-F) 
  1074. File menu  Alt+F 
  1075. The file menu lets you open and view files in a file viewer window. It also lets you print files, change the working directory, shell to DOS and exit the ToolDriver environment. '
  1076. There are five options in this menu - :
  1077.  View
  1078.  Print
  1079.  Change
  1080. Directory
  1081. Shell
  1082.  Quit
  1083. THelpTopic
  1084.  File
  1085. View 
  1086. View F2 
  1087. The File
  1088. View command displays a file-selection dialog box for you to select a text file to open in a file viewer window.  Here is what the box looks like: 
  1089. The View a File dialog box 
  1090.  View a File 
  1091.  Name
  1092.  *.*                              
  1093.  Open  
  1094.  Files                               
  1095.  CRE8FSL.EXE       
  1096.   FILEXREF.WSL  
  1097.   Cancel 
  1098.  FILELIST.EXE      
  1099.   FILEXREF.XRF  
  1100.  FILEXREF.BAK      
  1101.   HISTORY.DOC   
  1102.  FILEXREF.EXE      
  1103.   NAMEC.EXE     
  1104.  FILEXREF.FEI      
  1105.   NAMEC.FSL     
  1106.  FILEXREF.FSL      
  1107.   NAMEC.MSG     
  1108.  FILEXREF.MSG      
  1109.   NAMEC.SRL     
  1110. FILEXREF.RPT
  1111.      
  1112.   \WORK         
  1113.      
  1114. C:\TOOLDRIV\*.*                                    
  1115. FILEXREF.RPT 133153          Sep 01,1992   09:15a  
  1116. The dialog box contains an input box, a file list, buttons labeled Open and Cancel, and an information panel that describes the selected file. Now you can do any of these actions: `
  1117.  Type in a full file name and choose Open.  Open loads the file into a
  1118.    file viewer window.
  1119.  Type in a file name with wildcards, which filters the file list to
  1120.    match your specifications.
  1121.  Press down arrow to choose a file specification from a history list
  1122.    of file specifications you've entered earlier.
  1123.  View the contents of different directories by selecting a directory
  1124.    name in the file list.
  1125. The input box lets you enter a file name explicitly or enter a file name with standard DOS wildcards (* and ?) to filter the names appearing in the history list box. If you enter the entire name and press Enter, ToolDriver opens it for viewing. 
  1126. If you press 
  1127.  when the cursor is blinking in the input box, a history list drops down below the box. This list displays the last 15 file names or file name masks you've entered. Choose a name from the list by double-clicking it or selecting it with the arrow keys and pressing Enter. 
  1128. Once you've typed in or selected the file you want, choose the Open button (choose Cancel if you change your mind). You can also just press Enter once the file is selected, or you can double-click the file name in the file list. A
  1129. The file viewer will view text files up to about 40K in length. 
  1130. Using the file list box 
  1131. The File list box displays all file names in the current directory that match the specifications in the input box, displays the parent directory, and displays all subdirectories. Click the list box or press Tab until the list box name is highlighted. You can now press 
  1132.  to select a filename and then press Enter to open it. You can also double-click any file name in the box to open it. You might have to scroll the box to see all the names.  If you have more than one panel of names, you can also use the left and right arrows. 
  1133. The file information panel at the bottom of the View a file dialog box displays path name, file name, date, time and size of the file you've selected in the list box. As you scroll through the list box, the panel is updated for each file. 
  1134. THelpTopic
  1135.  File
  1136. Print 
  1137. Print 
  1138. The File
  1139. Print command displays a file-selection dialog box for you to select a text file to be printed. It looks and functions like the File
  1140. View command except that the output will be routed to your printer instead of a file viewer. 
  1141. THelpTopic
  1142.  File
  1143. Change Dir 
  1144. Change Dir =
  1145. The File
  1146. Change Dir command lets you specify a drive and a directory to make current.  The current directory is the one ToolDriver uses for viewing and printing files. Note that FileXref and NameChanger will always reset the current directory to the ToolDriver installation directory where its control files reside. :
  1147. Here is what the Change Directory dialog box looks like: !
  1148. The Change Directory dialog box 
  1149.  Change Directory 
  1150.  Directory Name 
  1151.  C:\TOOLDRIV                      
  1152.  Directory Tree                      
  1153.  Drives                             
  1154.   OK     
  1155.         C:\                   
  1156.      
  1157.         
  1158. TOOLDRIV            
  1159.      
  1160.   Chdir  
  1161.           
  1162. WORK              
  1163.      
  1164.                               
  1165.      
  1166.   Revert 
  1167.                               
  1168.      
  1169.                               
  1170.      
  1171.                               
  1172.      
  1173.                                     
  1174. There are two ways to change directories: M
  1175.  Type in the path of the new directory in the input box and press
  1176.    Enter
  1177.  Choose the directory you want in the directory tree (if you're using
  1178.    the keyboard, press Enter to make it the current directory), then
  1179.    choose OK or press Esc.
  1180. If you choose the OK button, your changes are made and the dialog box is closed. If you choose the Chdir button, the Directory Tree list box changes to the selected directory and displays the subdirectories of the currently highlighted directory (pressing Enter or double- clicking on that entry gives you the same result). If you change your mind about the directory you've picked and you want to go back to the previous one (and you've yet to exit the dialog box), choose the Revert button. 
  1181. THelpTopic
  1182.  File
  1183. DOS Shell 
  1184. DOS Shell 
  1185. The File
  1186. DOS Shell command lets you temporarily exit ToolDriver to enter a DOS command or program. To return to ToolDriver, type EXIT and press Enter. 
  1187. Don't install any TSR programs (like SideKick) or print a file with the DOS print command while you've shelled to DOS, because memory may be misallocated. 
  1188. THelpTopic
  1189.  File
  1190. Quit 
  1191.      (Alt-Q)
  1192. Quit    Alt+Q 
  1193. The File
  1194. Quit command exits ToolDriver and removes it from memory. If you have made any changes you haven't saved, ToolDriver asks if you want to save them before exiting. Use F3 to save. 
  1195. THelpTopic
  1196.  Edit 
  1197. Edit menu     Alt+E 
  1198. The Edit menu lets you cut, copy, and paste text in edit windows. You can also open a Clipboard window to view or edit its contents. +
  1199.  Copy
  1200.  Paste
  1201.  Show
  1202. Clipboard
  1203. These options are only active when an edit window is open. Edit windows are opened by the first two FileXref and NameChanger menu items.   0
  1204. A file edit window is presented in four cases: w
  1205.  after processing the FileXref
  1206. Files dialog (This allows you to
  1207.    modify the list of files to be cross referenced.)
  1208.  after choosing the FileXref
  1209. Words command (This allows you to modify a
  1210.    lis of words to be cross referenced.) (You do not need to list the
  1211.    names of any files here - they are automatically cross referenced.)
  1212.  after processing the NameChanger
  1213. Files dialog (This allows you to
  1214.    modify the list of files to be name-changed.)
  1215.  after choosing the NameChanger
  1216. Names command (This allows you to
  1217.    specify the names to be changed and what they are to be changed to.)
  1218.    (Names may be file names; variable names; i.e. any complete symbol)
  1219. Before you can use most of the commands on the edit menu, you need to know about selecting text (because most editor actions apply to selected text).  Selecting text means highlighting it. You can select text either with keyboard commands or with a mouse; the principle is the same even though the actions are different. 
  1220. From the keyboard >
  1221.  Press Shift while pressing any key that moves the cursor.
  1222. Using a mouse 
  1223.  To select text with a mouse, drag the mouse pointer over the desired
  1224.    text If you need to continue the selection past a window's edge, just
  1225.    drag off the side and the window automatically scrolls.
  1226.  To select a single word, double-click it.
  1227.  To extend or reduce the selection, Shift-click anywhere in the
  1228.    document (that is, hold Shift and click). Once you've selected text,
  1229.    the Cut and Copy commands in the Edit menu become available.
  1230. The Clipboard is the magic behind cutting and pasting. It's a special window that holds text you cut or copied, so you can paste it elsewhere. The Clipboard works in close concert with the commands in the Edit menu. 
  1231. THelpTopic
  1232.  Edit
  1233. Cut    Shift+Del 
  1234. The Cut option allows you to move text from the active window to the clipboard. You may then use Paste to copy that text to another (or the same) window. 
  1235. Using a mouse: A
  1236. Select the text to be Cut. Then click on Edit, followed by Cut. 
  1237. Using the keyboard: 4
  1238.   Select the text to be Cut. Then press Shift-Del.
  1239. The text will be removed from the active window and will be available in the clipboard 
  1240. THelpTopic    
  1241.  Edit
  1242. Copy 
  1243. Copy Ctrl+Ins 
  1244. The Copy option allows you to copy text from the active window to the clipboard. You may then use Paste to copy that text to another (or the same) edit window. 
  1245. Using a mouse: E
  1246. Select the text to be copied. Then click on Edit, followed by Copy. 
  1247. Using the keyboard: 4
  1248. Select the text to be copied. Then press Ctrl-Ins. ]
  1249. The text will remain as is in the active window and will also be available in the clipboard 
  1250. The Edit
  1251. Copy command leaves the selected text intact but places an exact copy of it in the Clipboard. You can then paste that text into any edit window by choosing Paste. 
  1252. THelpTopic    
  1253.  Edit
  1254. Paste 
  1255. Paste   Shift+Ins [
  1256. The Paste option alows you to copy text from the clipboard to the the active edit window. 
  1257. Using a mouse: q
  1258. Move the cursor to the point where you wish to insert the clipboard text. Then click on Edit followed by Paste. 
  1259. Using the keyboard: X
  1260. Move the cursor to the place you want to put the clipboard text. Then press Shift-Ins. h
  1261. The text will be inserted into the active window at that point and will remain as is in the clipboard. 
  1262. The Edit
  1263. Paste command inserts from the Clipboard into the current edit window at the cursor position. The text that is pasted is the currently marked block in the Clipboard window. 
  1264. THelpTopic
  1265.  Edit
  1266. Show Clipboard 
  1267. Show Clipboard 
  1268. The Show Clipboard option opens a window and displays the current contents of the clipboard. These contents can, themselves be edited. T
  1269. Click on Edit, then Show Clipboard or press Alt-E, then S to activate this option. 
  1270. The Edit
  1271. Show Clipboard command opens the Clipboard window, which stores the text you cut and copy from other windows. The text that's currently selected (highlighted) is the text ToolDriver uses when you choose Paste. 
  1272. You can think of the Clipboard window as a history list of your cuts and copies. You can edit the Clipboard so that the text you paste is precisely the text you want. ToolDriver uses whatever text is selected in the Clipboard when you choose Paste. 
  1273. The Clipboard window is just like other edit windows; you can move it, resize it, and scroll and edit its contents. The only difference you'll find in the Clipboard window is when you choose to cut or copy text. When you select text in the Clipboard window and choose Cut or Copy, the selected text immediately appears at the bottom of the window. (Remember, any text you cut or copy is appended to the end of the Clipboard and highlighted - so you can paste it later. 
  1274. THelpTopic
  1275.  Search 
  1276. Search menu   Alt+S C
  1277. The Search menu lets you search and replace text in edit windows. 
  1278. It has three options - 
  1279.  Find
  1280.  Replace
  1281.  Find
  1282. Again
  1283. THelpTopic
  1284.  Search
  1285. Find 
  1286. Find Ctrl+Q+F 
  1287. The Search
  1288. Find command displays the Find Text dialog box, which lets you type in the text you want to search for and set options that affect the search. 
  1289. The Find Text dialog box 
  1290.   Find Text  
  1291.  Text to Find 
  1292. aardvark                               
  1293.  Options                  
  1294.  (X) Case Sensitive      
  1295.  ( ) Whole words only    
  1296.   OK  
  1297.   Cancel  
  1298. The Find Text dialog box contains several buttons and check boxes: 
  1299.     Check the Case Sensitive box if
  1300.  (X) Case sensitive 
  1301.     you do want ToolDriver to
  1302.     differentiate uppercase from
  1303.                            lowercase.
  1304.   Check the Whole words Only box if
  1305.  ( ) Whole words only 
  1306.   you want ToolDriver to search for
  1307.   whole words only. (that is, the
  1308.                            string must have punctuation or
  1309.                            space characters on both sides)
  1310. THelpTopic    
  1311.  Search
  1312. Replace 
  1313. Replace Ctrl+Q+A a
  1314. The Replace option allows you to transform occurances of a selected string with another string. -
  1315. Following is the dialog for replacing text. 
  1316. The Replace Text dialog box S
  1317.   Replace Text  
  1318.  Text to Find 
  1319. aardvark                               
  1320.   New text     
  1321. platypus                               
  1322.  Options                  
  1323.  (X) Case Sensitive      
  1324.  ( ) Whole words only    
  1325.  ( ) Prompt on replace   
  1326.  ( ) Replace all         
  1327.   OK  
  1328.   Cancel  
  1329. The Replace Text dialog box contains several radio buttons and check boxes - many of which are identical to the Find Text dialog box, discussed previously. An additional checkbox, Prompt on Replace, controls whether you want to be prompted for each change. 
  1330. Enter the search string and the replacement string in the input boxes and choose OK to begin the search or Cancel to not do it. If you want to enter a string you used previously, press 
  1331.  to show a history list to choose from. 
  1332. If ToolDriver finds the specified text and Prompt on Replace is on, it asks you if you want to make the replacement. If you choose OK, it will find and replace the first instance of the search item. 
  1333. THelpTopic
  1334.  Search
  1335. Search Again 
  1336. Search Again  Ctrl+L 
  1337. The Search
  1338. Search Again command repeats the last Find or Replace command.  All settings you made in the last dialog box used (Find or Replace) remain in effect when you choose Search Again. 
  1339. THelpTopic
  1340.  FileXref 
  1341. FileXref   Alt+X 
  1342. The FileXref menu item is the place to go when you want to see how your text files relate to one another. It is also where you can find the global usage of words (data names, function names, language verbs, etc.) throughout your source and documentation files (any text files). 
  1343. The menu item is named FileXref since it uses the ConVal FILEXREF.EXE program to do the cross referencing. This program may also be used independently of the ToolDriver environment. View or print the separate FileXref User's Guide kept in text file FILXRF.DOC. 1
  1344. There are four supporting options on this menu: j
  1345.  Files
  1346. cross
  1347. reference
  1348.  Words
  1349. cross
  1350. reference
  1351.  Start
  1352. cross
  1353. referencing
  1354.  View
  1355. output
  1356. THelpTopic
  1357.  FileXref
  1358. Files 
  1359. Files to cross reference 
  1360. This is where you identify which files you want cross referenced. You do this by creating a list of those file names. A dialog
  1361. box is used for this. 
  1362. THelpTopic
  1363.  FileXref
  1364. Files Dialog 
  1365. The files dialog is used to find out how you want to define the files to be cross referenced. q
  1366.   Files to be cross referenced 
  1367. [X]  Generate a file list for me 
  1368.      using the directory tree starting with: 
  1369. C:\PROJECT1                             
  1370.   OK  
  1371.   Cancel  
  1372. If you check the check box and enter a directory name (as above) or drive (like C:), then a list will be prepared for you. It will be written to file FILEXREF.FSL (File Specification List). The list will include files in the directory entered and in its subdirectories and their subdirectories (the directory tree). 
  1373. In any case you will be presented with an edit window for this file. So the content of the file edit window will be what was just generated if you checked the check box, or it will be as delivered on the installation disk, or as most recently edited by you. F
  1374. Following are representative entries in the file specification list: |
  1375.  C:\PROJECT1\SOURCE\SAMPLE01.C
  1376.  C:\PROJECT1\SOURCE\SAMPLE02.C
  1377.  C:\PROJECT1\INCLUDE\MYSAMP.H
  1378.  D:\PROJECT1\DOCS\OVERVIEW.DOC
  1379. Start each line in colum one and press Enter for each line. ]
  1380. Press F3 to save your changes or F4 to close the window (this will cause a prompt to save). 
  1381. NOTE: The editor works with files up to 64K. This will handle hundreds of file names. If your application is larger than this we assume you have an editor! Drop out of ToolDriver, edit the list with that editor, and return to ToolDriver to do the cross referencing. 
  1382. THelpTopic
  1383.  FileXref
  1384. Words 
  1385. Words to cross reference 
  1386. ToolDriver, as installed, provides a starter file of words to cross reference. This file is named FILEXREF.WSL (Word Specification List). When you first select this option you will see the starter list. It contains entries like !
  1387.   I  re*
  1388.   X  return
  1389.   X  break
  1390. The I/X means to Include or eXclude. The entry I re* asks that words starting with the characters re be included in the word usage report. The entry X return says to exclude the word "return". (The starter list excludes the C keywords. The last entry shown is not required (break does not start with "re"). However, it is not considered an error. This allows you to keep a list of words to be excluded (like language keywords) regardless of the words you are currently including. 
  1391. THelpTopic
  1392.  FileXref
  1393. Start 
  1394. Start cross referencing 
  1395. Once you've set up the list of files to be examined and (optionally) the words to search for, select this menu item to have a cross referencing dialog. 
  1396. THelpTopic
  1397. The FileXref start dialog lets you define the type of output you'd like and whether you want to cross reference a list of words in addition to the filenames. Y
  1398.  Cross reference files (and words) 
  1399.  Type of output         
  1400.  Optional output            
  1401. ) Condensed reports 
  1402.  [ ] Cross reference words 
  1403.  ( ) Extended reports  
  1404.  ( ) Export file       
  1405.   OK  
  1406.  Cancel 
  1407. Three types of output are available. The condensed
  1408. report format displays file names only, without the path or file extension. It packs the most information in the smallest number of pages. The extended
  1409. report format displays the full file specification (drive, path, file name and extension). Export
  1410. file format provides a means for you to take the cross reference information and use it with other software (e.g. a database program). 
  1411. If you choose to cross reference words (by typing w or pressing the space bar when the cursor is on "Cross reference words"), the words you picked for inclusion and exclusion will be used. Otherwise the list of words will be ignored. l
  1412. Use File
  1413. Print to print file FILEXREF.RPT, the report file. Note: The reports require 132 print positions. 3
  1414. When you select condensed reports, the following: l
  1415.  Condensed File Cross Reference Report,
  1416.  Condensed Word Usage Report, and
  1417.  List of Unreferenced Files
  1418. will be written to file FILEXREF.RPT. &
  1419. Choosing extended reports will cause j
  1420.  Extended File Cross Reference Report,
  1421.  Extended Word Usage Report, and
  1422.  List of Unreferenced Files
  1423. to be written to file FILEXREF.RPT. "
  1424. Picking export files will create [
  1425.  cross reference data on file FILEXREF.XRF, and
  1426.  unused file data on file FILEXREF.FEI
  1427. THelpTopic
  1428. Condensed Reports C
  1429. The condensed style of reports identify files by their filename alone, without the drive, path, and file extension. Below is a condensed file cross reference report. The center column lists every file examined, sorted by file name. To the left are the files that reference it and to the right are those that it refereces. ,
  1430. The Condensed File Cross Reference Report 
  1431.  09/19/92  FileXref     CONDENSED FILE CROSS REFERENCE REPORT     Page 1
  1432.  LIST OF REFERENCING FILES      FILENAME    LIST OF REFERENCED FILES
  1433.  ----------------------------   ========    ----------------------------
  1434.                               - FILEXRF  -
  1435.            PACKLIST  TOOLDRIV - HISTORY  -
  1436.                               - NAMECHNG -  README
  1437.                               - PACKLIST -  HISTORY   README    REGISTER
  1438.                                             TOOLDRIV
  1439.  NAMECHNG  PACKLIST  TOOLDRIV - README   -
  1440.            PACKLIST  TOOLDRIV - REGISTER -
  1441.                      PACKLIST - TOOLDRIV -  HISTORY   README    REGISTER
  1442. *** End of report M
  1443. The optional condensed word usage report shows each word (and word prefix) requested, and the files that reference them. !
  1444. The Condensed Word Usage Report 
  1445.  09/19/92 05:33:38 FileXref  CONDENSED WORD USAGE REPORT     Page 1
  1446.  WORD                        IS REFERENCED BY FILENAME(S):
  1447.  --------------------------  ---------------------------------------
  1448.  However                     FILEXRF
  1449.  Hungarian                   NAMECHNG
  1450.  I                           FILEXRF  HISTORY  NAMECHNG README  REGISTER
  1451.                              TOOLDRIV
  1452.  IBM                         NAMECHNG TOOLDRIV
  1453.  IBM-compatible              TOOLDRIV
  1454.  IBMPRO                      HISTORY
  1455.  ID                          NAMECHNG
  1456.  IDE                         TOOLDRIV
  1457.  IMS                         NAMECHNG
  1458.  INCLUDE                     FILEXRF  NAMECHNG TOOLDRIV
  1459. *** End of report M
  1460. Below we see a list of files that were referenced by no other files.  So this list will contain top level components (and old obsolete components) of the application. '
  1461. The List of Unreferenced Files Report 
  1462.  09/19/92  05:33:39  FileXref   LIST OF UNREFERENCED FILES      Page  1
  1463.               FILENAME  TYPE    PATH
  1464.               --------  ---    -------------------------
  1465.               FILEXRF   DOC     C:\TOOLDRIV\
  1466.               NAMECHNG  DOC     C:\TOOLDRIV\
  1467.               PACKLIST  DOC     C:\TOOLDRIV\
  1468. *** End of report M
  1469. THelpTopic
  1470. Extended Reports 
  1471. The extended report style identifies files with their full file specification. If your filenames alone are not unique, then this report style may be more useful to you. *
  1472. The Extended File Cross Reference Report 
  1473.  09/19/92  05:37:40    EXTENDED FILE CROSS REFERENCE REPORT       Page   1
  1474.  FILE SPECIFICATION - REFERS TO: FILE SPECIFICATION   - REFERS TO:  FILENAME
  1475.  --------------------------      ---------------------------------  --------
  1476.                                - C:\TOOLDRIV\FILEXRF.DOC         -
  1477.  C:\TOOLDRIV\PACKLIST.DOC      - C:\TOOLDRIV\HISTORY.DOC         -
  1478.  C:\TOOLDRIV\TOOLDRIV.DOC      -                                 -
  1479.                                - C:\TOOLDRIV\NAMECHNG.DOC        -  README
  1480.                                - C:\TOOLDRIV\PACKLIST.DOC        -  HISTORY
  1481.                                -                                 -  README
  1482.                                -                                 -  REGISTER
  1483.                                -                                 -  TOOLDRIV
  1484.  C:\TOOLDRIV\NAMECHNG.DOC      - C:\TOOLDRIV\README.DOC          -
  1485.  C:\TOOLDRIV\PACKLIST.DOC      -                                 -
  1486.  C:\TOOLDRIV\TOOLDRIV.DOC      -                                 -
  1487.  C:\TOOLDRIV\PACKLIST.DOC      - C:\TOOLDRIV\REGISTER.DOC        -
  1488.  C:\TOOLDRIV\TOOLDRIV.DOC      -                                 -
  1489.  C:\TOOLDRIV\PACKLIST.DOC      - C:\TOOLDRIV\TOOLDRIV.DOC        -  HISTORY
  1490.                                -                                 -  README
  1491.                                -                                 -  REGISTER
  1492. *** End of report M
  1493. The Extended Word Usage Report 
  1494.  09/19/92 05:33:38 FileXref  EXTENDED WORD USAGE REPORT     Page 1
  1495.  WORD                   IS REFERENCED BY FILENAME(S):
  1496.  --------------------   ------------------------------------------
  1497.  However                C:\TOOLDRIV\FILEXRF.DOC
  1498.  Hungarian              C:\TOOLDRIV\NAMECHNG.DOC
  1499.  I                      C:\TOOLDRIV\FILEXRF.DOC
  1500.                         C:\TOOLDRIV\HISTORY.DOC
  1501.                         C:\TOOLDRIV\NAMECHNG.DOC
  1502.                         C:\TOOLDRIV\README.DOC
  1503.                         C:\TOOLDRIV\REGISTER.DOC
  1504.                         C:\TOOLDRIV\TOOLDRIV.DOC
  1505.  IBM                    C:\TOOLDRIV\NAMECHNG.DOC
  1506. *** End of report M
  1507. THelpTopic
  1508. Export files 
  1509. The quote and comma delimited export files (see below) are provided so you can import them into your software. You can then further process the data and/or produce custom reports of your own design. 
  1510. File FILEXREF.XRF is used for the cross reference export data. It contains a symbol in the first column. The second column contains the referencing file's file specification. The last column has six flags. The following table defines the meaning of these flags. 
  1511. Export file flags v
  1512.  123456
  1513.  ------
  1514.       The symbol in the first column is:
  1515.  1.....     a filename.
  1516.  .1....     a whole word.
  1517.  ..1...     a word prefix.
  1518.  ...1..     an expansion of a word prefix.
  1519.  ....1. The symbol was referenced.
  1520.  .....1 The symbol was marked for inclusion.
  1521. The following shows typical data in the cross reference export data file.  The first row shows that the symbol"HISTORY" was referenced by a file named PACKLIST.DOC. The flags for this symbol tell that it is a file, that it was referenced (every entry in this file will be so marked), and that it was marked for inclusion. (All files are automatically marked for inclusion by default. !
  1522. The Cross reference export data n
  1523.  "HISTORY","C:\TOOLDRIV\PACKLIST.DOC","100011"
  1524.  "HISTORY","C:\TOOLDRIV\TOOLDRIV.DOC","100011"
  1525.  "README","C:\TOOLDRIV\NAMECHNG.DOC","100011"
  1526.  "README","C:\TOOLDRIV\PACKLIST.DOC","100011"
  1527.  "README","C:\TOOLDRIV\TOOLDRIV.DOC","100011"
  1528.  "REGISTER","C:\TOOLDRIV\PACKLIST.DOC","100011"
  1529.  "REGISTER","C:\TOOLDRIV\TOOLDRIV.DOC","100011"
  1530.  "TOOLDRIV","C:\TOOLDRIV\PACKLIST.DOC","100011"
  1531.  "re*","C:\TOOLDRIV\FILEXRF.DOC","001101"
  1532.  "re*","C:\TOOLDRIV\HISTORY.DOC","001101"
  1533.  "re*","C:\TOOLDRIV\NAMECHNG.DOC","001101"
  1534.  "re*","C:\TOOLDRIV\README.DOC","001101"
  1535.  "re*","C:\TOOLDRIV\REGISTER.DOC","001101"
  1536.  "re*","C:\TOOLDRIV\TOOLDRIV.DOC","001101"
  1537.  "reach","C:\TOOLDRIV\TOOLDRIV.DOC","000101"
  1538.  "read","C:\TOOLDRIV\FILEXRF.DOC","000101"
  1539.  "read","C:\TOOLDRIV\NAMECHNG.DOC","000101"
  1540. Below is an example of the export data for unreferenced files. None of these files was referenced by any other file examined. $
  1541. The Unreferenced files export data 
  1542.  "C:\TOOLDRIV\FILEXRF.DOC","100001"
  1543.  "C:\TOOLDRIV\NAMECHNG.DOC","100001"
  1544.  "C:\TOOLDRIV\PACKLIST.DOC","100001"
  1545. THelpTopic
  1546.  FileXref
  1547. View 
  1548. View the output log ?
  1549. This command gives you a file viewer window to browse the messages about the cross referencing. These document the scope of the run (files and words specified, options, and record counts). You can use File
  1550. Print to get a hardcopy of this output log to file with the reports.  The name of the log file is FILEXREF.MSG. 
  1551. THelpTopic
  1552.  NameChanger 
  1553. NameChanger menu Alt+N N
  1554. Use the NameChanger menu whenever you want to go back and make your naming conventions consistent across your application(s). You might decide to do this after each revision level is complete to keep order. And, now that you have such a tool, you may want to go back to some older code you're still maintaining and clean it up, too. 
  1555. You will also want to use the NameChanger menu when you have successful code on one platform and want to port it to another. Download non-DOS code to your PC, do the renaming, and recompile on DOS. Or, do renaming, upload to a non-DOS platform and recompile there. 
  1556. This command invokes a DOS program - NAMEC.EXE. To see how to use this directly from a DOS command line, see the separate NameChanger User's Guide in text file NAMECHNG.DOC. 
  1557. NameChanger writes its output files to its subdirectory WORK.  It is recommended that you keep this directory empty between renamings.  That will allow you to perform the following steps until you have the transform rules exactly as you want them: 
  1558.  1. refine the list of files    NameChanger
  1559. Files
  1560.  2. refine the transform rules  NameChanger
  1561. Names
  1562.  3. run NameChanger             NameChanger
  1563. Start
  1564.  4. examine the output files    NameChanger
  1565. THelpTopic
  1566.  NameChanger
  1567. Files 
  1568. Files to process \
  1569. This is where you identify the files to be processed by NameChanger. A dialog
  1570. box is used. 
  1571. THelpTopic    
  1572. The NameChanger files dialog lets you select how you want to define the files to be name-changed. q
  1573.   Files with names to be changed 
  1574. [X]  Generate a file list for me 
  1575.      using the directory:  
  1576. C:\PROJECT1                             
  1577.   OK  
  1578.   Cancel  
  1579. If you check the check box and enter a directory (as above) or drive (like C:), then a list will be prepared for you. It will be written to file NAMEC.FSL (File Specification List). The list will include only those files in the directory entered. 
  1580. In any case you will be presented with an edit window for this file. So the content of the file edit window will be what was just generated if you checked the check box, or it will be as delivered on the installation disk, or as most recently edited by you. 3
  1581. Typical lines in this file (NAMEC.FSL) look like: 
  1582.  V    255   C:\PROJECT1\TST01.CPP
  1583.  V    255   C:\PROJECT1\TST02.CPP
  1584.  V    255   C:\PROJECT1\TST03.CPP
  1585.  F 80    C:\PROJECT2\REPORT01.COB
  1586.  F 80    C:\PROJECT2\REPORT02.COB
  1587. Each line describes one file. The first column defines whether the lines in the file must all be the same length. Code F (fixed) or V (variable). The second column tells the maximum length for an output record (or actual in the case of fixed length records). The last column gives the file specification.  The file format code ( F or V) must begin in the first column of the line. One or more spaces separate the columns. Press Enter after each line. ]
  1588. Press F3 to save your changes or F4 to close the window (this will cause a prompt to save). 
  1589. NOTE: The editor can work with files to 64K. This will handle hundreds of file names.  If your application is larger than this we assume you have an editor! Drop out of ToolDriver, edit the list with that editor, and return to ToolDriver to change names. 
  1590. THelpTopic    
  1591.  NameChanger
  1592. Names 
  1593. Names to be changed 
  1594. This is and edit window where you define the names you want to be changed. A file editor window will be displayed so you can add one line for each name change. To change "cat", "Cat", and "CAT" to "Dog", type 
  1595. I    cat      Dog 
  1596. That's all there is to it - The letter "I" tells the program to be Insensitive to case.  Type one or more spaces after the case sensitivity code, start typing the old word, type one or more spaces, type the new word exactly as it is to appear, then press Enter. o
  1597. To change "Alpha" to "Beta" , while leaving "ALPHA" (and "AlPhA") unchanged, the entry should look like this: 
  1598. S Alpha Beta 
  1599. This change will be Sensitive to the case of the old name. It will not alter the word alpha unless the case of each letter matches exactly. 
  1600. The case sensitivity code (I or S) must start in the first column of each line.  When you've entered all the names to be changed, press F3 to save the file, and then F4 to close the file editor window. It will be saved as filename NAMEC.SRL (Symbol Rename List). 
  1601. THelpTopic
  1602.  NameChanger
  1603. Start 
  1604. Start name changing w
  1605. After you've defined the files and names to be changed, select the "Start name changing" dialog.  It looks like this: 
  1606.  Change names 
  1607.  NOTE: Output files will be written to this  
  1608.       directory:                            
  1609.  C:\TOOLDRIV\WORK 
  1610. [ ] Delete prior output
  1611.   OK  
  1612.  Cancel 
  1613. Whenever you do name changing, the output files will be written to a ToolDriver's subdirectory named WORK. This is the WORK directory's only purpose. Your files will never be rewritten in place! If you are rerunning a name changing task, no work will be performed if any output file already exists on the ToolDriver WORK subdirectory. 
  1614. To delete ALL files in the ToolDriver WORK directory, check the checkbox.  As a final precaution, you will be asked to confirm the deletion, when the process starts. This is a reminder to move our prior ouput to a permanent home in another directory before renaming other projects. When the changing of names is complete, you will be presented with a file viewer window to browse a log of the renamming activity. This file is NAMEC.MSG. 
  1615. THelpTopic
  1616.  NameChanger
  1617. View 
  1618. View the output files 
  1619. Select this option to inspect the results of your name changing. The following dialog lets you select a file on the ToolDriver WORK directory (where NameChanger places its output). ,
  1620. The View the name-changed files dialog box 
  1621.  View a File 
  1622.  Name
  1623.  *.*                              
  1624.  Open  
  1625.  Files                               
  1626.  FILEXREF.RPT      
  1627.   TST01.C       
  1628.   Cancel 
  1629.  FILEXREF.DOC      
  1630.   TST02.CPP     
  1631.  HISTORY.DOC       
  1632.   TST03.H       
  1633.  NAMECHNG.DOC      
  1634.   TST04.PAS     
  1635.  PACKLIST.DOC      
  1636.   ..\           
  1637.  REGISTER.DOC      
  1638.                 
  1639.  TOOLDRIV.DOC      
  1640.                 
  1641.      
  1642. C:\TOOLDRIV\WORK\*.*                               
  1643. FILEXREF.RPT 88722           Sep 18,1992   08:25a  
  1644. See the View
  1645. file dialog description for a review of using this dialog. 
  1646. THelpTopic
  1647.  Window 
  1648.  (Alt-W)
  1649. Window menu   Alt+W `
  1650. The Window menu contains commands to close, move and perform other window-management commands. 
  1651. Most of the windows in this program have all the standard window elements, including scroll bars, a close box, and zoom icons. !
  1652.  The Window-management commands
  1653.  Size/Move        Zoom
  1654.  Tile             Cascade
  1655.  Next             Previous
  1656.  Close
  1657. THelpTopic
  1658.  Window
  1659. Size/Move 
  1660.      (Ctrl-F5)
  1661. Size/Move  Ctrl+F5 J
  1662. Choose this command to change the size or position of the active window. 
  1663. When you choose this command, the active window moves in response to the arrow keys. When the window is where you want, press Enter. You can also move a window by dragging its title bar. 
  1664. If you press Shift while you use the arrow keys, you can change the size of the window. When it's the size you want, press Enter. If a window has a resize corner, you can drag that corner or any other corner to resize it. 
  1665. THelpTopic
  1666.  Window
  1667. Zoom 
  1668.    (F5)
  1669. Zoom F5 
  1670. Choose Zoom to resize the active window to the maximum size. If the window is already zoomed, you can choose this command to restore it to its previous size. {
  1671. You can also double-click anywhere on the window's title bar (except where an icon appears) to zoom or unzoom the window. 
  1672. THelpTopic
  1673.  Window
  1674. Tile 
  1675. Tile O
  1676. Choose Window
  1677. Tile to arrange all your open windows like tiles on the screen. L
  1678.                
  1679.                
  1680.                
  1681.                
  1682.                
  1683.                
  1684.                
  1685.                
  1686.                
  1687.                
  1688.                
  1689.                
  1690.                
  1691.                
  1692.                
  1693.                
  1694.              Tiled Windows
  1695. THelpTopic
  1696.  Window
  1697. Cascade 
  1698. Cascade Choose Window
  1699. Cascade to stack all file viewers on the desktop. A
  1700.                          
  1701.                          
  1702.                          
  1703.                          
  1704.                          
  1705.         Cascaded Windows
  1706. Choose Window
  1707. Cascade to stack all open windows so the top of each (with its window number) shows. 
  1708. THelpTopic
  1709.  Window
  1710. Next 
  1711. Next F6 
  1712. Choose Window
  1713. Next to make the next window active and visible.  Using F6 repeatedly will cycle forward through the windows on the desktop. 
  1714. THelpTopic
  1715.  Window
  1716. Previous 
  1717. Previous   Shift+F6 ~
  1718. Choose Window
  1719. Previous to make the prior window active and visible, or to cycle backward through the windows on the desktop. 
  1720. THelpTopic
  1721.  Window
  1722. Close 
  1723.     (F4)
  1724. Close   F4 *
  1725. Choose Close to close the active window. h
  1726. You can also click the Close box in the upper left corner to close a window. Or press function key F4. 
  1727. THelpTopic
  1728.   Help 
  1729. Help menu  Alt+H 
  1730. The help menu gives you access to online help in a special window. The help text contains all of the ToolDriver User's Guide and more.  There is help information on virtually all aspects of the ToolDriver environment. To open a Help window, do one of these actions: a
  1731.  Press F1 at any time (including from any dialog box or when any menu
  1732.    command is selected).
  1733.  Click Help on the status line.
  1734. The exception to this is when your're already in a help screen. 
  1735. To close the Help window, press Esc, click the close box, or choose window
  1736. Close. Help windows must be closed to do work on non-help windows. S
  1737. Help screens often contain keywords (highlighted text) that you can choose to get more information. Press Tab to move to any keyword; press Enter to get more detailed help. (As an alternative, move the cursor to the highlighted keyword and press Enter.) With a mouse, you can double-click any keyword to open the Help text for that item. 
  1738. When you're in a detailed help screen (you got there from another help screen by selecting a keyword) and you want to go back to the previous help, press Alt+F1. By doing this repeatedly you can back-track to the original help screen where you selected the first keyword. (
  1739. There are two items in the help menu - 
  1740.  Contents
  1741.  Index
  1742. See the Contents menu item for a high level overview from which you may browse successively lower levels of detail by tabing to highlighted topics and pressing Enter (or clicking on them). j
  1743. The Index menu item presents an alphabetically ordered list of items which index key concepts and words. 
  1744. THelpTopic
  1745.  Contents 
  1746. Contents 
  1747. The Help
  1748. Contents command opens the Help window with the main table of contents displayed. From this window, you can branch to other parts of the help system. 
  1749. By browsing the Contents option and tabbing to subtopics you will get a top-down presentation of the functions and facilities in FileXref and NameChanger with ToolDriver. 
  1750. THelpTopic
  1751.  Index    
  1752. Index j
  1753. The Help
  1754. Index command displays an alphabetical list of items discussed in the ToolDriver documentation. 
  1755. Tab to the item you want and press Enter, or Tab to the "next page" keyword and press Enter to see the next page of keywords. 5
  1756. Use Alt+F1 to get back to the previous help screen. 
  1757. THelpIndexx
  1758. ]h the main table of contents displayed.  From this window, you can branch to any other part of the help system. 
  1759. You can get help on Help by pressing F1 when the Help window is active. You can also reach this screen by clicking Help on the status line. 
  1760. Index 
  1761. The Help
  1762. Index command displays a full list of Help keywords (the special highlighted text in Help screens that let you quickly move to a related screen). These are arranged in alphabetical order. 
  1763. Tab to the item you want and press Enter, or Tab to the "next page" keyword and press Enter to see the next page of keywords. 5
  1764. Use Alt+F1 to get back to the previous help screen. 
  1765. THelpIndexd
  1766. ]hat item. 
  1767. When you're in a detailed help screen (you got there from another help screen by selecting a keyword) and you want to go back to the previous help, press Alt+F1. By doing this repeatedly you can back-track to the original help screen where you selected the first keyword. 
  1768. Contents 
  1769. The Help
  1770. Contents command opens the Help window with the main table of contents displayed.  From this window, you can branch to any other part of the help system. 
  1771. You can get help on Help by pressing F1 when the Help window is active. You can also reach this screen by clicking Help on the status line. 
  1772. Index 
  1773. The Help
  1774. Index command displays a full list of Help keywords (the special highlighted text in Help screens that let you quickly move to a related screen). These are arranged in alphabetical order. 
  1775. Tab to the item you want and press Enter, or Tab to the "next page" keyword and press Enter to see the next page of keywords. 5
  1776. Use Alt+F1 to get back to the previous help screen. 
  1777. THelpIndexd
  1778. ]restore it to its previous size. You can also double-click anywhere on the top line (except where an icon appears) of a window to zoom or unzoom it. 
  1779. Tile O
  1780. Choose Window
  1781. Tile to arrange all your open windows like tiles on the screen.     
  1782. Cascade d
  1783. Choose Window
  1784. Cascade to stack all open windows so the top of each (with its window number) shows.     
  1785. Next F6 @
  1786. Choose Window
  1787. Next to make the next window active and visible. 
  1788. Previous   Shift+F6 E
  1789. Choose Window
  1790. Previous to make the prior window active and visible. 
  1791. Close   F4 *
  1792. To close the current window, press F4. 
  1793.                                                                     Page  39
  1794. THelpTopic
  1795. Help menu  Alt+H 
  1796. The help menu gives you access to online help in a special window. There is help information on virtually all aspects of the ToolDriver environment. To open a Help window, do one of these actions: a
  1797.  Press F1 at any time (including from any dialog box or when any menu
  1798.    command is selected).
  1799.  Click Help on the status line.
  1800. To close the Help window, press Esc, click the close box, or choose Window
  1801. Close. You can keep the Help window onscreen while you work in another window unless you pressed F1. S
  1802. Help screens often contain keywords (highlighted text) that you can choose to get more information. Press Tab to move to any keyword; press Enter to get more detailed help. (As an alternative, move the cursor to the highlighted keyword and press Enter.) With a mouse, you can double-click any keyword to open the Help text for that item. 
  1803. When you're in a detailed help screen (you got there from another help screen by selecting a keyword) and you want to go back to the previous help, press Alt+F1. By doing this repeatedly you can back-track to the original help screen where you selected the first keyword. 
  1804. Contents 
  1805. The Help
  1806. Contents command opens the Help window with the main table of contents displayed.  From this window, you can branch to any other part of the help system. 
  1807. You can get help on Help by pressing F1 when the Help window is active. You can also reach this screen by clicking Help on the status line. 
  1808. Index 
  1809. The Help
  1810. Index command displays a full list of Help keywords (the special highlighted text in Help screens that let you quickly move to a related screen). These are arranged in alphabetical order. 
  1811. Tab to the item you want and press Enter, or Tab to the "next page" keyword and press Enter to see the next page of keywords. 5
  1812. Use Alt+F1 to get back to the previous help screen. 
  1813. THelpIndexn
  1814. ]tory list. Click the icon to display the list. You'll find text you typed the last few times you used the input box. Press Enter to choose an item from this list. The Find box, for example, has such a history list, which keeps track of the text you searched for previously. Try choosing a previous search string. You can also edit an entry in the history list. Press Esc to exit from the history list without making a selection.
  1815.                                                                     Page  20
  1816. A final component of many dialog boxes is a list box, which lets you scroll through and select from variable-length lists (often file names) without leaving a dialog box. If a blinking cursor appears in the list box and you know what you're looking for, you can type the word (or the first few letters of the word) and ToolDriver will search for it. 
  1817. You make a list box active by clicking it or by choosing the highlighted letter of the list title (or press Tab until it's highlighted). Once a list box is displayed, you can use the scroll box to move through the list or press the up and down arrows from the keyboard. )
  1818. SECTION 4: Menus and options reference (
  1819. This section provides a reference to each ToolDriver menu option. It's arranged in the order that the menus appear on the screen. For information on starting and exiting ToolDriver, and general information on how the user interface works, see Section 1. l
  1820. Next to some of the menu option descriptions in this reference you'll see keyboard shortcuts, or hot keys. 
  1821.  (System) menu  Alt+Spacebar The 
  1822.  menu appears on the far left of the menu bar. Alt+Spacebar is the fastest way to get there. When you pull down the menu (by using the down arrow) you see two commands, Register and Product Information. 
  1823. Register Choose 
  1824. Register to print a ToolDriver Registration form. A file print dialog will be presented, with the file REGISTER.DOC selected. Just press enter to print the registration form. 
  1825. Product Information The 
  1826. Product Information menu command displays the version of ToolDriver you are running. The same information displays when you initially bring up ToolDriver. Put this information away by pressing enter. 
  1827. File menu  Alt+F The file menu lets you open and view files in a file viewer window. It also lets you print files, change the working directory, shell to DOS and exit the ToolDriver environment.  
  1828.                                                                     Page  21
  1829. View F2 The File
  1830. View command displays a file-selection dialog box for you to select a text file to open in a file viewer window. Here is what the box looks like: "
  1831. Figure 2: View a File dialog box 
  1832.  View a File 
  1833.  Name
  1834.  *.*                              
  1835.  Open  
  1836.  Files                               
  1837.  CRE8FSL.EXE       
  1838.   FILEXREF.WSL  
  1839.   Cancel 
  1840.  FILELIST.EXE      
  1841.   FILEXREF.XRF  
  1842.  FILEXREF.BAK      
  1843.   HISTORY.DOC   
  1844.  FILEXREF.EXE      
  1845.   NAMEC.EXE     
  1846.  FILEXREF.FEI      
  1847.   NAMEC.FSL     
  1848.  FILEXREF.FSL      
  1849.   NAMEC.MSG     
  1850.  FILEXREF.MSG      
  1851.   NAMEC.SRL     
  1852. FILEXREF.RPT
  1853.      
  1854.   \WORK         
  1855.      
  1856. C:\TOOLDRIV\*.*                                    
  1857. FILEXREF.RPT 133153          Sep 01,1992   09:15a  
  1858. The dialog box contains an input box, a file list, buttons labeled, Open and Cancel, and an information panel that describes the selected file. Now you can do any of these actions: _
  1859.  Type in a full file name and choose Open.  Open loads the file into a fil
  1860.    viewer window.
  1861.  Type in a file name with wildcards, which filters the file list to match
  1862.    your specifications.
  1863.  Press  to choose a file specification from a history list of file
  1864.    specifications you've entered earlier.
  1865.  View the contents of different directories by selecting a directory name
  1866.    in the file list.
  1867. The input box lets you enter a file name explicitly or enter a file name with standard DOS wildcards (* and ?) to filter the names appearing in the history list box. If you enter the entire name and press enter, ToolDriver opens it for viewing. "
  1868. If you press 
  1869.  when the cursor is blinking in the input box, a history list drops down below
  1870.  22 the box. This list displays the last 15 file names or file name masks you've entered. Choose a name from the list by double-clicking it or selecting it with the arrow keys and pressing Enter. 
  1871. Once you've typed in or selected the file you want, choose the Open button (choose Cancel if you change your mind). You can also just press Enter once the file is selected, or you can double-click the file name in the file list. /
  1872. Using the file list box The File list box displays all file names in the current directory that match the specifications in the input box, displays the parent directory, and displays all subdirectories. Click the list box or press Tab until the list box name is highlighted. You can now press 
  1873.  to select a filename and then press Enter to open it. You can also double-click any file name in the box to open it. You might have to scroll the box to see all the names. If you have more than one panel of names, you can also use the left and right arrows. 
  1874. The file information panel at the bottom of the View a file dialog box displays path name, file name, date, time and size of the file you've selected in the list box. As you scroll through the list box, the panel is updated for each file. 
  1875. Print The File
  1876. Print command displays a file-selection dialog box for you to select a text file to be printed. It looks and functions like the File
  1877. View command except that the output will be routed to your printer instead of a file viewer. H
  1878. Change Dir The File
  1879. Change Dir command lets you specify a drive and a directory to make current.  The current directory is the one ToolDriver uses for viewing and printing files. Note that FileXref and NameChanger will always reset the current directory to the ToolDriver installation directory where its control files reside. ;
  1880. Here is what the Change Directory dialog box looks like:
  1881.                                                                     Page  23
  1882. Figure 3: Change Directory dialog box 
  1883.  Change Directory 
  1884.  Directory Name 
  1885.  C:\TOOLDRIV                      
  1886.  Directory Tree                      
  1887.  Drives                             
  1888.   OK     
  1889.         C:\                   
  1890.      
  1891.         
  1892. TOOLDRIV            
  1893.      
  1894.   Chdir  
  1895.           
  1896. WORK              
  1897.      
  1898.                               
  1899.      
  1900.   Revert 
  1901.                               
  1902.      
  1903.                               
  1904.      
  1905.                               
  1906.      
  1907.                                     
  1908. There are two ways to change directories: J
  1909.  Type in the path of the new directory in the input box and press Enter
  1910.  Choose the directory you want in the directory tree (if you're using the
  1911.    keyboard, press Enter to make it the current directory), then choose OK o
  1912.    press Esc.
  1913. If you choose the OK button, your changes are made and the dialog box is closed. If you choose the Chdir button, the Directory Tree list box changes to the selected directory and displays the subdirectories of the currently highlighted directory (pressing Enter or double- clicking on that entry gives you the same result). If you change your mind about the directory you've picked and you want to go back to the previous one (and you've yet to exit the dialog box), choose the Revert button. 
  1914. Running commands under the FileXref and NameChanger menus automatically changes the directory to the ToolDriver installation directory where their program and help files reside. 
  1915. DOS Shell The File
  1916. DOS Shell command lets you temporarily exit ToolDriver to enter a DOS command or program. To return to ToolDriver, type EXIT and press Enter. 
  1917. Don't install any TSR programs (like SideKick) or print a file with the DOS print command while you've shelled to DOS, because memory may be misallocated.
  1918.                                                                     Page  24
  1919. Quit    Alt+Q The File
  1920. Quit command exits ToolDriver and removes it from memory. If you have made any changes you haven't saved, ToolDriver asks if you want to save them before exiting. 
  1921. Edit menu     Alt+E The Edit menu lets you cut, copy, and paste text in edit windows. You can also open a Clipboard window to view or edit its contents. 
  1922. An edit window is only created by ToolDriver, to support the creation and modification of input files used by the FileXref and NameChanger utilities. Edit (and Search) menu commands are disabled otherwise. 0
  1923. A file edit window is presented in four cases: z
  1924.  after processing the FileXref
  1925. Generate dialog (This allows you to modify
  1926.    the list of files to be cross referenced.)
  1927.  after choosing the FileXref
  1928. Edit command (This allows you to modify a lis
  1929.    of words to be cross referenced.) (You do not need to list the names of
  1930.    any files here - they are automatically cross referenced.)
  1931.  after processing the NameChanger
  1932. Generate dialog (This allows you to
  1933.    modify the list of files to be name-changed.)
  1934.  after choosing the NameChanger
  1935. Edit command (This allows you to specify
  1936.    the names to be changed and what they are to be changed to.) (Names may b
  1937.    file names; variable names; i.e. any complete symbol)
  1938. Before you can use most of the commands on the edit menu, you need to know about selecting text (because most editor actions apply to selected text). Selecting text means highlighting it. You can select text either with keyboard commands or with a mouse; the principle is the same even though the actions are different. 
  1939. From the keyboard =
  1940.  Press Shift while pressing any key that moves the cursor.
  1941. Using a mouse 
  1942.  To select text with a mouse, drag the mouse pointer over the desired text
  1943.    If you need to continue the selection past a window's edge, just drag off
  1944.    the side and the window automatically scrolls.
  1945.  To select a single word, double-click it.
  1946.                                                                     Page  25
  1947.  To extend or reduce the selection, Shift-click anywhere in the document
  1948.    (that is, hold Shift and click). Once you've selected text, the Cut and
  1949.    Copy commands in the Edit menu become available.
  1950. The Clipboard is the magic behind cutting and pasting. It's a special window that holds text you cut or copied, so you can paste it elsewhere. The Clipboard works in close concert with the commands in the Edit menu. 9
  1951. Here's an explanation of each command in the Edit menu. G
  1952. Cut    Shift+Del The Edit
  1953. Cut command removes the selected text from your document and places the text in the Clipboard. You can then paste that text into any other document (or somewhere else in the same document) by choosing Paste. The text remains selected in the Clipboard so that you can paste the same text many times. 
  1954. Copy Ctrl+Ins The Edit
  1955. Copy command leaves the selected text intact but places an exact copy of it in the Clipboard. You can then paste that text into any other document by choosing Paste. 
  1956. Paste   Shift+Ins The Edit
  1957. Paste command inserts from the Clipboard into the current edit window at the cursor position. The text that is pasted is the currently marked block in the Clipboard window. 
  1958. Show Clipboard The Edit
  1959. Show Clipboard command opens the Clipboard window, which stores the text you cut and copy from other windows. The text that's currently selected (highlighted) is the text ToolDriver uses when you choose Paste. 
  1960. You can think of the Clipboard window as a history list of your cuts and copies. You can edit the Clipboard so that the text you paste is precisely the text you want. ToolDriver uses whatever text is selected in the Clipboard when you choose Paste. 
  1961. The Clipboard window is just like other edit windows; you can move it, resize it, and scroll and edit its contents. The only difference you'll find in the Clipboard window is when you choose to cut or copy text. When you select text in the Clipboard window and choose Cut or Copy, the selected text immediately appears at the bottom of the window. (Remember, any text you cut or copy is appended to the end of the Clipboard and highlighted - so you can paste it later.
  1962.                                                                     Page  26
  1963. Search menu   Alt+S The Search menu lets you search and replace text in edit windows. 
  1964. Find Ctrl+Q+F The Search
  1965. Find command displays the Find Text dialog box, which lets you type in the text you want to search for and set options that affect the search. $
  1966. Figure 4: The Find Text dialog box 
  1967.   Find Text  
  1968.  Text to Find 
  1969.                          
  1970.  Options                  
  1971.  (X) Case Sensitive      
  1972.  ( ) Whole words only    
  1973.   OK  
  1974.   Cancel  
  1975. The Find Text dialog box contains several buttons and check boxes: 
  1976.     Check the Case Sensitive box if
  1977.  (X) Case sensitive 
  1978.     you do want ToolDriver to
  1979.     differentiate uppercase from
  1980.                            lowercase.
  1981.   Check the Whole words Only box if
  1982.  ( ) Whole words only 
  1983.   you want ToolDriver to search for
  1984.   whole words only. (that is, the
  1985.                            string must have punctuation or
  1986.                            space characters on both sides)
  1987.                                                                     Page  27
  1988. Replace Ctrl+Q+A Following is the dialog for replacing text. '
  1989. Figure 5: The Replace Text dialog box 
  1990.   Replace Text  
  1991.  Text to Find 
  1992.                          
  1993.  New Text 
  1994.                          
  1995.  Options                  
  1996.  (X) Case Sensitive      
  1997.  ( ) Whole words only    
  1998.  ( ) Prompt on replace   
  1999.  ( ) Replace all         
  2000.   OK  
  2001.   Cancel  
  2002. The Replace Text dialog box contains several radio buttons and check boxes - many of which are identical to the Find Text dialog box, discussed previously. An additional checkbox, Prompt on Replace, controls whether you want to be prompted for each change. 
  2003. Enter the search string and the replacement string in the input boxes and choose OK to begin the search or Cancel to not do it. If you want to enter a string you used previously, press 
  2004.  to show a history list to choose from. 
  2005. If ToolDriver finds the specified text and Prompt on Replace is on, it asks you if you want to make the replacement. If you choose OK, it will find and replace the first instance of the search item. 
  2006. Search Again  Ctrl+L The Search
  2007. Search Again command repeats the last Find or Replace command. All settings you made in the last dialog box used (Find or Replace) remain in effect when you choose Search Again.
  2008.                                                                     Page  28
  2009. FileXref   Alt+X The FileXref menu item is the place to go when you want to see how your text files relate to one another. It is also where you can find the global usage of words (data names, function names, language verbs, etc.) throughout your source and documentation files (any text files). 
  2010. The menu item is named FileXref since it uses the ConVal FILEXREF.EXE program to do the cross referencing. This program may also be used independently of the ToolDriver environment (see the separate FileXref User's Guide) 1
  2011. There are four supporting options on this menu: j
  2012.  Files to cross reference
  2013.  Words to cross reference
  2014.  Start cross referencing
  2015.  View the output log
  2016. Files to cross reference This is where you identify which files you want cross referenced. You do this by creating a list of those file names. The dialog box you use looks like this: $
  2017. Figure 6: Files to cross reference q
  2018.   Files to be cross referenced 
  2019. [X]  Generate a file list for me 
  2020.      using the directory tree starting with: 
  2021. C:\PROJECT1                             
  2022.   OK  
  2023.   Cancel  
  2024. If you check the check box and enter a directory (as above) or drive (like C:), then a list will be prepared for you. It will be written to file FILEXREF.FSL (File Specification List). The list will include files in the directory entered and in its subdirectories and their subdirectories (the directory tree). 
  2025. In any case you will be presented with an edit window for this file. So the content of the file edit window will be what was just generated if you checked the check box, or it will be as delivered on the installation disk, or as most recently edited by you. 
  2026.                                                                     Page  29
  2027. Following are representative entries in the file specification list: x
  2028. C:\PROJECT1\SOURCE\SAMPLE01.C C:\PROJECT1\SOURCE\SAMPLE02.C C:\PROJECT1\INCLUDE\MYSAMP.H D:\PROJECT1\DOCS\OVERVIEW.DOC =
  2029. Start each line in colum one and press Enter for each line. ]
  2030. Press F3 to save your changes or F4 to close the window (this will cause a prompt to save). 
  2031. NOTE: The editor's capability is limited to 64K. This will handle several thousand file names. If your application is larger than this we assume you have an editor! Drop out of ToolDriver, edit the list with that editor, and return to ToolDriver to do the cross referencing. 
  2032. Words to cross reference ToolDriver, as installed, provides a starter file of words to cross reference. This file is named FILEXREF.WSL (Word Specification List). When you first select this option you will see the starter list. It contains entries like !
  2033.   I  re*
  2034.   X  return
  2035.   X  break
  2036. The I/X means to Include or eXclude. The entry I re* asks that words starting with the characters re be included in the word usage report. The entry X return says to exclude the word "return". (The starter list exclude the C keywords. The last entry shown is not required (break does not start with "re"). However, it is not considered an error. This allows you to keep a list of words to be excluded (like language keywords) regardless of the words you are currently including. 
  2037. Start cross referencing Once you've set up the list of files to be examined and (optionally) the words to search for, select this menu item to initiate cross referencing.
  2038.                                                                     Page  30
  2039. This is what the associated dialog looks like: ,
  2040. Figure 7: The Cross reference files dialog Y
  2041.  Cross reference files ( and words) 
  2042.  Type of output         
  2043.  Optional output            
  2044.  ( ) Condensed reports 
  2045.  [ ] Cross reference words 
  2046.  ( ) Extended reports  
  2047.  ( ) Export file       
  2048.   OK  
  2049.  Cancel 
  2050. Three types of output are available. The condensed report format displays file names only, without the path or file extension. It packs the most information in the smallest number of pages. The extended report format displays the full file specification (drive, path, file name and extension). Export file format provides a means for you to take the cross reference information and use it with other software (e.g. a database program). 
  2051. If you choose to cross reference words (by typing w or pressing the space bar when the cursor is on "Cross reference words"), the words you picked for inclusion and exclusion will be used. Otherwise the list of words will be ignored. l
  2052. Use File
  2053. Print to print file FILEXREF.RPT, the report file. Note: The reports require 132 print positions. 4
  2054. When you select condensed reports, the following: m
  2055.  Condensed File Cross Reference Report,
  2056.  Condensed Word Usage Report, and
  2057.  List of Unreferenced Files
  2058. will be written to file FILEXREF.RPT. &
  2059. Choosing extended reports will cause j
  2060.  Extended File Cross Reference Report,
  2061.  Extended Word Usage Report, and
  2062.  List of Unreferenced Files
  2063. to be written to file FILEXREF.RPT.
  2064.                                                                     Page  31
  2065. Picking export files will create [
  2066.  cross reference data on file FILEXREF.XRF, and
  2067.  unused file data on file FILEXREF.FEI
  2068. Condensed Reports The condensed style of reports identify files by their filename alone, without the drive, path, and file extension. Figure 8 shows a condensed file cross reference report. The center column lists every file examined, sorted by file name. To the left are the files that reference it and to the right are those that it refereces. 2
  2069. Figure 8: Condensed File Cross Reference Report M
  2070.  09/19/92  FileXref     CONDENSED FILE CROSS REFERENCE REPORT      Page   1
  2071.  LIST OF REFERENCING FILES      FILENAME    LIST OF REFERENCED FILES
  2072.  ----------------------------   ========    -------------------------------
  2073.                               - FILEXRF  -
  2074.            PACKLIST  TOOLDRIV - HISTORY  -
  2075.                               - NAMECHNG -  README
  2076.                               - PACKLIST -  HISTORY   README    REGISTER
  2077.                                             TOOLDRIV
  2078.  NAMECHNG  PACKLIST  TOOLDRIV - README   -
  2079.            PACKLIST  TOOLDRIV - REGISTER -
  2080.                      PACKLIST - TOOLDRIV -  HISTORY   README    REGISTER
  2081. In Figure 9 you see the optional condensed word usage report. This shows each word (and word prefix) requested, and the files that reference them. (
  2082. Figure 9: Condensed Word Usage Report E
  2083.  09/19/92 05:33:38 FileXref  CONDENSED WORD USAGE REPORT     Page 1
  2084.  WORD                            IS REFERENCED BY FILENAME(S):
  2085.  ------------------------------  -------------------------------------------
  2086.  However                         FILEXRF
  2087.  Hungarian                       NAMECHNG
  2088.  I                               FILEXRF  HISTORY  NAMECHNG README   REGISTE
  2089.                                  TOOLDRIV
  2090.  IBM                             NAMECHNG TOOLDRIV
  2091.  IBM-compatible                  TOOLDRIV
  2092.  IBMPRO                          HISTORY
  2093.  ID                              NAMECHNG
  2094.  IDE                             TOOLDRIV
  2095.  IMS                             NAMECHNG
  2096.  INCLUDE                         FILEXRF  NAMECHNG TOOLDRIV
  2097.                                                                     Page  32
  2098. In figure 10 we see a list of files that were referenced by no other files. So this list will contain top level components (and old obsolete components) of the application. '
  2099. Figure 10: List of Unreferenced Files L
  2100.  09/19/92  05:33:39  FileXref         LIST OF UNREFERENCED FILES      Page
  2101.               FILENAME  TYPE    PATH
  2102.               --------  ---    -------------------------
  2103.               FILEXRF   DOC     C:\TOOLDRIV\
  2104.               NAMECHNG  DOC     C:\TOOLDRIV\
  2105.               PACKLIST  DOC     C:\TOOLDRIV\
  2106. Extended Reports The extended report style identifies files with their full file specification. If your filenames alone are not unique, then this report style may be more useful to you. 2
  2107. Figure 11: Extended File Cross Reference Report M
  2108.  09/19/92  05:37:40    EXTENDED FILE CROSS REFERENCE REPORT            Page
  2109.  FILE SPECIFICATION - REFERS TO: FILE SPECIFICATION   - REFERS TO:  FILENAME
  2110.  --------------------------      ---------------------------------  --------
  2111.                                - C:\TOOLDRIV\FILEXRF.DOC         -
  2112.  C:\TOOLDRIV\PACKLIST.DOC      - C:\TOOLDRIV\HISTORY.DOC         -
  2113.  C:\TOOLDRIV\TOOLDRIV.DOC      -                                 -
  2114.                                - C:\TOOLDRIV\NAMECHNG.DOC        -  README
  2115.                                - C:\TOOLDRIV\PACKLIST.DOC        -  HISTORY
  2116.                                -                                 -  README
  2117.                                -                                 -  REGISTER
  2118.                                -                                 -  TOOLDRIV
  2119.  C:\TOOLDRIV\NAMECHNG.DOC      - C:\TOOLDRIV\README.DOC          -
  2120.  C:\TOOLDRIV\PACKLIST.DOC      -                                 -
  2121.  C:\TOOLDRIV\TOOLDRIV.DOC      -                                 -
  2122.  C:\TOOLDRIV\PACKLIST.DOC      - C:\TOOLDRIV\REGISTER.DOC        -
  2123.  C:\TOOLDRIV\TOOLDRIV.DOC      -                                 -
  2124.  C:\TOOLDRIV\PACKLIST.DOC      - C:\TOOLDRIV\TOOLDRIV.DOC        -  HISTORY
  2125.                                -                                 -  README
  2126.                                -                                 -  REGISTER
  2127.                                                                     Page  33
  2128. Figure 12: Extended Word Usage Report D
  2129.  09/19/92 05:33:38 FileXref  EXTENDED WORD USAGE REPORT     Page 1
  2130.  WORD                   IS REFERENCED BY FILENAME(S):
  2131.  --------------------   ------------------------------------------
  2132.  However                C:\TOOLDRIV\FILEXRF.DOC
  2133.  Hungarian              C:\TOOLDRIV\NAMECHNG.DOC
  2134.  I                      C:\TOOLDRIV\FILEXRF.DOC
  2135.                         C:\TOOLDRIV\HISTORY.DOC
  2136.                         C:\TOOLDRIV\NAMECHNG.DOC
  2137.                         C:\TOOLDRIV\README.DOC
  2138.                         C:\TOOLDRIV\REGISTER.DOC
  2139.                         C:\TOOLDRIV\TOOLDRIV.DOC
  2140.  IBM                    C:\TOOLDRIV\NAMECHNG.DOC
  2141.  ---------------------  ------------------------------------------
  2142. Export files The quote and comma delimited export files (see Figure 13) are provided so you can import them into your software. You can then further process the data and/or produce custom reports of your own design. 
  2143. File FILEXREF.XRF is used for the cross reference export data. It contains a symbol in the first column. The second column contains the referencing file's file specification. The last column has six flags. Their meaning is shown in the table following. 
  2144. Table 7: Export file flags 
  2145.  123456
  2146.  ------
  2147.       The symbol in the first column is:
  2148.  1.....     a filename.
  2149.  .1....     a whole word.
  2150.  ..1...     a word prefix.
  2151.  ...1..     an expansion of a word prefix.
  2152.  ....1. The symbol was referenced.
  2153.  .....1 The symbol was marked for inclusion.
  2154. The following shows typical data in the cross reference export data file. The first row shows that the symbol"HISTORY" was referenced by a file named PACKLIST.DOC. The flags for this symbol tell that it is a file, that it was referenced (every entry in this file will be so marked), and that it was marked for inclusion. (All files are automatically marked for inclusion by default. 
  2155.                                                                     Page  34
  2156. Figure 13: Cross reference export data 
  2157.  "HISTORY","C:\TOOLDRIV\PACKLIST.DOC","100011"
  2158.  "HISTORY","C:\TOOLDRIV\TOOLDRIV.DOC","100011"
  2159.  "README","C:\TOOLDRIV\NAMECHNG.DOC","100011"
  2160.  "README","C:\TOOLDRIV\PACKLIST.DOC","100011"
  2161.  "README","C:\TOOLDRIV\TOOLDRIV.DOC","100011"
  2162.  "REGISTER","C:\TOOLDRIV\PACKLIST.DOC","100011"
  2163.  "REGISTER","C:\TOOLDRIV\TOOLDRIV.DOC","100011"
  2164.  "TOOLDRIV","C:\TOOLDRIV\PACKLIST.DOC","100011"
  2165.  "re*","C:\TOOLDRIV\FILEXRF.DOC","001101"
  2166.  "re*","C:\TOOLDRIV\HISTORY.DOC","001101"
  2167.  "re*","C:\TOOLDRIV\NAMECHNG.DOC","001101"
  2168.  "re*","C:\TOOLDRIV\README.DOC","001101"
  2169.  "re*","C:\TOOLDRIV\REGISTER.DOC","001101"
  2170.  "re*","C:\TOOLDRIV\TOOLDRIV.DOC","001101"
  2171.  "reach","C:\TOOLDRIV\TOOLDRIV.DOC","000101"
  2172.  "read","C:\TOOLDRIV\FILEXRF.DOC","000101"
  2173.  "read","C:\TOOLDRIV\NAMECHNG.DOC","000101"
  2174. The next figure, shows the export data for unreferenced files. None of these files was referenced by any other file examined. +
  2175. Figure 14: Unreferenced files export data o
  2176.  "C:\TOOLDRIV\FILEXRF.DOC","100001"
  2177.  "C:\TOOLDRIV\NAMECHNG.DOC","100001"
  2178.  "C:\TOOLDRIV\PACKLIST.DOC","100001"
  2179. View the output log This command gives you a file viewer window to browse the messages about the cross referencing. These document the scope of the run (files and words specified, options, and record counts). You can use File
  2180. Print to get a hardcopy of this output log to file with the reports.  The name of the log file is FILEXREF.MSG. d
  2181. NameChanger menu Alt+N Use the NameChanger menu whenever you want to go back and make your naming conventions consistent across your application(s). You might decide to do this after each revision level is complete to keep order. And, now that you have such a tool, you may want to go back to some older code you're still maintaining and clean it up too. 
  2182. You will also want to use the NameChanger menu when you have successful code on one platform and want to port it to another. Download non-DOS code to your PC, do the renaming, and recompile on DOS. Or, do renaming, upload to a non-DOS platform and recompile there. 
  2183. This command invokes a DOS program - NAMEC.EXE. For information on using this directly from a DOS command line, see the separate NameChanger User's Guide.
  2184.                                                                     Page  35
  2185. Files to process This is where you identify the files to be processed by NameChanger. The dialog box you use looks like this: %
  2186. Figure 15: NameChanger Files dialog q
  2187.   Files with names to be changed 
  2188. [X]  Generate a file list for me 
  2189.      using the directory:  
  2190. C:\PROJECT1                             
  2191.   OK  
  2192.   Cancel  
  2193. If you check the check box and enter a directory (as above) or drive (like C:), then a list will be prepared for you. It will be written to file NAMEC.FSL (File Specification List). The list will include only those files in the directory entered. 
  2194. In any case you will be presented with an edit window for this file. So the content of the file edit window will be what was just generated if you checked the check box, or it will be as delivered on the installation disk, or as most recently edited by you. 3
  2195. Typical lines in this file (NAMEC.FSL) look like: 
  2196. V    255   C:\PROJECT1\TST01.CPP V    255   C:\PROJECT1\TST02.CPP V    255   C:\PROJECT1\TST03.CPP F 80    C:\PROJECT2\REPORT01.COB F 80    C:\PROJECT2\REPORT02.COB k
  2197. Each line defines one file. It defines whether the file is fixed length (F) or variable length (V), the maximum length for an output record (or actual in the case of fixed length records), and the file specification. The file format code ( F or V) must begin in the first column of the line. One or more spaces separate the columns. Press Enter after each line. ]
  2198. Press F3 to save your changes or F4 to close the window (this will cause a prompt to save). 
  2199. NOTE: The editor's capability is limited to 64K. This will handle several thousand file names.  If your application is larger than this we assume you have an editor! Drop out of ToolDriver, edit the list with that editor, and return to ToolDriver to change names.
  2200.                                                                     Page  36
  2201. Names to be changed This is where you define the names you want to be changed. A file editor window will be displayed so you can add one line for each name change. To change "cat", "Cat", and "CAT" to "Dog", type 
  2202. I    cat      Dog 
  2203. That's all there is to it - The letter "I" tells the program to be Insensitive to case.  Type one or more spaces after the case sensitivity code, start typing the old word, type one or more spaces, type the new word exactly as it is to appear, then press Enter. o
  2204. To change "Alpha" to "Beta" , while leaving "ALPHA" (and "AlPhA") unchanged, the entry should look like this: 
  2205. S Alpha Beta 
  2206. This change will be Sensitive to the case of the old name. It will not alter the word alpha unless the case of each letter matches exactly. 
  2207. The case sensitivity code (I or S) must start in the first column of each line.  When you've entered all the names to be changed, press F3 to save the file, and then F4 to close the file editor window. It will be saves as filename NAMEC.SRL (Symbol Rename List). 
  2208. Start name changing After you've defined the files and names to be changed, select the "Start name changing" dialog.  It looks like this: $
  2209. Figure 16: The Change names dialog 
  2210.  Change names 
  2211.  NOTE: Output files will be written to this  
  2212.       directory:                            
  2213.  C:\TOOLDRIV\WORK 
  2214. [ ] Delete prior output
  2215.   OK  
  2216.  Cancel 
  2217. Whenever you do name changing, the output files will be written to a ToolDriver's subdirectory named WORK. This is the WORK directory's only purpose. Your files will never be rewritten in place! If you are rerunning a name changing task, no work will be performed if any output
  2218.                                                                     Page  37
  2219. file already exists on the ToolDriver WORK subdirectory. To delete ALL files in the working directory, check the checkbox. As a final precaution, you will be asked to confirm the deletion, when the process starts. This is a reminder to move our prior ouput to a permanent home in another directory before renaming other projects. When the changing of names is complete, you will be presented with a file viewer window to browse a log of the renamming activity. This file is NAMEC.MSG. 
  2220. View the output files Select this option to inspect the results of your name changing. The following dialog lets you select a file on the ToolDriver working directory (where NameChanger places its output). 3
  2221. Figure 17: View the name-changed files dialog box 
  2222.  View a File 
  2223.  Name
  2224.  *.*                              
  2225.  Open  
  2226.  Files                               
  2227.  FILEXREF.RPT      
  2228.   TST01.C       
  2229.   Cancel 
  2230.  FILEXREF.DOC      
  2231.   TST02.CPP     
  2232.  HISTORY.DOC       
  2233.   TST03.H       
  2234.  NAMECHNG.DOC      
  2235.   TST04.PAS     
  2236.  PACKLIST.DOC      
  2237.   ..\           
  2238.  REGISTER.DOC      
  2239.                 
  2240.  TOOLDRIV.DOC      
  2241.                 
  2242.      
  2243. C:\TOOLDRIV\WORK\*.*                               
  2244. FILEXREF.RPT 88722           Sep 18,1992   08:25a  
  2245. See the "View a file" dialog description on page 21 for a review of using this dialog. 
  2246. Window menu   Alt+W The Window menu contains window-management commands. Most of the windows you open from this menu have all the standard window elements like scroll bars, a close box, and zoom boxes. Refer to page 15 for information on these elements and how to use them.
  2247.                                                                     Page  38
  2248. Size/Move  Ctrl+F5 Choose Window
  2249. Size/Move to change the size or position of the active window. 
  2250. When you choose this command, the active window moves in response to the arrow keys. When the window is where you want, press Enter. You can also move a window by dragging its title bar. 
  2251. If you press shift while you use the arrow keys, you can change the size of the window. When it's the size you want, press enter. If a window has a resize corner, you can drag that corner or any other corner to resize it. )
  2252. Zoom F5 Choose Window
  2253. Zoom to resize the active window to the maximum size. If the window is already zoomed, you can choose this command again to restore it to its previous size. You can also double-click anywhere on the top line (except where an icon appears) of a window to zoom or unzoom it. T
  2254. Tile Choose Window
  2255. Tile to arrange all your open windows like tiles on the screen. l
  2256. Cascade Choose Window
  2257. Cascade to stack all open windows so the top of each (with its window number) shows. I
  2258. Next F6 Choose Window
  2259. Next to make the next window active and visible. Y
  2260. Previous   Shift+F6 Choose Window
  2261. Previous to make the prior window active and visible. 5
  2262. Close   F4 To close the current window, press F4. 
  2263.                                                                     Page  39
  2264. Help menu  Alt+H The help menu gives you access to online help in a special window. There is help information on virtually all aspects of the ToolDriver environment. To open a Help window, do one of these actions: a
  2265.  Press F1 at any time (including from any dialog box or when any menu
  2266.    command is selected).
  2267.  Click Help on the status line.
  2268. To close the Help window, press Esc, click the close box, or choose Window
  2269. Close. You can keep the Help window onscreen while you work in another window unless you pressed F1. S
  2270. Help screens often contain keywords (highlighted text) that you can choose to get more information. Press Tab to move to any keyword; press Enter to get more detailed help. (As an alternative, move the cursor to the highlighted keyword and press Enter.) With a mouse, you can double-click any keyword to open the Help text for that item. 
  2271. When you're in a detailed help screen (you got there from another help screen by selecting a keyword) and you want to go back to the previous help, press Alt+F1. By doing this repeatedly you can back-track to the original help screen where you selected the first keyword. 
  2272. Contents The Help
  2273. Contents command opens the Help window with the main table of contents displayed.  From this window, you can branch to any other part of the help system. 
  2274. You can get help on Help by pressing F1 when the Help window is active. You can also reach this screen by clicking Help on the status line. 
  2275. Index The Help
  2276. Index command displays a full list of Help keywords (the special highlighted text in Help screens that let you quickly move to a related screen). These are arranged in alphabetical order. 
  2277. Tab to the item you want and press Enter, or Tab to the "next page" keyword and press Enter to see the next page of keywords. 7
  2278. Use Alt+F1 to get back to the previous help screen. 
  2279.                                                                     Page  40
  2280. INDEX (
  2281.  File
  2282.  export, file cross reference . . . . . . . . . . . . . . . . . . . .  . 33
  2283.  export, selecting. . . . . . . . . . . . . . . . . . . . . . . . . .  . 30
  2284.  export, unreferenced files . . . . . . . . . . . . . . . . . . . . .  . 34
  2285.  list, for cross referencing. . . . . . . . . . . . . . . . . . . . .  . 28
  2286.  list, for name changing. . . . . . . . . . . . . . . . . . . . . . .  . 35
  2287.  FILEXREF.EXE
  2288.  the cross reference tool . . . . . . . . . . . . . . . . . . . . . .  . 28
  2289.  FILEXREF.FEI
  2290.  the unreferenced files export file . . . . . . . . . . . . . . . . .  . 31
  2291.  FILEXREF.FSL
  2292.  the file specification list for FileXref . . . . . . . . . . . . . .  . 28
  2293.  FILEXREF.MSG
  2294.  the cross reference activity log . . . . . . . . . . . . . . . . . .  . 34
  2295.  FILEXREF.RPT
  2296.  the cross reference report file. . . . . . . . . . . . . . . . . . .  . 30
  2297.  the cross reference report file for FileXref . . . . . . . . . . . .  . 30
  2298.  FILEXREF.WSL
  2299.  file of words to be cross referenced . . . . . . . . . . . . . . . .  . 29
  2300.  FILEXREF.XRF
  2301.  the cross reference export file. . . . . . . . . . . . . . . . . .  31, 33
  2302.  Hot keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . m 13
  2303.  of cross referencing . . . . . . . . . . . . . . . . . . . . . . . .  . 34
  2304.  of name changing activity. . . . . . . . . . . . . . . . . . . . . .  . 37
  2305.  Name
  2306.  list for name changing . . . . . . . . . . . . . . . . . . . . . . .  . 36
  2307.  NAMEC.EXE
  2308.  the name-changing tool . . . . . . . . . . . . . . . . . . . . . . .  . 34
  2309.  NAMEC.FSL
  2310.  file of file names to be name-changed. . . . . . . . . . . . . . . .  . 35
  2311.  NAMEC.MSG
  2312.  file containing a log of the renamming process . . . . . . . . . . .  . 37
  2313.                                                                     Page  41
  2314.  NAMEC.SRL
  2315.  file of symbol renamming rules . . . . . . . . . . . . . . . . . . .  . 36
  2316.  report
  2317.  condensed file cross reference, example. . . . . . . . . . . . . . .  . 31
  2318.  condensed word usage, example. . . . . . . . . . . . . . . . . . . .  . 31
  2319.  creating . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  . 30
  2320.  extended file cross reference, sample. . . . . . . . . . . . . . . .  . 32
  2321.  extended word usage, sample. . . . . . . . . . . . . . . . . . . . .  . 33
  2322.  list of unreferenced files, sample . . . . . . . . . . . . . . . . .  . 32
  2323.  printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  . 30
  2324.  selecting the type of. . . . . . . . . . . . . . . . . . . . . . . .  . 30
  2325.  Word
  2326.  list for cross referencing . . . . . . . . . . . . . . . . . . . . .  . 30
  2327.   End of User Guide for ToolDriver
  2328. THelpIndexZ
  2329.