home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR31 / BW212OS2.ZIP / !!README.DOC next >
Text File  |  1994-01-21  |  8KB  |  161 lines
  1.  
  2.  
  3.                      The Blue Wave Offline Mail Reader
  4.                              Version 2.12 OS/2
  5.  
  6.                 Copyright (C) 1994 by Cutting Edge Computing
  7.                             All Rights Reserved
  8.  
  9.  
  10.                      PRE-INSTALLATION DOCUMENTATION AND
  11.                        COMMON INSTALLATION "GOTCHA'S"
  12.  
  13.  
  14.   *** Please continue reading the documentation after you read the
  15.       pre-installation instructions that pertain to you.  There is
  16.       information contained here that will help optimize performance
  17.       and answer questions about installation/operation that are bound to
  18.       cause many people some trouble!
  19.  
  20.  
  21.   First Time Installations
  22.   ------------------------
  23.   If you are installing The Blue Wave Offline Mail Reader for the first
  24.   time (either the DOS or the OS/2 version), please see BWAVE2.DOC for
  25.   complete installation instructions.  If you are one who refuses to read
  26.   documentation first, here's a small hint:  you must run INSTALL.CMD to
  27.   create the BWAVE2.EXE executable.
  28.  
  29.  
  30.   Converting or Upgrading from DOS version to OS/2 version
  31.   --------------------------------------------------------
  32.   If you have already installed the OS/2 version or DOS version of the
  33.   reader, installation is simple.  All support files (TAGLINES.BW,
  34.   TAGFILES.BW, KEYWORDS.BW, NAMES.BW, etc) are compatible between both
  35.   versions of the reader.  You may install the OS/2 reader into the same
  36.   directory as your DOS reader.
  37.  
  38.   In order to make changing between the DOS and the OS/2 version easy, the
  39.   default configuration file name for the OS/2 version is "BWAVEOS2.CFG",
  40.   instead of the default file name of "BWAVE200.CFG" for the DOS version.
  41.   This will allow different configurations between the two operating
  42.   environments.
  43.  
  44.   To install the OS/2 version in the same directory as the DOS version,
  45.   simply copy these files to your current reader directory:
  46.  
  47.   BWAVE2.INS
  48.   BWAVE2.EA
  49.   INSTALL.CMD
  50.  
  51.   After copying these files, run the INSTALL.CMD file (from an OS/2 command
  52.   prompt!).  INSTALL.CMD will create BWAVE2.EXE and delete the .INS and .EA
  53.   files for you.  You can then load the reader by typing "BWAVE2" from the
  54.   OS/2 command prompt.
  55.  
  56.   If you are a REGISTERED user of the DOS version, you will find that you
  57.   will need an upgraded registration number in order to run the OS/2 reader
  58.   in registered mode.  Cutting Edge Computing is offering several discounts
  59.   for upgrading your registration number.  If you registered the DOS reader
  60.   after July 1, 1993, you are eligible for a FREE upgrade.  But you must
  61.   hurry, because this offer expires on April 1, 1994!  If you registered
  62.   your DOS version before July 1, 1993, you are still eligible for a
  63.   discounted upgrade fee through April 1, 1994.
  64.  
  65.   For full information on upgrade costs and procedures, please see either
  66.   REGISTER.BW (US, Canada, elsewhere), REGISTER.EUR (Europe), or
  67.   REGISTER.AUS (Australia).
  68.  
  69.  
  70.  
  71.   COMMON PROBLEMS AND SOLUTIONS
  72.   -----------------------------
  73. * The Blue Wave Offline Mail Reader for OS/2 needs to execute several
  74.   external programs in order to function properly.  In order to unpack and
  75.   repack mail packets, you will need an external archiver/unarchiver.
  76.  
  77.   Due to the current "lack" of OS/2 specific compression programs, there is
  78.   not a whole lot of options for you to choose from.  While the reader will
  79.   load ANY archiver program (OS/2, DOS, and/or WIN), best performance is
  80.   obtained through the use of an OS/2 hosted application.
  81.  
  82.   The InfoZIP Project's ZIP.EXE and UNZIP.EXE applications have been found
  83.   to be the best for use with the reader.  (We recommend against the use of
  84.   PKZIP/UNZIP v1.02 for OS/2 due to the fact that you will not have ZIP
  85.   v2.x compatibility!).
  86.  
  87.   If ZIP.EXE and UNZIP.EXE are found in the OS/2 PATH (defined in
  88.   CONFIG.SYS), they will automatically be installed by the reader the first
  89.   time you load it.  UNZIP.EXE, in particular, will cause many people
  90.   problems when trying to install it into the reader (especially if they
  91.   are used to the way the DOS reader uses PKZIP and PKUNZIP).
  92.  
  93.   UNZIP.EXE does not accept a command line parameter telling it WHERE to
  94.   place the files that it unarchives.  UNZIP will *always* place the
  95.   unpacked files in the current directory.  For this reason, the OS/2
  96.   reader will always CHANGE DIRECTORIES to the directory defined in the
  97.   SETUP menu as your "WORK" directory, call the OS/2 archiver, and then
  98.   restore the reader's "home" directory.
  99.  
  100.   Because the reader changes to the WORK directory before calling an
  101.   archiver, it will NOT be enough to place your archiver executables in the
  102.   reader directory (unless the reader directory is on your PATH).  You will
  103.   need to either place the archiver executables somewhere in your OS/2
  104.   PATH, or give the full drive:\directory\exename.exe when setting up the
  105.   reader.
  106.  
  107.   Below are the command lines that need to be used for ZIP.EXE and
  108.   UNZIP.EXE:
  109.  
  110.   Compression Command Line   : C:\PATH\TO\ZIP.EXE -jk @F @I
  111.   Decompression Command Line : C:\PATH\TO\UNZIP.EXE @F
  112.  
  113.   Please note that the DECOMPRESSION command line for UNZIP does *not* have
  114.   the '@I' parameter.  Adding the '@I' parameter to the command line will
  115.   cause UNZIP.EXE to fail!
  116.  
  117.   Please also note that the COMPRESSION command line for ZIP requires the
  118.   use of the -j command line parameter.  If you do not include this command
  119.   line parameter, your archives will contain full path names, which will
  120.   (many times) cause the reader to fail when you decompress it.
  121.  
  122.  
  123. * The reader will (by default) load all external programs in such a way
  124.   that any type of executable format that OS/2 supports (DOS, OS/2, WIN)
  125.   will run properly from within the reader.  For example, you *could* use
  126.   PKZIP/PKUNZIP v2.04g for DOS as the ZIP program defined in the reader.
  127.   When using non-native OS/2 applications, the secondary program will be
  128.   spawned in another session by the command processor (CMD.EXE, 4OS2.EXE,
  129.   etc).  This process will take a bit more time than simply executing an
  130.   OS/2 executable, but it allows for greater compatibility and selection of
  131.   programs.
  132.  
  133.  
  134. * Here's a hint to save a few seconds of load time when the reader calls
  135.   an external program:
  136.  
  137.   Suppose we have our editor defined as "C:\OS2UTIL\OS2EDIT.EXE @F", which
  138.   is an OS/2 executable.  The default behavior is to call the command
  139.   processor, which in turn loads OS2EDIT.EXE.  Since OS2EDIT.EXE is an OS/2
  140.   application, you can force the reader to execute OS2EDIT.EXE directly
  141.   (skipping the command processor) by placing an exclamation point (!) as
  142.   the first character in the command line:
  143.  
  144.   !C:\OS2UTIL\OS2EDIT.EXE
  145.  
  146.   This will shave a few seconds off of the load time of the editor,
  147.   especially with slower processors.  Note that this technique works on ALL
  148.   command lines configurable within the reader.
  149.  
  150.  
  151. * The reader cannot properly detect (and guard against) a user pressing
  152.   Control-Break.  If you press Control-Break while using the reader, the
  153.   program will come to a screeching halt.  This is due to [what we believe
  154.   to be] a bug in OS/2 itself.  We will continue to work on the problem and
  155.   guard against the Control-Break sequence aborting the reader in the
  156.   future.
  157.  
  158.   However, at this time, the only way around the problem is to not press
  159.   Control-Break when the reader has the keyboard focus!
  160.  
  161.