home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / afe_t11.zip / AFE_T.DOC next >
Text File  |  1994-09-30  |  9KB  |  232 lines
  1.  
  2. ABSTRACT:
  3.  
  4. AFE uTiny is a small program for opening, examining, scanning and
  5. unarchiving archive files.  It takes advantage of the WPS's object-oriented
  6. nature,including drag and drop.  Multiple archives can be opened to their 
  7. own temporary directories at the same time.
  8.  
  9. AFE aTiny is a small program for creating and updating archives.  It takes
  10. advantage of the WPS's object-oriented nature, including drag and drop.
  11.  
  12. These programs have been tested under OS/2 2.1 and 2.11.  They currently
  13. are also running on my personal machine under the Warp II beta.
  14.  
  15. REGISTRATION:
  16.  
  17. AFE aTiny and AFE uTiny are companion shareware programs.  After an
  18. evaluation period of 15 days, you should register.  The registration fee
  19. is $15 U.S.  This covers both programs.  Upon receipt of your registration
  20. form and payment, you will be mailed a registration file that will disable
  21. the bootup shareware notice for both programs, current and future versions.
  22. See REG-FORM.A for further instructions.
  23.  
  24. Current registered users of AFE 2.4 or higher are granted free registration
  25. for these programs.  If you copy your current registration file to the
  26. directory where the AFE xTiny programs are installed, it will work with
  27. them.
  28.  
  29. AFE xTiny registered users will be given a $12.50 credit toward registration
  30. of AFE.  Your registration file will not work with AFE, however if you send
  31. in the AFE registration form with the balance of payment, you will be sent
  32. a registration file for AFE.
  33.  
  34.  
  35. INSTALLATION:
  36.  
  37. Unzip AFET11.ZIP and run AFET-INS.CMD.
  38.  
  39. Running AFET-INS.CMD copies all required files to the directory you
  40. designate and creates desktop objects for both AFE xTiny programs.
  41.  
  42. If you have a registration file, put that in the same directory.
  43.  
  44. NOTE: DO NOT COPY AFE.INI TO AFET.INI !!!!
  45.  
  46. After installation, the settings notebook will pop up.
  47.  
  48.  
  49. CONFIGURATION:
  50.  
  51. The settings notebook is used to define the variables that the AFE xTiny
  52. programs will use on your system.
  53.  
  54. The WORK DRIVE is where these programs will create their temporary directories.
  55.  
  56. The ARC DIRECTORY is where new archives will be created, or where an existing
  57. archive that you want to update should be.
  58.  
  59. The various executable settings for archiving and unarchiving should include
  60. the command line switches. If you are not going to be working with one of
  61. the three defined archive types, leave the field BLANK.
  62.  
  63. The "OTHER" page is for defining and archive program for something other than
  64. ZIP, LZH, ZOO, or ARJ archives.
  65.  
  66. I've tested with the same programs as AFE uses.  Use the suggested switches
  67. until you are comfortable with the program, then decide for yourself.
  68.  
  69. I've also done some cursory testing with PKZIP (for DOS) with success.
  70.  
  71. The /pause option is required for OS2SCAN 2.x.  It shouldn't be necessary
  72. with 1.x series.  The /all option is for OS2SCAN 2.1 or higher.
  73.  
  74. Full path spec is not required if the particular external program is in your
  75. path.
  76.  
  77. When settings are complete, close the notebook and AFEaT will become visible.
  78.  
  79.  
  80. RUNNING AFEaT:
  81.  
  82. Select an archive type by clicking on the appropriate radio button.  You can
  83. also use the cursor keys to switch among the types.  You'll see the "focus"
  84. move from type to type.  Pressing the spacebar when the focus is on the type
  85. of your choice, accomplishes the same as clicking on it.
  86.  
  87. The focus is now on the "name" field.  Type in the name you want for a new
  88. archive, or the one you want to update (must be in the ARC DIRECTORY).
  89.  
  90. When you press the okay button (or press enter), AFEaT will open an empty
  91. folder for you to fill with file objects you want to include in your archive.
  92. AFEat will take your archive name, append .TMP to it, and create a directory
  93. on your WORK DRIVE.
  94.  
  95. Drag and drop copies of file objects from other folders using the standard
  96. WPS means.  These are the files to be included in your archive.
  97.  
  98. You may open other folder views by typing the drive:\directory spec in the
  99. "Open Folder" field, then click OK (or press enter).
  100.  
  101. If you put just a single letter in this field, AFEaT will attempt to open a
  102. tree view for the drive by that name if it exists and is ready (for a floppy
  103. drive).  If you type a drive letter followed by : an icon view will be 
  104. opened instead of a tree view.
  105.  
  106. You can type multiple entries in this field separated by spaces, and AFEaT
  107. will open them all.
  108.  
  109. Once AFEaT creates and opens the temporary directory for your files, it
  110. enables the "Create" entry on the menu bar.
  111.  
  112.  
  113. AFEaT MENU BAR:
  114.  
  115. Create
  116. ------
  117. Clicking Create (or Alt-C) will open a windowed session for the archive
  118. program you've defined and create the archive of the files in the temporary
  119. directory.  Any user interaction with the archive program is done in this
  120. window.  The archive will be created in the ARC DIRECTORY.
  121.  
  122. If an archive of the same name and type already exists in the ARC DIRECTORY,
  123. it will be updated (can be dependant on the switches you've defined) with
  124. these files.
  125.  
  126. Cleanup
  127. -------
  128. Clicking Cleanup (or Alt-L) will destroy the .tmp folder that AFEaT had
  129. created.  AFEaT's Cleanup only remembers the last temp directory it created,
  130. unlike AFEuT.
  131.  
  132. Cleanup does not cause AFEaT to close down.
  133.  
  134. Exit
  135. ----
  136. Click (or Alt-x) exits the program with no cleanup performed.
  137.  
  138. About, Settings
  139. ---------------
  140. You don't think I'm really going to explain this, do you?
  141.  
  142.  
  143. RUNNING AFEuT:
  144.  
  145. Once AFEuT is started, opening an archive is as simple as dropping it on the
  146. "Archive Drop Area".  If you don't have a program handy to open an icon view
  147. of a folder, simply type the path spec in the "Open Folder" entry field.
  148. Pressing OK (or Enter) will open the folder.  You can type multiple folder
  149. names or drive names in this field as explained above in the AFEaT 
  150. documentation.
  151.  
  152. When you drag an archive to the drop area, AFET will check the file's
  153. extension and start the appropriate unarchiver.  If the extension is not
  154. ZIP, ZOO, LZH, or ARJ, AFEuT will prompt you for the file type.
  155.  
  156. AFEuT will open a window for the unarchiving program and run it.  Any prompts
  157. or error messages should be viewed or responded to in this window.  At the
  158. same time, AFEuT will open a folder of the temporary storage directory for
  159. the files from the archive.  When the files are are all created, the WPS
  160. will populate the folder.  Sometimes this is slow, especially when many 
  161. folders are opened, and I've found that when I use the DOS ARJ program, I
  162. always have to use the "refresh now" on the temporary folder.  Probably
  163. because the files are created in a DOS session.
  164.  
  165. You may open as many archives as you want.  All will be opened to separate
  166. directories.  AFEuT takes the filename of the archive, drops the extension,
  167. appends .tmp, and uses that for the temp folder name on your defined Work
  168. Drive.
  169.  
  170. From this point you can drop a file on a viewer object, move or copy files
  171. in various ways using the standard WPS tools, or virus scan all the files
  172. in the opened archive(s).  The "Open Folder" dialogue is always available
  173. if you want to open a folder of a path to which you want to drag and drop
  174. individual or all files.  Popup "copy" or "move" is another way...
  175.  
  176.  
  177. AFEuT MENU BAR:
  178.  
  179. Scan
  180. ----
  181. Clicking Scan (or Alt-S) will start the scan program you've defined.  Scan
  182. will run against each .tmp folder that AFEuT has opened.  Each scan will run
  183. in a separate session.   Results are displayed in the windowed session.
  184.  
  185. Cleanup
  186. -------
  187. Clicking Cleanup (or Alt-C) will destroy ALL .tmp folders that AFEuT has
  188. created.  If you wish to keep ONE of several still intact, you should use
  189. the individual folders' popup dialog to delete the unwanted ones.  Another
  190. alternative is to use Cleanup, then recreate just the one you want.
  191.  
  192. Cleanup does not cause AFEuT to close down.
  193.  
  194. Exit
  195. ----
  196. Click (or Alt-x) exits the program with no cleanup performed.
  197.  
  198. About, Settings
  199. ---------------
  200. You don't think I'm really going to explain this, do you?
  201.  
  202.  
  203. OTHER NOTES:
  204.  
  205. AFEuT can be started by dropping an archive file on the desktop object.
  206. This archive will automatically be opened.
  207.  
  208. Multiple archives may be dropped on the "Archive Drop Area" simultaneously.
  209. This is not necessarily recommended, as the screen clutter can be
  210. unbelievable!
  211.  
  212.  
  213. DISCLAIMER:
  214.  
  215. THE AFE xT PROGRAMS ARE PROVIDED AS IS. AUTHOR H.M. WEINER IS NOT
  216. RESPONSIBLE FOR DAMAGE, LOSS, OR ANY OTHER DISCOMFORT YOU MAY SUFFER
  217. FROM THE USE OF THESE PROGRAMS.
  218.  
  219.  
  220. RELEASE NOTES:
  221.  
  222. 7/10/94 - 1.0 released
  223.  
  224. 9/30/94 - 1.1 released
  225.  
  226. corrected version/release numbers on "About" window
  227.  
  228. fixed code so combination of bare drive and drive/directory spec could be
  229. typed into open folder field at the same time.
  230.  
  231. Converted to VX-REXX 2.1
  232.