home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / TCAT110.ZIP / TCAT.HLP (.txt) < prev    next >
Borland Turbo Vision Help  |  1993-08-24  |  29KB  |  521 lines

  1.    TCAT Help Contents
  2.    1. General
  3. overview
  4.    2. Before
  5. begin
  6.    3. Mastering
  7.    4. What
  8. BEFORE
  9. archive
  10.    5. Cataloging
  11.    6. Software
  12. credit
  13.    7. User
  14. credit
  15.    8. TCAT
  16. Files
  17.    9. Registration
  18.   10. Index
  19. No help available for this context. 
  20.  (System) menu 
  21.     (Alt-Spacebar)
  22. The System menu appears on the far left of the menu bar and is represented by the 
  23.  symbol. (
  24. When you pull down the 
  25.  menu, you see 
  26.   About
  27.   Registration
  28. About 
  29. When you choose the About command from the 
  30.  (System) menu, a dialog box appears, showing copyright and version information. G
  31. To close the box, press Esc, Space, or Enter, or click the OK button. 
  32. Registration 
  33. When you choose the Registration command from the 
  34.  (System) menu, a help box appears, showing registration information. 
  35.  File  (Alt-F) 
  36. The File menu offers choices for opening/creating/importing databases, shelling to DOS, and exiting the program. @
  37.  Open
  38. Database      Exit
  39. Database       DOS
  40. Shell
  41.  Import
  42.  File
  43. New   (F4) 
  44. The New command is used to create a new database. This command will prompt you for the name of this new database. It will then open this new database automatically. 
  45.  File
  46. Import 
  47. The Import command is used to convert a Paradox database file into a TCAT database file. After selecting this command you will select the Paradox database file via a file
  48. dialog box. The next step is to instruct TCAT how to interpret your Paradox file by using a database
  49. interpretation
  50. dialog box. F
  51. Next, TCAT will sort this Paradox database and proceed to import it. J
  52. Finally, TCAT will prompt you for a name for the new TCAT database file. 
  53. **NOTE** If this option is disabled (grayed), it's because TCAT has found the Paradox directory specification to be invalid. Check to make sure your directories are properly specified in the directories configuration. 
  54.  File
  55. DOS Shell 
  56. With the DOS Shell command, you can leave the program temporarily to perform a DOS command or run another program. 9
  57. To return to this program, type EXIT at the DOS prompt. 
  58.  File
  59. Open  (F3) 
  60. The Open command displays the Open a File dialog box. In this dialog box you select the database file you want open. 
  61. The open
  62. dialog box contains: 
  63.  an input
  64. box with a history list
  65.  a list
  66. box to browse the directory
  67.  the standard Cancel button
  68.  Open action button
  69.  an information panel that describes the
  70.    selected file
  71.  File
  72. Exit 
  73.      (Alt-X)
  74. The Exit command terminates this program. 
  75.  Options  (Alt-O) 
  76. The Options menu contains commands that let you change default colors and directory settings. 
  77.  Options
  78. Colors... 
  79. The Colors item brings up the colors
  80. dialog box, where you can customize the colors of the display. 
  81.  Options
  82. Directories 
  83. The directories item brings up the directories
  84. dialog box, where you can specify directories that TCAT cares about. 
  85.  Help on the directories dialog box 
  86. The directories dialog box contains four input fields which specify directories of interest. p
  87.  TapeCat Directory 
  88.                                  
  89. This tells TCAT where to put its files. It will use this as a "work" directory as well as a place to store its database files, category listings, and other miscellaneous files. p
  90.  Colorado Directory 
  91.                                  
  92. TCAT needs to know where to find your Colorado tape software since it uses it to see what's on your tapes. p
  93.  Paradox Directory 
  94.                                  
  95. This is the default directory for importing. Exported TCAT entries are also written here. p
  96.  Listings Directory 
  97.                                  
  98. This is the default directory for listings of files and descriptions. 
  99.  Help on open a file dialog box 
  100. The Open a File dialog box contains an input box, a file
  101. list, a file information panel, the standard button Cancel, one other action button (Open), plus a history list that's attached to the name
  102. inputbox. 
  103.  Name 
  104.                                  
  105. 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, *.*). 
  106.  Files 
  107.                                  
  108.   FILENM01.TCT  
  109.   FILENM09.TCT  
  110.   FILENM02.TCT  
  111.   FILENM10.TCT  
  112.   FILENM03.TCT  
  113.   FILENM11.TCT  
  114.   FILENM04.TCT  
  115.   FILENM12.TCT  
  116.   FILENM05.TCT  
  117.   ..            
  118.   FILENM06.TCT  
  119.   \BACKUP       
  120.   FILENM07.TCT  
  121.                 
  122.   FILENM08.TCT  
  123.                 
  124. 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. 
  125.  C:\TC\*.TCT                              
  126.  MYFILES.TCT  16493  Jul 14,1990  12:00pm 
  127. The File information panel shows the path name, file name, date, time, and size of the selected file. =
  128. None of the items on this information panel are selectable. 
  129.  [ Open ] 
  130. The Open button opens a new tape database panel. 
  131.  [ Cancel ] 
  132. If you choose Cancel, nothing changes and no action occurs, and the dialog box is put away. M
  133. (Esc always cancels a dialog box, even if a Cancel button does not appear.) 
  134.  Help on the select directory dialog box 
  135. The Select Directory dialog box consists of a list box, the standard OK and Cancel buttons, and one other button (Revert). 
  136.  Directory Tree 
  137.    Drives                            
  138. C:\                            
  139.      
  140. UTIL                         
  141.        
  142. TCAT                       
  143. The Directory Tree list box enables you to navigate directories by using the selection bar and pressing Space. 
  144. If you're using the keyboard, press Space to make the selected directory be the current directory, then choose OK or press Enter to exit the dialog box. +
  145.  [Revert] 
  146. The Revert button goes back to the previous directory, as long as you haven't yet exited the dialog box. 
  147.  Help on the colors dialog box 
  148. The Colors dialog box consists of two list boxes, a text display area, the standard OK and Cancel buttons, and one of the following: 
  149.  On color and black-and-white systems, it
  150.    also contains two color palettes.
  151.  On monochrome systems, it contains a set
  152.    of radio buttons instead of the palettes.
  153. This dialog box is where you can change the colors of different parts of this program. 
  154.  Group 
  155.    Menus            
  156.    Dialogs #1       
  157.    Dialogs #2       
  158.    Dialogs #3       
  159.    Busy Windows     
  160.    Help             
  161.                     
  162. The Group list box contains the names of the different regions of the program that you can customize. L
  163.  Item 
  164.    Color            
  165.                     
  166. When you select a group from the Group list, the Item list box displays the names of the different views in that region. 
  167.  Foreground 
  168.  Background 
  169. On color and black-and-white systems, you use the Foreground and Background palettes to modify colors. 
  170.  Colors 
  171. ) Mono low        
  172.   ( ) Mono high       
  173.   ( ) Mono underscore 
  174.   ( ) Mono inverse    
  175. On monochrome systems, you use the Colors set of radio buttons systems to modify the character attributes. Q
  176.  Text Text Text 
  177.  Text Text Text 
  178. On all systems, the display text (above the Help button) shows the current color or attribute settings. a
  179. Changes do not take effect on the desktop until you close the Colors dialog box by choosing OK. 
  180.  Help on the tape base dialog box 
  181. The dialog box currently selected allows you to perform a number of operations to the loaded database. In this box there are nine buttons, some of the buttons perform operations on the database as a whole, the rest only perform on the highlighted tape entry. +
  182.  [ Open ] 
  183. Opens the currently selected tape and brings up a volume
  184. dialog
  185. box. 1
  186.  [ Export ] 
  187. Exports the current tape to Paradox format. The exported file is placed in the directory specified in the directories using the database name "TCEXPORT.DB". 
  188. Successive exports result in appends to the TCEXPORT.DB. TCAT tries to stop you from exporting the same tape to TCEXPORT twice. 
  189. **NOTE** If this button is disabled (grayed), it's because TCAT has found the Paradox directory specification to be invalid. Check to make sure your directories are properly specified in the directories configuration. (
  190.  [ Add ] 
  191. This command runs the Colorado tape software to extract all volumes and names from the tape in the drive (or files from a disk directory). TCAT then processes these names and prompts you for a tape name. The new tape is then added into the current database. 
  192. **NOTE** If this button is disabled (grayed), it's because TCAT cannot find a file called "TAPE.EXE" in the Colorado directory. Check to make sure your directories are properly specified in the directories configuration. .
  193.  [ Erase ] 
  194. Use this command to erase the highlighted tape entry from the list. 1
  195.  [ ExpTxt ] 
  196. Similar to [Export] only the entries are saved as ascii to a file called [DATABASE NAME].TXT. Where [DATABASE NAME] is the name of the database currently selected. This file is placed in the listings directory. 
  197. **NOTE** If this option is disabled (grayed), it's because TCAT has found the listings directory specification to be invalid. Check to make sure your directories are properly specified in the directories configuration. 1
  198.  [ Rename ] 
  199. Use this command to rename a tape. +
  200.  [ Pack ] 
  201. Erase commands which reside in three places (This dialog box, volume dialog box, and file entry dialog box), perform their function but do not actually remove the data from the file; The data is only marked as "dead". This command goes through the entire database and removes all "dead" data. 1
  202.  [ Search ] 
  203. This command brings up a prompt box for entering the search
  204. data. After which, TCAT searches all tapes**, and all volumes for the first 500 entries that contain filenames or descriptions with matching data (key is found in file name or description). f
  205. ** The search begins the currently selected tape and continues searching to the end of the database. 1
  206.  [ ChkDup ] 
  207. One of TCAT's "Power" features. This command looks at all files in a directory specified by you via a directory
  208. select
  209. dialog, and tries to find them in the TCAT database. Matching names represent duplicates. The names (if any) are placed in a duplicate
  210. viewer which is capable of deleting the duplicates at your command. ChkDup looks at the entire database, the tape selector plays no role. .
  211.  [ Close ] 
  212. Use this command to put away this dialog box. 
  213.  Help on the volume base dialog box 
  214. The dialog box currently selected allows you to perform a number of operations to the loaded tape. In this box there are five buttons. +
  215.  [ Open ] 
  216. Opens the currently selected volume and brings up a file
  217. entry
  218. dialog
  219. box. (
  220.  [ Add ] 
  221. This command runs the Colorado tape software to extract all volumes and names from the tape in the drive that don't already exist on the selected database tape. 
  222. **NOTE** If this button is disabled (grayed), it's because TCAT cannot find a file called "TAPE.EXE" in the Colorado directory. Check to make sure your directories are properly specified in the directories configuration. .
  223.  [ Erase ] 
  224. Use this command to erase a volume from the list. 1
  225.  [ Rename ] 
  226. Use this command to rename a volume. .
  227.  [ Close ] 
  228. Use this command to put away this dialog box. 
  229.  Help on the file base dialog box 
  230. The dialog box currently selected allows you to perform a number of operations to the loaded volume/file entry list. &
  231. In this box there are seven buttons. /
  232. There are two non-button fields of interest : '
  233. [  #1  ]
  234.                                               
  235.                                               
  236.                                               
  237.                                               
  238.                                               
  239.                                               
  240.  (------------------  #2  ------------------) 
  241.                                               
  242.                                               
  243. #1 - [ A / B ]  Where A is the number of described files in the list and B is the total number of files in the list. S
  244. #2 - The entire description viewer -OR- an input line for changing a description. 
  245. The buttons... +
  246.  [ Desc ] 
  247. Changes the description viewer to an input box and waits for your input. Press enter to accept the description and remove the input box and replace it with the viewer. =
  248.  [ Select Cat ] 
  249. Opens a category
  250. selector for you to select or add a new category. 4
  251.  [ Set Cat ] 
  252. Sets the category field of the current file entry to the last selected category. 1
  253.  [ Inject ] 
  254. One of TCAT's "Power" commands. Inject matches names from the file entry list to a master
  255. description
  256. database. If a match was found and the description in the database is longer than the one in the file entry list, the description in the file entry list is replaced. +
  257.  [ Dupe ] 
  258. Dupe is used to duplicate descriptions in a "smart" manner. Let's say you type in a description for "LOOM1.ZIP" and the description was "Loom, a new Apolgy game [1/3]". Now move to "LOOM2.ZIP" and press Dupe, this results in a description reading "Loom, a new Apolgy game [2/3]". .
  259.  [ Erase ] 
  260. Use this command to erase a file entry from the list. .
  261.  [ Close ] 
  262. Use this command to put away this dialog box. 
  263.  Help on the search results dialog box 
  264. This dialog box contains a list of matches to the search. 
  265. Press OK to close the box. @
  266. Press Save to add the text to a disk file called "SEARCH.TXT". 
  267.  Help on the category select dialog box 
  268. This dialog box manipulates a list of categories. (
  269.  [ Add ] 
  270. Use this command to add a category. 1
  271.  [ Delete ] 
  272. Use this command to delete the currently selected category from the list. 
  273. OK and Cancel work as normal. 
  274.  Help on the duplicate results dialog box 
  275. This dialog box contains a list of duplicates. A duplicate is defined as a filename found both on a specific directory on the hard disk as well as on some tape in the database. Two things may be done using the list of duplicates: 4
  276.  [ Del NOW ] 
  277. Deletes the currently selected file off the hard disk and removes it from the duplicate listing. 4
  278.  [ Gen bat ] 
  279. Generates a "$KILLDUP.BAT" and places it in the directory with the duplicates. This bat file is a simple list of "del DUPE1.ZIP, del DUPE2.ZIP, etc". .
  280.  [ Close ] 
  281. Use this command to put away this dialog box. 
  282. Enter the name for the database, 8 characters or less, and press ENTER. 
  283. Enter new volume name and press ENTER. 
  284. Enter keyword(s) to search for and press ENTER. 
  285. Enter new tape name and press ENTER. 
  286. Enter tape name and press ENTER. 
  287. Adding from tape retrieves file names from a tape adds a tape entry. y
  288. Adding from disk retrieves file names from a disk directory on your hard drive. This broadly expands TCAT applications! 
  289.  Help on the database interp. dialog box 
  290. This dialog box is used to define the fields of the Paradox database being imported. 
  291. For example, in order to import a database, that database must have a filename field. This is all TCAT knows. You must tell TCAT which field is the filename field. 
  292. The filename, extension, tape number, date, and size are required fields. In short, if any of these fields do not exist, the database cannot be imported. 
  293.  Help on the DEF edit dialog box 
  294. This dialog box is used to tell TCAT how to get useful information from a listing. 
  295. Here's a sample listing : 
  296.  ....|....1....|....2....|....3....|..
  297.  79  DJGPP-01.ZIP 1174k GCC C/C++ 32-Bit Compiler for DOS  [ 1/11]
  298.  80  DJGPP-02.ZIP 1172k GCC C/C++ 32-Bit Compiler for DOS  [ 2/11]
  299. The filename starts at column 5 and the description starts at column 24. 
  300. Plug 5 in the filename input and 24 in the description input. Then tab down to the listing window and pan it down and make sure TCAT is extracting both the names and descriptions properly. 
  301. Warning!! Only master linear listings. If the filename or description field shifts throughout the file, this may cause problems. Fortunately, TCAT is fairly leniant in this manner in that it will remove preceeding white spaces when parsing the string. 
  302. For example: )
  303.  ....|....1....|....2....|....3....|..
  304.  79  DJGPP-01.ZIP 1174k GCC C/C++ 32-Bit Compiler for DOS  [ 1/11]
  305.  80  DJGPP-02.ZIP 1172k GCC C/C++ 32-Bit Compiler for DOS  [ 2/11]
  306.  ..  -                  -
  307.  ..  -                  -
  308.  1000-RBBS17C.ZIP   311k-RBBS V17.3.C  [1/1]
  309.      -                  -
  310. A 5 for the filename and 24 for the description will work here because TCAT removes the preceeding white spaces. 
  311. This is very important!! If you add garbage to your master database, the only way to get rid of it is to erase MASTER.DB or edit it out by hand using Paradox. 
  312.  Help on the master list entry dialog box 
  313. This dialog box is meant for accumulating a list of lists to be added to the master description database. Once all the listings are [ADD]ed, press [GO] and they'll be processed. (PATIENCE!) 
  314.  Master (Alt-M) 
  315. The Master menu offers choices for performing operations on TCAT's master description database. 
  316.  Process
  317. DIZ's
  318.  Master
  319. Process List 
  320. This command brings up the master
  321. box to select listings to be mastered. 
  322. **NOTE** If this option is disabled (grayed), it's because TCAT has found the listings directory specification to be invalid. Check to make sure your directories are properly specified in the directories configuration. 
  323.  Master
  324. Get DIZ's 
  325. This command will prompt you for a directory using a directory
  326. select
  327. dialog. TCAT will then make use of PKUNZIP to extract the .DIZ descriptions from the files in this directory and add the filenames and descriptions to a list called "DIZ.LST" in the listings directory. You should then add this listing to your master database using the process
  328. list command. 
  329. **NOTE** If this option is disabled (grayed), it's because TCAT has found the listings directory specification to be invalid or PKUNZIP.EXE could not be found in your search path. Check to make sure your directories are properly specified in the directories configuration. 
  330.  Help (ALT-H) 
  331. When you pull this menu down, you see !
  332.   Contents
  333.   Index
  334.   What's
  335.  Help
  336. Contents 
  337. This command brings up the table of contents for the help. 
  338.  Help
  339. Index 
  340. This command brings up the index for the help. 
  341.  Help
  342. Whats New 
  343. This command shows revision history of TCAT. 
  344.  What's New 
  345. **** V1.10 ****  8/24/93  
  346.  ** NO BUG FIXES TO REPORT! **
  347.  Added [ExpTxt] button. Allows you to
  348.  export your tapes to ascii files.
  349.  Isolated desktop backdrop. You can
  350.  now make your own, or use the standard
  351.  checkerboard by deleting "TCAT.DRP".
  352.  See TCAT
  353. files.
  354.  Entire disk directories may be added
  355.  to the database as if they were tapes.
  356.  This is an extension of the [Add]
  357.  command on the database dialog box.
  358. **** V1.02 ****  8/16/93 
  359.  Multiple fixes in export.
  360.  Clarification of search function in help.
  361.  OOP Portion of database engine removed.
  362.  (Provides 60 more K of heap space and
  363.   probably more speed when importing)
  364. **** V1.01 ****  8/13/93 i
  365.  Bug fix in interrupt service routine.
  366.  (Caused TCAT to seize if executed after
  367.   certain applications)
  368.  Safety net added for loading files.
  369.  If memory drops below 20000, then
  370.  TCAT can't show you all the files on
  371.  that volume.
  372.  ** NOTE: If this should happen, all
  373.  changes made to this volume will be
  374.  lost since it would be wrong for TCAT
  375.  to save the file list if it couldn't
  376.  load it completely.
  377. **** V1.00 ****  8/9/93 
  378.  (First release)
  379.  New intro screens and backdrop.
  380. **** V0.80 **** (
  381.  Added registration and title screens.
  382.  Improved help text.
  383. **** V0.79 **** 
  384.  HELP System impovements:
  385.   * Cursor keys now allowed, improves feel.
  386.   * Previous topic hotkey.
  387.   * More help text, more help topics.
  388.  Bug fixed in adding tapes.
  389.  Shell to DOS command added.
  390.  Results of search may be saved to disk.
  391.  Ability to scan entire directories
  392.  of .ZIPs for FILE_ID.DIZ descriptors
  393.  and accumulates a listing to later be
  394.  mastered. (Get
  395. DIZ's)
  396.  TCAT Tape Cataloger 
  397. Welcome to TCAT!  TCAT is a top notch, cutting edge tape cataloging system placed on top of one of world's hottest and most intuitive user interfaces available (Turbo Vision). 
  398. A few features... }
  399.  * Designed to work with any version of
  400.    Colorado tape software.
  401.  * Quick searching.
  402.  * Ability to catch and easily remove
  403.    duplicates before they go on tape.
  404.  * Import from and export to the Paradox
  405.    database system.
  406.  * Context sensative help.
  407.  * Simple and powerful mechanism which
  408.    automatically describes your files.
  409.  * Excellent user interface with mouse
  410.    support.
  411.  Mastering 
  412. Under TCAT, "listings" are defined as being ascii lists of filenames and descriptions. Nearly all bulletin board systems have a mechanism for sending you their "listing". Since many of us get our files from BBS's, this mechanism allows us to describe our files with never imagined ease. /
  413. To use this system follow these simple steps: 
  414.  1. Get good listings, keep them up to date.
  415.  2. Process new listings. See process
  416. list.
  417.  3. Inject descriptions into your files.
  418.  Before you begin 
  419. The only configuration necessary before TCAT becomes fully functional is to tell it where certain files are located on your hard disk. This is done by selecting directories under the options menu. 
  420.  Before you archive 
  421. A typical scenario for archiving is to place a modest amount of files onto tape, label the tape, then erase the files. 
  422.  1. Are you sure there are no duplicates?
  423.  2. There maybe descriptor files in the .ZIP
  424.     to help you describe the files later.
  425. With TCAT in your arsenal, these issues are put to rest. 
  426. First select get
  427. DIZ's from the master menu. This will scan your files and make a list containing the filenames and associated descriptors found inside the .ZIP files (if any). {
  428. Next check for duplicates using the check duplicate [ChkDup] button. This will allow you to purge duplicates selectively. 
  429.  A few words about cataloging 
  430. The first thing you need to do is create a database for all your tapes, this is done by selecting new under the file menu. 
  431. Next, pop in your first tape and select [Add]. TCAT will collect the information off the tape and then prompt you for a tape number. 
  432. This tape has been cataloged but the files have not been described or categorized. Although describing and categorizing is purely optional, TCAT has good tools to aid you here. See mastering. 
  433.  Software credit 
  434.  * Paradox is a trademark of Borland
  435.    International.
  436.  * Colorado TAPE SYSTEM is copyrighted by
  437.    Colorado Memory Systems, Inc.
  438.  * PKUNZIP is a trademark of PKWARE, Inc.
  439.  User credit 
  440. I would like to thank all the beta testers who helped find most of the bugs as well as providing great ideas. Great job guys! 
  441.  Registration 
  442. TCAT is Shareware and represents many hours of grueling work. A registration fee of $15 is required and appreciated. d
  443. In return you will receive my thanks and the registration code to remove the unregistered message. N
  444. Please fill out the register form supplied with this program and send it to: K
  445.  Dave Sharpless
  446.  3712 N. Broadway Box #157
  447.  Chicago, IL  60613
  448.  Ref: TCAT
  449.  TCAT Files 
  450.  The files included in this are as follows:
  451.  TCAT.EXE      - Primary EXE
  452.  TCAT.OVR      - Code overlays
  453.  TCAT.HLP      - Help file
  454.  TCAT.DRP      - Back drop for desktop.
  455.                  Rename to .BIN and edit
  456.                  with an ANSI editor or
  457.                  make your own!
  458.  DIZ.DEF       - Ready made definition
  459.                  file for use with
  460.                  mastering DIZ
  461. lists.
  462.  REGISTER.FRM  - Form for registering TCAT.
  463.  FILE_ID.DIZ   - PCBoard or compatible
  464.                  BBS description.
  465. A couple suggested options for file placement: q
  466.  1. Place all the files in a directory
  467.     such as "\TCAT". Adding this
  468.     directory to your PATH is optional.
  469.  2. Place TCAT.* in a PATHed directory,
  470.     and place the remainder of the files
  471.     in a directory such as "\TCAT".
  472.  Index 
  473.  Before
  474. archiving
  475.  Before
  476. beginning
  477.  Cancel
  478. buttons
  479.  Cataloging
  480.  Category
  481. editor
  482.  Color
  483. changing
  484.  Database
  485. interpretation
  486. editor
  487.  Directory
  488. configuration
  489.  Directory
  490. selector
  491. lists
  492.  Duplicate
  493.  Exiting
  494.  File
  495. entries
  496.  General
  497. overview
  498.  Importing
  499.  Master
  500. entry
  501.  Master
  502. processing
  503.  Mastering
  504. database
  505.  Open
  506. database
  507.  Registering
  508.  Search
  509.  Shelling
  510.  Software
  511. credit
  512.  Tape
  513. listing
  514.  TCAT
  515. Files
  516.  User
  517. credit
  518.  Volume
  519. listing
  520.  What's
  521.