home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / archiver / cwac / cwac3.doc < prev    next >
Text File  |  1993-06-07  |  11KB  |  280 lines
  1. ===================
  2. CWAC 3.0ß
  3. Documentation
  4. ===================
  5.  
  6.     CWAC, or Cool Wave Archive Converter, is a tool that
  7. automates the conversion of archive files from one format to the
  8. other.  Why do this?  For several reasons, the most important
  9. being to save space on your drive.
  10.  
  11.     There are several different archive formats used on the ST
  12. series of computers.  With the varied formats available, no two
  13. will compress the same file to the same size on a consistent
  14. basis.  The result of this situation is to have to continually
  15. convert your archive files from each format into your favorite
  16. format.
  17.  
  18.     This can involve running four different programs to do the
  19. extraction of the archives, along with running your favorite
  20. compactor.  CWAC steps in and does all this for you.  You simply
  21. tell CWAC what types of conversions to perform, and on what
  22. directories, and your work is done.  Then, CWAC can perform these
  23. conversions over and over again, because the conversions you
  24. select are stored until you delete them.
  25.  
  26.     There are help screens within CWAC to guide you along, but
  27. should something be confusing, you can refer to the following
  28. documentation as a guide.
  29.  
  30. Getting Started:
  31. ----------------
  32.  
  33.     Getting started with CWAC was made as easy as possible.  It
  34. is suggested that you create a folder, called CWAC, to use for
  35. this installation.  You may name the folder what you wish, but
  36. naming it CWAC will make your setup match that described below.
  37.  
  38.     First, copy CWAC3_00.PRG, CWAC3_00.CWI, CWAC3_00.RSC, and
  39. CWAM3_00.RSC into your CWAC folder.  These files must be present
  40. at all times for CWAC to operate properly.  You may set them to
  41. read-only status so that you do not remove them accidentally.
  42.  
  43.     Second, if you received the PACKERS.TOS file, place it where
  44. you want to have the archivers/extractors placed and run it.  It
  45. will make a folder called CWACPACK and place the necessary
  46. archives inside it.  If you did not receive the PACKERS.TOS file,
  47. it contains the most recent version of ARC.TTP, LHARC.TTP,
  48. STZIP.PRG, UNARJ.TTP, and ZOO.TTP.  You must possess the
  49. appropriate archiver/extractor because CWAC has command lines
  50. designed for use with these particular packages.
  51.  
  52.     Finally, run CWAC3_00.PRG.  On your first run, an additional
  53. data file, CWAC3_00.DAT will be created using the default data
  54. settings.  It is now up to you to set up CWAC as you wish.
  55.  
  56. Setting Up The System:
  57. ----------------------
  58.  
  59.     From the main menu, click on Setup.  You will be given the
  60. option of editing the system data or the conversion data.  It
  61. will do you no good to work on conversion data until your system
  62. is setup, so let's enter the system section first.
  63.  
  64.     You will notice that you have a box for each archiver that
  65. CWAC is designed to utilize.  Simply click on each box and locate
  66. the appropriate file.  If you do not wish to use a particular
  67. format, then do not select that box.  After you have successfully
  68. located the appropriate file, CWAC will indicate your success by
  69. placing a check-mark in the box to the left of the filename.
  70.  
  71.     Now, you need to decide where CWAC will extract files to,
  72. and where they will be rebuilt in the new format.  When you
  73. select an extract path, CWAC will place a folder there called
  74. CWAC_EX and extractions will occur there.  It is important that
  75. you do not place files in this folder that you wish to keep,
  76. because it is wiped clean several times during the execution of
  77. CWAC.
  78.  
  79.     It is not necessary for you to have an empty folder for the
  80. rebuild path, as this is simply where the new archives will be
  81. created.
  82.  
  83.     After setting those two paths, your setup is complete unless
  84. you are running a registered version.  If you are running a
  85. registered version, refer to REG.DOC for complete details on how
  86. to complete installation.
  87.  
  88. Adding Conversions:
  89. -------------------
  90.  
  91.     After selecting setup from the main menu, select to work
  92. with the conversion data.  You will now be entering the heart of
  93. CWAC and telling it how to beat.
  94.  
  95.     The basic questions you need to be able to answer are:
  96.  
  97.         1)  What format will the archives be in that I want to  
  98.              convert?
  99.          2)  What format do I wish to convert them to?
  100.          3)  What path do I wish to perform this conversion on?
  101.          4)  Do I want to over-write the original files with the 
  102.              newly converted ones?
  103.  
  104.     The first thing to do is to select the format that you wish
  105. to convert your archives to.  This is done in the center column. 
  106. You can select ARC, LZH, ZIP, or ZOO, as these are the only ones
  107. that the ST can create.
  108.  
  109.     The next thing to do is select the formats that you want
  110. converted to that format.  i.e.  If I wanted to convert all ARC,
  111. ZIP, and ZOO files to LZH format, I would select ARC, ZIP, and
  112. ZOO from the columns on the left.
  113.  
  114.     Notice that you have an additional box available for custom
  115. extension.  This is a very powerful selection.  With it, you can
  116. convert a file with any extension to your destination format. 
  117. If, for example, you had a directory that contained files named
  118. ATARI.TXT, DRIVE.TXT, MODEM.TXT, and README.TXT.  You could enter
  119. TXT in the custom extension box and the result would be to have
  120. ATARI.LZH, DRIVE.LZH, MODEM.LZH, and README.LZH (assuming you
  121. converted to LZH format).  As you can tell, this gives you
  122. amazing flexibility in your conversions, because you can add as
  123. many custom extensions as you wish!
  124.  
  125.     You may only add one custom extension per addition, so if
  126. you have 5 custom extensions that you want to convert, you will
  127. simply have to do 5 separate additions to do so.
  128.  
  129.     Here is an example:
  130.  
  131.     I want to perform the following conversions:
  132.  
  133.     A)  ARC, LZH, and ZIP to ZOO in D:\STORAGE\
  134.      B)  TXT, DOC, and PI1 to LZH in E:\ART\
  135.      C)  ARC, LZH, NEO, TXT, and ZOO to ZIP in C:\BACKUP\
  136.  
  137.     The ones listed in A) can be entered on one page.  Simply
  138. click on ARC, LZH, ZIP, and ZOO in the From selections, and ZOO
  139. in the To selections.  Then, set the source directory to
  140. D:\STORAGE\ and click on Add.
  141.  
  142.     The conversion in B) will take a bit more work.  You will
  143. have to do three screens of additions to complete these.  First,
  144. type in TXT in the custom box.  Select LZH in the To selections,
  145. set your source directory to E:\ART\ and click on ADD.  Then
  146. repeat these steps to add DOC and PI1 as custom extensions.
  147.  
  148.     You should be able to figure out how to do C) now.  Select
  149. ARC, LZH, ZOO, and type in NEO in the custom extension.  Set the
  150. source directory to C:\BACKUP\ and click on add.  You will then
  151. have to enter TXT in custom extension, set the source directory,
  152. and click on add again.
  153.  
  154.     Hopefully this will show you how to get all of your desired
  155. conversions entered.
  156.  
  157. Editing Conversions:
  158. --------------------
  159.  
  160.     Editing conversions is simple.  Simply click on View from
  161. the Add Conversion page and you will be shown the conversions
  162. that you have entered.  You can go forward and backward through♪pages by clicking on the arrows.
  163.  
  164.     Once you have found the conversion you wish to edit, simply
  165. click on that line and you will be presented a blown up view of
  166. that conversion.  Click on the item you wish to change and the
  167. options available will be shown to you.  Once you have changed to
  168. what you wish, click on save.
  169.  
  170.     If you wish to remove that conversion totally, click on
  171. kill.
  172.  
  173. Over-write?
  174. -----------
  175.  
  176.     Each time you enter a conversion, CWAC will ask if you wish
  177. to overwrite the originals.  Answering no will mean that each
  178. file converted will remain in the rebuild path you have setup. 
  179. Answering yes will mean that the original will be deleted and the
  180. new archive will be copied in its place.  There is no real
  181. advantage to saying no to an overwrite, unless you want to take
  182. care of the removal of the old archives yourself.
  183.  
  184. Converting:
  185. -----------
  186.  
  187.     You will now have completed adding your conversion settings
  188. and are ready to convert.  Simply click on the convert icon on
  189. the main menu and watch CWAC do your conversions for you.
  190.  
  191. Word From Author:
  192. -----------------
  193.  
  194.     I wrote CWAC to be fully functional with the exception of
  195. the BBS operations.  The basic point of this is to give you a
  196. full chance to see how CWAC operates.
  197.  
  198.     The additional features of CWAC, available in registered
  199. versions, will automate the conversions of your archives PLUS it
  200. will maintain your BBS system files also.  It will perform the
  201. conversion and update your BBS system files to show the change in
  202. filename, size, location, etc.
  203.  
  204.     For a SysOp, this eliminates an extreme amount of extra
  205. work, and makes performing a large conversion painless.
  206.  
  207.     The registered version of CWAC will function with command
  208. line operation.  This enables you to run it as a maintenance file
  209. without your attendance.
  210.  
  211.     If you are not a SysOp, these features may not be valuable
  212. to you.  I fully understand that.  I also understand that the
  213. majority of you will be content using CWAC and never registering
  214. it.  That is a contingency that I had to swallow when deciding to
  215. release CWAC fully functional.
  216.  
  217.     I will stick with a $10 registration fee for those willing
  218. to register.  The $10 includes the availability of a version of
  219. CWAC registered in your name.  If you do not include a disk, I
  220. will NOT mail your version back to you.
  221.  
  222.     Simply print out this form, fill it out and mail it to me at
  223. the address indicated at the bottom of the form.  Include $10
  224. (US), cashiers check, money order, or cash only! and a 3.5 inch
  225. double-sided/double-density disk.  Your registered version will
  226. be sent to you as soon as I receive your registration.
  227.  
  228. --------------------------------------------------------------------------
  229. CWAC 3.00 Registration Form
  230.  
  231. Name ________________________________________ (No Handles)
  232.  
  233. Address ________________________________________  (No PO Box)
  234.  
  235.         ________________________________________
  236.  
  237. City _____________________________   ST _____   ZIP __________
  238.  
  239. Phone Number ______________________  (Include Area Code)
  240.  
  241. Machine that CWAC will be used on __________________________________
  242.  
  243. How much memory ____________________________
  244.  
  245. Hard drive?  Yes  No        If yes, size _____________
  246.  
  247. Are you a SysOp?  Yes  No   If yes, BBS name ____________________________
  248.  
  249.                                     BBS # _______________________________
  250.  
  251.                                 Your Handle _____________________________
  252.  
  253.                                  Max Baud ___________________
  254.  
  255. Comments/Suggestions
  256.  
  257. __________________________________________________________________________
  258.  
  259. __________________________________________________________________________
  260.  
  261. __________________________________________________________________________
  262.  
  263. __________________________________________________________________________
  264.  
  265. How do you rate CWAC for ease of installation
  266.  
  267.            Poor   Fair   Average   Good  Excellent
  268.  
  269.  
  270. Complete this form and mail, complete with $10 and a disk, to:
  271.  
  272. Cool Wave Computing
  273. 1672 Ringfield Drive
  274. Galloway, OH  43119
  275.  
  276. You may also issue me a Gift-Of-Time on GEnie for $12, fmail me this
  277. completed form at mail address OFFY, and upon receipt of the Gift-Of-Time, I
  278. will mail you a registered version.  I will NOT fmail a registered version,
  279. this is merely an option for your registration fee.
  280.