home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / archiver / expand15 / expando.txt < prev    next >
Text File  |  1993-04-07  |  12KB  |  238 lines
  1.                              Expand-o-matic:
  2.               Automatic File Extractor (Well, semi-automatic)
  3.                                Version 1.5
  4.                                 12/20/92
  5.                               Public Domain
  6.                                    by
  7.                               Andrew Cullum
  8.  
  9. If you are already familiar with an earlier version, see the attached
  10. update.txt file for a brief list of the changes.
  11.  
  12. This program may be freely copied so long as all three files (expando.prg, 
  13. expando.txt and expand15.rsc) are included in their original 
  14. (i.e. unmodified) form.  If you find this program useful you might 
  15. consider:
  16.                 Sending the author (namely me) $5-10
  17.                 Giving blood at your local Red-Cross
  18.                 Going out and buying a commercial program at your
  19.                         local ST dealer
  20.                 Some other good deed
  21.  
  22. Thanks to those who gave me help on Pexec(), namely Carlos Sara,
  23. Carlos Varela and Richard Syratt (Hope I got the names right, I'm
  24. going from memory)
  25.  
  26. And Thanks to Fred Koch and Gordon Meyer for their suggestions for the
  27. upgrade.
  28.  
  29. And forgive me, this is my first attempt at documentation.
  30.  
  31.  
  32. So, what's it do?
  33.  
  34. Expand-o-matic is a shell for dealing with a variety of compressed
  35. formats.  Most shells that I have seen allow you to do everything
  36. that the various archivers can do, i.e. archive, extract, list files,
  37. etc.  The problem with this is that they are not as convenient as they
  38. might be.  As I almost never do anything other than extract files, I
  39. decided to write a shell that is more convenient, at the price of
  40. not being able to do the other functions.  Thus, after much swearing
  41. and reading of manuals (normally in that order, and repeated several
  42. times), was born Expand-o-matic.  The first time you run the program,
  43. you will need to set it up (see the section on Setup below), to
  44. tell it which archive types you deal with, and where the program for
  45. that type is located.  After that, just give it the name of the file,
  46. or if you are using NeoDesk or a Tos version of 2.05 or higher, drag 
  47. the file onto the Expando.prg icon, and off it goes .  It looks at 
  48. the extension of the file you give it, and calls the appropriate 
  49. program for that type of archive.  All this is explained in more 
  50. detail below.
  51.  
  52. Setup:
  53. Before you can extract files with Expand-o-matic you will need to set
  54. everything up.  To do this go to the Setup option under the File menu,
  55. or hit Alt-s.  Across the top of the dialog box that appears it will
  56. say:
  57.         Ext.    Com.            Archive
  58.  
  59. and have a box beneath each.  Ext. stands for extension.  Click on the
  60. box below it and enter the extension for an archive you deal with,
  61. such as .ARC or .LZH.  If you enter lowercase letters, they will be
  62. converted to uppercase for you.  Com.  stands for command.  This is 
  63. the command that is used to extract that type of archive.  For all the 
  64. archivers that I know of x is the  command you want, but I thought I would 
  65. play it safe and make it configurable.  Click on the box and enter the 
  66. appropriate command.  Archive is the program that should be run for 
  67. files that end with the extension listed in the first box.  Click on 
  68. the box below Archive and a file selector will pop up.  Select the 
  69. program you want and click on OK.  The three boxes should then look 
  70. something like this:
  71.  
  72.         .ARC    x       D:\ARCHIVES\ARC602\ARC.TTP
  73.  
  74. To add another extension, command and program, click on New.  See The
  75. New Button below.
  76.  
  77.         To set where your files will be extracted to click to the right of
  78. where it says Destination.  A file selector should appear.  Go to
  79. the drive and directory that you want and click on OK.
  80.  
  81.         To set where it will go to for you to select files, click to the
  82. right of where it says Source.  Select the source directory as you
  83. did for the Destination above.
  84.  
  85. The New Button:
  86.         Click on the button that says New and you will get a blank entry,
  87. in which to add a second set of extension/command/program information.
  88. Use the arrows on either side of the boxes at the top to scroll
  89. through the sets that you have.
  90.  
  91. The Delete Button:
  92.         Click on this to delete the set that is currently displayed at
  93. the top.  You will be asked if you are sure that you want to do this.
  94. Click Yes, or hit return, and it will be erased.
  95.  
  96. The Save Button:
  97.         Click on the Save button to save your current configuration in
  98. a file called EXPANDO.CFG.  Expand-o-matic looks for this file
  99. when it starts up, and reads in the information if it finds it.  The
  100. configuration information is stored in a regular text file, so if
  101. things get messed up it should be easy enough to fix.  If you want to
  102. edit the config file, see 'The Config File' below.
  103.  
  104. The Reload Button:
  105.         This will read in the current EXPANDO.CFG file, thus returning
  106. all your settings to the last time you saved (the poor man's cancel
  107. option).
  108.  
  109. The OK Button:
  110.         Use this to exit Setup
  111.  
  112. The Options Button:
  113.         This button will take you to a seperate dialog box, with six
  114. options listed on it.  If the box to the left of the option is
  115. shaded, the option is turned on.  The options are:
  116.  
  117. Continue Until Cancel?
  118.     If you have a lot of files to extract, click on the box by Continue
  119. Until Cancel.  With this set, after the first archive is done, the
  120. file selector will appear, prompting you for a second.  It will keep
  121. doing this until you hit cancel.
  122.  
  123. Quit After Auto-run?
  124.     If you check this box the program will automatically quit after
  125. expanding files passed to it from the command line or by dropping
  126. files onto the program.  Thus you just have to drop the file on the
  127. icon, it'll extract it and then quit, you don't have to do anything
  128. else.
  129.  
  130. Remember Directories?
  131.         If this option is set, the program will keep track of the last
  132. directory that you selected a file from while 'Expand'ing, and go
  133. back to there for you to select the next one.  If this isn't set, the
  134. file selector will go back to the folder you put into the 'Source' 
  135. box.  If 'Source' isn't set either, it will go to the folder where
  136. expando.prg is.
  137.  
  138. Auto-Create Directory?
  139.         If this is set, Expand-o-matic will create a folder with the same
  140. name as the file you are expanding, minus the extension, and expand
  141. the files into there.  For instance, if your 'Destination' is
  142. 'd:\newstuff\', and you are unarcing 'neato.arc', it would create
  143. 'd:\newstuff\neato\' and unarc the files into there.
  144.  
  145. Use File Directory?
  146.         If this is set your files will be uncompressed to the same
  147. directory that your archive is located in (or a folder created in
  148. that directory, if you have Auto-Create Directory set).
  149.  
  150. Prompt For Directory?
  151.         With this option set, after you select the file(s) to uncompress,
  152. you will be presented with another file selector and asked to choose
  153. the directory for the files to be placed in, rather than the
  154. 'Destination' or Expando directory being used.  If Auto-create is set
  155. new folders will be created in the directory you select.  You can also
  156. have it prompt you for the directory (without this option being set)
  157. by holding down the alternate key when you select the name of the file
  158. to unarchive.
  159.  
  160. Extracting Files:
  161.         There are three ways to extract (or expand) files with
  162. Expand-o-matic.  The easiest way, if you use NeoDesk or
  163. TOS 2.05 or higher, is to simply drag the icon for the archive
  164. you want to extract files from onto the icon for EXPANDO.PRG.
  165. The program will the start up and automatically start extracting for
  166. you.  If you pass it more than one file this way, by holding down
  167. shift and selecting them all, Expand-o-matic will deal with each of
  168. them in turn (Note: TOS 2.05 + only seems to pass the first file name
  169. this way, so you can only drop one file at a time).
  170.         The second way is to simply start up the program and go to the Expand 
  171. option under the Files menu, or hit Alt-e.  You will then be presented 
  172. with a file selector to pick the file that you want it to expand (also 
  173. see Wildcards below).  If you hold down the alternate key when you click 
  174. on OK (or hit return) you will then be presented with a file selector to 
  175. pick the directory to send the files to (just as if you had the 'Prompt
  176. for Directory' option set).  If you have the Continue Until Cancel option 
  177. set, you will be presented with the file selector again after the first 
  178. file is done, and this will continue, surprisingly enough, until you click 
  179. on Cancel.  
  180.         The last way is to rename EXPANDO.PRG EXPANDO.TTP and then enter the 
  181. name(s) of the file(s) that you want to expand in the command line.
  182.  
  183. Wildcards:
  184.         If you are using the Fileselector or Command Line to tell
  185. Expand-o-matic which files to extract you can use wildcards to select
  186. more than one file.  If you enter *.* it will do all files in the
  187. path.  You can also use *.arc, etc to get all files that use one type
  188. of  archiver.  I think file.* should also work, but I don't think
  189. that one will come up much.  Anyway, using the file selector after
  190. selecting 'Expand', simply enter *.* or *.arc, etc. for the filename.
  191. If you are using it as a .ttp, you will need to put
  192. 'drive:\path\*.*', etc.  (i.e. d:\download\*.arc)
  193.  
  194. The Config File
  195. The format is for the .cfg is as follows:
  196.  
  197. 2               <---- The number of entries you have
  198. .ARC x D:\ARC.TTP       <---- The 3 pieces of info for each entry,
  199. .ZOO x D:\ZOO.TTP                 seperated by a space
  200. 10              <---- Integer containing the Options settings (see below)
  201. E:\NEWSTUFF\            <---- Where to extract files to
  202. D:\DOWNLOADS\           <---- Where to go for the files to expand.
  203.  
  204. If you use an archiver that has no command, and need to edit the .CFG
  205. file by hand, put a | in for the command.  If the command you set up
  206. has a space in it, the .CFG file needs a # in place of the space
  207. (i.e. 'l#-d' would be saved in place of 'l -d')
  208.  
  209. Options Integer:
  210.         The first six bits of the integer represent the six options.  
  211. If bit 1 is set, 'Continue until Cancel' is on, bit 2 is for 
  212. 'Quit after Auto-run', 3 is 'Remember Directories' and 4 is
  213. 'Auto-Create Directories'.  5 is for 'Use File Directory'.  With
  214. version 1.5 'Prompt For Directory' has been added, which is the sixth
  215. bit.  If you need to change this, start at 0 (for no options on), add 
  216. 1 for the first option to be on, 2 for the second, 4 for the third, 8 
  217. for the fourth, 16 for the fifth and 32 for the sixth.  So, to have 
  218. 'Continue' and 'Auto-Create' set, you would put 0 + 1 + 8 = 9 on that 
  219. line.  In the example above I have 'Quit' and 'Auto-Create' set (2 + 8).
  220.  
  221.  
  222.  
  223. Questions, Comments, Criticisms, Requests, Enormous Cash Donations?
  224.         Send 'em on in, I'd love to hear from you.
  225.         I can be reached at: (In order of speed with which I will
  226.                         see your message, but reverse order of
  227.                         permanence of access for me.)
  228.  
  229.                 E-mail:  elvis@watserv.ucr.edu
  230.                 Genie:   A.CULLUM1
  231.                 Real mail:
  232.                         Andrew Cullum
  233.                         995 Hymettus Ave
  234.                         Encinitas, CA 92024
  235.                         (Note: This is my parent's address, but it is much
  236.                         more permanent than my current one is likely to
  237.                         be, and mail can be forwarded from there)
  238.