home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / gendoc / crcksort.dqc / CRCKSORT.DOC
Encoding:
Text File  |  1985-02-10  |  3.3 KB  |  81 lines
  1. CRCKSORT.DOC   Documentation file.   04/22/82    T McCormick.
  2.  
  3. It would be helpful to have the CRCKLIST.CRC file in
  4. alphabetical order by filename. It would also be helpful
  5. to add information helpful to the user to this file and
  6. thus eliminate the need for separate doc files for small
  7. amounts of information.
  8.  
  9. The instructions below explain how to edit a file
  10. output from the CRCK.COM program so that it can be
  11. alphabetically sorted on filename by SUPERSORT.
  12. This involves stripping out:
  13.     a. the blank lines (SUPERSORT drops them automatically)
  14.     b. the leading "--> FILE:  "  before each filename thus
  15.        moving the file name to positions 1 through 12 of the records.
  16.     c. six of the eight blanks between the filename and the CRC.
  17. Items b. and c., above, are done with an editor using global search/replace.
  18.  
  19. The example below assumed Magic Wand was used, but
  20. it is applicable to other word processors with the
  21. search/replace global function.
  22.  
  23. When CRCK *.* F    (note the F) is entered, the
  24. CRCK program creates a disk file of the Cyclic
  25. Redundancy Checksum values, and this file is
  26. named CRCKLIST.CRC.
  27.  
  28. Here is how to edit that file so that it can be
  29. sorted alphabetically. Optionally, it can then
  30. have additional information inserted for each
  31. file by using an editor.  The result is a very
  32. nice documentation file containing the filenames
  33. in alphabetical order, the CRCK checksum for
  34. validating legitimate copies, and descriptive
  35. information about the file and how to use it.
  36.  
  37. For example, the finished product might appear as:
  38.  
  39. ASM    .COM  CRC = CB A8  Digital Research's standard CP/M assembler.
  40.                A>ASM FILENAME.ABZ  where:
  41.                         Z indicates no printed listing.
  42.                        B  indicates .HEX file goes to B:.
  43.                       A   indicates .ASM source is on A:.
  44. CRCK    .COM  CRC = 2D 47  Public domain file integrity control program.
  45.                Creates a hex control sum of one or more files;
  46.                this value would vary if ANY change to program
  47.                is made. Useful also to detect old versions of
  48.                program having same name, etc.  Wildcards OK.
  49.                Trailing F parameter causes disk file written
  50.                in same format as CRT display.  For example:
  51.                A>CRCK *.* F
  52.  
  53. ------------------------------------------------------------------------
  54.  
  55. After running CRCK to create CRCKLIST.CRC disk file, edit it as follows:
  56.  
  57.     1. EDIT CRCKLIST.CRC    <to bring file into Magic Wand.
  58.  
  59.     2. Do two global search replaces:
  60.  
  61.         old = '--> FILE:  '    new = nothing (delete from each line.)
  62.  
  63.         old = '      CRC'    new = 'CRC'    ..delete leading spaces.
  64.  
  65.     3. Save edited file.  It will be input file to SUPERSORT command
  66.        saved in CRCKSORT.SUB.
  67.  
  68. --------------------------------------------------------------------------
  69.  
  70. The final step is to run SUPERSORT:    A>SUBMIT CRCKSORT    
  71.  
  72. Here is what that CRCKSORT.SUB file looks like:
  73.  
  74. SORT INP=80,CR; SO=CRCKLIST.CRC; OUT=CRCKSORT.CRC; KEY=#1,12; GO
  75.  
  76. It is then useful to rename the sorted file to indicate the date or
  77. something else useful, for example: REN CRCK0422.CRC=CRCKSORT.CRC
  78. might be used to indicate the CRC file is as of April 22nd.
  79.  
  80. ---------------------------------------------------------------------------
  81.