home *** CD-ROM | disk | FTP | other *** search
/ Boldly Go Collection / version40.iso / TS / 05B / UZ.ZIP / UZ.DOC < prev    next >
Text File  |  1992-07-26  |  6KB  |  145 lines
  1.  
  2. UZ.EXE v1.0
  3. A program to automate the routine done with every downloaded file
  4. Copyright 1992 by Alan Dougherty
  5. All Rights Reserved
  6.  
  7. DISCLAIMER OF WARRANTY
  8. THIS SOFTWARE IS OFFERED "AS IS" AND IS WITHOUT A WARRANTY AS TO
  9. PERFORMANCE OR MERCHANTABILITY.  THIS PROGRAM IS OFFERED WITHOUT ANY
  10. EXPRESS OR IMPLIED WARRANTIES WHATSOEVER.  BECAUSE OF THE DIVERSITY
  11. OF CONDITIONS AND HARDWARE UNDER WHICH THIS PROGRAM MAY BE USED, NO
  12. WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED.  THE USER
  13. IS ADVISED TO TEST THE PROGRAM THOROUGHLY BEFORE RELYING ON IT.  THE
  14. USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM.
  15.  
  16. When I call one of my favorite bulletin boards and download a file,
  17. there are things that I always do after receiving the file.
  18.     1 - strip the ZIP comment
  19.     2 - unzip the file into another subdirectory
  20.     3 - do a virus check
  21.     4 - read documents
  22.     5 - look for name of the executable
  23.     
  24. I wrote UZ to automate this process.  Everything UZ does could be
  25. done with a batch file except for loading the documents.  UZ
  26. supports wildcards in designating which files to load in your
  27. favorite editor.
  28.  
  29. UZ can be configured with the file UZ.CFG.  The UZ.CFG included
  30. looks like this:
  31.  
  32. C:\DOWNLOAD
  33. C:\DOWNLOAD\EXTRACT
  34. PKUNZIP.EXE -e FILENAME DESTPATH
  35. .ZIP
  36. STRIPZIP FILENAME
  37. SCAN.EXE *.* /NOMEM /NOBREAK /BELL /E .OVL .DAT .BIN
  38. LIST.COM
  39. *.me
  40. *.new
  41. *.
  42. *.doc
  43. *.man
  44. *.txt
  45. #*.c
  46.  
  47. Each line must end with a carriage return.  Some lines may be
  48. ignored by UZ if commented out with a # character (see example last
  49. line above).
  50.  
  51. The first row is where to look for the file to process IF it is not
  52. present in the current subdirectory.  A trailing backslash is
  53. optional. This subdirectory must already exist.
  54.  
  55. The second row is where to put the extracted files.  This line is
  56. required and should not be commented out. Trailing backslash is
  57. optional. This subdirectory must already exist.
  58.  
  59. The third line is the name of the archiver to use and its arguments.
  60. Please enter "FILENAME" in UZ.CFG wherever you want the name and
  61. path for the archived file substituted.  Enter "DESTPATH" wherever
  62. you want the path to the destination subdirectory substituted.  The
  63. archiver, in the example PKUNZIP.EXE, must have the full filename
  64. including extension to spawn properly.  There may be ten arguments
  65. following it in UZ.CFG (all must be on same line in UZ.CFG).
  66.  
  67. The fourth line is the default extension of the archived files.  If
  68. this is given in UZ.CFG, it allows you to simply enter the filename
  69. without the extension when using UZ (e.g.  "UZ filename" instead of
  70. "UZ filename.ext").  This line can be commented out with a # as the
  71. first character on the line but will then require that the extension
  72. is given every time when using UZ.
  73.  
  74. The fifth line is the program to use on the archived file prior to
  75. extracting it.  There may be up to ten arguments to this program in
  76. UZ.CFG (all must be on same line in UZ.CFG).  This line may be
  77. commented out with a # as the first character in the line.  UZ will
  78. then not call this program.  You must include the file extension.
  79.  
  80. The sixth line is the program to use on the extracted files in the
  81. destination subdirectory.  There may be up to ten arguments (all on
  82. same line in UZ.CFG) and this line may also be commented out. You
  83. must include the file extension.
  84.  
  85. The seventh line is your favorite editor.  There may be up to ten
  86. arguments (all on same line in UZ.CFG) and this line may also be
  87. commented out.  You must include the file extension.
  88.  
  89. The next lines (up to ten) give the wildcard specifications of which
  90. files you want to load into your editor.  Please be cautious in your
  91. selections since it may lead to loading executables or other binary
  92. files.
  93.  
  94.  
  95. UZ will need to know where its configuration file is if it is not
  96. present in the current subdirectory.
  97.       SET UZ=C:\UZDIR
  98. Set the environment variable UZ to the directory which contains the
  99. UZ.CFG file.
  100.  
  101. You may also change the wildcard specifications "on the fly" by
  102. placing them on the command line.  For instance, suppose you
  103. download a file that contains some interesting C source code.
  104. If "*.c" is not in UZ.CFG, or if it is and you want to examine the C
  105. source first, simply enter:
  106.  
  107.                 UZ <filename> *.c
  108.                 
  109. This will cause UZ to process the archived file and load the C
  110. source first.  Then it will load files into your editor as given in
  111. UZ.CFG.  Any number of arguments you type on the UZ command line
  112. will be processed in sequence.
  113.  
  114. UZ returns the following errorlevels:
  115. DOS errorlevel value
  116.      0  UZ executed properly
  117.     -1  No argument
  118.     -2  Environment variable not set
  119.     -3  Can't open UZ.CFG file
  120.     -4  Archiver commented out
  121.     -5  Programming error in SPAWN ARCHIVE logic
  122.     -6  Extension commented out
  123.     -7  Can't find file in current directory (sourcepath commented out)
  124.     -8  Destination directory commented out
  125.  
  126. This program is copyrighted shareware.  You are free to copy and
  127. distribute this program as long as no files are deleted or altered
  128. in any way.  You may use this program on a trial basis for one week.
  129. After this period of time you must register this program if you
  130. continue to use it.
  131.  
  132.                   SCENIC POSTCARD REGISTRATION  
  133.  
  134. To register this program, simply send me a scenic postcard from your
  135. area.  Include any comments or suggestions regarding UZ on it.  I'll
  136. enjoy your postcard and you will then be registered.  Registered
  137. users will receive no additional benefits other than a license
  138. to use the program.
  139.  
  140. Mail postcards to:
  141.  
  142. Alan Dougherty
  143. 1 Crossing Circle G
  144. Boynton Beach, FL 33435
  145.