home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 15 / AACD15.ISO / AACD / Utilities / arc2arc / arc2arc.doc < prev    next >
Encoding:
Text File  |  2000-10-12  |  6.3 KB  |  167 lines
  1.  
  2.     Arc2Arc 2.8 - by Rolf Max Rotvel
  3.  
  4.  
  5.     DESCRIPTION    
  6.     Arc2Arc is a universal archive converter.
  7.  
  8.     Unlike the typical lha -> lzx converters you can configure this one to
  9.     convert to and from any archive format you like.
  10.     Examples: gz to zip, tgz to lha, lzx to lha (of course :-)) or even dms
  11.     to lha!
  12.  
  13.     Arc2Arc uses the standard List syntax when specifying archive files. This
  14.     means wildcard support and the ALL/S, PAT/K, etc keywords.
  15.     It's also possible to convert different archive formats in one go. Like
  16.     converting all zip and lha files in a directory to lzx.
  17.  
  18.     Arc2Arc also copies any filenote from the original archive to the new.
  19.     Also it automatically converts any dots in new archive names to
  20.     underscores to make sure the correct suffix is added by the archiver and
  21.     hyphenates any spaces in archive filenames.
  22.  
  23.  
  24.     INSTALLATION
  25.     Copy the script to rexx:
  26.     Copy arc2arc.prefs to s:
  27.  
  28.  
  29.     CONFIGURATION
  30.     Load the configuration (s:arc2arc.prefs) file into your text editor and
  31.     change the settings to suit your system. 
  32.     NB: Don't forget that the configuration file is actually an Arexx script
  33.     so stick to Arexx conventions. Ie: Don't use ';' as comment identifier
  34.     etc. If in doubt just change the values and don't touch anything else.
  35.  
  36.     The first word of the dearchiver description strings is the archive
  37.     suffix. Arc2Arc uses this to figure out which dearchiver to launch. You
  38.     don't have to worry about case, but you must include all the dots (Eg:
  39.     .LHA, .TAR.GZ, etc).
  40.  
  41.     It's important that you think a bit about the order of the list. If you
  42.     list .GZ before .TAR.GZ, .tar.gz archives will be recognized as straight
  43.     .gz archives. So childpatterns must be listed before parentpatterns.
  44.  
  45.     The rest of the dearchiver string is the actual command including options.
  46.     If the dearchiver requires redirection (Like GZip) you must include the
  47.     '>' sign at the end of the dearchiver string.
  48.  
  49.  
  50.     The first word of the archiver strings is the archive type. This must be
  51.     the same as the suffix created by the archiver, but without any dots (Eg:
  52.     LHA, LZX). Case isn't important.
  53.     The rest of the archiver string is the actual command including options.
  54.     Note: You can only use archivers capable of archiving the contents of a
  55.     directory, like LhA, Lzx or Zip). 'Single file' archivers like GZip won't
  56.     work.
  57.  
  58.  
  59.     Tmpdir is the directory where Arc2Arc creates its work directory. Keep
  60.     this in t: if you have enough ram.
  61.  
  62.  
  63.     Nodearcstr is the error message Arc2Arc displays if it can't find any
  64.     dearchiver for a file. 
  65.     Overwritestr is the prompt Arc2Arc displays when it asks if it should
  66.     overwrite an existing archive.
  67.     You can translate these message to your language if you like. All other
  68.     error messages in Arc2Arc are from system commands, ie: they are already
  69.     translated.
  70.  
  71.  
  72.     USAGE
  73.     rx arc2arc [ARCTYPE],DIR/M,P=PAT/K,SUB/K,SINCE/K,UPTO/K,ALL/S
  74.  
  75.     [ARCTYPE]
  76.     is the name of the archive format you want to convert to. This should
  77.     match one of the archivers you have configured (But again, case doesn't
  78.     matter). You can specify the arctype anywhere on the commandline.
  79.     If you don't specify this Arc2Arc will use the default archiver (arc.1).
  80.  
  81.     DIR/M,P=PAT/K,SUB/K,SINCE/K,UPTO/K,ALL/S
  82.     Arc2Arc uses List to create a list of archives to process. This means you
  83.     can use wildcards and the List file selection options listed above.
  84.     Don't use FILES/S or DIRS/S or any of the display format options like
  85.     LFORMAT/K. But nothing should happen if you do anyway - Arc2arc will
  86.     simply display some error messages and exit.
  87.  
  88.     Examples:
  89.     rx arc2arc ZIP dl:test1.lha dl:test2.lzx
  90.     This will create the archives dl:test1.zip and test2.zip
  91.  
  92.     rx arc2arc dl:#?.zip
  93.     Assuming that LZX is your default archiver this will convert all your zip
  94.     files in dl: to lzx.
  95.  
  96.     rx arc2arc dl: ALL PAT #?.zip LHA
  97.     Scan all subdirectories of dl: for zip files and convert them to lha.
  98.  
  99.     rx arc2arc "dl:te st1.lha" dl:test2.2.zip" LZX
  100.     This will create the archives dl:te-st1.lzx and test2_2.lzx
  101.  
  102.     rx arc2arc ZIP dl:test.lha dl:test.lzx
  103.     Here Arc2arc detects that dl:test.zip will be created twice and asks if
  104.     you want to overwrite the first copy or skip converting this archive.
  105.  
  106.     The original files are not deleted of course.
  107.  
  108.     If an error happens while listing, dearchiving or archiving Arc2Arc will
  109.     try to clean up and exit gracefully.
  110.  
  111.  
  112.     NOTES
  113.     Sometimes Arc2Arc isn't able to delete its temp directory, just the
  114.     contents of it. This is probably because some archivers doesn't release
  115.     their lock on this directory properly. You'll get an error message if this
  116.     happens.
  117.  
  118.     Don't forget to add all necessary options to your archivers. Like LhA -r
  119.     that enables archiving of subdirectories.
  120.  
  121.     Arc2Arc uses a temporary arc2arc: assign to circumvent any problems with
  122.     spaces in paths (Eg: "Ram Disk"). This is why you this assign turns up
  123.     in packer/unpacker output.
  124.  
  125.  
  126.     CREDITS:
  127.     Thanks to 
  128.  
  129.     Michael for the emails.
  130.     Javier de las Rivas for the bugreport/suggestions.
  131.  
  132.  
  133.     COPYRIGHT
  134.     No copyright. Do whatever you want with this.    
  135.  
  136.  
  137.     DISCLAIMER
  138.     It's all your fault :-) 
  139.  
  140.  
  141.     AUTHOR
  142.     Please send send any comments you might have to me: 
  143.     rolfrotvel@bigfoot.com
  144.  
  145.  
  146.     HISTORY:
  147.     2.5 - First release.
  148.     2.6 - Readded deleting of tmpdir.
  149.           Added support for converting many files in one go.
  150.           Added wildcard support.
  151.           <arctype> can be anywhere on commandline.
  152.           Any '.' in filename are removed.
  153.           Added protection against overwriting of new files.
  154.     2.7 - Bugfix: Converting files in current dir failed.
  155.           Added AmigaDOS dms2dir script.
  156.           Added support for most of the c:List file selection options.    
  157.           Added much better error handling.
  158.     2.8 - Fixed all problems with spaces in path/filenames (Javier de las
  159.           Rivas).
  160.           Removed the file renaming system if an archive was about to be 
  161.           overwritten. Now it prompts with an 'Overwrite [y/N]'.
  162.           Moved configuration section to an external file.  
  163.           Made it possible to 'translate' Arc2Arc (Javier de las Rivas).
  164.           Dots in new archive names are now translated to underscores instead
  165.           of being removed.
  166.           
  167.