home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / ZIPENG10.ZIP / ZIPENG.TEX < prev    next >
Text File  |  1993-03-21  |  19KB  |  306 lines
  1. /* DO NOT MODIFY THIS FILE IN ANY WAY!!!  SEE WARNING AT END OF FILE. */
  2. /* Lines for Files to Delete from the .ZIP File: input box: */
  3. Specify the files you want to delete.  Use of wildcards    
  4. is fine, so you can type *.COM *.EXE to delete all the   
  5. files with those extensions from the .ZIP file.  Or you  
  6. can type AUTOEXEC.BAT CONFIG.SYS to delete just those  
  7. two files.  Or, if you want a checkbox from which you     
  8. can choose whatever individual files you want, click   
  9. on CANCEL here.  
  10. Just be aware that many DOS programs (like zippers)      
  11. can't handle command lines longer than 127 characters.    
  12. So don't specify too many individual filenames!   
  13. /* Lines for .ZIP File to Create: input box: */
  14. Type the full drive:\pathname\filename of the file you   
  15. want to create.  For example, D:\ZIPENGIN.ZIP or     
  16. C:\UTIL\ZIPFILES\TESTING.ZIP      
  17. Your default directory name is already filled in for 
  18. you if you have used the Edit-the-Config routine to   
  19. specify one.  If you don't want to use that directory  
  20. name this time, then just backspace over it and type    
  21. a new name.  Or if you do, then just add a filename    
  22. to the end of it.
  23. /* Lines for Target Directory Name: input box: */
  24.    Type the full drive:\pathname of the directory into which you want to     
  25. place the extracted files.  Like C:\UTIL or A:\ or B:\DOWN\NEW       
  26.    If there's already a directory name there, and you don't want to use that      
  27. one, just backspace or edit it.
  28.    If the directory you want to unzip into does not exist, Zip Engine will   
  29. create it as long as its parent exists.  For example, if C:\DOWN\NEW does       
  30. not exist but C:\DOWN does, then Zip Engine will create NEW if you say so.       
  31.    If you want to create a directory with the same name as the file you're     
  32. unzipping, use $ as the directory name.  Like if your .ZIP file is THIS.ZIP      
  33. then type C:\UNZIP\$ to have Zip Engine create C:\UNZIP\THIS        
  34. /* Lines for Directory of Files to Zip: input box: */
  35. Type the full drive:\pathname of the directory which contains the files    
  36. you want to zip.  For example, C:\PRODIGY\PRO-UTIL or C:\OS2          
  37. or D:\ or whatever. 
  38. Or if you're not adding any files to the .ZIP file you're working with,  
  39. choose CANCEL now to continue without specifying any files to add, and       
  40. we'll add '-x*.*' to the command line instead, so that the Zip program     
  41. won't just add all the files from the current directory as it would by  
  42. default.
  43. /* Lines for Files to Zip: input box: */
  44. Now specify the files you want to zip from that directory.   
  45. For example, *.* for all the files, or *.EXE for all the 
  46. .EXE files, or TEXT*.*  *.EXE for all the .EXE files   
  47. and all the files that start with TEXT, or AUTOEXEC.BAT      
  48. CONFIG.SYS to do just those two files.  Or, if you want    
  49. a checkbox from which you can choose whatever individual      
  50. files you want, click on CANCEL here.   
  51. Just be aware that many DOS programs (like zippers) can      
  52. not handle command lines longer than 127 characters.  So     
  53. don't specify too many individual filenames!  
  54. /* Lines for Careful! message box: */
  55. This command may not be successful.  DOS programs can only
  56. process the first 127 characters of any command, and OS/2 passes
  57. some extra characters to the DOS session.  So watch the number
  58. in the lower right corner of the 'Watch the Command Line Being
  59. Built' window (which is the length of the command you're building)
  60. and if your command does not work, then you'll have an idea of
  61. what the limit is on your system so that next time, you'll know
  62. not to exceed that limit.  If you often run into this problem,
  63. then you should consider getting an OS/2 zipper to replace your
  64. current one.
  65. /* Lines for Finished building command line.... message box: */
  66. The Command Line is complete now.  It is shown in the dialog box below, 
  67. and you may edit it if desired (especially in cases where you have chosen 
  68. default options in the Edit-the-Config routine and you want to get rid of
  69. one of them for this particular operation).  If you edit it and change
  70. your mind, clicking on CANCEL will allow you to execute the command 
  71. as it was before you edited it, or alternately abort the entire opera-
  72. tion.  Click on OK in the dialog box below when you're satisfied with the 
  73. command and ready to execute it.  Note that if you have a long command it 
  74. is split into sections.  Each can be no longer than 80 characters.  And
  75. be very careful not to add or remove spaces at the ends of each section!
  76. /* Lines for Cancel? message box: */
  77. Do you want to execute the command as it was before you edited
  78. it, or do you want to abort the operation and return to the
  79. main menu?  OK to execute, or CANCEL for main menu.
  80. /* Lines for Sorry! message box under the -& switch in Zopt: */
  81. You cannot use the 'paths and subdirs' switches
  82. with the -&s switch.  That's ok, because the -&s
  83. takes care of everything the 'paths and subdirs'
  84. switches do.  Dropping the 'paths and subdirs'
  85. switches now.
  86. /* Lines for Files to Exclude from the .ZIP File: input box: */
  87. Specify the files you want to exclude.  Use of wild-   
  88. cards (* or ?) is fine.  For example, you might type   
  89. *.EXE  *.COM  *.BAT  to exclude all the files with    
  90. those extensions.  Or say AUTOEXEC.BAT CONFIG.SYS           
  91. to exclude just those two files.  Or, if you want a  
  92. checkbox from which you can choose whatever indiv-      
  93. idual files you want, click on CANCEL here.   
  94. Just be aware that many DOS programs (like zippers)     
  95. can't handle command lines longer than 127 characters.      
  96. So don't specify too many individual filenames!   
  97. /* Lines for Files to Exclude from Extraction: input box: */
  98. Specify the files you want to exclude.  Use of wild-   
  99. cards (* or ?) is fine.  For example, you might type   
  100. *.EXE  *.COM  *.BAT  to exclude all the files with    
  101. those extensions.  Or say AUTOEXEC.BAT  CONFIG.SYS          
  102. to exclude just those two files.  Or, if you want a  
  103. checkbox from which you can choose whatever indiv-      
  104. idual files you want, click on CANCEL here.   
  105. Just be aware that many DOS programs (like unzippers)       
  106. can't handle command lines longer than 127 charac-    
  107. ters.  So don't specify too many individual filenames!  
  108. /* Lines for Really? message box: */
  109. Are you sure you want to relabel the entire target drive
  110. with the volume label that's inside the .ZIP file, if any?
  111. Click on NO to drop the -$ switch.
  112. /* Lines for Files to Extract from the .ZIP File: input box: */
  113. Specify the files you want to extract.  Use of wildcards   
  114. is fine, so you can type *.COM *.EXE to extract all the   
  115. files with those extensions from the .ZIP file.  Or you  
  116. can type AUTOEXEC.BAT CONFIG.SYS to extract just those          
  117. two files.  Or, if you want a checkbox from which you     
  118. can choose whatever individual files you want, click on    
  119. CANCEL here.  
  120. Just be aware that many DOS programs (like zippers) can      
  121. not handle command lines longer than 127 characters.    
  122. So don't specify too many individual filenames!    
  123. /* Lines for Input the Date: input box: */
  124. Type the date you wish to use in MMDDYY format.      
  125. For example, type 120192 for Dec 1, 1992.     
  126. (Leave this line blank to use today's date.)  
  127. /* Lines for OPTIONAL Temporary directory: input box in Temp: subroutine: */
  128. Type the full drive:\pathname of the directory you   
  129. want Zip to use as a working directory, if any.   
  130. For example, D:\TEMP or F:\DOWNLOAD\WORKING           
  131. You should choose a directory on the fastest drive   
  132. you have, provided that it has enough free space.   
  133. If there's already a directory name there, and you  
  134. don't want to use that one, just backspace over it.  
  135. /* Lines for Temporary directory: input box in ViewExec: subroutine: */
  136. Type the full drive:\pathname of the directory   
  137. you want Unzip to use as a working directory.    
  138. For example, D:\TEMP or F:\DOWNLOAD\WORKING           
  139. /* Lines for Oops! message box in ViewExec: subroutine: */
  140. Sorry, there's a problem here.  We can't create the temporary     
  141. directory so we have to abort this operation in order to avoid     
  142. the possibility of deleting any of your files.     
  143. /* Lines for WAIT!  Warning! message box in ViewDiskFiles: subroutine: */
  144. Move this little dialog box out of your way while you read your .INF
  145. file, but DO NOT CLICK ON OK until you've CLOSED the VIEW program
  146. (by double-clicking mouse button one on the little square in the top
  147. left corner of the VIEW window).  If you ignore this piece of advice,
  148. the Zip Engine program will try to delete its temporary files while
  149. VIEW is still using one of them, and OS/2 won't allow that to happen
  150. so you'll have temp files left behind on your hard drive to find two
  151. months from now and wonder where they came from.
  152. /* Lines for Edit the .INI File: message box in EditCfg: subroutine: */
  153. Welcome to the ZIPENG.INI modifying routine.  In order for you to get
  154. here, either you chose this option from the main menu or else your zip/
  155. unzip programs could not be found.  Now let's see your .INI file.....
  156. ZIPENG.INI file cannot be found in the current directory or on
  157. the PATH, which are the only places The Zip Engine looks for it.
  158. We'll have to create a new ZIPENG.INI file in the current directory
  159. now.  If you want to move it later, you may.  By the way, your current
  160. /* Lines for Exit Line: message box: */
  161. The eighth possible line in the .INI file is "exit action" which tells
  162. the Program what you want to do after the first zip/unzip function is
  163. completed.  The default is to go back to this Program's main menu,
  164. where you can perform more zip/unzip functions.  If you ever do more
  165. than one zip/unzip function in a row, this saves you the time it takes
  166. this Program to initialize itself.  But if you rarely want to perform
  167. more than one function at a time, and you don't want to have to click
  168. on CANCEL to exit this Program afterward, then choose EXIT below.  Then
  169. this Program will just exit instead of returning you to the main menu
  170. when your first zip/unzip function is completed.
  171. /* Lines for Zipper Line: input box: */
  172. The first possible line in the .INI file is "zipper", which tells   
  173. the Program the full drive:\path\filename.ext of your zip program.     
  174. Shown below is whatever is already assigned to your "zipper" line,       
  175. if anything.  You may leave it as it is, change it to whatever you     
  176. like, or leave it blank to remove the whole line from the .INI   
  177. file.  But if you do that (remove the line), your zip program must     
  178. be named PKZIP.EXE and must be on the PATH command in the           
  179. OS/2 CONFIG.SYS file or the Zip Engine program will not work.       
  180. /* Lines for Unzipper Line: input box: */
  181. The second possible line in the .INI file is "unzipper", which tells    
  182. the Program the full drive:\path\filename.ext of your unzip program.    
  183. Shown below is whatever is already assigned to your "unzipper" line,      
  184. if anything.  You may leave it as it is, change it to whatever you    
  185. like, or leave it blank to remove the whole line from the .INI  
  186. file.  But if you do that (remove the line), your unzip program must    
  187. be named PKUNZIP.EXE and must be on the PATH command in the           
  188. OS/2 CONFIG.SYS file or the Zip Engine program will not work.      
  189. /* Lines for Directory Lines: multbox: */
  190. The next three possible lines in the .INI file are "temporary directory",
  191. "extract directory", and "default directory".  The input box shows what
  192. you now have assigned to those lines, if anything.  You may leave them as
  193. they are, change them to whatever you want, or leave them blank to remove
  194. them from the .INI file altogether.  The Program will not allow you to
  195. specify "\" (root directory of current drive), however---that could cause
  196. all sorts of problems if you ever happen to use The Zip Engine with a 
  197. floppy drive as your current drive.  So if you want to specify the root
  198. directory, include the drive letter along with it, as in "C:\" or "D:\".
  199.      The "temporary directory" line tells Zip Engine where to create its
  200. own temp files, and what to use whenever you unzip files with the "-b"
  201. switch (though the Program does allow you to override that setting for
  202. the "-b" switch if you so desire).
  203.      The "extract directory" line tells Zip Engine what directory name
  204. to supply for your approval each time you see the Target Directory
  205. Name: input box.
  206.      The "default directory" line tells Zip Engine what directory to show
  207. you in the FileBox dialog boxes and to supply for your approval each time
  208. you see the .ZIP File to Create: input box.  If you always keep all of
  209. your .ZIP files in a certain directory, then you probably want to put
  210. its name here.  If you leave this line blank, Zip Engine will use the
  211. current directory for those functions.
  212. /* Lines for Default options information window: */
  213. The last three possible lines in the .INI file are 'zip options', 'unzip
  214. options', and 'global options', which tell the Program to use certain
  215. switches on your command lines without you telling it each time to do so.
  216. Do NOT put anything here until you are very familiar with both your
  217. zipper's syntax AND this Program.  What you put here for zip options
  218. will go on the command line during any procedure that takes you to the
  219. 'Zip Special OPTIONAL Switches' dialog box.  What you put here for un-
  220. zip options will go on the command line during any procedure that takes
  221. you to the 'Unzip Special OPTIONAL Switches' dialog box.  What you put
  222. here for global options will go on the command line during any proced-
  223. ure that uses your Zip/Unzip program in any way, even things that happen
  224. in the background such as the unzipping of a .ZIP file into a temporary
  225. directory in order to let you view text files within the .ZIP file.  Be
  226. careful to use only options that you want used EVERY time Zip Engine
  227. performs ANY sort of Zip/Unzip operation.  Remember that's only for the
  228. global options.  The zip options and unzip options are more forgiving,
  229. because they only apply to the commands which you have a chance to edit
  230. before executing.  So for example, if you like to use the -$ switch with
  231. zip ALMOST all the time, you can put it here and then at times when you
  232. don't want to use it, you can just edit it out of the finished command
  233. line before executing it.  DO NOT choose an option from the Special OP-
  234. TIONAL Switches dialog boxes that has already been specified here, be-
  235. cause it'll already BE on the command line.  Note that there is no error
  236. checking in this routine, so don't put anything into these default options
  237. lines that you're not SURE is valid and appropriate.  And DO NOT put any-
  238. thing into the zip options and unzip options lines that is also in your
  239. global options line, or it will show up twice on the command line.
  240. ----------
  241. Click on the "Options lines:" dialog box above when ready to fill it in.
  242. /* Lines for About..... message box: */
  243.                        The Zip Engine.
  244.      A graphical approach to zipping and unzipping files.
  245.    Copyright 1992-93 by Kari Jackson and Bart Toulouse.
  246.                           Version 1.0
  247.         3201 Monroe Street, Omaha NE  68107-4048
  248.    Click on OK to view the Zip Engine program's .DOC file
  249.        or click on CANCEL to return to the main menu.
  250. /* Lines for Sorry! message box in About..... routine: */
  251. The ZIPENG.DOC file cannot be found either in the current directory
  252. or an any of the directories on your CONFIG.SYS file's PATH
  253. command.  Returning you to the main menu......
  254. /* Lines for Sorry! message box in PAR2.q = '-s' routine: */
  255. You did not specify any files to add to this
  256. .ZIP file.  You can only add password protec-
  257. tion to the files that are being added.
  258. Therefore, you cannot use the -s switch at
  259. this time.
  260. /* Lines for Sorry! message box in CreateError: subroutine: */
  261. We were not able to create the temporary file which is
  262. needed in order to complete this procedure.  The most
  263. common reason for this to occur is a full root direc-
  264. tory.  The root directory of a hard drive can contain
  265. no more than 512 entries (or 112 for a double-density
  266. floppy, or 224 for a high-density floppy).  If you're
  267. already at the limit, then Zip Engine cannot create
  268. another.  If the root directory size limit is not the
  269. problem, then you should run CHKDSK and see what it
  270. finds.  Returning you to the main menu now.
  271. /* Lines for VSAY window in ViewOnly: subroutine: */
  272. When the Unzip program's window comes up, click on it to bring it to the
  273. foreground, and type your password (or if you clicked on OK by mistake,
  274. just type anything and hit Enter).  You will not see the Unzip program
  275. ask you for input, since its output is being redirected into a temp file.
  276. /* Lines for Window Action window: */
  277. The ninth possible line in the .INI file is "start switch" which tells
  278. the Program how you want your zip/unzip windows to behave.  By default,
  279. the windows are opened by the START command with the /C switch, which
  280. means they close by themselves as soon as the zip/unzip command has
  281. finished.  This means you don't have to close them yourself, but it
  282. also means it's not terribly easy for you to see the output of the zip/
  283. unzip command if you want to.  If you often want to see that output,
  284. you can tell Zip Engine to START those windows with the /K switch
  285. instead, which means they'll stay open so you can see the output, and
  286. then you'll have to type the EXIT command in those windows yourself to
  287. close them when you're done reading them.
  288. /* Lines for EditColors: subroutine: */
  289. The last lines in the .INI file specify the colors you
  290. want to use for Zip Engine windows.  That is, not dialog
  291. boxes---those use the Menu Text and Dialog Background
  292. colors from whatever color scheme is current on your
  293. Desktop.  This is about the windows that open up for
  294. information purposes only, with no mouse buttons on them,
  295. like this one.  The default window colors are white on
  296. blue.  This Edit-the-.INI-File routine will not use
  297. your chosen colors, but the rest of The Zip Engine will.
  298.  
  299. * *** WARNING *** WARNING *** WARNING *** WARNING *** WARNING *** WARNING *** *
  300. * This file must NOT be modified in ANY way.  If you even open it with a text *
  301. * editor and save it without changing anything, it could be ruined.  Because  *
  302. * most text editors do not preserve spaces at the end of lines.  This file's  *
  303. * end-of-line spaces ARE NECESSARY.  If you've opened this file to look at it,*
  304. * get out, go away, close the file without SAVING it!  Now!                   *
  305. * *** WARNING *** WARNING *** WARNING *** WARNING *** WARNING *** WARNING *** *
  306.