                            WnBrowse 3.6
                            ============

                        A Windows File Browser
                        ======================

                                 By
                                 ==

                           Nigel G. Thomas
                           ===============


Introduction
============

The standard method of viewing files under Windows is to use the provided
accessory program Notepad. As a file viewer however, Notepad has a number
of limitations. It can only be used for relatively small files (less than
53K), and can only view text files. When you view a file using an editor,
you also run the risk of inadvertently modifying the file.

WnBrowse removes these limitations, and in addition provides MANY more
facilities to make file viewing faster and easier.

Some of the highlights of WnBrowse are :

  * Support for files of any size
  * Files may be viewed in a text or hex format
  * Text can be selected and copied to the clipboard, printed or
    saved to a file.
  * The file or a selected portion can be printed with optional user
    defined running headers/footers.
  * Font selection capability
  * Selectable colour schemes
  * Drag and Drop file support.
  * One-click operation via the Button-Bar
  * Online Help
  * Optional File Manager Extension.
  * Can list and View the contents of ZIP files.
    (Viewing Zip files requires a copy of PKUNZIP)

  **********************************************************************
  *  PLEASE NOTE !                                                     *
  *                                                                    *
  * WnBrowse 3.5 and above will only run under Windows 3.1 and above,  *
  * it will NOT run under Windows 3.0. Likewise, OS/2 2.1 is required  *
  * to run WnBrowse, OS/2 2.0 will not do.                             *
  *                                                                    *
  **********************************************************************


Installing WnBrowse
===================

WnBrowse is distributed as nine files :

   SETUP.EXE     - WnBrowse installation and setup program
   WNBROWSE.EXE  - The WnBrowse program file
   WNBROWSE.HLP  - The on-line help file
   WNBROWSE.TXT  - Program documentation and registration details.
   WBFXTEN.DLL   - WnBrowse File Manager extension 
   WNBZIP.BAT    - DOS Command file for running PKUNZIP
   WNBZIP.PIF    - PIF file for WNBZIP.BAT
   CTL3DV2.DLL   - Microsoft 3D control library
   README.NOW    - Information about the latest release.

(WnBrowse may also be distributed as a compressed ZIP file (WINBRW.ZIP) in
which case you should use PKUNZIP to expand the files to a diskette or to
a temporary directory on your hard disk before running SETUP).

The installation of WnBrowse has been simplified in this release by
the provision of a setup program. While you can still install WnBrowse
manually, I strongly advise you to use the Setup program as this will
ensure that the files are installed correctly.


1. Execute the Setup program

   a. From the Windows Program Manager, select the Run option from the
      File menu.

   b. In the command line box enter :

             A:\SETUP

       Note : If the WnBrowse distribution files are in a directory on your
              hard disk run Setup from there. For example, if the files are
              in the directory TEMP on your C drive, enter :

                    C:\TEMP\SETUP

   c. Press the OK button.

2. Specify your installation options

   The Setup program will display a dialog box indicating the installation
   options that will be used.

   a. The default installation directory is WNBROWSE on the disk that contains
      Windows (usually C:). If you want to install WnBrowse in a different
      location, change the destination path name.

   b. If you want Setup to add WnBrowse to a Program Manager group, select
      the appropriate check box and enter the required Program Group name in
      the provided edit box. (The default group is WnBrowse).

   c. If you want the optional WnBrowse File Manager extension installed,
      select that check box.

   Finally, click the Proceed button to start the installation. If you want
   to cancel the installation, click the Exit Setup button.        

