home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / ZFV12.ZIP / README < prev    next >
Text File  |  1991-05-11  |  7KB  |  151 lines
  1.  
  2.    ZFV v1.1 (C) Copyright 1990 by R. P. Byrne
  3.    ------------------------------------------------------------------------
  4.  
  5.    Introduction
  6.    ------------
  7.  
  8.    ZFV is an archive utility program that can be used to increase the
  9.    functionality provided by the PCBoard bulletin board software's F V
  10.    command.  It provides viewing of archive file contents, files within an
  11.    archive, viewing 'plain ascii' text files and other binary files not
  12.    recognized as having a supported archive format.  The program will
  13.    function properly under any version of PCBoard from 14.0 upward.
  14.  
  15.    While written specifically for PCBoard systems, ZFV can also function as
  16.    a stand-alone program called from the DOS command line.  See the
  17.    description of the /S command line switch in the section below on program
  18.    syntax.  This capability extends the functionality your callers enjoy
  19.    while on-line to their own DOS prompts (and also allows you, the PCBoard
  20.    sysop, to enjoy this functionality from within PCBFiler)!
  21.  
  22.    ZFV provides these services for any .ZIP, .ARC or .LZH archive file (at
  23.    least for those produced on or before 8/27/90) as well as their
  24.    corresponding self-extractor formats.  It performs this magic without the
  25.    need to call any external program (eg. PKUnZip.Exe does not need to be
  26.    accessible to ZFV).  All archive processing, including the reading of
  27.    archived text files, is performed entirely by the ZFV program itself.
  28.  
  29.  
  30.    Installation
  31.    ------------
  32.  
  33.    The PCBView.Bat file, included in the ZFV archive, shows how to install
  34.    the program to work with your PCBoard 14.5  system.  The PCBView.Bat file
  35.    should be placed into your default PCB subdirectory (usually \PCB or
  36.    something similar).  ZFV.EXE can also be placed here or in some other
  37.    subdirectory that is part of your DOS PATH.  Next, install PCBView.Bat as
  38.    'The batch file for viewing compressed files' via the PCBSetup program.
  39.    That's all there is to it!
  40.  
  41.    ZFV can also be installed for use from within PCBFiler.  The first
  42.    PCBFiler options screen allows you to specify ZFV as the DOS program to
  43.    be invoked as a 'viewer' based on a file's extension.  You should specify
  44.                                   ZFV /SB
  45.    as the DOS Command to be used for .ARC, .ZIP, .LZH, .EXE and .COM files
  46.    (remember, ZFV can handle self extractors and other binary files).
  47.  
  48.  
  49.    You can use ZFV from your DOS prompt whether you are a sysop or not.  To
  50.    do so, place the ZFV.EXE file into a subdirectory that is part of your
  51.    DOS PATH variable (see your DOS manual for an explanation of the PATH and
  52.    how to set it) and invoke the program using the /S switch (see the
  53.    section below on program syntax).  You may find it convenient to create a
  54.    batch file to invoke ZFV so that you don't have to remember to include /S
  55.    everytime you call the program.  Mine is called Z.BAT and looks like
  56.    this:
  57.                                  Echo Off
  58.                                  ZFV /SB %1
  59.    This batch file should also be placed somewhere along your DOS PATH.
  60.  
  61.  
  62.    Syntax
  63.    ------
  64.  
  65.    ZFV's syntax is as follows:
  66.  
  67.                  ZFV [/switches] [d:][\path\]filename[.ext]
  68.  
  69.    where 'd:' represents a drive letter, '\path\' represents a valid
  70.    subdirectory name, 'filename' represents the name of the archive file to
  71.    be processed, and '.ext' is the filename extension of the archive.
  72.  
  73.    Switches are optional, may appear anywhere on the command line, and must
  74.    be preceded by either a slash or a hyphen.  Allowable switches are as
  75.    follows:
  76.  
  77.        S indicates standalone mode (ie. not called from PCBoard).  This
  78.          switch allows ZFV to be used as an archive viewer from the DOS
  79.          command line or from within PCBFiler.
  80.  
  81.        B allows hex dumps of any file that is not recognized as being in one
  82.          of ZFV's supported archive formats and does not contain plain ascii
  83.          text.  This option also affects the viewing of files contained
  84.          within an archive in that binary files will be dumped rather than
  85.          skipped.
  86.  
  87.        X causes ZFV to disallow extraction of archive members to a "temp"
  88.          archive file.
  89.  
  90.        F allows specification of a drive/subdirectory where "temp" archive
  91.          files (created by extracting members from the selected archive)
  92.          will be created (eg. /Fh:\temp).
  93.  
  94.    Example:   ZFV /sb e:\work\testfile.zip
  95.  
  96.  
  97. ──────────────────────────────────────────────────────────────────────────
  98.  
  99.                                LICENSE
  100.  
  101. ──────────────────────────────────────────────────────────────────────────
  102.  
  103.      The ZFV.EXE program ("software") is copyrighted.  However, I am
  104. distributing this software for free and you are licensed to use this
  105. software without any charge.
  106.  
  107.      Redistribution of this software is encouraged.  Please do share it with
  108. your friends, upload it to bulletin board systems, etc.  However, as I am
  109. making this software available for free, you must do the same. You are not
  110. permitted by this license to request or accept any remuneration of any kind
  111. for this software.  This prohibition extends to including my software with
  112. any other product or service for which money is charged.
  113.  
  114.      The only exceptions to this "don't charge for what I'm giving away for
  115. free" restriction are as follows:
  116.  
  117.      (1) Bulletin board systems or other electronic information services are
  118. permitted to make this software available for download and charge their
  119. customary fees, if any, for access to the service.
  120.  
  121.      (2) Users groups and other not-for-profit organizations that distribute
  122. this software may charge a reasonable fee to cover duplication and related
  123. costs.
  124.  
  125.      (3) There may be other situations not covered by this license where
  126. some charge for distribution would be appropriate.  Contact me and we'll
  127. talk about it.  But, this license does not authorize any such distribution
  128. without express, written permission from me in advance.
  129.  
  130.      Except as provided above, if you do wish to charge for my software or
  131. for any software derived from mine, then you must contact me for prior
  132. permission.  In short, if you're going to ask for money, then we're going to
  133. share in whatever you receive.  That's only fair.  I can be reached at the
  134. following address:
  135.  
  136.                               Richard P. Byrne
  137.                              5 Twin Elm Terrace
  138.                               Sparta, NJ 07871
  139.  
  140.      In the event that you feel "guilty" about using this software for free,
  141. you may, at your discretion, send a contribution to the author.  Suggested
  142. contributions include money, beer (preferably something from a local
  143. brewery), memory chips (1Mb 80ns SIMMS preferred), or any other item that
  144. may perform useful work, provide intellectual stimulation or possess other
  145. recreational value (ie 'fun').
  146.  
  147.      This software is distributed without warranties of any kind, express or
  148. implied, including, but not limited to, the implied warranties of
  149. merchantability and fitness for a particular purpose.
  150.  
  151.