home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / c / cdpro12.zip / CDPRO12.DOC < prev    next >
Text File  |  1993-02-03  |  19KB  |  413 lines

  1.  
  2.                                    CD-ROM PRO
  3.                  Librarian/File Manager for CD-ROM Collections
  4.  
  5.                                   Version 1.2
  6.  
  7.                                    SHAREWARE
  8.                               All Rights Reserved
  9.                             (c) 1993 Vince Sorensen
  10.  
  11.       This program is shareware. If you continue to use it past the 30 day
  12.                       evaluation period, you must register.
  13.  
  14. ───────────────────────────────────────────────────────────────────────────────
  15. Registration Fee:    $15.00 (U.S. or Cdn)
  16. Author Address:      Vince Sorensen                BBS Info:
  17.                      6 Armstrong Bay                  Superboard 1:140/121
  18.                      Regina, Sk., Canada              (306)789-8682
  19.                      S4N 4G7                          14400 v.32/v.42bis
  20. ───────────────────────────────────────────────────────────────────────────────
  21. Registered Users receive the latest registered version on diskette, as well
  22. as CDPTOOLS (includes file repair, special sorting, and conversion programs).
  23. ───────────────────────────────────────────────────────────────────────────────
  24.  
  25. This program was written originally to keep track of what programs were on
  26. what CD-ROM, and to eliminate duplicate files on floppy. It allows the user to
  27. quickly find and view/run/copy any file on any CD-ROM, as well as reporting
  28. on duplication and/or unique files between CDs, whether in the user's
  29. collection or not. Text file format conversion is also supported, with
  30. the ability to fill in information found on the actual CD if it was not
  31. included in the text files originally.
  32.  
  33.  
  34.     Note: Pressing F1 gives context sensitive help wherever available.
  35.           The ESC key cancels most operations, and exits most screens
  36.           (without saving, where applicable).
  37.  
  38.  
  39. Quick Set-Up
  40. ────────────
  41.  
  42.     You should have a copy of CDP.EXE and CDP.HLP somewhere in your
  43.     path. The databases will be built in the current directory.
  44.  
  45.     To run this program:
  46.  
  47.     (1) You need text files containing the file listings for your CD-ROMs.
  48.     (2) Configure CD-ROM PRO File Manager to reflect your equipment
  49.         set-up, and use the "Format File Listings" option to enter the
  50.         format of the text files you will be importing (if not already
  51.         set up - some, such as PCBoard, already are). This means
  52.         checking the text files in (1) above, and noting the column
  53.         that the file name, date, size, and description information
  54.         begins in, and their length (in the case of the date, its format).
  55.         If a field is missing, set its column to zero. You can fill in
  56.         the date and size information later with the "Correct Date and
  57.         Size" function.
  58.     (3) If you will be importing a large number of text files, it is
  59.         recommended that you set up a file called "IMPORT.CNF" that
  60.         contains information on what CD and directory will be
  61.         imported, and which text file will contain the file names, etc.,
  62.         for that directory. The format of IMPORT.CNF is explained below
  63.         briefly, and in greater detail in the sample IMPORT.CNF enclosed
  64.         in this archive.
  65.         The "Import File Listings - Interactive" feature is more useful
  66.         for single directories, and novice users.
  67.     (4) Use one of the "Import File Listings" features to import the
  68.         information you require. This program will automatically detect
  69.         if one-line or multiple-line descriptions are being entered
  70.         (PCBoard or LongLine Formats Only).
  71.         ┌────────────────────────────────────────────────────────────────┐
  72.         │  ** ADVANCED USERS**   If you are already sure of the format,  │
  73.         │  you can press CTRL-I from the main menu to skip right to the  │
  74.         │  IMPORT.CNF importing without wading though the menus and      │
  75.         │  having to confirm that you want to go ahead.                  │
  76.         └────────────────────────────────────────────────────────────────┘
  77.  
  78.  
  79.                             ─────────────────────
  80.  
  81.  
  82.  
  83. IMPORT.CNF File Definition:
  84. ───────────────────────────
  85.  
  86. Source File Listing        Size:  25            Location:    1 - 25
  87. CD Title                   Size:  15            Location:   26 - 40
  88. Format                     Size:  10            Location:   41 - 50
  89. Location                   Size:  32            Location:   51 - 82
  90. Title                      Size:  40            Location:   83 -122
  91. Subscription               Size:  15            Location:  123 -138
  92.  
  93. A sample IMPORT.CNF is enclosed in this archive for your convenience.
  94.  
  95.  
  96.                             ─────────────────────
  97.  
  98.  
  99.  
  100. About File Listing Formats and Exporting File Listings:
  101. ───────────────────────────────────────────────────────
  102.  
  103. Using the Recreate File Listing option (also know as Create Listing of
  104. Files in a Directory) allows you to generate a formatted DOS file or
  105. printout of the list of files in a directory (not surprisingly!).
  106. All FILES.BBS file listings that are created using the "Re-Create/Print
  107. File Listings" option will use one-line descriptions, unless a "~", "|"
  108. is contained within the format name or one of the proprietary formats
  109. (described below - see "Format Conventions") is used.
  110.  
  111. Converting from a DOS file listing in one format to another will only
  112. convert the first line of each description, regardless of what multi-line
  113. options (as described below) are selected.
  114.  
  115. Format Conventions:
  116. ───────────────────
  117.  
  118. If the format title contains a "~" character, it indicates that the
  119. format is multi-line. The "~" should be followed by the number of lines
  120. of description allowed per file.
  121.  
  122.    I.E.:
  123.      MAXFMT~2 will output 2 line descriptions for each file.
  124.  
  125. If the format title contains a "|" character, it indicates that the
  126. description should be preceded by a "|". Note that the description
  127. is still placed at the position indicated in the format configuration.
  128. The "|" is placed two spaces before the description.
  129.  
  130. If both "|" and "~" are in the format title, the "|" is always placed
  131. before the 2nd and following lines, but only before the 1st line if
  132. the "|" precedes the "~".
  133.  
  134.     I.E.:
  135.        Taking the format "WILD" and simply changing the format name
  136.        has the following results:
  137.  
  138. If     WILD     outputs:      FILENAME.ZIP 91810 01-01-93  Description
  139.  
  140. then   WILD|    outputs:      FILENAME.ZIP 91810 01-01-93| Description
  141.  
  142. and    WILD|~2  outputs:      FILENAME.ZIP 91810 01-01-93| Description
  143.                                                          | Description Line 2
  144.  
  145. and    WILD~2|  outputs:      FILENAME.ZIP 91810 01-01-93  Description
  146.                                                          | Description Line 2
  147.  
  148. and    WILD~2   outputs:      FILENAME.ZIP 91810 01-01-93  Description
  149.                                                            Description Line 2
  150.  
  151. Also note that if there are not two spaces between the description and
  152. the previous field, and "|" is used, the previous field will be over-written.
  153.  
  154.  
  155.  
  156. Special Case (Proprietary Formats): If either the "PCBOARD" or
  157. "WILDCAT_2" file listing formats have been specified, special
  158. logic comes in to play to ensure the resulting FILES.BBS looks
  159. more like the proprietary formats used by these boards.
  160.  
  161. I.E.:
  162.  
  163. PCBOARD
  164. ARJ230.EXE    200363  02-07-92   This is what you'll use to extract files
  165.                                | that end in the ARJ extension. Its self-
  166.                                | extracting, so just type in ARJ230, and
  167.                                | then use the ARJ.EXE that comes out to
  168.                                | extract other files!
  169.  
  170. WILDCAT_2
  171. ARJ230.EXE    200,363   02/07/92 | This is what you'll use to extract files
  172. DwnLds: 3     DL Time   00:17:23 | that end in the ARJ extension.
  173.  
  174.  
  175.  
  176.                             ─────────────────────
  177.  
  178.  
  179. Program Parameters:
  180. ───────────────────
  181.  
  182. If you wish, you can specify the path to the databases when you
  183. start the program. For example,
  184.  
  185. CDP C:\DATA
  186.  
  187. would look in the C:\DATA directory for all five of the databases.
  188. Please note that the import file information routine does
  189. NOT look at this path. C:\DATA\ and C: are also valid paths.
  190.  
  191. This way you can access your CD from any directory, and even use
  192. the current directory as a default to copy/unzip to.
  193.  
  194. You can also specify exact directory and file names for each of
  195. the individual databases using switches:
  196.  
  197. /F=FILE INFORMATION PATH AND FILE NAME
  198. /D=DIRECTORY INFORMATION PATH AND FILE NAME
  199. /C=CONFIGURATION INFORMATION PATH AND FILE NAME
  200. /L=FILE LISTING FORMATS PATH AND FILE NAME
  201. /T=TEMPORARY FILE
  202.  
  203. Filenames must either not have an extension, or have the extension
  204. .DAT
  205.  
  206. You cannot, however, mix the general and specific paths together.
  207. I.E.
  208. CDP c:\data /f=c:\data\data\filedata.dat
  209. is not allowed.
  210.  
  211.  
  212.                             ─────────────────────
  213.  
  214.  
  215.  
  216. File Descriptions:
  217. ──────────────────
  218.  
  219. File descriptions are stored in a 1 line + 5 line format in order to save
  220. space... Since many CD-ROMs contain only 1 line descriptions, it would be
  221. wasteful to take up 6x48 bytes for every file's description when 48 would
  222. do. However, some CDs have PCBoard and 2 line style descriptions. This
  223. program determines if this is the case, and stores the 2nd and following
  224. lines in a special field that is only placed in records when necessary,
  225. saving the extra 240 bytes for each files with only a one-line description.
  226. On the tables of files shown in the program, only the first or first two
  227. lines are shown, and CTRL-D can be used to view the complete record.
  228. All searches check within the entire description, however.
  229.  
  230. Here's a sample screen of the extended description popped-up over the main
  231. file listing:
  232.  
  233. 42BOOT.ZIP       10210  4/08/92 Package th╔══════════════════════╗ot MS-DOS
  234.                                 MY CD-ROM ║ EXTENDED DESCRIPTION ║lternate Op. S
  235. 4CASE16.ZIP   ╔═══════════════════════════╝──────────────────────╢like case
  236.               ║ 42BOOT.ZIP       10210  4/08/92                  ║lternate Op. S
  237. 4DDBU512.ZIP  ║                                                  ║
  238.               ║ Package that allows you to dual boot MS-DOS      ║lternate Op. S
  239. 4DESC307.ZIP  ║ or DR-DOS easily using 4DOS' aliasing and INI    ║ber for
  240.               ║ (autoexecpath) capabilities to enhance /         ║lternate Op. S
  241. 4EDIT110.ZIP  ║ simplify booting up either operating system;     ║ creating &
  242.               ║ original config/autoexec are no longer used,     ║lternate Op. S
  243. 4LASER.ZIP    ║ so install programs which mangle... etc.         ║or sending
  244.               ║                                                  ║lternate Op. S
  245. 4LOGIC10.ZIP  ║ MY CD-ROM 7                                      ║ featuring
  246.               ║ 001A                                             ║lternate Op. S
  247. 4MICA25A.ZIP  ║ Alternate Op. Systems                            ║ll for
  248.               ║                                                  ║lternate Op. S
  249. 4PHONE.ZIP    ║         Press Any Key to Return to Table         ║along with
  250.               ╚══════════════════════════════════════════════════╝lternate Op. S
  251. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  252. ENTER to Change/View              ESC to Exit        CTRL-D Extended Description
  253. CTRL-S Search for Phrase          INSERT to Add               CTRL-X Execute Cmd
  254. CTRL-N Find Next Occurance        DELETE to Delete              CTRL-V View File
  255.  
  256.  
  257.                             ─────────────────────
  258.  
  259.  
  260. Text File Viewing:
  261. ──────────────────
  262.  
  263.   CD-ROM PRO File Manager contains an internal file viewer, with Search
  264.   and Line Jump Functions. However, if you have another text file
  265.   viewer you prefer, you can specify it in the Configuration menu.
  266.   To return to using the internal viewer, specify INTERNAL or leave
  267.   the TEXT VIEWER line blank. Please note that the internal file viewer
  268.   tries to load the file into memory - if you are viewing files over
  269.   140K in size, it is recommended that you use an external viewer, such
  270.   as LIST. Please note that only the file you are highlighting when you
  271.   press CTRL-V will be viewed (and the files it contains, if it is
  272.   archived) - tagged files are only used when executing DOS commands
  273.   with the CTRL-X key (see below).
  274.  
  275.  
  276.                             ─────────────────────
  277.  
  278. Executing Commands:
  279. ───────────────────
  280.  
  281. You have the option to execute a DOS command from within the program in a
  282. number of places by pressing CTRL-X. When you do, you'll be presented with
  283. the following screen:
  284.  
  285. ╔══════════════════════════════════════════════════════════════════════════════╗
  286. ║ EXECUTE COMMAND (up to 130 characters):                                      ║
  287. ║COPY C:\001A\42BOOT.ZIP                                                     ║
  288. ║                                                                              ║
  289. ║             ┌───────────────────────────────────────────────────┐            ║
  290. ║             │  Pressing CTRL-END clears to the end of the line  │            ║
  291. ║             │  Pressing ESC exits without executing command     │            ║
  292. ║             │  Pressing ENTER accepts and executes the command  │            ║
  293. ║             └───────────────────────────────────────────────────┘            ║
  294. ║                                                                              ║
  295. ║      ^    Indicates "Next command" (Divides multiple commands)               ║
  296. ║      ->   Indicates "Change to this directory before executing command"      ║
  297. ║      %TAG Indicates execute command for all tagged files                     ║
  298. ║      %FN  Indicates execute command on c:\001A\42BOOT.ZIP                    ║
  299. ║                                                                              ║
  300. ╚══════════════════════════════════════════════════════════════════════════════╝
  301.  
  302. ...and you can alter the command (between the symbols  and )
  303. however you wish, and then press ENTER to shell out to DOS and
  304. execute it. The default command is the one you specified in the
  305. Configuration screen, followed by the last path and file name
  306. referenced, unless you have tagged files, in which case the file
  307. name is replaced by %TAG.
  308.  
  309. In some areas, CTRL-C and CTRL-Z are also available. You are still
  310. presented with a default command, but CTRL-C will always begin with
  311. COPY instead of your default command, and CTRL-Z will begin with
  312. PKZIP instead of your default command. In addition, the default
  313. target directory you specified within Configuration will be appended
  314. to the end, following a "->". This way, you can copy, or even unzip
  315. the chosen file into a selected directory within a minimum of keystrokes.
  316.  
  317. Tagging notes:
  318.  
  319. Before calling the command screen, you may select (tag) files using the
  320. SPACE BAR. F10 will clear all tags. When entering commands, put
  321. %TAG where you would normally put the file path and file name. When
  322. the command is executed, the program will execute your command once
  323. for each tagged file, replacing the %TAG with the file path and name.
  324.  
  325. I.E.
  326. Below shows the results of pressing SPACE on INSTRUCT.ZIP and INSTRUC3.ZIP.
  327. The √ symbol shows that the file is tagged.
  328.  
  329. INSTRUCT.ZIP√    64234  01/01/93 Instructions for using this CD-ROM.
  330. INSTRUC2.ZIP    141434  01/01/93 Instructions for getting more CDs from us.
  331. INSTRUC3.ZIP√    25234  01/01/93 Advanced info for using this CD-ROM.
  332.  
  333. CTRL-X is pressed, and the following is entered:
  334. COPY %TAG \TEMP
  335.  
  336. The two tagged files are then copied into the \TEMP directory. Tags
  337. are cleared as the command is executed. If you have set "Prompt for
  338. CD change when executing commands on tagged files" (in CONFIGURATION)
  339. to "Y", you will be prompted before the first command is executed on
  340. each tagged file if the CD that the file is on is different than the
  341. last one accessed. At this prompt, you may choose to CANCEL by pressing
  342. the ESCAPE key. All remaining tagged files will REMAIN tagged, if you
  343. do this.
  344.  
  345. ───────────────────────────────────────────────────────────────────────────────
  346. If you have been using Version 1.00, ensure that you download CDPROxxC.ARJ
  347. and use the CONVMULT.BAT file enclosed to convert your files (xx is the
  348. version number you wish to convert to).
  349. ───────────────────────────────────────────────────────────────────────────────
  350.  
  351.  
  352. Searching for Phrases:
  353. ──────────────────────
  354.  
  355. (a) Basic
  356.    In it's simplest form, you just type in the phrase you want to scan
  357. the file names, dates, and descriptions (including extended descriptions) for.
  358.  
  359. (b) Wildcards
  360.    A '*' in the phrase indicates that you are entering two (or more) phrases,
  361. and that there can be any number of characters between the two phrases.
  362. A '?' indicates that there is 1 character between the two phrases, and a
  363. number of question marks indicate that there are a set number of characters
  364. between the two phrases. Both these wildcard symbols should work the
  365. same as they do in DOS.
  366.  
  367.    Examples:
  368.  
  369.       11/??/92*FIDO
  370.       will find the next file dated in November of 1992 and containing
  371.       the word FIDO in their descriptions. (Case is ignored)
  372.  
  373.       FIDO*PCB
  374.       will find the next file with both FIDO and PCB in their
  375.       name/description separated by 0-255 characters. Note that 'PCB'
  376.       *MUST* follow 'FIDO'. It cannot be before.
  377.  
  378.  
  379.  
  380. (c) Extended AND/OR
  381.    A '||' can be used to indicate an OR statement. A '&&' will indicate
  382. an AND. Note that neither can be combined with any other wildcard or
  383. extended search (I.E. This||That&&Another is invalid, and so is
  384. FIDO&&PCB*FOLLOWED). In these cases, the wildcard characters will be
  385. treated as ordinary characters.
  386.  
  387.    Examples:
  388.  
  389.       92&&FIDO
  390.       will find the next file with both a 92 and the word 'FIDO' in
  391.       its name description. In other words '1992 FidoNet' and 'FidoNet
  392.       1992' would both be found.
  393.  
  394.       92||FIDO
  395.       will find the next file with either a 92 or the word 'FIDO' in
  396.       its name description. In other words '1992', 'FidoNet', '1992 Fido',
  397.       and 'FIDO.ZIP...11/23/92' would all be found.
  398.  
  399. Note that these rules apply for both single file searches and the
  400. extended table searches.
  401.  
  402.  
  403. History:
  404. ───────
  405.  
  406. Version 1.2   Enhanced search routines, and adjusted some overlays to reduce
  407.               memory requirements. CDP.HLP is now used instead of CD_PRO.HLP.
  408. Version 1.1d  Further refinements of the multi-CD players support. Selectable
  409.               drives instead of just A: for floppy dupe checking.
  410. Version 1.1   Multi-CD Player support added.
  411. Version 1.0   First release, fixed minor bugs in beta
  412. Beta   0.97   First trial release.
  413.