3. Install the ZIP File viewing support.

   Before you can view the contents of ZIP files with WnBrowse, you must
   first install the ZIP extraction utility PKUNZIP (a shareware utility
   available from PKWARE Ltd).

   If PKUNZIP is installed in a directory that is NOT in your DOS PATH
   statement you must also make a change to the WNBZIP.BAT file.

   WNBZIP.BAT as shipped contains the following line :

      pkunzip %1 %2 %3 %4 %5

   If PKUNZIP.EXE is NOT in your DOS path, you must change the file to 
   contain the full path to PKUNZIP. For example if PKUNZIP.EXE is in the
   directory UTILS on drive C, change the contents to :

      C:\UTILS\PKUNZIP %1 %2 %3 %4 %5

   When Viewing a zipped file, WnBrowse creates a temporary copy of the
   file. This copy is deleted after viewing is completed. Where WnBrowse
   places these temporary files depends on the presence of a DOS 
   environment variable (TEMP). If the TEMP variable is defined, then
   temporary files are placed in that directory, otherwise, files are
   placed in the root directory of the disk containing Windows.

   For example to place temporary files in the directory C:\TEMP, place
   the following line in your AUTOEXEC.BAT file :

      SET TEMP=C:\TEMP 

   Note : Ensure that the directory named in the TEMP variable exists.
   
   WARNING : To ensure that you do not inadvertently overwrite files in
             your root directory, it is STRONGLY recommended that you use
             a temporary directory. 

4. Possible Installation Problems

   This version of WnBrowse uses the Microsoft 3D control DLL to provide
   3D dialogs. If this DLL (CTL3DV2.DLL) is not installed correctly, you
   will receive an error message every time WnBrowse starts, and the dialogs
   will not be 3D.

   The WnBrowse setup program has been provided to ensure that this DLL is
   installed correctly. If you are installing WnBrowse manually however, you
   should ensure that the following rules are followed :

     * If you are installing CTL3DV2.DLL on a stand alone copy of Windows,
       it MUST be installed in the Windows system directory. This is
       usually C:\WINDOWS\SYSTEM

     * If you are installing CTL3DV2.DLL on a shared copy of Windows on a
       network, it should be installed in the Windows directory. This is
       usually C:\WINDOWS

     * If CTL3DV2.DLL is loaded from any other location, it will display
       an error message, and terminate.

   Note: CTL3DV2.DLL is shipped as a compressed file named CTL3DV2.DL_, if
         you are installing manually, you must uncompress it using EXPAND
         program provided with Windows:

           expand a:\ctl3dv2.dl_ c:\windows\system


        
****************************************************************************
****************************************************************************
**                                                                        **
**                               ===========                              **
**                               Please Note                              **
**                               ===========                              **
**                                                                        **
**  WnBrowse is not freeware or in the public domain, it is Shareware.    **
**  You may use WnBrowse without charge for a reasonable period of time   **
**  to evaluate the product. If after that time you wish to continue      **
**  using WnBrowse you must register your copy using the procedure        **
**  detailed at the end of this file.                                     **
**                                                                        **
**  However, WnBrowse is 100% functional and contains no limitations or   **
**  'Nag' boxes.                                                          **
**                                                                        **
**  Please support the shareware concept, and register the products that  **
**  you continue to use !                                                 **
**                                                                        **
****************************************************************************
****************************************************************************   


Menu Commands
=============

   For information about the use of the program menus, please read the online
   help.

