home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / CRCOK157.ZIP / CRC_OK.DOC < prev    next >
Text File  |  1995-06-27  |  11KB  |  246 lines

  1.  ┌─────╖ ┌──────╖ ┌─────╖         ┌─────╖ ┌─╖┌───╖
  2.  │ ╔═╕ ║ │ ╔══╕ ║ │ ╔═╕ ║         │ ╔═╕ ║ │ ║│ ╔═╝
  3.  │ ║ ╘═╝ │ ╙──┘ ║ │ ║ ╘═╝ ┌─────╖ │ ║ │ ║ │ ╙┘ ╙─╖    Version 1.57
  4.  │ ║ ┌─╖ │ ╔═╕ ╔╝ │ ║ ┌─╖ ╘═════╝ │ ║ │ ║ │ ╔══╕ ║
  5.  │ ╙─┘ ║ │ ║ │ ╙╖ │ ╙─┘ ║         │ ╙─┘ ║ │ ║  │ ║    ▓▓▓ beerware ▓▓▓
  6.  ╘═════╝ ╘═╝ ╘══╝ ╘═════╝         ╘═════╝ ╘═╝  ╘═╝
  7. ───────────────────────────────────────────────────────────────────────────────
  8.  
  9.               This program is (c) Peter Hampf --- pbs data vec
  10.                            Graf von Galen Str. 27
  11.                                 49377 Vechta
  12.                                   Germany
  13.  
  14.                              2:241/1090@fidonet
  15.                              246:6101/0@PB-Net
  16.                              9:491/6010@virnet
  17.                              21:490/2105@gernet
  18.  
  19.                              Tue., Jun. 27. 1995
  20.  
  21.                              All rights reserved
  22. ───────────────────────────────────────────────────────────────────────────────
  23.  
  24. Only a few questions and the answers to complete this doc :-)
  25.  
  26. Q.: What does this program do?
  27.  
  28. A.: It compares the CRC - checksum in a TIC (or BAD) file against the real
  29.     CRC - checksum of the file which belongs to the TIC - file.
  30.     If the checksum is wrong, a new TIC - file with the correct checksum
  31.     will be generated.
  32.     Furthermore the SIZE line will be corrected, and -optional- the REPLACES
  33.     line. (Call "CRC_OK /?" for a little more information!)
  34.  
  35.  
  36. Q.: Why this program?
  37.  
  38. A.: Because I use MTA (a really great program from Rob van Hoeven) :-)
  39.     If my system receives a TIC - file, the corresponding file will be
  40.     converted into an ARJ. Under some circumstances the CRC - checksum for
  41.     the new generated archive is calculated incorrect.
  42.  
  43.  
  44. Q.: Can I use it for other things?
  45.  
  46. A.: Of course ... e.g. if you are going to hatch an own program and two
  47.     minutes later you have to change something [:-)] --- you have not to
  48.     hatch the altered version again. Just call CRC_OK to make the new
  49.     checksum in the old TIC-files... .
  50.     Or if your tick-manager always uses REPLACE (like Filescan does!) and
  51.     you don't want your files to replaces automatically: just call
  52.     CRC_OK /R=DUMMY.DAT (or something else as filename) and your REPLACES-
  53.     line will be invalidated!
  54.  
  55.  
  56. Q.: Are there any limitations?
  57.  
  58. A.: Yes! :-)
  59.     The TIC - file may not exceed 52 KB :-)))))
  60.  
  61.  
  62. Q.: How have I to call the program?
  63.  
  64. A.: CRC_OK [path_to_ticfiles] [path_to_file_in_ticfile] [/R<=some.nam>]
  65.     Just place this call *after* the MTA - call and *BEFORE* your TICK-call!
  66.  
  67.  
  68. Q.: Is this program free?
  69.  
  70. A.: NOOOO!! Under NO circumstances! It is beerware :-) That means, if you
  71.     ever meet me anywhere, you have to pay a beer for me!
  72.     If you don't want to pay this beer, you can send me a nice postcard
  73.     alternatively ! (I would very pleased if you do so! Really!!)
  74.  
  75.     NOTE: this program is NOT public domain! It is (c) by pbs!
  76.     You may NOT alter it (or it's doc:-) in any way!!!
  77.  
  78.  
  79. Q.: What the hell are these [C] letters on the screen?
  80.  
  81. A.: Simple: [C]   ->  CRC corrected
  82.             [R]   ->  REPLACES - extension corrected
  83.             [XR]  ->  REPLACES - line invalidated
  84.             [NOF] ->  No file. File mentioned in the TIC-file is missing.
  85.             [R]   ->  file has been renamed, extension corrected!
  86.             [D]   ->  corrected UNIX-style DATE - line
  87.  
  88.  
  89.  
  90. Q.: Guaranties?
  91.  
  92. A.: grmpf...hahahahaha ... MAAAAAMA
  93.  
  94. ------------------------------------------------------------------------------
  95. Changes:
  96. ========
  97.  
  98. v1.10 31.07.1992:     - removed the limitation that the FILE-line had to
  99. -----------------       appear in front of the CRC-line.
  100.                         Works very smart now ;-)
  101.  
  102.                       + added a second parameter. If specified, this is the
  103.                         path to the files (FILE <name> - line in tic-file)
  104.                         You can give this parameter in ADDITION to the first
  105.                         one (path to tic-files) if the tics are in another
  106.                         directory than the files... .
  107.  
  108.                         e.g.:     CRC_OK .\ H:\FILES\SDSRA
  109.                                          ^  ^
  110.                                          |  |
  111.                                          |  +-- here are the files
  112.                                          |
  113.                                          +----- tics are in the current path
  114.  
  115.  
  116. v1.20 13.08.1992:     + CRC_OK will now always correct the SIZE line in
  117. -----------------       the tic-file, too!
  118.                         (Necessary for example for 're-hatching' a changed
  119.                         version of one of your programs ;-) )
  120.  
  121. v1.30 24.08.1992:     + added logging in CRC_OK.LOG in CRC_OK's homedir!
  122.  
  123. v1.40 06.10.1992:     only internal....
  124.  
  125. v1.41 07.10.1992:     + added REPLACE-line handling and invalidating.
  126. -----------------     + changed the TIC-handling at all! (a total rewrite)
  127.                       + added correction of the SIZE-line, even if the CRC
  128.                         is correct.
  129.                       + added /L-parameter to specify another LOG-file!
  130.  
  131. v1.50 30.11.1992:     - Fixed bug with non-existing CRC lines in TICs.
  132. -----------------
  133.                       + added file CRC_OK.CTL (in the same directory as the
  134.                         EXE-file). This file contains your fileareas and the
  135.                         paths to them. One per line. Example:
  136.  
  137.                         DISPAREA E:\FD\FILES\DISP
  138.  
  139.                         If CRC_OK.CTL is present, the file mentioned in the
  140.                         TIC-file will be searched in it's area-path instead
  141.                         of the current directory or command-line-parameter
  142.              --->>>     /FI. If you give the default search-path as /FI-
  143.                         commandline parameter, the contents of CRC_OK.CTL
  144.                         will be ignored!!!!!!!!!
  145.  
  146.                       + added support for FILESCANs renamed TIC-files.
  147.                         The known extensions are:
  148.                         .BAD, .UNK, .MIS, .CON,
  149.                         .BYU, .NOU, .UNL, .SEC,
  150.                         .PW,  .CRC, .DUP
  151.                         All files with this extensions are treated as valid
  152.                         TIC-files.
  153.  
  154.  
  155. v1.51 10.12.1992:     + if CRC_OK.CTL is present *AND* the file mentioned in
  156. -----------------       the TIC-file resides in the same directory than the
  157.                         TIC itself (*AND* no second parameter is given on
  158.                         the commandline!), THIS file is used instead of the
  159.                         file in the areapath from CRC_OK.CTL!
  160.  
  161.  
  162. v1.52 17.12.1992:     + you may specify a single tic-file as first parameter
  163. -----------------       instead of only a whole directory.
  164.                         >>        CRC_OK C:\FD\OUT\TK123831.TIC
  165.  
  166.                       - fixed a bug in searching for the keywords in tic-
  167.                         files. (The search is binary.) If the word "File"
  168.                         did appear within (e.g.) the description-line, it
  169.                         could have been identified as file-keyword :-(
  170.                         To be valid the keywords MUST start at character 1
  171.                         of the corresponding line now and may not be
  172.                         preceded by spaces or tabs. This is normally the
  173.                         case in every known tic-file.
  174.  
  175.  
  176. v1.53 27.12.1992:     - fixed a silly bug: if both lines, size- and crc-,
  177. -----------------       had to be corrected and the length of the size-line
  178.                         had to be changed, the crc-line would have been
  179.                         written incorrectly. (Not very likely to happen, but
  180.                         even possible!)
  181.  
  182. v1.54 02.04.1993:     + CRC_OK now handles renamed files!  e.g. if MTA renamed
  183. -----------------       a file FILEA.ARJ to FILEA.ZIP and did not correct your
  184.                         TIC-file (can happen if you haven't installed properly)
  185.                         CRC_OK will do it for you.
  186.                         But be aware: the first matching file  (FILEA.*)  will
  187.                         be inserted into your TIC-file, either from the actual
  188.                         path or the path from CRC_OK.CTL (or from commandline-
  189.                         parameter #2).
  190.                         If the file FILEA.ARJ does not exist anymore, CRC_OK
  191.                         will search for:
  192.                         1.) FILEA.ARJ in your Areapath (from CRC_OK.CTL)
  193.                         2.) FILEA.*   in the TIC-files' directory
  194.                         3.) FILEA.*   in your Areapath (from CRC_OK.CTL)
  195.  
  196. v1.55 21.04.1994:     + added check for DATE line. If the unix-style file-
  197. -----------------       date is not correct, CRC_OK will correct it ...
  198.                         This will only be done if /UNIX (/UN) has been speci-
  199.                         fied on the commandline.
  200.  
  201.                       - changed commandline-parsing!!!!!
  202.                         Path to ticfile is now: /TICPATH=<path>
  203.                         Path to filearea is now: /FILEPATH=<path>
  204.                         (maybe abbreviated to /TI=<path> and /FI=<path>)
  205.  
  206. v1.56 03.10.1994:     - small bugfix: September and October were reversed
  207. -----------------       in the logfile.
  208.  
  209.                       + CRC_OK supports ENVIRONMENT-variables in pathnames
  210.                         now. You may use $[VARIABLE] (the name of the variable
  211.                         must be enclosed in brackets and preceded by an
  212.                         $-sign!) in the command- line parameters /TI and /FI
  213.                         *and* inside the ctl- file! Example:
  214.  
  215.                         CRC_OK /TI=$[FD]\OUTTIC /FI=$[FILES]\SDN
  216.  
  217.                         You must have defined FD and FILES in your environment,
  218.                         for example:
  219.                         SET FD=D:\FD\
  220.                         SET FILES=P:\BASE\FILES
  221.  
  222.                         The backslash is optional and will be added/handled by
  223.                         CRC_OK itself!
  224.  
  225.                         A line inside CRC_OK.CTL may look like this:
  226.  
  227.                         disparea $[files]disp
  228.  
  229.                         NOTE: unresolved environmentvariables will NOT be
  230.                               replaced! So ensure that they are defined!
  231.  
  232. v1.57 27.07.1995:     + added the /CRC parameter. If you are using this pa-
  233. -----------------       rameter, CRC_OK will create and insert a NEW CRC
  234.                         line, if there is NO ONE in the TIC file.
  235.  
  236.                       - CRC_OK should not change to a default screen mode
  237.                         anymore if you have any unusual mode on you machine.
  238.  
  239.  
  240. CRC_OK is extremely fast, all TIC-file-access is done binary. If you have any
  241. problems, please let me know, I will fix'em asap!
  242.  
  243. Ok, now have fun and always good 'ticking' :-)))
  244.  
  245. Peter
  246.