home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / ac_16 / ac_16.doc < prev    next >
Text File  |  1992-03-27  |  7KB  |  160 lines
  1.  
  2.                              - AUTO CRUNCH v1.6
  3.  
  4.                       - Copyright (c) 1992  M.J.Matts -
  5.  
  6.                      - Original Idea By Robert Darling -
  7.  
  8.                       - This Program Is Public Domain -
  9.  
  10.  
  11.       What is AUTO CRUNCH?
  12.  
  13.    AUTO CRUNCH is a QuickBBS utility that will automatically join all your 
  14. FILES.BBS's as one large file. This file can then be packed using standard 
  15. archiving formats, so far it supports LZH, ARC & ZIP, but more formats can be 
  16. added if you send me the archiving utility and a letter asking me to do so. To 
  17. make use of the archiving function you MUST have the external program in the 
  18. same folder as AUTO CRUNCH.
  19.  
  20.       How does it work?
  21.  
  22.    AUTO CRUNCH now uses 2 control files called A_CRUNCH.CTL & AC_PATH.CTL. 
  23. Because there is no user input needed the program can be run at any time, a 
  24. good example would be at a mail clean up. The control files MUST be in the 
  25. same folder as the AUTO CRUNCH program. Sample control files are included in 
  26. this LZH file but you may well need to make changes to suit your own setup. 
  27. The entries can be in upper or lower case but can NOT have any comments added. 
  28. The correct syntax of command that can be used in A_CRUNCH.CTL is shown below. 
  29. They can be in any order and any functions not needed can just be left out.
  30.  
  31. ALLFILE=[filename without extension]
  32.          This is the name for the files to be created for you all areas 
  33.          listing. Note that it should only be a maximum of 8 characters and 
  34.          should NOT have an extension.
  35.  
  36. ALLPATH=[full path name]
  37.          This is the full path of where you want the resulting files to be 
  38.          placed. I have found that the archiving does not work properly if 
  39.          this string is to long. A safe length for it is about 20 characters 
  40.          but you may get more. Best to experiment with this one. If you use 
  41.          the same path as for your present version of A_Crunch it will work ok 
  42.          - seems to be a bug in GFA that does not allow me to pass a large 
  43.          string to an external program.
  44.  
  45. ALLHEADER=[full path + filename]
  46.          This is the full path INCLUDING the filename of a text file that will 
  47.          be included as a header in the final all areas listings. This path 
  48.          can be as long as you like.
  49.  
  50. ALLFOOTER=full path + filename]
  51.          Exactly the same as above but this is a file that will be appended to 
  52.          the end of the all areas list.
  53.  
  54. ALLLZH
  55. ALLARC
  56. ALLZIP
  57. ALLTXT
  58.          These four commands activate each type of compression. If you do not 
  59.          want to use a particular type just exclude the command from the CTL 
  60.          file.
  61.  
  62. NEWDAYS=[number of days to include in the NEWFILES list (numeric)]
  63.          Simply enter the number of days you want to go back for the files to 
  64.          be included. I have tried it set to 60 as you say you have yours and 
  65.          there seems to be no problems. There is no limitation for how far 
  66.          back you can go. It will count back in days, months & years if it has 
  67.          to. This was done so that you can still go back 60 days even when it 
  68.          is January. It will go back into last year so you will always get an 
  69.          accurate 60 day list. THIS WAS A REAL HEADACHE TO WORK OUT HOW TO DO 
  70.          SO I HOPE IT WORKS ON YOUR SETUP AS IT DID ON MINE - IT SHOULD DO 
  71.          ANYWAY.
  72.  
  73. NEWFILE=[filename without extension]
  74.          The same as for the ALLFILE= command but it refers to the NEWFILES 
  75.          lists.
  76.  
  77. NEWPATH=[full path name]
  78.          The same as for the NEWPATH= command but it refers to the NEWFILES 
  79.          lists.
  80.  
  81. NEWHEADER=[full path + filename]
  82.          The same as for the NEWHEADER= command but it refers to the NEWFILES 
  83.          lists.
  84.  
  85. NEWFOOTER=[full path + filename]
  86.          The same as for the NEWFOOTER= command but it refers to the NEWFILES 
  87.          lists.
  88.  
  89. NEWLZH
  90. NEWARC
  91. NEWZIP
  92. NEWTXT
  93.          Again each of these commands activate the type of compression 
  94.          required for the new files list.
  95.  
  96. ALLOFF
  97.          This will completely disable the ALL files option. Any other commands 
  98.          refering to the all files list will be ignored.
  99.  
  100. NEWOFF
  101.          This will completely disable the NEW files option. Any other
  102.          commands refering to the all files list will be ignored.
  103.  
  104. NOLOG
  105.          This will disable the LOG file that Auto Crunch Creates. The LOG file 
  106.          will always be created unless you include this command.
  107.  
  108. *** IMPORTANT *** When you include a filename or path name after a command 
  109. with the '=' sign there must be no spaces between them, for example ALLFILE= 
  110. allfiles will not work. It must be ALLFILE=allfiles for the function to work 
  111. properly.
  112.  
  113. The second CTL file, AC_PATH.CTL, simply holds the full drive and path name 
  114. for the file areas to be included in the listings. It is assumed the file area 
  115. lists will be named FILES.BBS. AUTO CRUNCH does not check for any other named 
  116. files. The drive letter must be specified if AUTO CRUNCH is to be run from 
  117. another drive. See the sample file for an idea of how it should look - There 
  118. is no limit to the amount of paths that can be added to the AC_PATH.CTL file.
  119.  
  120.       Thats all there is to it. Once the CTL files have been set up correctly 
  121. the program can be run at anytime of the day (or night).
  122.  
  123.                       *** External Archiver Names! ***
  124.  
  125.          Auto Crunch looks for specific file names when it is told to archive 
  126. using a certain type of compression so if your archiver has a different name 
  127. you will have to renmae it. For example, different versions of LZH compression 
  128. programs have been called LHARC.TTP,!LHARC.TTP,LZH201.TTP. If you use the 
  129. correct file names but still have problems creating the compressed files try a 
  130. different version of the compression program. The version numbers that I use 
  131. are shown after each file name. Below is a list of the correct file names for 
  132. each compression that Auto Crunch looks for..
  133.  
  134.                         Type -  File Name  - Version I Use
  135.  
  136.                         LZH  -  LHARC.TTP  -  v2.01k
  137.                         ARC  -  ARC.TTP    -  v5.12
  138.                         ZIP  -  ZIP.TTP    -  v1.1
  139.  
  140.  
  141.       If you do have any problems with AUTO CRUNCH or if you would like the 
  142. latest version then please leave me E-mail on my BBS or on Roberts.
  143.                            The details are as follows:-
  144.  
  145.          My BBS : The Confederation   Roberts BBS : FolkeSTone BBS
  146.                   300/1200/2400                     300/1200/2400
  147.                   10pm - 7am                        9pm - 8am
  148.                   +44 (0) 533 413443                +44 (0)303 245203
  149.  
  150.  
  151.      Alternativly you could send me a letter to : Mark Matts
  152.                                                    66 Telford Way
  153.                                                     Leicester
  154.                                                      LE5 2LX
  155.                                                       England
  156.  
  157. Happy Auto Crunching....
  158.  
  159.  
  160.