Procedures
==========

   Selecting Files for Browsing
   ----------------------------

   There are five ways of selecting files for browsing with WnBrowse.

   1. Open command
    
      By selecting "Open" from the File menu or by clicking the open 
      button, a dialog box is presented from which a single file can be
      selected. WnBrowse also saves the names of all files contained in
      the file listbox. These can be browsed by selecting the Previous or
      Next file command on the File menu.

   2. Drag and Drop

      One or more files can be dragged from the File Manager and dropped
      onto the WnBrowse Window or the WnBrowse ICON. To facilitate easy 
      drag and dropping, the WnBrowse ICON can be kept on constant display
      by selecting 'Keep ICON on top' from the WnBrowse system menu. 

   3. Command Line

      The name of the file to be browsed can be specified on the WnBrowse
      command line. More than one file can be selected by using the DOS
      wildcards '?' and '*'.

            WNBROWSE.EXE C:\DOCS\*.TXT

      Would select all files in the DOCS directory with a file type of TXT.

   4. WnBrowse File Manager Extension.

      If you installed the optional WnBrowse File Manager Extension, you
      can browse files directly from a new File Manager menu. The extension
      adds an extra menu (Browse) to the File Manager menu bar. To browse a 
      file (or files), simply select the files in the usual way, and select 
      'Browse Selected File(s)' from the Browse menu. The Browse menu option 
      works from both the directory window and the search results window.

      If a copy of WnBrowse is not running when the Browse option is
      selected, the WnBrowse File Manager extension attempts to start a 
      copy. For this to work, a copy of WNBROWSE.EXE must be contained in 
      the same directory as the File manager extension DLL (WBFXTEN.DLL).

      If you are running Windows for Workgroups, the WnBrowse extension
      will add a browse button (a magnifying glass) to the File Manager
      toolbar. This button can be used for even faster browsing.

   5. Previously browsed files can be selected from the list of files
      at the end of the File menu.
      
  Selecting Text
  --------------

  The mouse is used to select text from the file being browsed. The
  selected text is displayed in a different colour to distinguish it
  from unselected text. Selected text can be copied to the Windows
  clipboard (for pasting into other applications), can be printed, or
  can be save to a file.

  Text is selected in the usual way by clicking the mouse at the start or
  end of the required text, and dragging the mouse over the required text.
  If the mouse is dragged outside the boundaries of the WnBrowse window, 
  the file will be scrolled and selected.

  To speed up text selected, the keyboard can be used. For example, click
  and hold the mouse at the start of the required text, then use the
  Page-Down key to scroll through the file, selecting as you go.

  Note : In text mode, selection is done character by character, in hex
         view mode selection is line by line.

  Viewing ZIP Files
  -----------------
  
  WnBrowse can be used to list the contents of ZIP files, and to browse
  individual files contained within them.
 
  When a ZIP file is selected, the ZIP button and the 'View ZIP File
  Contents' menu item can be used to display the names of the included
  files.

  From the ZIP display dialog, you can select one of the included files
  for viewing by double clicking on the required file name, or by selecting
  a file and pressing the View button. WnBrowse will UNZIP the file and
  display it in the WnBrowse window. Selecting 'Redisplay Zip File' or
  pressing the Re-display ZIP button will redisplay the original ZIP file.

  When Windows is running in enhanced mode, files are unzipped in an 
  iconized DOS window. In standard mode the unzipping will be performed
  in a fullscreen DOS session.

  NOTE : ZIP Viewing is not currently supported when WnBrowse is running
         under the OS/2 operating System.
         
         Recursive Zip viewing is not supported. That is, you cannot view
         a file contained within a Zip file that is itself contained within
         a Zip file. You can however, list the contents of a Zipped Zip
         file.

  Printing 
  --------

  The File menu contains two commands used to control printing, the first
  'Printer Setup' is used to select the required printer, and to set
  printer options, such as page size. The actual options available will
  vary according to the type of printer being used.

  The second print command 'Print' is used to display a dialog box from
  which file printing is controlled (you can also click on the printer
  button).

  The following options are available :

    * Print the entire file or only the selected portion
    * Set the size of the left, right, top and bottom margins
    * Print with or without user defined headers and footers
    * Print using the default printer font
    * Process embedded form feed characters.
    * Wrap print lines

  If the header/footer check box is clicked, the print dialog box is
  expanded to allow the entry of a header and footer line to be printed at
  the top and bottom of each page. Along with the text required in these 
  lines, you may also include the following codes :

      &d - Prints the current date
      &t - Prints the current time
      &f - Prints the name of the file being printed
      &p - Prints the current page number

  Note: The exact format of the time and date is dependant on the current
        control panel settings.

  The slash character '/' can be used to left justify, right justify, or
  centre text within the headers and footers.

  for example :

     &f/&d/Page &p

  would result in :

    wnbrowse.txt                28/04/94                    Page 1

  Page Ejects
  -----------

  When printing a text file, if the Process Form Feed option is set, and if
  any line contains a Form-Feed ASCII character in position one (hex '0C'),
  WnBrowse will start a new page before printing that line. When printing
  files that contain Form-Feeds, you should ensure that the page margins
  are set to appropriate values.

  Launching Files
  ---------------

  When browsing a file you can launch it by clicking on the Launch button,
  or by selecting the 'Launch Current File' option from the File menu.

  What happens when you launch a file depends on the file type, and
  whether or not it has an associated application:

  * If the file has an associated application, launching the file, will
    start that application and load the file being browsed into it.
    For example, launching a file with an extension of BMP, will normally
    start the Windows Paintbrush program.

  * If the file is a Windows 16 bit program. Launching the file will
    start it's execution.

  * If the file is a text file, launching it will start the default editor
    program. The name of the editor can be set from the Preferences
    dialog.   

  If the 'Minimize on Launch' option has been set, WnBrowse will minimize
  after the file has been launched.

  Note: The launch facility also works when viewing a file contained
        within a ZIP file.


  Mouse control
  -------------

  While most WnBrowse functions can be controlled by either the mouse
  or the keyboard, some functions are only available via the mouse. One,
  text selection, has already been covered, below are the rest :


     Popup File selection
     --------------------

       When multiple files are available for browsing, a single right
       click of the mouse in the WnBrowse window will produce a popup
       dialog box allowing quick file selection.

     Mouse File positioning
     ----------------------

       If the left mouse button is double clicked on a text line two
       things take place :

         1. The line is scrolled to the top of the window.
         2. The new file position is remembered by WnBrowse.

       If the right mouse button is subsequently double clicked anywhere
       within the WnBrowse text window, the file is repositioned at the
       point saved above. A second right button double click returns to
       the previous position.

     Selecting text to search for
     ----------------------------

       You can quickly find other occurrences of a text string within a
       file by selecting the text you want to search for before clicking
       the Find button or selecting Find from the Search menu. The selected 
       text will be used as the string to be searched for.       

     Reverse Repeat Search Direction
     -------------------------------
     
       The repeat search button is used to find the next or previous
       occurrence of a character string within a file. If the shift key is
       pressed while the repeat search button is clicked, then the search
       direction is temporarily reversed.   

  
  Keyboard Usage
  --------------

            Key                         Usage    
       ===============  =======================================

        F1              Displays the Help Index 
        F3              Performs a Find Next 
        ESC             Closes the file and iconizes 
 
        ctrl-T          Selects text view mode 
        ctrl-H          Selects hex view mode 
 
        ctrl-M          Toggles the display of the menu 
        ctrl-S          Saves the currently selected options 
 
        ctrl-C          Copies selected text to the clipboard 
 
        ctrl-Page Up    Browses the previous file 
        ctrl-Page Down  Browses the next file
 
        Page Up         Scrolls up one window full 
        Page Down       Scrolls down one window full 
        Up Arrow        Scrolls up one line 
        Down Arrow      Scrolls down one line 
        Left Arrow      Scrolls left 8 characters 
        Right Arrow     Scrolls right 8 characters 
        Home            Scrolls to the top of the file 
        End             Scrolls to the bottom of the file. 
   

  File Information Display
  ------------------------

  The File Information option on the File menu (or the information button)
  can be used to display information about the file that is currently
  being browsed.

  When browsing a Windows 16 bit application file (EXE or DLL), WnBrowse
  will display Version information if available. This information can be
  useful in identifying the purpose of a file.

  Also available is the list of DLL's that a program has imported. 

  WNBROWSE.INI options file
  -------------------------

  A large number of WnBrowse options can be changed to meet your exact
  requirements. These include the colour scheme, default font etc. To
  avoid having to change these settings each time you start WnBrowse,
  you can save them by using the 'Save Settings' command on the Options
  menu. WnBrowse saves all the settings in a private file (WNBROWSE.INI)
  in the Windows directory . No changes are made to any of the Windows
  INI files.

  Most of the options in the wnbrowse.ini file are created when the Save
  Settings option is selected. Others, such as print options, are created
  when they are changed. These should therefore not be changed by other
  means, such as with a text editor, doing so could cause unpredictable
  results. 

  Options that must be entered/changed with an editor are detailed below :

    ExitOnEsc=1 or 0 (default is 0)

      This option modifies the behavior of the Escape key. When set to
      '0' the Escape key causes WnBrowse to close the current file and
      iconize. When set to 1, the Escape key will cause WnBrowse to Exit.

    Buffers=n         (n is 0 to 5, the default is 5)

      This option specifies how many buffers are used to store data from
      files being browsed. Each buffer is approximately 30k in size. All
      such buffers are freed if Windows becomes short of storage.

    MaxTextSize=n    (n is 0 to 114, the default is 12)

      This option specifies the largest file size (in megabytes) that can
      be browsed in text mode. Any file larger than the specified size will
      be treated as a 'non-text' file.

      Note: When WnBrowse opens a text file, the entire file is read. For
            large files, such as 10MB or more, this may take a while.
            Setting the MaxTextSize option to a low value (EG '1') will
            speed up processing.

    MaxLineLen=n    (n is 80 to 1024, the default is 256).

      This parameter can be used to change the maximum length of a line
      that WnBrowse will allow in a text file.  

   
  Named Saved Options
  -------------------

  WnBrowse also allows you to save options as named configurations, 
  allowing you to specify the named configuration at run time.
  To do this you must tell WnBrowse the name of the INI configuration to
  use at startup. This is done by passing the required name as a command
  line parameter.

         WNBROWSE.EXE -Iname

  The dash character indicates a WnBrowse parameter, the 'I' specifies that
  an INI configuration name follows, 'name' can be any name you like (less
  than 20 characters).

  Customizing  File Open Filters
  ------------------------------

  When you select the File open command (or click the open button), the
  common Windows file open dialog box is displayed. Included is a list
  box (List files of type) containing file filters. You can use your
  own list of filters by adding a parameter to the WnBrowse options
  file (WNBROWSE.INI).

  The filter string should consist of one or more pairs of strings
  separated and terminated by a unique character. For example to allow
  for the selection of TXT files or INI files you would code :

    FilterSpec=Text Files (*.TXT)|*.TXT|INI Files (*.INI)|*.INI|

  The first string in each pair is displayed in the filter listbox to
  inform the user what file types will be selected. In the example above,
  these descriptive strings are :

     Text Files (*.TXT)
     INI Files (*.INI)

  The second string in each pair is the file filter specification that
  is to be used to select files. In the example above, they are :

     *.TXT
     *.INI

  Each string is separated by a unique character that is not it's self
  contained in the strings proper. In the example above the character
  used is '|'.    

  You may also combine filters into a single selection by separating them
  with a semicolon, for example :

    FilterSpec=Text Files (*.TXT;*.DOC)|*.TXT;*.DOC|

  The First filter in the list is used as the default. The default 
  filter used by WnBrowse is :

    All Files (*.*)|*.*|Text Files (*.TXT)|*.TXT|INI Files (*.INI)|*.INI|
       ZIP Files (*.ZIP)|*.ZIP|

  Note : WnBrowse does not perform any sanity checks on the supplied
         string. Failure to provide a valid string could produce
         unpredictable results.

  Removing WnBrowse from your system
  ----------------------------------

  If after evaluating WnBrowse you decide not to register it, you must
  remove it from your system. To do this delete the following files :

           WNBROWSE.EXE
           WNBROWSE.HLP
           WBFXTEN.DLL
           WNBROWSE.TXT
           WNBZIP.BAT
           WNBZIP.PIF
           
  If you saved the WnBrowse settings, delete the file WNBROWSE.INI from
  your Windows directory (usually C:\WINDOWS).

  If you installed the WnBrowse File Manager extension, you should remove
  the appropriate line from the Addons section of WINFILE.INI.

    Load the file WINFILE.INI into an editor, such as notepad, and find the
    addons section. This section starts with a line containing [AddOns].
    Delete the line in the Addons section that loads the WnBrowse File
    Manager extension. It will look like the example below :

      WnBrowse=C:\WNBROWSE\WBFXTEN.DLL

    Save the file and restart File Manager. 


