home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / arc_lbr / arcvrt21.arc / ARCVERT.DOC < prev    next >
Text File  |  1989-08-12  |  13KB  |  338 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                               ARCvert Version 2.1
  8.                      A utility to convert from one archive
  9.                                format to another.
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                     Author:
  17.                               David Pitts
  18.                            6620 Danbrooke Park Drive
  19.                               Charlotte, NC 28227    
  20.  
  21.  
  22.  
  23.  
  24. DISCLAIMER
  25.  
  26. I don't promise or warrant a single thing about this program. If
  27. you use it and it doesn't work then too bad. I have no reason to
  28. believe that it could possibly harm anybody's hardware or other
  29. software but I won't accept responsibility for anything.
  30.  
  31. I am NOT releasing this to the public domain.  I just don't
  32. choose to charge for it right now.  I reserve all rights to all
  33. parts of the program.
  34.  
  35. You are however free to copy and distribute this program to
  36. anyone you like as long as you charge nothing at all for it. No
  37. disk or distribution fees or anything at all.  If you can't just
  38. give it away then don't do anything with it.
  39.  
  40. Thanks for downloading ARCvert.  I would be very pleased to
  41. receive any positive or negative comments about this program that
  42. you would care to make.
  43.  
  44. I can be reached at the address on the cover page. I can also be
  45. reached on GEnie at CLAGRAPH.
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62. FILE LIST
  63.     ARCVERT.DOC  You are reading it. Congratulations.
  64.     ARCVERT.CFG  The configuration file.  It MUST be in the
  65.              directory that you start ARCvert from. It
  66.              does many important things. Read the .DOC
  67.              file carefully to learn more.
  68.     ARCVERT.EXE  This is the program file.    
  69.  
  70. FEATURES
  71.     -Converts from ANY archive format that uses the conventional
  72.      command string. Including but not limited to:
  73.                          ARC
  74.                  PKARC
  75.                  PAK
  76.                  LHARC
  77.                     DWC
  78.                      ZOO
  79.     -Converts to ANY of the above formats or any other archive format
  80.      if the program uses the conventional command string.
  81.     -Automatically determines the extraction commands required
  82.     -You decide the format to convert to
  83.     -Capable of being run from a batch file without human intervention
  84.     -No hard disk required (But it is much faster with one)
  85.     -Un-archive from any drive and re-archive on any other drive
  86.     -Does not alter or delete the original file
  87.     -Save your configuration for future use
  88.     -Easy user interface
  89.  
  90. STARTING ARCvert
  91.  
  92. Type ARCVERT at the DOS prompt. Any of the archiving programs
  93. that you wish to use to archive and un-archive your files must
  94. be in the default directory OR in the DOS path somewhere. The
  95. file ARCVERT.CFG MUST be in the directory that you start
  96. ARCvert from. If this is not the case then you will get an error
  97. message and you will have to start over. Please understand that
  98. ARCvert is only a front-end system for other archiving programs
  99. and that it does not archive or extract files by itself.
  100.  
  101. COMMANDS ON THE MAIN MENU
  102.  
  103.     InputDir
  104.         This command allows you to access the directory window
  105.     for the input directory that is displayed on the screen.
  106.     This will allow you to scroll the information up and down
  107.     in order to see all of the files listed. Only files as
  108.     specified in the INPUT PATH will be shown.
  109.  
  110.     OutputDir
  111.      This does the same thing as the previous command except
  112.         it shows all files in the OUTPUT PATH.
  113.     
  114.     Go
  115.         This starts the conversion process. Here is what actually
  116.         happens after the program starts.
  117.  
  118.     1. Copy the first file that matches the FILE MASK from
  119.         the INPUT PATH to the WORK PATH.
  120.  
  121.      2. Shell to DOS and UN-ARCHIVE the file into the empty
  122.         WORK PATH directory using the program commands specified
  123.         by the EXTRACT SEQUENCE.
  124.  
  125.      3. Delete the original archive file leaving only the
  126.         files that were formerly archived under the old format.
  127.  
  128.     4. Shell to DOS and ARCHIVE all the files in the WORK
  129.         PATH directory into a single archive using the the
  130.         program commands specified by the ARCHIVE SEQUENCE.
  131.  
  132.     5. Copy the newly created archive file to the directory
  133.         specified by OUTPUT PATH.
  134.  
  135.     6. Delete ALL files in the directory specified by WORK
  136.         PATH.
  137.  
  138.     7. Copy the next file from INPUT PATH to the WORK PATH
  139.         and start the process over until all files are complete.
  140.  
  141.     Go from the command line
  142.     ARCvert can also be started from the command line by
  143.     typing the command line as ARCVERT GO. If ARCvert is
  144.     started in this manner the program will immediately
  145.     proceed to execute based upon the default parameters
  146.     already in place in ARCVERT.CFG. This will allow you to
  147.     use ARCvert to convert all uploads to a given file type
  148.         as a timed "event". Since ARCvert does not do the actual
  149.         conversion it is impossible to trap for errors during
  150.         the actual conversion. You should check the files in the
  151.         destination directory against the files in the input
  152.         directory BEFORE deleting the original files.
  153.  
  154.     Shell
  155.      This command allows you to shell to DOS. Type 'exit' to
  156.         return to the program.
  157.  
  158.     View Defaults
  159.     This lets you look at all your default settings at once.
  160.     It is a good idea to check them before beginning the
  161.     file conversion process.
  162.  
  163.     ESC to Exit
  164.     This exits the program.
  165.  
  166.     Defaults
  167.     This command allows you to set up the program for nine
  168.     different settings. These settings are:
  169.  
  170.      1. Input Path
  171.         The input path is the file directory and file mask that
  172.         tells the program which files to transfer. The program
  173.         will attempt to transfer all files shown in the Input
  174.         Directory window. Some valid input paths are:
  175.                 a:\*.*
  176.             c:\util\arc\*.zip
  177.     Always include a drive specifier, the complete path, and
  178.     a file mask. None of the files in this directory will be
  179.     altered or deleted. Any files that do not have an archiving
  180.     program specified for their file extension in ARCVERT.CFG
  181.     will NOT be converted. Any files that have an extension
  182.     matching a specified extension in .CFG file will be converted
  183.     using the un-archive command string given in the .CFG file.
  184.  
  185.  
  186.     2. Output Path
  187.     The output path is the drive and directory that the files
  188.     archived in the new format will be transferred to. Always
  189.     include a drive specifier and directory information. If you
  190.     are specifying the ROOT directory of a drive DO NOT include
  191.     a backslash. Some examples of valid Output Paths are:
  192.              b:
  193.              c:\outpath
  194.     Always leave off the last backslash of any specification.
  195.     
  196.     3. Work Directory
  197.     This is the name of a directory that will be created as a
  198.     subdirectory of the default directory. This is where all
  199.     the work will be performed. This directory will be deleted
  200.     when the program is finished with the transfers. I
  201.     recommend that this be left as $work$ so it will be
  202.     easily identified if something should prevent it from
  203.     being deleted.
  204.  
  205.     5. Archive Command
  206.     This is the command string that will be used to RE-
  207.     archive the files designated in the Input Path. Basically
  208.     what this should be is everything that normally goes on
  209.     the command line except the name or names of the files to
  210.     be archived. Some examples are
  211.         for LHARC the archive string is 'LHARC a'
  212.             for PKZIP the archive string is 'PKZIP'
  213.         for PKZIP with extra compression the
  214.                archive string is 'PKZIP -ex'
  215.             for ZOO the archive string is 'ZOO -a'
  216.     Other options and switches may be set by simply putting
  217.     them in this command. The program will supply the
  218.     filenames and destinations. After setting the Archive
  219.     command you will be prompted to give the New File Extension.
  220.     
  221.     6. New File Extension
  222.     This is the file extension that the program that you
  223.     specified as the ARCHIVING program uses as its default.
  224.     You MUST change this EVERY TIME that you change the
  225.     ARCHIVE command to a different program. If this is not
  226.     set correctly the program will name the new file wrong.
  227.     I could have made this an automatic feature of the
  228.     program but chose not to because there may be a new
  229.     program out tomorrow that is better and faster than any
  230.     out there today with a different file extension. Done
  231.     this way you can use it even if I've never heard of it.
  232.     
  233.     7. Color Toggle
  234.     Type Color if you want color. Type Mono if you want mono.
  235.     If you wish to change the colors used by the program you
  236.     will need to edit ARCVERT.CFG with your word processor.
  237.     Be sure to save ARCVERT.CFG as an ASCII file. Your word
  238.     processor's format may mess up the file if you are not
  239.     careful. If it is not immediately clear to you how to
  240.     change the colors in the .CFG file then you probably should
  241.     not mess around with it. Always make a backup copy of a
  242.     current .CFG file BEFORE you edit it.
  243.  
  244.     8. Snow Toggle
  245.     Set this to Slow if you are getting snow on your monitor.
  246.     Leave it on Fast if you are not.
  247.  
  248.     9. Save Configuration
  249.     This writes all the things that we just discussed to a
  250.     file called ARCVERT.CFG. This file must be in the directory
  251.     that ARCvert is started from. If it is missing the program
  252.     will bomb out.    
  253.  
  254.     Changing and adding the commands that EXTRACT archives
  255.  
  256.     It is possible to add new programs that will be automatically
  257.     executed by ARCvert. The file ARCVERT.CFG has these lines at
  258.     the bottom of it as supplied with the program:
  259.  
  260.         ext=.zip pkunzip
  261.         ext=.arc pkxarc
  262.         ext=.lzh lharc e
  263.         ext=.zoo zoo -e
  264.         ext=.dwc dwc e
  265.         ext=.pak pak e
  266.         end of file
  267.  
  268.     If you use a different program to extract .ARC files then you
  269.     will need to change the line that says "ext=.arc pkxarc" to
  270.     use the program that you desire. To change it to use ARCE
  271.     you would edit the line to read "ext=.arc arce".
  272.     
  273.     To add another program simply insert another line in front of
  274.     the line that says "end of file".  The program will allow you
  275.     to use up to 24 different extraction commands for 24 different
  276.     file extensions. DO NOT alter the line that indicates the
  277.     end of the file. This line MUST be the last non-blank
  278.     line in the file. It MUST be all lower case.    
  279.  
  280.     To break it down a little further:
  281.  
  282.         The first four characters on an extraction command line
  283.         are always "ext="
  284.     
  285.         The next four characters are always a period and the
  286.         file extension of the type of file to be extracted.
  287.                            .zoo
  288.  
  289.         The next character is always a space
  290.  
  291.         The next characters are the program name and any
  292.         options required to properly un-archive the file.
  293.  
  294.  
  295. SOME NOTES ON THIS PROGRAM
  296.  
  297. I would first like to make it clear that I have never written and
  298. never will write an archiving program. I am in awe of all those
  299. that have written the programs that this program makes use of. I
  300. do not advocate any particular archiving program. They each have
  301. their strengths and I think everyone should choose for themselves.
  302. This program simply makes it easier to convert from those that
  303. you don't like to the one that you do like.
  304.  
  305. This program was written in QuickBasic 4.5. It is not a miracle
  306. of modern programming by any stretch of the imagination but it
  307. works damn well. I have used several routines from the ProBas
  308. (tm) libraries from Hammerly Computer Services, Inc.  These have
  309. proven to be invaluable tools in all the programs that I have
  310. written.
  311.  
  312. I have found that in the past when I have written similar
  313. utilities that the response from users has been sparse. I pity
  314. the people that are trying to make a living from shareware.
  315. I don't know where the term originated but this program is
  316. classified as "FOOLWARE". I'd be a fool if I thought you would
  317. send me any money for it. This is my way of thumbing my nose at
  318. all the "BEGWARE" and "CRIPPLEWARE" authors out there.
  319.  
  320. These are NOT to be confused with legitimate "SHAREWARE" authors
  321. that do a great job. I just cannot stand a program that BEGS
  322. every thirty seconds or so for me to register my copy or flashes
  323. "UNREGISTERED TRIAL EVALUATION TEST COPY" in hot pink letters on
  324. every screen. Worse is the DATABASE program in which the
  325. unregistered version lets you save two whole records to disk
  326. before ceasing to work. 
  327.  
  328. If you have comments or suggestions about this program please
  329. feel free to mail me a letter at the address on the cover page or
  330. contact me on GEnie at CLAGRAPH.
  331.  
  332. PKZIP/PKUNZIP is copyright (c)1989 PkWare, Inc.
  333. DWC is copyright (c)1986,87,88 Dean W. Cooper
  334. LHARC is copyright (c)1988,89 Haruyasu Yoshizaki
  335. PAK is copyright (c)1988,89 NoGate Consulting
  336. ZOO is copyright (c)1988 Rahul Dhesi
  337.  
  338.