home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / ARCHIVE / AC137.ZIP / AC.DOC < prev    next >
Encoding:
Text File  |  1991-10-15  |  17.6 KB  |  635 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                      ▓▓▓▓▒              ▓▓▓▓▓▓
  25.                     ▓▒   ▓▒    V1.37   ▓▓▒   ▓▓▒
  26.                    ▓▒     ▓▒          ▓▓▒
  27.                   ▓▓▒     ▓▓▒         ▓▓▒
  28.                   ▓▓▓▓▓▓▓▓▓▓▒         ▓▓▒
  29.                   ▓▒       ▓▒          ▓▓▒   ▓▓▒
  30.                   ▓▒       ▓▒rchive     ▓▓▓▓▓▓▒onverter
  31.                            
  32.                
  33.                           Donald M. Langhorne
  34.                         South 5241 Columbia Ave.
  35.                            Hamburg, NY 14075
  36.  
  37.  
  38.                          Regisration only $10
  39.                                    
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                                      -i-
  68.  
  69.  
  70.                                     Contents
  71.                                     --------
  72.  
  73.  
  74.                       Introduction---------------------- 1
  75.                       Special Features------------------ 1
  76.                       Installation---------------------- 1
  77.                       Archive programs------------------ 2
  78.                       Usage----------------------------- 3
  79.                       Commands-------------------------- 4
  80.                       Options--------------------------- 5
  81.                       Examples-------------------------- 5
  82.                       Customizing AC.CFG---------------- 6-7
  83.                       Limitations----------------------- 7
  84.                       Disclaimer------------------------ 8
  85.                       Registration---------------------- 8
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.                                       -1-
  133.  
  134.  
  135.  
  136. INTRODUCTION:
  137. =============
  138.  
  139.         AC is a command line archive converter.  Unlike full blown menu
  140.      driven programs, AC is completely command line oriented.
  141.      It is not necessary to have any knowledge of the archive
  142.      program switches, unless you plan to modify the configuration file.
  143.  
  144.         AC supports the most popular archive programs in circulation.
  145.      By customizing the AC.CFG file that is now an integral part of
  146.      AC, it is possible to use almost any archive program.  AC allows
  147.      for easy conversion between any two archive types specified.
  148.      It accepts both wild card specifications and multiple file
  149.      specifications on the command line.
  150.  
  151.  
  152. SPECIAL FEATURES:
  153. =================
  154.  
  155.       -AC has the ability to report conversion to a log file
  156.       -AC works in conjunction with a configuration file AC.CFG.  This allows
  157.        for customization
  158.       -AC supports recursive archives.  To convert an archive recursively
  159.        the archive being converted to MUST support recursion.
  160.       -AC has a /c switch to prevent suppresion any ouput during
  161.        execution of the archivers/dearchivers
  162.       -AC has a /v switch to scan the archives for viruses during conversion
  163.       -AC supports creation/extraction of SFX files created by many of
  164.        the archivers.   
  165.       -AC will prompt for a new file name if it is about to overwrite an
  166.        archive file.    
  167.       -AC accepts wildcard specifications on the command line.
  168.       -AC allows an unlimited number of files and or file specs. on the
  169.        command line.  Each file must be separated by a space.                
  170.       -If the file you want to convert is unique(no other file by that name
  171.       exists in the current directory) you do not need to specify the 
  172.       extension, AC will find it for you.
  173.  
  174.  
  175.  
  176. Installation:
  177. =============
  178.  
  179.         Installation can be completed by following these simple steps:
  180.  
  181.         1)  Copy the files AC.EXE and AC.CFG to a directory in your path
  182.  
  183.         2)  Wherever you place AC.EXE, AC.CFG MUST be in the SAME
  184.             location for AC to operate.
  185.  
  186.         3)  Check the file AC.CFG to make sure that the archivers match
  187.             the ones you use, and if necessary modify it to suit your
  188.             system(See the section modifying AC.CFG for more help)
  189.  
  190.  
  191.         That's It!! Enjoy.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                       -2-
  198.  
  199. Archive Programs:
  200.  
  201.         The following is a list of all known archivers that I was able
  202.         to integrate into AC along with the versions I have tested
  203.  
  204.         -AC will search your path for the following archive programs:
  205.  
  206.  
  207. Type:          Files Supported           Vendor   Versions(tested & supported)
  208. =============================================================================
  209.  
  210. ARC programs:
  211.                pkarc.exe & pkxarc.exe   {PKWARE, Inc.}        3.61
  212.                pkpak.exe & pkunpak.exe  {PKWARE, Inc.}        3.61
  213.                arc.exe                  {Sea, Inc.}           6.02
  214.  
  215. ARJ programs:
  216.                arj.exe                  {Robert Jung}         2.00-2.21
  217.  
  218. LZH programs:
  219.                lha.exe                  {Haruyasu Yoshizaki}  2.11-13
  220.                lharc.exe                {Haruyasu Yoshizaki}  1.13c
  221.  
  222. ZIP programs:
  223.                pkzip.exe & pkunzip.exe   {PKWARE, Inc.}       1.10
  224.  
  225. DWC programs:
  226.                dwc.exe                                        A5.01
  227.  
  228. HYP programs:
  229.                hyper.exe                                      2.5
  230.  
  231. ZOO programs:
  232.                zoo.exe                                        2.01-2.10
  233.  
  234. MD  programs:
  235.                mdcd.exe                                       1.00
  236.  
  237. PAK programs:
  238.                pak.exe                                        2.51
  239.  
  240. LZS programs:
  241.                larc.exe &larc7e.ovr                           3.33
  242.           
  243.  
  244.        
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                      -3-
  263.  
  264.  
  265.  
  266. USAGE:
  267.      The syntax is as simple and forgiving as possible.  All that is
  268.      necessary to convert an archive is to follow these simple rules:
  269.  
  270.         1) make sure you are in the current directory of the archive
  271.            you want to convert
  272.  
  273.         2) Determine what you want to convert to and find out the switch you
  274.            need by running AC without any switches
  275.  
  276.         3) Be sure the archive you want to convert has an apprropriate
  277.            extension.  IE ZIP files should have a .zip extension.  This
  278.            is how AC determines what archive extractor to use
  279.  
  280.         4) Enter the command 'AC /<switch>[option] Archive file'
  281.                 There are no spaces between switches and options
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                      -4-
  328. COMMANDS:
  329. =========
  330.  
  331.      
  332.      /K (Keep original archive)
  333.        This switch causes AC to process the archive normally, but will 
  334.        not delete the original archive.
  335.  
  336.      /C (Show Output to Console)
  337.        This switch causes all output to be shown on the screen, 
  338.        instead of the default which suppresses output.
  339.  
  340.      /V (Scan for viruses)
  341.        This switch causes AC to scan the archive for viruses using 
  342.        Mcafee's SCAN.  If used in conjunction with the /R switch
  343.        AC will scan the archive recursively.
  344.  
  345.      /W (Write output to log file)
  346.           When using this switch AC will report file sizes and file
  347.           names to a log file called AC.LOG, which is located in the
  348.           same location as AC.EXE, if AC.LOG does not exist then AC will
  349.           create it.
  350.  
  351.      /A (Convert to ARC file)
  352.        This switch converts any archive type supported by AC to a 
  353.        corresponding ARC file.
  354.      
  355.      /D (Convert to DWC file)
  356.        This switch converts any archive type supported by AC to a 
  357.        corresponding DWC file.     
  358.  
  359.      /H (Convert to HYP file)
  360.        This switch converts any archive type supported by AC to a 
  361.        corresponding HYP file.
  362.  
  363.      /J (Convert to ARJ file)
  364.        This switch converts any archive type supported by AC to a 
  365.        corresponding ARJ file.
  366.      
  367.      /L (Convert to LZH file)
  368.        This switch converts any archive type supported by AC to a 
  369.        corresponding LZH file.
  370.  
  371.      /O (Convert to ZOO file)
  372.        This switch converts any archive type supported by AC to a 
  373.        corresponding ZOO file.
  374.      
  375.      /P (Convert to PAK file)
  376.        This switch converts any archive type supported by AC to a 
  377.        corresponding PAK file using PAK.EXE
  378.  
  379.      /M (convert to MD file)
  380.        This switch converts any archive type supported by AC to a 
  381.        corresponding MD file using MDCD.EXE
  382.      
  383.      /S (Convert to LZS files)
  384.        This switch converts an archive to a corresponding LZS file
  385.        using LARC.EXE
  386.  
  387.      /Z (convert to ZIP files)
  388.        This switch converts an archive to a corresponding ZIP file
  389.        using PKZIP.EXE
  390.  
  391.                                       -5-
  392.  
  393.  
  394.  
  395.  
  396. OPTIONS:
  397. ========
  398.      The options are used in conjunction with the archive switches, they
  399.      have no effect when used on their own.
  400.           
  401.      e  Create SFX file
  402.      
  403.      x  Use extra compression.  This option only works with DWC and ZOO
  404.           conversions, otherwise it is ignored.
  405.      
  406.      t  Set date to latest member.  This option will set the date
  407.         of the resulting archive to equal the newest member of
  408.         the archive file.
  409.      
  410.      r  Convert archives recursively.  If any directories are stored
  411.         in archive that is to be converted, it's directory structure
  412.         will be retained.
  413.  
  414.         NOTE: Simply add the option after the switch without spaces or
  415.           any other characters between the two.  Multiple switches
  416.           may be strung together.
  417.  
  418.  
  419. EXAMPLES:
  420. =========
  421.  
  422.           1.)  AC file1.arc
  423.                  this converts the file 'file1.arc' to a zip 
  424.                  file with the name 'file1.zip'
  425.  
  426.           2.)  AC file1
  427.                  this searches the current directory for a file 
  428.                  matching 'file1.*'.  If no file is found or the file does 
  429.                  not have a valid extension, then no action is taken.
  430.      
  431.           3.)  AC *.ARJ  
  432.                  this searches the current directory for all files
  433.                  with .ARJ extensions and convert each file in turn, 
  434.                  the name of each will remain the same, except the extension 
  435.                  will become .ZIP
  436.  
  437.           4.)  AC /K /L file.zoo  
  438.                   This converts the file 'file.zoo' to 
  439.                   'file.lzh' and keeps the original archive intact.
  440.  
  441.  
  442.           5.)   AC /jert MYFILE.ZIP
  443.                   This will convert the file MYFILE.ZIP with the following
  444.                   options:
  445.                  --MYFILE.ZIP will be converted to an ARJ file.
  446.                  --MYFILE.ZIP will convert files recursively
  447.                  --MYFILE.EXE will be created since e option spec. 
  448.                  --MYFILE.EXE will use the date of it's latest member
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.                                      -6-
  458.  
  459. Configuration of AC.CFG
  460. =======================
  461.  
  462.         Modifying AC.CFG should ONLY be perfomed when it is necessary
  463.         and if you are familiar with the command line switches of the
  464.         various archivers.  If you have problems after making
  465.         modifications, double check your changes before going any
  466.         further.
  467.  
  468.         AC.CFG is broken up into 4 parts.
  469.  
  470.         1) DEFAULTS:
  471.            This section is only recognized when a license
  472.            number has been purchased.
  473.  
  474.         2) COMPRESSORS:
  475.            For Each archiver there are four fields that take the
  476.            form  ARCHIVE-EXTENSION="filename"  S="xxx" r="xxx" t="xxx"
  477.  
  478.             ARCHIVE-EXTENSION: As of this release this is NOT a value that
  479.             can be altered, it MUST remain unchanged.
  480.  
  481.                filename: is the name of the archive compression program for
  482.                          the associated type.
  483.  
  484.             S="xxx": This is where the default switches go for creating
  485.                      an archive. The actual switches go inside the
  486.                      quotations.
  487.  
  488.             R="xxx": This is where the switches for recursion go.  They
  489.             are appended to the normal switches defined with S="xxx".
  490.  
  491.             T="xxx": This is where the switches for timestamping go.
  492.                   They are appended to the normal switches and the
  493.                   recursion switches.
  494.  
  495.  
  496.          3) DECOMPRESSORS:
  497.             for each De-Archiver there are three fields that take the
  498.             form ARCHIVE-EXTENSION="filename"  S="xxx" r="xxx"
  499.  
  500.               ARCHIVE-EXTENSION: As of this release this is NOT a value
  501.               that can be altered, it MUST remain unchanged.
  502.  
  503.                   filename: is the name of the archive extractor program
  504.                             for the associated type.
  505.  
  506.                   S="xxx":  This is where the default switches(if any)
  507.                             go for extracting an archive. The actual
  508.                             switches go inside the quotes.
  509.  
  510.                   R="xxx":  This is where the switch(es) go to extract
  511.                             an archive with recursion(or extract with
  512.                             full path names.  If recursion is specified
  513.                             this switch will REPLACE the switch settings
  514.                             in S="xxx", unlike the compressors that
  515.                             appended the recursion switch to the normal
  516.                             switches.
  517.                                 (Cont.)
  518.  
  519.  
  520.  
  521.  
  522.                                       -7-
  523.  
  524.  
  525.          4) SFX ARCHIVERS:
  526.             For Each SFX there are three fields that take the form:
  527.               S(ARCHIVE-EXTENSION)="filename"  S="xxx"
  528.  
  529.                 S(ARCHIVE-EXTENSION): As of this release this is NOT a
  530.                 value that can be altered, it MUST remain unchanged.
  531.  
  532.                         filename: this is the name of the program to be
  533.                                 used to CREATE SFX(SELF EXTRACTING ARCHIVES)
  534.  
  535.                         s="xxx":Any necessary switches for creating the
  536.                                 archive go here.
  537.  
  538. LIMITATIONS:
  539. ============
  540.  
  541.         The following is a compilation of known limitations that I have
  542.         encountered while writing AC, some are in the works(to be added
  543.         in future releases) and others are inherent in the archivers
  544.         that AC uses and would be extremely difficult, if not impossible
  545.         to fix
  546.  
  547.         --When extracting a SFX archive created by ARJ that has
  548.           sub-directories(Created with recursion) It is NOT possible to
  549.           extract the archive to a single directory, even though
  550.           apparently it is an option with the ARJSFX module.  To avoid
  551.           lost files, be sure to convert to an archive type that
  552.           supports recursion, and also add the 'r' option to enable
  553.           recursion.
  554.  
  555.         --Do not Add Recursive switch settings to DWC or ZOO, while they
  556.           both support recursion, they both use the full path with the
  557.           drive, and will not work with AC at this time.
  558.  
  559.         --While AC does support the option to scan archives for viruses,
  560.           I have not been able to test this feature properly in a
  561.           real-time situation.  I would appreciate hearing from ANYONE
  562.           who experience a virus detection with AC, and can let me know
  563.           if it executed properly or not.
  564.  
  565.         --While Larc does have the ability to create SFX files, it will
  566.           create a COM file if it is less than 65k and an EXE if greater
  567.           than 65k.  At this time AC does not support SFX files with
  568.           COM extensions.  This will be addressed in a future release.
  569.  
  570.         --Wildcards are accepted on the command line for example: *.zip,
  571.           myfile.* and so forth, however myfile*.* does NOT work
  572.           at this time, this is a limitation of AC and will be
  573.           addressed in a future release.
  574.  
  575.         --DWC uses the environment variable TEMP if it exists to point
  576.           to the directory for it to create temporary files in.  If this
  577.           value is set to a directory that does not exist DWC will not
  578.           function.
  579.  
  580.         --When using 4DOS or NDOS AC will NOT convert files properly
  581.           with LHA.  This seems to be a problem with 4dos's handling of
  582.           the NULL device.  It is recommended to use MSDOS 4.0+
  583.  
  584.  
  585.  
  586.  
  587.                                   -8-
  588.  
  589.  
  590.  
  591. DISCLAIMER:
  592. ===========
  593.  
  594.      I assume no liability or responsibility for any damages that may occur
  595.      from the use or misuse of this program.  A user operates this program 
  596.      without any guarantees as to the accuracy of the information included.  
  597.      All use is at the user's risk.
  598.  
  599.  
  600. A note on registration:
  601. =======================
  602.  
  603.      I am releasing this program as shareware.  Using this program for a
  604.      NON-COMMERCIAL PURPOSE is allowed.  If you find this program of use, 
  605.      a donation of $10 is encouraged.  Use of this program 
  606.      for COMMERCIAL use REQUIRES registration of $10 US per copy.
  607.      Please make payment in US funds to:
  608.  
  609.        Donald M. Langhorne
  610.        South 5241 Columbia Ave.
  611.        Hamburg, NY  14075
  612.  
  613. Thank you for your interest in AC.
  614.  
  615.  
  616. Why register:
  617. =============
  618.  
  619.         Registering this program gives you a license to use AC and enjoy
  620.         free upgrades for the life of the program.  The registered
  621.         version will enable defaults for all options to be set
  622.         either on or off in the CFG file.
  623.         For more information or to register write to the above address.
  624.  
  625. problems or suggestions:
  626. ========================
  627.  
  628.    If you encounter a problem or have any suggestions in reference to this
  629.    program, please send your comments to the above address or to the 
  630.    following boards.
  631.  
  632.      BIBMUG:716-695-0583
  633.      Data Express:716-627-3299
  634.                 
  635.