Registering WnBrowse
====================

  If you like WnBrowse enough to want to continue using it after the
  evaluation period, you must register it using the procedure below. The
  benefits of registration are many :

    * You will have access to free product support.

    * You will receive details of new versions of WnBrowse (and hopefully
      other future products).

    * You will be able to make suggestions for improvements and (horror)
      report any bugs.

    * You will enable me to continue to improve and support what I hope
      is the first of many useful products.

    * If the version you are evaluating has been superseded, you will also
      receive a copy of the latest version.

   
  Register By Post :
  ------------------

    To register by post, send your cheque, made payable to N.G.Thomas
    to the following address :

          Nigel.G.Thomas.
          39 Redshank Avenue,
          Winsford,
          Cheshire CW7 1SP,
          England.
  
    Please send what you think WnBrowse is worth, I suggest 10 UK pounds.

    (Please note that at this time I CANNOT accept payment by credit cards,
     if absolutely necessary, send cash (in Sterling))
   
    Include the following :

      * Your name
      * Your address and telephone number.
      * From where you acquired WnBrowse
      * The version being evaluated.
      * Required disk size 3.5 or 5.25.

      Note : A new disk will ONLY be sent if there is a newer version
             of WnBrowse available.

      Any comments on the product would also be appreciated. 

  Register by CompuServe
  ----------------------

    You can also register WnBrowse by using the CompuServe shareware
    registration service. To access the service, logon to CompuServe and
    access the SWREG service (GO SWREG). The CompuServe registration ID
    for WnBrowse is 1108. 

    When you register via SWREG, the cost is a fixed 15 US dollars.
  
  Registering Multiple Copies
  ---------------------------

    For details on registering multiple copies of WnBrowse, please contact
    me at the above address. I can also be contacted on CompuServe, my ID
    is 100117,1542.


  Windows NT Version
  ------------------

    A Windows NT version of WnBrowse is now available. It is a full 32 bit
    application supporting such features as long file names. Please contact 
    me for details.


