home *** CD-ROM | disk | FTP | other *** search
/ Der Mediaplex Sampler - Die 6 von Plex / 6_v_plex.zip / 6_v_plex / DISK5 / DOS_07 / CDPRO15.ZIP / CDPRO15.DOC < prev    next >
Text File  |  1993-04-25  |  22KB  |  481 lines
  1.  
  2.                                    CD-ROM PRO
  3.                  Librarian/File Manager for CD-ROM Collections
  4.  
  5.                                   Version 1.5
  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 (see
  22. shipping notes below), a registration key, and the latest beta of any
  23. "version-in-the-works".
  24.  
  25. Shipping of the current copy of CD-ROM PRO is included for destinations
  26. within Canada, the U.S., and U.K. All non-Canadian registrants are asked
  27. to pay with U.S. funds.
  28.  
  29. The registered version includes automated file listing import (searches CDs
  30. for FILES.BBS; IMPORT.CNF not necessary in many cases), sample IMPORT.CNFs
  31. for popular CD-ROMs, and extra utilities and reports.
  32. ───────────────────────────────────────────────────────────────────────────────
  33.  
  34. This program was written originally to keep track of what programs were on
  35. what CD-ROM, and to eliminate duplicate files on floppy. It allows the user to
  36. quickly find and view/run/copy any file on any CD-ROM, as well as reporting
  37. on duplication and/or unique files between CDs, whether in the user's
  38. collection or not. Text file format conversion is also supported, with
  39. the ability to fill in information found on the actual CD if it was not
  40. included in the text files originally.
  41.  
  42.  
  43.     Note: Pressing F1 gives context sensitive help wherever available.
  44.           The ESC key cancels most operations, and exits most screens
  45.           (without saving, where applicable).
  46.  
  47.  
  48. Quick Set-Up
  49. ────────────
  50.  
  51.     You should have a copy of CDP.EXE and CDP.HLP somewhere in your
  52.     path. The databases will be built in the current directory.
  53.  
  54.     To run this program:
  55.  
  56.     (1) You need text files containing the file listings for your CD-ROMs.
  57.     (2) Configure CD-ROM PRO File Manager to reflect your equipment
  58.         set-up, and use the "Format File Listings" option to enter the
  59.         format of the text files you will be importing (if not already
  60.         set up - some, such as PCBoard, already are). This means
  61.         checking the text files in (1) above, and noting the column
  62.         that the file name, date, size, and description information
  63.         begins in, and their length (in the case of the date, its format).
  64.         If a field is missing, set its column to zero. You can fill in
  65.         the date and size information later with the "Correct Date and
  66.         Size" function.
  67.     (3) If you will be importing a large number of text files, it is
  68.         recommended that you set up a file called "IMPORT.CNF" that
  69.         contains information on what CD and directory will be
  70.         imported, and which text file will contain the file names, etc.,
  71.         for that directory. The format of IMPORT.CNF is explained below
  72.         briefly, and in greater detail in the sample IMPORT.CNF enclosed
  73.         in this archive.
  74.         The "Import File Listings - Interactive" feature is more useful
  75.         for single directories, and novice users.
  76.     (4) Use one of the "Import File Listings" features to import the
  77.         information you require. This program will automatically detect
  78.         if one-line or multiple-line descriptions are being entered
  79.         (PCBoard or LongLine Formats Only).  The registered version
  80.         includes a feature that eliminates the need for IMPORT.CNF
  81.         with most CDs.
  82.  
  83.                             ─────────────────────
  84.  
  85.  
  86.  
  87. IMPORT.CNF File Definition:
  88. ───────────────────────────
  89.  
  90. Source File Listing        Size:  25            Location:    1 - 25
  91. CD Title                   Size:  15            Location:   26 - 40
  92. Format                     Size:  10            Location:   41 - 50
  93. Location                   Size:  32            Location:   51 - 82
  94. Title                      Size:  40            Location:   83 -122
  95. Subscription               Size:  15            Location:  123 -138
  96.  
  97. A sample IMPORT.CNF is enclosed in this archive for your convenience.
  98.  
  99. The fields are:
  100.  
  101. Source File Listing - path and filename of the FILES.BBS to be imported
  102. CD Title - Your choice of 15 letters to describe this CD
  103. Format - The format (PCBoard is the default) the FILES.BBS is in.
  104. Location - The location of the files that are described in the FILES.BBS
  105. Title - Your choice of 40 letters to describe the directory
  106. Subscription - The CD Title of the CD being replaced (I.E. A "Subscription"
  107.    of "Simtel 9/92" when the CD Title above is "Simtel 12/92" Means that if
  108.    the same file name is on both disks, the reference to it under Simtel 9/92
  109.    is deleted.
  110.  
  111.                             ─────────────────────
  112.  
  113.  
  114.  
  115. Keyboard Commands for Scrolling Tables
  116. ──────────────────────────────────────
  117.  
  118.    Press F1 when in a scrolling table for a complete command list.
  119.  
  120.    ENTER       - Edit highlighted entry
  121.    CTRL-V      - View/Run highlighted file
  122.    ESC         - Return to previous screen
  123.    ARROW DOWN  - Highlight next file
  124.    ARROW UP    - Highlight previous file
  125.    CTRL-S      - Search for a phrase
  126.    CTRL-N      - Next occurance of a phrase (specified by the last CTRL-S)
  127.    CTRL-X      - Run DOS Command (on tagged files, if any; otherwise the
  128.                  current highlighted file; see below)
  129.    SPACE BAR   - Tag/Untag highlighted file
  130.    F10         - Clear all tags
  131.  
  132.                             ─────────────────────
  133.  
  134.  
  135. Some General Keyboard Commands
  136. ──────────────────────────────
  137.  
  138.    ESC         - Previous field or screen; cancel entry
  139.    ENTER       - Accept and move to next field or as otherwise indicated
  140.                  on-screen; On menu screens, execute highlighted function.
  141.    F5          - Look up field in a table (where applicable)
  142.    CTRL-X      - Execute a DOS command (where available)
  143.  
  144.  
  145.  
  146.                             ─────────────────────
  147.  
  148.  
  149.  
  150. Searching for Phrases:
  151. ──────────────────────
  152.  
  153. (a) Basic
  154.    In it's simplest form, you just type in the phrase you want to scan
  155. the file names, dates, and descriptions (including extended descriptions) for.
  156.  
  157. (b) Wildcards
  158.    A '*' in the phrase indicates that you are entering two (or more) phrases,
  159. and that there can be any number of characters between the two phrases.
  160. A '?' indicates that there is 1 character between the two phrases, and a
  161. number of question marks indicate that there are a set number of characters
  162. between the two phrases. Both these wildcard symbols should work the
  163. same as they do in DOS.
  164.  
  165.    Examples:
  166.  
  167.       11/??/92*FIDO
  168.       will find the next file dated in November of 1992 and containing
  169.       the word FIDO in their descriptions. (Case is ignored)
  170.  
  171.       FIDO*PCB
  172.       will find the next file with both FIDO and PCB in their
  173.       name/description separated by 0-255 characters. Note that 'PCB'
  174.       *MUST* follow 'FIDO'. It cannot be before.
  175.  
  176.  
  177.  
  178. (c) Extended AND/OR
  179.    A '||' can be used to indicate an OR statement. A '&&' will indicate
  180. an AND. Note that neither can be combined with any other wildcard or
  181. extended search (I.E. This||That&&Another is invalid, and so is
  182. FIDO&&PCB*FOLLOWED). In these cases, the wildcard characters will be
  183. treated as ordinary characters.
  184.  
  185.    Examples:
  186.  
  187.       92&&FIDO
  188.       will find the next file with both a 92 and the word 'FIDO' in
  189.       its name description. In other words '1992 FidoNet' and 'FidoNet
  190.       1992' would both be found.
  191.  
  192.       92||FIDO
  193.       will find the next file with either a 92 or the word 'FIDO' in
  194.       its name description. In other words '1992', 'FidoNet', '1992 Fido',
  195.       and 'FIDO.ZIP...11/23/92' would all be found.
  196.  
  197. Note that these rules apply for both single file searches and the
  198. extended table searches.
  199.  
  200.  
  201.                             ─────────────────────
  202.  
  203.  
  204. Text File Viewing:
  205. ──────────────────
  206.  
  207.   CD-ROM PRO File Manager contains an internal file viewer, with Search
  208.   and Line Jump Functions. However, if you have another text file
  209.   viewer you prefer, you can specify it in the Configuration menu.
  210.   To return to using the internal viewer, specify INTERNAL or leave
  211.   the TEXT VIEWER line blank. Please note that the internal file viewer
  212.   tries to load the file into memory - if you are viewing files over
  213.   140K in size, it is recommended that you use an external viewer, such
  214.   as LIST. Please note that only the file you are highlighting when you
  215.   press CTRL-V will be viewed (and the files it contains, if it is
  216.   archived) - tagged files are only used when executing DOS commands
  217.   with the CTRL-X key (see below).
  218.  
  219.  
  220.                             ─────────────────────
  221.  
  222.  
  223. Executing Commands:
  224. ───────────────────
  225.  
  226. You have the option to execute a DOS command from within the program in a
  227. number of places by pressing CTRL-X. When you do, you'll be presented with
  228. the following screen:
  229.  
  230. ╔══════════════════════════════════════════════════════════════════════════════╗
  231. ║ EXECUTE COMMAND (up to 130 characters):                                      ║
  232. ║COPY C:\001A\42BOOT.ZIP                                                     ║
  233. ║                                                                              ║
  234. ║             ┌───────────────────────────────────────────────────┐            ║
  235. ║             │  Pressing CTRL-END clears to the end of the line  │            ║
  236. ║             │  Pressing ESC exits without executing command     │            ║
  237. ║             │  Pressing ENTER accepts and executes the command  │            ║
  238. ║             └───────────────────────────────────────────────────┘            ║
  239. ║                                                                              ║
  240. ║      ^    Indicates "Next command" (Divides multiple commands)               ║
  241. ║      ->   Indicates "Change to this directory before executing command"      ║
  242. ║      %TAG Indicates execute command for all tagged files                     ║
  243. ║      %FN  Indicates execute command on c:\001A\42BOOT.ZIP                    ║
  244. ║                                                                              ║
  245. ╚══════════════════════════════════════════════════════════════════════════════╝
  246.  
  247. ...and you can alter the command (between the symbols  and )
  248. however you wish, and then press ENTER to shell out to DOS and
  249. execute it. The default command is the one you specified in the
  250. Configuration screen, followed by the last path and file name
  251. referenced, unless you have tagged files, in which case the file
  252. name is replaced by %TAG.
  253.  
  254. In some areas, CTRL-C and CTRL-Z are also available. You are still
  255. presented with a default command, but CTRL-C will always begin with
  256. COPY instead of your default command, and CTRL-Z will begin with
  257. PKZIP instead of your default command. In addition, the default
  258. target directory you specified within Configuration will be appended
  259. to the end, following a "->". This way, you can copy, or even unzip
  260. the chosen file into a selected directory within a minimum of keystrokes.
  261.  
  262. Tagging notes:
  263.  
  264. Before calling the command screen, you may select (tag) files using the
  265. SPACE BAR. F10 will clear all tags. When entering commands, put
  266. %TAG where you would normally put the file path and file name. When
  267. the command is executed, the program will execute your command once
  268. for each tagged file, replacing the %TAG with the file path and name.
  269.  
  270. I.E.
  271. Below shows the results of pressing SPACE on INSTRUCT.ZIP and INSTRUC3.ZIP.
  272. The √ symbol shows that the file is tagged.
  273.  
  274. INSTRUCT.ZIP√    64234  01/01/93 Instructions for using this CD-ROM.
  275. INSTRUC2.ZIP    141434  01/01/93 Instructions for getting more CDs from us.
  276. INSTRUC3.ZIP√    25234  01/01/93 Advanced info for using this CD-ROM.
  277.  
  278. CTRL-X is pressed, and the following is entered:
  279. COPY %TAG \TEMP
  280.  
  281. The two tagged files are then copied into the \TEMP directory. Tags
  282. are cleared as the command is executed. If you have set "Prompt for
  283. CD change when executing commands on tagged files" (in CONFIGURATION)
  284. to "Y", you will be prompted before the first command is executed on
  285. each tagged file if the CD that the file is on is different than the
  286. last one accessed. At this prompt, you may choose to CANCEL by pressing
  287. the ESCAPE key. All remaining tagged files will REMAIN tagged, if you
  288. do this.
  289.  
  290.  
  291.                             ─────────────────────
  292.  
  293.  
  294. Program Parameters: Using one set of databases from any directory
  295. ─────────────────────────────────────────────────────────────────
  296.  
  297. If you wish, you can specify the path to the databases when you
  298. start the program. For example,
  299.  
  300. CDP C:\DATA
  301.  
  302. would look in the C:\DATA directory for all five of the databases.
  303. Please note that the import file information routine does
  304. NOT look at this path. C:\DATA\ and C: are also valid paths.
  305.  
  306. This way you can access your CD from any directory, and even use
  307. the current directory as a default to copy/unzip to.
  308.  
  309.  
  310.                             ─────────────────────
  311.  
  312.  
  313.  
  314. File Descriptions:
  315. ──────────────────
  316.  
  317. File descriptions are stored in a 1 line + 5 line format in order to save
  318. space... Since many CD-ROMs contain only 1 line descriptions, it would be
  319. wasteful to take up 6x48 bytes for every file's description when 48 would
  320. do. However, some CDs have PCBoard and 2 line style descriptions. This
  321. program determines if this is the case, and stores the 2nd and following
  322. lines in a special field that is only placed in records when necessary,
  323. saving the extra 240 bytes for each files with only a one-line description.
  324. On the tables of files shown in the program, only the first or first two
  325. lines are shown, and CTRL-D can be used to view the complete record.
  326. All searches check within the entire description, however.
  327.  
  328. Here's a sample screen of the extended description popped-up over the main
  329. file listing:
  330.  
  331. 42BOOT.ZIP       10210  4/08/92 Package th╔══════════════════════╗ot MS-DOS
  332.                                 MY CD-ROM ║ EXTENDED DESCRIPTION ║lternate Op. S
  333. 4CASE16.ZIP   ╔═══════════════════════════╝──────────────────────╢like case
  334.               ║ 42BOOT.ZIP       10210  4/08/92                  ║lternate Op. S
  335. 4DDBU512.ZIP  ║                                                  ║
  336.               ║ Package that allows you to dual boot MS-DOS      ║lternate Op. S
  337. 4DESC307.ZIP  ║ or DR-DOS easily using 4DOS' aliasing and INI    ║ber for
  338.               ║ (autoexecpath) capabilities to enhance /         ║lternate Op. S
  339. 4EDIT110.ZIP  ║ simplify booting up either operating system;     ║ creating &
  340.               ║ original config/autoexec are no longer used,     ║lternate Op. S
  341. 4LASER.ZIP    ║ so install programs which mangle... etc.         ║or sending
  342.               ║                                                  ║lternate Op. S
  343. 4LOGIC10.ZIP  ║ MY CD-ROM 7                                      ║ featuring
  344.               ║ 001A                                             ║lternate Op. S
  345. 4MICA25A.ZIP  ║ Alternate Op. Systems                            ║ll for
  346.               ║                                                  ║lternate Op. S
  347. 4PHONE.ZIP    ║         Press Any Key to Return to Table         ║along with
  348.               ╚══════════════════════════════════════════════════╝lternate Op. S
  349. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  350. ENTER to Change/View              ESC to Exit        CTRL-D Extended Description
  351. CTRL-S Search for Phrase          INSERT to Add               CTRL-X Execute Cmd
  352. CTRL-N Find Next Occurance        DELETE to Delete              CTRL-V View File
  353.  
  354.  
  355.                             ─────────────────────
  356.  
  357.  
  358. About File Listing Formats and Exporting File Listings:
  359. ───────────────────────────────────────────────────────
  360.  
  361. Using the Recreate File Listing option (also know as Create Listing of
  362. Files in a Directory) allows you to generate a formatted DOS file or
  363. printout of the list of files in a directory (not surprisingly!).
  364. All FILES.BBS file listings that are created using the "Re-Create/Print
  365. File Listings" option will use one-line descriptions, unless a "~", "|"
  366. is contained within the format name or one of the proprietary formats
  367. (described below - see "Format Conventions") is used.
  368.  
  369. Converting from a DOS file listing in one format to another will only
  370. convert the first line of each description, regardless of what multi-line
  371. options (as described below) are selected.
  372.  
  373. Format Conventions:
  374. ───────────────────
  375.  
  376. If the format title contains a "~" character, it indicates that the
  377. format is multi-line. The "~" should be followed by the number of lines
  378. of description allowed per file.
  379.  
  380.    I.E.:
  381.      MAXFMT~2 will output 2 line descriptions for each file.
  382.  
  383. If the format title contains a "|" character, it indicates that the
  384. description should be preceded by a "|". Note that the description
  385. is still placed at the position indicated in the format configuration.
  386. The "|" is placed two spaces before the description.
  387.  
  388. If both "|" and "~" are in the format title, the "|" is always placed
  389. before the 2nd and following lines, but only before the 1st line if
  390. the "|" precedes the "~".
  391.  
  392.     I.E.:
  393.        Taking the format "WILD" and simply changing the format name
  394.        has the following results:
  395.  
  396. If     WILD     outputs:      FILENAME.ZIP 91810 01-01-93  Description
  397.  
  398. then   WILD|    outputs:      FILENAME.ZIP 91810 01-01-93| Description
  399.  
  400. and    WILD|~2  outputs:      FILENAME.ZIP 91810 01-01-93| Description
  401.                                                          | Description Line 2
  402.  
  403. and    WILD~2|  outputs:      FILENAME.ZIP 91810 01-01-93  Description
  404.                                                          | Description Line 2
  405.  
  406. and    WILD~2   outputs:      FILENAME.ZIP 91810 01-01-93  Description
  407.                                                            Description Line 2
  408.  
  409. Also note that if there are not two spaces between the description and
  410. the previous field, and "|" is used, the previous field will be over-written.
  411.  
  412.  
  413.  
  414. Special Case (Proprietary Formats): If either the "PCBOARD" or
  415. "WILDCAT_2" file listing formats have been specified, special
  416. logic comes in to play to ensure the resulting FILES.BBS looks
  417. more like the proprietary formats used by these boards.
  418.  
  419. I.E.:
  420.  
  421. PCBOARD
  422. ARJ230.EXE    200363  02-07-92   This is what you'll use to extract files
  423.                                | that end in the ARJ extension. Its self-
  424.                                | extracting, so just type in ARJ230, and
  425.                                | then use the ARJ.EXE that comes out to
  426.                                | extract other files!
  427.  
  428. WILDCAT_2
  429. ARJ230.EXE    200,363   02/07/92 | This is what you'll use to extract files
  430. DwnLds: 3     DL Time   00:17:23 | that end in the ARJ extension.
  431.  
  432.  
  433.  
  434.                             ─────────────────────
  435.  
  436.  
  437. History:
  438. ───────
  439.  
  440. Version 1.5   Automatic File Listing Import now handles multi-line
  441.               descriptions; various screen clean-ups and minor bug
  442.               fixes; Create File Listings now has option to do so for entire
  443.               CD-ROM; increased speed of CHECK FLOPPIES FOR DUPES and
  444.               CORRECT DATE/SIZE routines by up to 200% (no longer shelling
  445.               to DOS); Fixed bug in Compare File Listings - now correctly
  446.               excludes CDs specified. Search for Phrase report expanded
  447.               to include Date/Size ranges (registered users only).
  448.               File imports now filter out the "garbage characters", or
  449.               extended ASCII characters, in descriptions... for example:
  450.  
  451.   _1ARCTIC.ZIP    97382  12-01-91   │▌█▐█▐█▌███  ARCTIC ADVENTURE ███▐█▌█▌█▐│
  452.                                   | The chilling sequel to Pharaoh's
  453. Becomes:
  454.   _1ARCTIC.ZIP    97382  12-01-91  ARCTIC ADVENTURE The chilling sequel to
  455.                                  | Pharaoh's Tomb finds Nevada Smith on the
  456.  
  457. Version 1.4   Released to registered users only. User can now specify what
  458.               extensions should and shouldn't match.
  459. Version 1.3   Fixed bug FILE ALLOCATION ERROR bug due on systems with low
  460.               memory. Reduced memory requirements in general. Streamlined
  461.               floppy dupe checking, and changed tagged file command execution
  462.               to call a single batch file instead of re-shelling to DOS
  463.               for each file (in other words: DOS commands on tagged files
  464.               are faster!) Auto-import feature added to registered version.
  465.               Added Search for Phrase report to compliment existing Search
  466.               for Phrase tables and functions. Compare file lists and check
  467.               floppy for dupes routines now check extensions for "close"
  468.               matching - THIS.GIF now will not match THIS.ZIP. THIS.ARJ will
  469.               continue to match THIS.ZIP (Just checks for GIF/JPG extension
  470.               versus all others).
  471. Version 1.2   Enhanced search routines, and adjusted some overlays to reduce
  472.               memory requirements. CDP.HLP is now used instead of CD_PRO.HLP.
  473.               First Release through SDN
  474. Version 1.1d  Further refinements of the multi-CD players support. Selectable
  475.               drives instead of just A: for floppy dupe checking.
  476. Version 1.1c  Same as Version 1.1, except included upgrade package for some
  477.               users of Version 1.0.
  478. Version 1.1   Multi-CD Player support added.
  479. Version 1.0   First release, fixed minor bugs in beta
  480. Beta   0.97   First trial release.
  481.