home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util1 / zgen122.lzh / ZGEN.DOC < prev    next >
Text File  |  1990-12-07  |  35KB  |  1,019 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.               ┌──────────────────┐
  7.               │          │
  8.               │     Z G E N     │
  9.               │          │
  10.               └──────────────────┘
  11.                  v1.22
  12.  
  13.  
  14.                       MS-DOS File and Archive Management Utility
  15.  
  16.               (c) copyright 1990 RWare Software Company
  17.               portions copyright Borland International
  18.               portions copyright Ralph Brown
  19.  
  20.               ALL WORLDWIDE RIGHTS RESERVED
  21.  
  22.  
  23.  
  24.  
  25.  
  26. 1
  27. ┌──────────────────────────────── Disclaimer ─────────────────────────────────┐
  28. │                                          │
  29. │  RWare makes no warranty of any kind, either express or implied,          │
  30. │  including but not limited to implied warranties of merchantablility          │
  31. │  and fitness for a particular purpose, with respect to this software          │
  32. │  and accompanying documentation.                          │
  33. │                                          │
  34. │  IN NO EVENT SHALL RWARE BE LIABLE FOR ANY DAMAGES (INCLUDING           │
  35. │  DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF       │
  36. │  BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS) ARISING OUT OF THE USE      │
  37. │  OF THIS PROGRAM, EVEN IF RWARE HAS BEEN ADVISED OF THE POSSIBILITY OF      │
  38. │  SUCH DAMAGES.                                  │
  39. │                                          │
  40. │                                          │
  41. │  By using this program, you agree to these terms.                  │
  42. │                                          │
  43. └─────────────────────────────────────────────────────────────────────────────┘
  44.  
  45. Trademarks:
  46.  
  47. PKZIP and PKUNZIP are trademarks of PKWARE Inc.
  48. ARC is a trademark of System Enhancement Associates.
  49. PAK is a trademark of NoGate Consulting.
  50. MS-DOS is a trademark of the MicroSoft Corporation.
  51. 4DOS is a trademark of J.P. Software
  52. Turbo C is a trademark of Borland International Inc.
  53.  
  54. The RWare Software company is not associated with the above firms.
  55.  
  56. License
  57.  
  58. ZGEN is distributed under the shareware concept.  You are allowed to
  59. freely copy and distribute the unregistered versions of the files
  60. ZGEN.EXE and ZGEN.DOC without modification and in their entirety, and
  61. this program is not misrepresented as free or public domain software.
  62. No fee exceeding $6.00 U.S. may be charged for specific access to this
  63. program.  You are granted permission to use this software for a period
  64. of thirty (30) days.  At the end that period, you must either register
  65. ZGEN or discontinue use of ZGEN.
  66.  
  67. 2
  68.  
  69. Registering:
  70.  
  71. The registered version of ZGEN does not print the exit message.  The
  72. unregistered version is as fully functional as the registered version.
  73.  
  74. To register ZGEN, fill out this form completely :
  75. -------------------------------------------------------------------------------
  76.  
  77. RWare Software Company
  78. 1510 Silver Creek Circle
  79. Norman OK 73071
  80.  
  81.    Name:__________________________________________
  82.  
  83. Company:__________________________________________
  84.  
  85. Address:__________________________________________
  86.  
  87.    City:_________________________  State:_________
  88.  
  89.     Zip:________________   Country:________________
  90.  
  91. Where did you get ZGEN v1.22?_____________________________
  92.  
  93. Computer Brand Name and Model :___________________________
  94.  
  95. Computer Processor: ( ) 8086/88 V20/30 ( ) 80286 ( ) 80386  ( ) 80486
  96.  
  97. DOS vendor and version:____________________________________
  98.  
  99.  
  100. ZGEN registration costs $25 in North America, $27 elsewhere, payable
  101. in US currency. A 10% discount is available for orders over 10 in
  102. quantity.
  103.  
  104. By registering ZGEN, you will be given a 360K 5¼" disk with the latest
  105. registered version of ZGEN, and voice technical support.
  106.  
  107. Upgrade policy:
  108.  
  109. Upgrades will be offered at the price of the diskette postage and
  110. a $1 handling fee. RWare will send notices of changes in versions to
  111. registered users. The RWare software company reserves the right to
  112. discontinue development of this software.
  113.  
  114. 3
  115.  
  116. What is ZGEN?
  117.  
  118. ZGEN is a directory program that provides an alternative to the DOS
  119. command line.  ZGEN gives the user freedom to zip through file directories
  120. and perform various actions on files that might be done from the DOS command
  121. line.  ZGEN also has the ability to search through the directories of
  122. various archives programs such as .ZIP files, .LZH files and .ARC/.PAK
  123. files.  ZGEN will never directly alter an archive, it is done with
  124. the various archiving programs that you use.
  125.  
  126. ZGEN software requirements
  127.  
  128. ZGEN takes about 150K of free memory to run.  ZGEN requires DOS 3.0 or
  129. better, a listing program, and the archiving programs for the archive
  130. types that you use.
  131.  
  132. For a listing program, I suggest getting LIST written by Vernon D. Buerg.
  133. For users of 4dos, the internal list command does fine.
  134.  
  135. Since 4dos is mentioned in this document, and it is an excellent
  136. replacement for command.com, this is the address:
  137.  
  138. J.P. Software
  139. P.O. Box 1470
  140. E. Arlington, MA 02174
  141.  
  142. LIST is available as shareware, the latest version is LIST73E
  143.  
  144. Vernon D. Buerg
  145. 139 White Oak Circle
  146. Petaluma CA 94952
  147.  
  148.  
  149. PKZIP/PKUNZIP, written by Phil Katz is available as shareware.
  150. It supports the .ZIP archive format.
  151. It is usually in an archive called PKZ102.EXE
  152. Later versions of this software may have a higher version number.
  153.  
  154. PKWARE, Inc.
  155. 7545 N. Port Washington Rd.
  156. Glendale WI 53217.
  157.  
  158. LHARC, written by Haruyasu Yoshizaki is available as freeware.
  159. It supports the .LZH and .LZS archiving formats.
  160. Its current version is in a file LH113C.EXE, available on many BBS's.
  161.  
  162. 4
  163.  
  164. PAK, written by NoGate consulting, is available as shareware.
  165. It supports the .ARC, .PAK, .SDN and .ZIP file formats.
  166. Its current version is available in a file called PAK251.EXE,
  167. available on many BBS's
  168.  
  169. NoGate Consulting
  170. P.O. Box 88115
  171. Grand Rapids, MI 49518-0115
  172.  
  173. ZGEN also supports the background print spooler TSR program PRINT.COM
  174. to print files.  The program is available with MS-DOS starting at 3.0.
  175. ZGEN communicates with this program through the interrupt 2fh.    To
  176. install print, simply type "print" at the command line.
  177.  
  178. Installing ZGEN
  179.  
  180. To call ZGEN from any directory, place ZGEN in a directory that is specified
  181. by the DOS path environment variable.  To set it use a statement like:
  182.  
  183. SET PATH=C:\;C:\UTILS;C:\TOOLS
  184.  
  185. where the directories to be searched are separated by semicolons.  See
  186. your MS-DOS reference manual for more information.
  187.  
  188. When ZGEN is first executed, it will create a configuration file
  189. called ZGEN.CFG in the same subdirectory as ZGEN.EXE. ZGEN will also
  190. place directory tree map files in this directory named ZGEN.TRx where
  191. x is a drive letter. There is one for each fixed device logical drive.
  192.  
  193. The default configuration assumes that the files PKZIP.EXE,
  194. PKUNZIP.EXE, LHARC.COM, PAK.EXE and LIST.COM are in a directory
  195. specified by PATH.
  196.  
  197. If you wish to use the internal 4dos command list, change the viewing
  198. program command under options from "list %" to "*list %"
  199.  
  200. Main display
  201.  
  202. The main display is like the output from the command line "dir"
  203. command.  File entries are displayed with the file name, filesize in
  204. bytes, time and date, file attributes, and description.  The top line
  205. displays,  the ZGEN version number, operating system version number,
  206. the version of 4dos (if used), the current volume label, and current
  207. time and date. The second line displays the current directory.
  208.  
  209. 5
  210.  
  211. One of the entries is contained in the select bar.  The select
  212. bar may be moved by using the up/down arrows,  and the display
  213. may be paged by using the <PgUp> and <PgDn> keys.  <Home> will move
  214. the select bar to the first entry, <End> will move the select bar to
  215. the last entry.  The space bar will display the main menu.
  216.  
  217. Pressing the <Enter> key will cause a certain action to occur to
  218. the selected entry.  If the entry is a directory, ZGEN will
  219. change to that directory.  If the entry is a program, such that it has
  220. the .exe, .com, .bat, and under 4dos 3.0+ the .btm extension, the file
  221. will be executed.  If the selected entry is an archive,  ZGEN will
  222. display the archives files. In all other cases, the file viewing
  223. command is invoked for that file.
  224.  
  225. Pressing the <Esc> key will cause ZGEN to move to the parent
  226. directory of the current directory, or if inside an archive,
  227. return to the DOS directory.
  228.  
  229. Pressing a letter key will scroll the select bar to the next entry
  230. that begins with this letter, if such an entry exists.
  231.  
  232. Pressing '\' will change the directory to the root directory of the
  233. current drive.
  234.  
  235.  
  236. Mouse
  237.  
  238. If there is a mouse installed, you may use the mouse for
  239. navigating through ZGEN.  If the mouse has three buttons, the
  240. middle button may be used to display the main menu.  If the
  241. mouse has only two buttons, the main menu is invoked by moving
  242. the mouse cursor to the "space for menu" text in the main
  243. display and pressing the left button.
  244.  
  245. An entry may be selected by moving the mouse cursor to the line
  246. that contains the entry the entry and pressing the left button.
  247. Pressing the left button on while the mouse cursor is on the
  248. selected entry is the same as pressing the <Enter> key.
  249.  
  250. Pressing the right mouse button in almost all cases is like pressing
  251. the <Esc> key.
  252.  
  253. Clicking the left mouse button while the mouse cursor is on the top
  254. line will move the select bar one entry up.  Holding down the left and
  255. right buttons here will cause it to repeat.  Doing the same for the
  256. bottom line causes the select bar to move down.
  257.  
  258. Clicking on either the small up arrow or down arrow is the same as
  259. pressing the <PgUp> or <PgDn> key.
  260.  
  261. 6
  262.  
  263. Clicking on the second line is like pressing <Alt-G>, the change
  264. directory command.
  265.  
  266. Clicking on the "Verify" text on the bottom line will toggle the
  267. verify mode.  It is the same as invoking the toggle verify
  268. command from the main menu.
  269.  
  270. Clicking on the any of the first three characters of an entry will
  271. toggle the tag status of that entry.  This is like pressing <Tab> from
  272. the keyboard.  Note that directories cannot be tagged.
  273.  
  274.  
  275. Menu operations
  276.  
  277. When a menu is invoked, it displays a list of options.  Each option
  278. is a brief description of the command.  If the command has a hotkey,
  279. it is displayed to the right of the option.  The convention used for
  280. naming keys is as follows:   '@' stands for <Alt>, and '^' stands for
  281. <Ctrl>.   For example, @D means <Alt D> and is used by pressing down
  282. the <Alt> key followed by the <D> key and then releasing.  Using a
  283. hotkey bypasses navigating through menus.
  284.  
  285. A menu has a select bar.  The up and down arrow keys are used to move
  286. the select bar.  To invoke the option, press <Enter>.  Pressing <Esc>
  287. will return you from the menu.
  288.  
  289. Each option will have a capitalized letter in the window highlight
  290. color.  Pressing that letter on the keyboard will invoke that
  291. option.
  292.  
  293. With a mouse, you may move the mouse cursor to the option and then
  294. press the left mouse button.  The select bar moves to that option.
  295. Pressing the left mouse button while the mouse cursor is on the select
  296. bar invokes that function.  The right mouse button acts as the <Esc>
  297. key on the keyboard.
  298.  
  299.  
  300. Subdirectory Tree display
  301.  
  302. The subdirectory tree display is invoked when using the goto
  303. directory, copy, and move commands.  The arrow keys and <PgUp>,
  304. <PgDn>, <Home>, <End> keys move the select bar.  Select the desired
  305. directory to complete the command and press <Enter>.  To abort the
  306. command, press <Esc>.  Pressing a letter key will scroll the select
  307. bar to to the next entry beginning with that letter, if such an entry
  308. exists.
  309.  
  310. 7
  311.  
  312. The mouse works in the same way as the main menu display.
  313.  
  314. Pressing the space bar or clicking on the "press space for menu" text
  315. will invoke the subdirectory tree menu.
  316.  
  317. The first time that the subdirectory tree is used, ZGEN will build a
  318. directory tree for the current drive and display the message: "wait -
  319. reading directory tree".  This only occurs when the directory
  320. structure has been changed from ZGEN, such as removing or creating a
  321. directory, or if the Reread directory tree command has been selected,
  322. or if the logical drive is not a fixed disk, or if ZGEN finds that a
  323. selected directory no longer exists.
  324.  
  325. Subdirectory Tree Menu
  326.  
  327. Change Drive
  328. <Alt D>
  329.  
  330.    This command allows you to select a directory on a different
  331.    logical drive.  Selecting a different drive displays a directory
  332.    tree of that drive.  Note that this does not change the currently
  333.    logged drive unless the 'Goto directory' command is used.
  334.  
  335. Make directory
  336. <Alt K>
  337.  
  338.    This command allows you to create a subdirectory in the currently
  339.    selected subdirectory.  It is useful for creating a destination
  340.    directory on the fly when copying or moving files.  You will be
  341.    prompted for a name for the new subdirectory.  Afterwards, the
  342.    directory tree will be reread, and the select bar will move to the
  343.    new directory.
  344.  
  345. Reread dir tree
  346. <Alt R>
  347.  
  348.    This command rereads the directroy tree structure from the disk.
  349.    You use this if you have altered the subdirectory tree structure
  350.    outside of ZGEN.
  351.  
  352. 8
  353.  
  354. Print this dir tree
  355. <Alt P>
  356.  
  357.    This command sends a copy of the directory tree structure to the
  358.    printer.  It's useful if you like to have a hardcopy of the
  359.    subdirectory tree display.
  360.  
  361. Quit - current dir
  362. <Alt Q>
  363.  
  364.    This command terminates ZGEN and returns you to the current
  365.    directory.
  366.  
  367. Exit - original dir
  368. <Alt X>
  369.  
  370.    This command terminates ZGEN and returns you to the directory that
  371.    you were in when ZGEN was executed.
  372.  
  373.  
  374. Main Menu
  375.  
  376. View file
  377. <Alt V>
  378.  
  379.      This option invokes the viewing command for the selected
  380.      file, or the archive view file command, for files inside
  381.      archives.    You may view a file that is not an archive or program
  382.      by pressing <Enter> instead of using this command.
  383.  
  384. Archive create/view menu
  385.  
  386. create archive file
  387. <Alt A>  .arc/.pak
  388. <Alt L>  .lzh
  389. <Alt Z>  .zip
  390.  
  391.      These options allow you to create an archive for the supported
  392.      archive types. If a create archive function is invoked, all of
  393.      the tagged files will be added to an archive file that you
  394.      specify. If no files are tagged, the selected file is added to an
  395.      archive.  You will be prompted for a name for the archive.  See
  396.      the archive option menu description for more details on how this
  397.      function works.
  398.  
  399. 9
  400.  
  401. force archive file
  402. <Ctrl A> .arc/.pak
  403. <Ctrl L> .lzh
  404. <Ctrl Z> .zip
  405.  
  406.      These options force ZGEN to display the directory of the selected
  407.      file that is an archive that does not match the archive type's
  408.      aliases.  If the archive file does not match an alias, it is not
  409.      displayed with the archive file color.
  410.  
  411.  
  412. Copy/unarc files
  413. <Alt C>
  414.  
  415.      This option will copy the tagged or selected files to a specified
  416.      directory.  The directory is specified by using the directory
  417.      tree.  If the file(s) is/are inside an archive the archive's
  418.      unarchive command is used.  See the archive option menu
  419.      description for details on how this command works.  If no files
  420.      are tagged, and the the selected entry is a directory, the
  421.      contents of that directory, including any subdirectories will be
  422.      copied to the destination directory.
  423.  
  424. Change drive
  425. <Alt D>
  426.  
  427.      This function allows you to change to a different logical drive.
  428.      A menu with a list of the currently valid logical drives is
  429.      displayed.  When you change to a different drive, ZGEN displays
  430.      the current directory of that drive.
  431.  
  432.  
  433. Goto directroy
  434. <Alt G>
  435.  
  436.      This function allows you to change to a different directory.  The
  437.      subdirectory tree is displayed to allow you to select the
  438.      directory you wish to change to.
  439.  
  440. Hotkey list
  441. <Alt H>
  442.  
  443.      This option displays a list of hotkeys.  It also contains the
  444.      serial number and user name for registered versions.
  445.  
  446. 10
  447.  
  448. Make directory
  449. <Alt K>
  450.  
  451.      This function allows you to create a subdirectory in the current
  452.      directory.  You will be prompted for a name.
  453.  
  454. Move file(s)
  455. <Alt M>
  456.  
  457.      This function will move all the tagged files, or the selected
  458.      file if none are tagged.  The subdirectory tree display is used
  459.      to select the destination directory. If the selected entries are
  460.      inside an archive, they are simply unarchived.
  461.  
  462. Rename file
  463. <Alt N>
  464.  
  465.      This function allows you to rename the selected file.  You will
  466.      be prompted for a new name for the file.  Note that wildcards do
  467.      not work with this function.
  468.  
  469.  
  470. Printer Menu
  471.  
  472. Print file(s)
  473. <Alt P>
  474.  
  475.      This function allows you to print a file.  If the DOS program
  476.      print.com has been installed, the selected file is sent to the
  477.      printer queue, otherwise, the file is printed directly.  If the
  478.      file is inside an archive, the file is printed using that
  479.      archive's command for printing a file.  See the archive command
  480.      options for further details.
  481.  
  482. Edit print queue
  483. <Ctrl Q>
  484.  
  485.      This option is only valid if print.com has been installed. This
  486.      function allows you to view and delete files from the print
  487.      queue.  It shows a list of the current state of the queue and
  488.      halts printing.  You may delete a file from the queue by
  489.      selecting it and pressing <Del>
  490.  
  491. 11
  492.  
  493. Cancel printing
  494. <Ctrl C>
  495.  
  496.      This option is only valid if print.com has been installed. This
  497.      option terminates the printing of all files in the print queue.
  498.  
  499. Delete file(s)
  500. <DEL>
  501.  
  502.      This option allows you to delete all of the tagged files, or if
  503.      none are tagged, the selected entry.  If the selected entry is a
  504.      directory, this command will remove that directory and all files
  505.      contained within it.  Note that if the verify mode is off, you
  506.      will not be asked for verification before deleting the files.
  507.  
  508.  
  509. Find a file
  510. <Alt F>
  511.  
  512.      This option allows you to locate a file on the current logical
  513.      drive.  You will prompted for a filename, and this file name can
  514.      contain wildcard characters such as '*' and '?'.  This option
  515.      will also ask you if you want to search inside any archive files
  516.      after a normal file search.
  517.  
  518. Configuration menu
  519. <Alt O>
  520.  
  521.      This menu allows you to configure various aspects of ZGEN.
  522.  
  523. Colors
  524.  
  525.      This menu allows you to define various colors that ZGEN displays.
  526.  
  527.      "Status lines" and "status line highlight" are the colors of the
  528.      top two lines and the bottom line.
  529.  
  530.      "Marker" is the color of the marker character for tagged files
  531.      and mouse cursor. The marker character is displayed in the first
  532.      column of the main display.
  533.  
  534.      "Select bar" is the color of the currently selected entry in the
  535.      main display, directory in the subdirectory tree display, and
  536.      selected option in the menus.
  537.  
  538. 12
  539.  
  540.      "Directory" is the color of directory entries.
  541.  
  542.      "Archives" is the color of any file that matches an archive alias.
  543.  
  544.      "Programs" is the color of an .exe, .com, .bat and under 4dos 3.0+,
  545.      .btm files.
  546.  
  547.      "Other files" the files is the color of directory entries not
  548.      covered by the above cases.
  549.  
  550.  
  551. Display lower case filenames
  552.  
  553.      Switching this option to yes displays filenames as lower case in
  554.      the main display.  Directory names will still be displayed as
  555.      upper case.
  556.  
  557. Directory sort method
  558.  
  559.      This allows you to specify the sort order that ZGEN uses to
  560.      display the entries.  Note that in all cases, subdirectories will
  561.      be displayed first.
  562.  
  563.      No sort:
  564.  
  565.      Files are displayed in DOS creation order.  Specifying this
  566.      method will speed up directory loading speed.
  567.  
  568.      Sort alphabetically by name:
  569.  
  570.      Directories and filenames are sorted alphabetically, with
  571.      directories preceeding files.
  572.  
  573.      Sort alphabetically by ext:
  574.  
  575.      This is like the above method, except that the files are sorted
  576.      by file extension before sorting by the main part of the name.
  577.  
  578.      Sort by size, smallest/largest first:
  579.  
  580.      These methods sort filenames by the size of the file.
  581.  
  582.      Sort by time/date, earliest/latest first:
  583.  
  584.      Files are sorted by the time/date indicated in the directory
  585.      entry.
  586.  
  587. 13
  588.  
  589. Command Syntax
  590.  
  591.      Various options, such as the file viewing program, archive
  592.      options, and user commands allow you to specify a command.  A
  593.      command is a name of a program or a command interpeter
  594.      instruction.  A command may contain the following symbols:
  595.  
  596.             %    name of the selected entry
  597.             %.   name of the selected entry without extension
  598.             %:   name of the current directory
  599.             %a   name of the archive file that is being viewed
  600.             %p   pause after program execution
  601.         *     (at start of command) invoke command interpeter for
  602.          this command.
  603.  
  604.      To run a .bat or .btm file, you must either specify the extension
  605.      in the command or preceed the command with a '*'. All programs
  606.      specified in commands are searched for by using the path
  607.      environmental variable.
  608.  
  609. File viewing program
  610.  
  611.      This function allows you to specify the file viewing command.
  612.      The default is "list %".  This assumes that the program is on the
  613.      path.  The name of the currently selected entry is replaces the
  614.      "%" in the command.   For users of 4dos that wish to use the
  615.      internal 4dos list command, preceed the command with a '*' such
  616.      that it is "*list %".  The '*' tells ZGEN to execute the command
  617.      interpeter to complete this command.
  618.  
  619. Archive file options
  620.  
  621.      These are the various commands that ZGEN executes for operations
  622.      on archive files.  Note that ZGEN itself does no direct
  623.      alteration of archives and relies on these commands to do archive
  624.      operations.
  625.  
  626.      The default commands assume that you have the programs
  627.      pkunzip.exe, pkzip.exe, pak.exe, lharc.com, and list.com on the
  628.      path.
  629. 14
  630.      Unarchive file:
  631.  
  632.      This is the command used when a single file has been selected to
  633.      be unarchived with the copy/unarchive function.  Place "%a" in
  634.      this command where the archive file needs to be placed. Place the
  635.      "%" where the name of the file inside the archive needs to be
  636.      placed.  Note that when this command is invoked, ZGEN has
  637.      switched to the destination directory and uses the full path
  638.      name to the archive for the "%a" parameter.
  639.  
  640.      Archive file:
  641.  
  642.      This is the command used when creating a new archive from a
  643.      single file with a create archive file command.  The "%a"
  644.      specifies the name of the archive file.  "%" specifies the name
  645.      of file to be archived.
  646.  
  647.      Delete file:
  648.  
  649.      This command is used when the delete file command has be invoked
  650.      for a single file.
  651.  
  652.      View file:
  653.  
  654.      This is the command invoked when <Enter> has been pressed on an
  655.      entry inside an archive or the view file command was selected for
  656.      that entry.  The default commands use the command interpeter to
  657.      pipe output from the unarchiving programs into the list program.
  658.      This may cause problem viewing archives on a diskette that is
  659.      full.   A solution is to create a batch file like this:
  660.  
  661.           viewzip.bat
  662.       ---------------------
  663.           pkunzip -x %1 %2 c:\
  664.           list c:\%2
  665.           del c:\%2
  666.       ---------------------
  667.  
  668.      and changing the command to this:
  669.  
  670.           viewzip.bat %a %
  671.  
  672.  
  673.      Print file
  674.  
  675.      This is the command used when the Print file function is used on a
  676.      file inside an archive.
  677. 15
  678.      Describe file
  679.  
  680.      This is the command used to create a description for an single
  681.      entry inside an archive.  It may be left blank.  Currently, lharc
  682.      does not support file descriptions.
  683.  
  684.      Unarchive list
  685.  
  686.      This command is used when the copy/unarchive files command is
  687.      used when there is a list of tagged files to be unarchived.  It
  688.      may be left blank, and in that case the unarchive command is used
  689.      repeatedly.  ZGEN creates a temporary file that contains the
  690.      names of the files to be unarchived and passes this filename in
  691.      the "%" parameter.
  692.  
  693.      Archive list
  694.  
  695.      This command is used when a set of tagged files is to be archived
  696.      with the create archive file function  Like the unarchive list
  697.      command,  ZGEN creates a temporary file with a list of files to
  698.      be archived and passes this files's name in the "%" parameter.
  699.      This command may be left blank, and in that case the archive file
  700.      command is used repeatedly.
  701.  
  702.      Delete list
  703.  
  704.      This command is used when a set of tagged files in an archive are
  705.      to be deleted with the Delete files command.  Like the above two
  706.      commands, a temporary file is created with a list of file names
  707.      to deleted in the archive.  This command may be left blank, and
  708.      in that case, the delete file command is used repeatedly.
  709.  
  710.      Unarchive with password
  711.  
  712.      Currently only zip files provide a means of detecting if a file
  713.      inside an archive is encrypted.  If an encrypted file is to be
  714.      enarchived, this command is used.  The "%e" parameter is a
  715.      password that you will be prompted for.  This command may be left
  716.      blank for the other archive types.
  717.  
  718.      Aliases
  719.  
  720.      This is a list of file masks that are to be treated as of this
  721.      archive type. Each mask is delimited by a space.  These
  722.      filemasks may contain the DOS wildcards '*' and '?'.  You may
  723.      disable an archive ZGEN from dealing with a certain archive type
  724.      by leaving this entry blank.
  725.  
  726. 16
  727.  
  728. Swapping options
  729.  
  730.      ZGEN uses swapping code written by Ralph Brown.  This enables
  731.      ZGEN to swap out of memory when executing a command or a program,
  732.      such as the file viewing program, the archive commands, and the
  733.      user commands.
  734.  
  735.      Enable swapping
  736.  
  737.      This option allows you to disable swapping completely.  In that
  738.      case, ZGEN takes up about 160K of DOS memory, but executes things
  739.      a little faster.
  740.  
  741.      Use XMS memory if available?
  742.  
  743.      By default ZGEN will try to use XMS memory to swap if it finds
  744.      it.  You may disable this by toggling this option to no.
  745.  
  746.      Use EMS memory if available?
  747.  
  748.      If any EMS memory is available, ZGEN will use this for swapping.
  749.      You may disable this by toggling this option to no.
  750.  
  751.      Disk overlay path
  752.  
  753.      If ZGEN finds no EMS or XMS memory to use for swapping, ZGEN will
  754.      swap to disk.  This is the path to where you would like ZGEN to
  755.      place the swap file.  This file is about 160K in size.
  756.  
  757. Enable Mouse
  758.  
  759.      If you do not use your mouse with ZGEN and don't want to see the
  760.      mouse cursor, you may disable the mouse by switching this option
  761.      to no.
  762.  
  763. 17
  764.  
  765. Other menu:
  766.  
  767. Toggle verify mode
  768. <Alt T>
  769.  
  770.      This option toggles the status of the verify mode. The current state is
  771.      displayed in the lower right hand corner of the main display.
  772.      If verify mode is toggled on, ZGEN will ask you if you want to
  773.      delete files with delete command, or overwrite them with the copy
  774.      or move files command.  ZGEN will always ask for verification if
  775.      you try to delete a directory with files in it.  You may toggle
  776.      the verify mode with the mouse by clicking the right mouse button
  777.      on the verify status message in the main display.
  778.  
  779. View DOS screen
  780. <Alt S>
  781.  
  782.      ZGEN saves the DOS screen on entry and uses it whenever it runs
  783.      an external program.  You may view this screen by selecting this
  784.      option.  Pressing any key brings you back to the ZGEN display.
  785.  
  786. Mark file
  787. <+>
  788.  
  789.      This option marks the currently selected entry and moves the
  790.      select bar down. A tagged entry has the '»' character in front of
  791.      it. Directory entries cannot be marked.
  792.  
  793. Unmark file
  794. <->
  795.  
  796.      This option unmarks the currently selected entry and moves the
  797.      select bar down.
  798.  
  799.  
  800. Toggle mark
  801. <TAB>
  802.  
  803.      This option toggles the marking status of the currently selected
  804.      entry and moves the select bar down.  Note that directory entries
  805.      cannot be tagged.  You may use the mouse to toggle the tag of an
  806.      entry by clicking the left mouse button on any of the first three
  807.      characters of an entry.
  808.  
  809. 18
  810.  
  811. Change file attributes
  812. <Ctrl T>
  813.  
  814.      this option allows you to change the file attributes of a file.
  815.      A small menu pops up so you can set the status of the various
  816.      attributes you want to change.
  817.  
  818.      Readonly - setting this bit prevents the file from being changed
  819.      or deleted by DOS.
  820.  
  821.      Hidden - setting this bit will disclude the file from being
  822.      listed in a DOS directory.
  823.  
  824.      System - this bit is rarely used, but it works like the hidden
  825.      bit.  Usually the file io.sys and msdos.sys have this bit set.
  826.  
  827.      Archive - this bit is set whenever a file has been changed.  A
  828.      backup program usually will clear this bit.  This bit is used to
  829.      indicate that a file has not been backed up.
  830.  
  831. Describe file
  832. <Ctrl D>
  833.  
  834.      This option allows you to create or change a description for a
  835.      file.  For normal files, the descriptions are stored in a hidden
  836.      file called DESCRIPT.ION.  This file uses the same format as the
  837.      file descriptions used in 4dos. If a file with a description is
  838.      moved or copied by ZGEN, the description will go with it.  If a
  839.      file is inside and archive, this option will use the describe
  840.      file command for that archive type.
  841.  
  842.  
  843. Create volume label
  844. <Ctrl V>
  845.  
  846.      This option allows you to create or change the volume label of
  847.      the current logical drive.  Note that some programs create
  848.      non-standard volume labels that cannot be changed by ZGEN.
  849.  
  850. 19
  851.  
  852. Edit user commands
  853. <Alt E>
  854.  
  855.       You may assign external programs to be executed by ZGEN to the
  856.       function keys F1-F10.  These commands use the symbols listed
  857.       under command syntax.   For example, if you have an editor
  858.       program called edit.exe that is in a directory on the path, you
  859.       may create a command that edits the currently selected file by
  860.       using the command "edit %".  The "%" will be replaced by the
  861.       selected entry's filename.
  862.  
  863. Execute user commands
  864.  
  865.       This menu shows the assignment of the various user commands.
  866.  
  867. Run selected program
  868. <Alt R>
  869.  
  870.       This option will allow you to run the currently selected entry
  871.       if it is a program, that is, if it has the .exe, .com, .bat and
  872.       under 4dos 3.0+, the .btm file extension.  This option will
  873.       prompt you for any parameters for the program.
  874.  
  875. Quit - current dir
  876. <Alt Q>
  877.  
  878.    This command terminates ZGEN and returns you to the currently
  879.    logged directory.
  880.  
  881. Exit - original dir
  882. <Alt X>
  883.  
  884.    This command terminates ZGEN and returns you to the directory that
  885.    you were in when ZGEN was executed.
  886.  
  887. ZGEN Error Messages:
  888.  
  889. Invalid Directory
  890.   - An invalid directory was specified.  This error may
  891.     occur if a floppy disk was swapped on ZGEN.
  892.  
  893. Invalid Drive
  894.   - The drive specified is not valid.  This may be reported after
  895.     a critical hardware error.
  896.  
  897. 20
  898.  
  899. Invalid Argument
  900.   - The swapping path is invalid
  901.  
  902. Can't find 'XXXXXX.XXX'
  903.   - Program that was to be executed was not there.  Be sure that the
  904.     program has a fully specified path name and is spelled correctly.
  905.  
  906. Not enough memory to exec xxxxxxxx.xxx
  907.   - There was not enough memory to execute the specified program.  This
  908.     error might occur if there are too many TSR programs in memory or
  909.     ZGEN is executed from another program.
  910.  
  911. Error in the exec of xxxxxxxx.xxx
  912.   - Some other error occured in the exec of the specified
  913.     program.
  914.  
  915. Unable to Copy
  916.   - The destination disk is may full or write protected, or the
  917.     you are attempting to overwrite a file with the readonly bit
  918.     set or a subdirectory with the same name.
  919.  
  920. Unable to remove xxxxxxxx.xxx
  921.   - ZGEN is unable to remove a sub directory.  You cannot remove
  922.     a directory that is on the path to the current directory or
  923.     directories with the readonly bit set.
  924.  
  925. Unable to delete xxxxxxxx.xxx
  926.   - ZGEN is unable to delete a file. The file may be read only, or
  927.     the disk is write protected.
  928.  
  929. Print spooler queue full, file not submitted
  930.   - The print spooler program PRINT.COM has reported that the queue
  931.     is full after an attempt to submit a file.  Try waiting until a
  932.     file is done printing or increase the queue buffer size for PRINT.COM
  933.     with the /Q: option.  The default buffer size is 10 file names and
  934.     can be increased to 32.  Refer to your DOS manual for more information.
  935.  
  936. Print spooler busy, file not submitted
  937.   - The print spooler program has reported that it is busy.  Try waiting
  938.     and then try again.
  939.  
  940. File name is too long, file not submitted
  941.   - The name submitted to the print spooler is too long.  This could happen
  942.     if the file is deeply nested in the subdirectory structure.
  943.  
  944. File not found by the print spooler
  945.   - The print spooler reported that it could not find the file
  946.  
  947. 21
  948.  
  949. Path not found by the print spooler
  950.   - The print spooler reported that the path name of the file could
  951.     not be found
  952.  
  953. Too many open files, file not submitted
  954.   - The print spooler has reported that there are too many open files
  955.     to print the file.  Try increasing the files parameter in the
  956.     your systems config.sys file. Refer to your DOS manual for more
  957.     information.
  958.  
  959. Access denied, file not submitted
  960.   - The print spooler was denied access to the file.  The file was probably
  961.     locked.
  962.  
  963. Drive invalid, file not submitted
  964.   - The print spooler has reported that the drive is invalid in the file
  965.     submitted to it.
  966.  
  967. Unexpected print spooler error %x
  968.   - The print spooler returned an unexpected error code.
  969.  
  970. Drive is no longer valid
  971.   - Reported after a disk access that resulted in a critical error.  You
  972.     will be prompted select a new drive.
  973.  
  974. Invalid .ZIP file
  975.   - .ZIP file has a corrupted directory format.  Try using PKZIPFIX to
  976.     repair the .ZIP file.
  977.  
  978. Not enough Memory
  979.   - ZGEN has run out of dynamic memory.  This error should rarely
  980.     occur.
  981.  
  982. 22
  983.  
  984. Notes about ZGEN:
  985.  
  986. If you should ever encounter a bug in ZGEN, or have a suggestion to
  987. improve the software, or find something unclear in the documentation,
  988. feel free to notify the author.
  989.  
  990. The file ZGEN.EXE has been compressed by the program LZEXE written by
  991. Fabrice Bellard.
  992.  
  993. I can be contacted via the FidoNet network at the address: 1:147/66.66
  994. or by the postal service at 1510 Silver Creek/Norman OK 73071
  995.  
  996. Thanks to Rod Wilson Beta testing.  Thanks to Darin Fox for Beta
  997. Testing and free legal advice.    Thanks to Rex Conn for some info
  998. providing information on 4dos.    Special thanks to Ralph Brown for
  999. making his spawno code available without royalties.
  1000.  
  1001. ZGEN was written by Robert Mashlan entirely in Turbo C v2.0.
  1002.  
  1003. The swapping code in ZGEN is copyright and was written by Ralph Brown
  1004. and was taken from his spawno C library.
  1005.  
  1006. The remainder of the code with exception of the Turbo C standard
  1007. library were written by Robert Mashlan.
  1008.  
  1009. History:
  1010. 11-12-90  version 1.03
  1011.       first public release of ZGEN.
  1012.  
  1013. 12-7-90   version 1.22
  1014.       added pop-up menus
  1015.       added mouse support
  1016.       added swapping options
  1017.  
  1018. 23
  1019.