The Legal Stuff
---------------

   WnBrowse is supplied as is. The author disclaims all warranties, 
   expressed or implied, including, without limitation, the warranties of
   merchantability and of fitness for any purpose. The author assumes no
   liability for damages, direct or consequential, which may result from
   the use of WnBrowse.

   WnBrowse is a "shareware program", and is provided at no charge for you
   to evaluate for a reasonable period of time. You may also pass copies of
   WnBrowse to friends so that they may also evaluate the product. If you 
   do pass on WnBrowse, you must do so without modification, including all
   of the supplied files.

   If you find WnBrowse useful and wish to continue using it, you must
   register it using the procedure outlined above. Once you have registered
   WnBrowse, you may continue to use this version, and ALL future versions
   of WnBrowse, without further charge.
  
         
Techi stuff + Thanks
--------------------

   WnBrowse was developed on an IBM PS/2 model 70 under Windows 3.0 and
   a Dell 466/T under Windows 3.1. It was written in the C language and
   was compiled using the Borland C++ compiler version 4.0

   The ICON was provided by Arthur. Thanks Arthur !

   A number of people have contributed to the design of WnBrowse by 
   providing constructive criticism and suggestions for improvements.
   Thanks to all, but particularly to Tom and Jack. 



                           ----------------
       
   Windows is a trademark of Microsoft Corporation
   PS/2 and OS/2 are trademarks of International Business Machines Ltd.
   PKUNZIP is copyright PKWARE Ltd.
