Fileview 1.5





Date: Dec. 31, 1992

Fileview1.5Dec. 31, 1992

                            Fileview
                                
                                
                               by
                                
                                
                                
                      Snake River Software
                                
                           Version 1.5
                                








          Program and Documentation Copyright 1990-1992
                                
                                
                                
                       All Rights Reserved
                                
                                
                                
                                
                                
 Microsoft and MS-DOS are registered trademarks and Windows is a
               trademark of Microsoft Corporation.
                                
                                
                                
                                
                                
                            Contents*
                                
                                
Overview                                                   1
Notations                                                  1
Acknowledgements                                           1
System Requirements                                        1
Installation                                               2
Conversion                                                 2
Usage                                                      2
Commands                                                   4
    File                                                   4
    Edit                                                   4
    Options                                                5
    Help                                                   5
Keys                                                       6
Searching                                                  7
Messages                                                   8
WIN.INI                                                    9
License Information                                       10
Ordering Information                                      12
A.                                              User License     14
B.                                              Site License     15







*   Page numbers are based on the printed version.  The *.txt
    version of this document that is distributed on disk may not
    be the same.  The page numbers should provide an approximate
    place to refer to.
    

Overview
    This documentation is for release 1.4 of Fileview.
    
    Fileview is a Microsoft Windows based tool that allows you to
    browse files on your hard-drive or network drives.  Unlike
    other Windows browsers, Fileview does not load the file into
    memory, allowing you to browse files that are larger than
    available memory while leaving room for other windows
    applications to run.
    
    To use Fileview, select a file to browse from the File/Open
    dialog as you would select a file in any other windows
    program.
    
    Once you are browsing a file, you can scroll through it and
    search for text using DOS style or Regular Expression style
    search patterns.
    

Notations
    The following notations are used in this manual:
    
    [text]  is used to identify optional information.  If the
            option is not specified, the default action will be
            taken. An exception is in the discussion of the
            WIN.INI file.  WIN.INI section headers are identified
            as [text].  These sections are boldfaced to assist in
            their identification whereas [options] are not
            normally boldfaced.  Hopefully, context and the use
            of boldfacing will distinguish these two uses.
            

Acknowledgements
    The regular expression routines were derived from routines
    written by Henry Spencer and copyright in 1986 by the
    University of Toronto.
    

System Requirements
    Fileview runs within the Microsoft Windows.  Minimum System
    requirements include:
    
        Microsoft Windows 3.1 or higher
        
        DOS 3.X or higher
        
        Approximately 165K disk space
        
        Windows compatible mouse
        

Installation
    Fileview is easy to install. Simply copy all distribution
    files to the disk/directory where you want to run Fileview
    from.  This will usually be \windows.  Note that you may
    install Fileview in a directory that is not in your
    environment path if you provide the path to the program
    manager.  However, the Fileview.hlp file must be in the
    environment path for it be found when help is requested.  If
    you install Fileview in a path that is not in your
    environment path, installing it in the \windows directory is
    recommended.
    
    All configuration options reside in your WIN.INI file.  All
    of these can be set within Fileview.
    

Conversion
     Prior to version 1.5, Fileview used the windows
     initialization file WIN.INI.  A conversion utility is
     provided with version 1.5.  This utility will copy the
     WIN.INI entries to a private ini file: FILEVIEW.INI.  You do
     not have run the conversion program.  You may instead choose
     the various options in FileView and save them to the
     settings that you wish.  To convert:
          1    Choose Run from Program Manager File menu.
          2    Type the drive, path, and PVPINI; or push the
               browse button and choose the correct drive,
               directory, and FVPINI.EXE.
          3    Press the OK button.
     The following dialogs will present themselves:
          1    Convert from WIN.INI to FILEVIEW.INI?
               Pressing the 'Yes' button to continue with the
               conversion.  Pressing the 'No' button will display
               a termination message and quit.
          2    If the 'YES' button was pressed, PVPINI will
               display a list your WIN.INI that will be moved to
               FILEVIEW.INI.  Press the 'OK' button.
          3    Delete FileView entries in WIN.INI?
               Press the 'Yes' button to delete your FileView
               entries in the WIN.INI file.  Press 'No' to retain
               these entries.  If you press 'No', you will have
               to manually delete these entries at a later time.
          4    FileView INI conversion ended.
               Press the 'OK' button to terminate the program.
               

Usage
    Fileview is invoked like other windows programs.
    
    From the WINDOWS Program Manager, double click a Program
    Group  that contains Fileview, then double click on the
    Fileview icon.
    
    If you have installed Fileview as a program under Filefind's
    user defined menu, you may invoke it from Filefind and
    automatically open and browse the selected file.
    

Commands
     File
        Open        Invokes a dialog to choose a file to browse.
                    The dialog consists of one edit field and two
                    list boxes.  The file name with a path or
                    wild cards may be entered.  If the file
                    specification does not contain wild cards,
                    Fileview will attempt to open the file.  If
                    the file specification includes wild cards,
                    Fileview will list all matching files in the
                    path, and change the default extension to
                    match the specification extension.  The
                    extension will remain until changed again, or
                    the program is terminated.  A file list box
                    allows a specific file to be picked without
                    typing the filename.  A directory list box
                    allows the directory tree to be traversed and
                    the disk drive to be changed.
                    
        Refresh File     Reloads the current file.  Fileview
                    loads a series of pointers into the file the
                    you are using. If this file becomes changed
                    (because you are changing it with NOTEPAD for
                    example), Fileview will not display the file
                    correctly.  The Refresh File command
                    instructs Fileview to reload its pointers so
                    the file is correctly displayed.  This
                    command is only needed if the file is changed
                    while you are viewing it.
                    
        Select Printer   Selects the printer to use.  The printer
                    selected will remain the printer to use until
                    another is selected or you close the program.
                    If no printer is selected, the windows
                    default printer is used.  Setup... within
                    this dialog opens the setup dialog for the
                    particular printer selected.  The details of
                    the Setup... dialog vary with the printer
                    selected.  Control Panel... within this
                    dialog will invoke the
                    Control Panel(CONTROL.EXE).  This program
                    must  reside in the windows directory
                    (Whatever directory you originally installed
                    windows in).
                    
        Print File  Prints the file.
                    
        Print Window     Prints the portion of the file shown by
                    the window.
                    
        Select Font...   Invokes a dialog that allows you to
                    select a font and point size for printing the
                    file or window.
                    
        Exit        Shuts down the program.
                    
     Edit
        Search      Invokes a dialog to specify search criteria
                    
        Continue Search  Searches from the top line in the
                    display downward for the last search string
                    specified.
                    
     Options
        ASCII       Switches the display mode to ASCII.  ASCII is
                    not always available.  Fileview examines the
                    beginning of the file to determine whether
                    ASCII mode is feasible.  If not, ASCII mode
                    is disabled.
                    
        Hex         Switches the display mode to Hexadecimal.
                    
        Display     Invokes a dialog that allows the display to
                    be tailored.  Settings in this dialog may be
                    saved.  Saved settings may also be restored.
                    
        Other       Controls auto-open, auto-refresh, initial
                    sizing.  Options can be saved or restored.
                    
        Register User    Invokes a dialog to enter a license id.
                    
     Help
                    Invokes the windows help program.  Once
                    invoked, you can select from the various help
                    topics as in other windows 3.x programs.  You
                    can open other help files if you wish.  When
                    Fileview is closed, the windows help program
                    will also be closed (if no other application
                    is using WinHelp).
                    
        Index       The main index is displayed
                    
        Keys        Displays help for Fileview's use of keys.
                    
        Printing    Displays help about Fileview printing.
                    
        Refresh File     Displays help about Fileview file
                    refreshing.
                    
        Searches    Displays help about Fileview text searching.
                    
        About       Invokes the About dialog.  Additional
                    information about the selected file is
                    included in the About dialog.  This
                    information includes the file path, Size in
                    bytes, size in records, date and time created
                    or last modified, and the file attributes.
                    

Keys
    Ctrl+R      Refresh the file
                
    =>          Scroll 1 character to the right
                
    <=          Scroll 1 character to the left.
                
    /\          Scroll 1 character up
                
    \/          Scroll 1 character down
                
    Home        Position at the top of the file
                
    Ctrl+Home   Position at the leftmost position of the file
                
    End         Position at the end of the file
                
    Ctrl+End    Position at the rightmost position of the file
                
    PgUp        Scrolls 1 screen up
                
    Ctrl+PgUp   Scrolls 1 screen to the left
                
    PgDn        Scrolls 1 screen down
                
    Ctrl+PgDn   Scrolls 1 screen to the right
                
    F3          Repeat search forward
                
    Shift+F3    Invoke the Search specification Dialog.
                
    Alt+F4      Exit the application.
                
    Crtl+F12    Invoke the Open dialog.
                

Searching
    Fileview will the file for a specified string.  To specify
    and start a search, invoke the Edit/Search command.  Once the
    OK button is pressed, the search will start at the top of the
    file and continue until the string is found or the end of the
    file is encountered.  Fileview searches a single record at a
    time, so the search string can not span a line.
    
    Search For: Enter the text that should be search for.  The
                string is entered as a wild card string or a
                regular expression depending on which search type
                is chosen.
                
    Ignore Case:     If checked, the search ignores case in the
                search string and the file.  If unchecked, the
                search matches on case as well as value for non-
                wildcard positions.
                
    Search Type
                Wildcard        specifications are similar to
                                wild card specification in DOS.
                                Only the '?' is implemented as
                                the '*' doesn't make a lot of
                                sense.
                                
                Regular Expression   specifications include all
                                the normal stuff.  A couple brief
                                commands for those not familiar
                                with regular expressions:
                                .    Any character (like DOS ?)
                                ?    0 or 1 of the previous
                                character
                                +    1 or more of the previous
                                character
                                *    0 or more of the previous
                                character
                                ^    match at the beginning of
                                the line
                                $    match at the end of the line
                                [abc]     match 'a', 'b', or 'c'
                                Examples:
                                a*   match on 'a', 'aa',
                                'aaaaaaa', etc.
                                a.b  match on 'axb', 'ayb',
                                'azb', etc.
                                a.b* match on 'ax', 'axb',
                                'axbb', 'ay', 'ab', 'abb'
                                ^a.b matches 'axb' at the
                                beginning of the line
                                a.b$ matches 'axb' at the end of
                                the line
                                
    Save        Saves the current values of the Ignore Case check
                box and Search Type.
    Reset       Reset Ignore Case check box and Search Type to
                the saved values.

Messages
    This section describes the various messages that Fileview may
    generate.  This section contains a description of the
    messages that are specific to Fileview.  Other messages may
    occur because of general windows errors, network problems,
    etc.  Please refer to the appropriate documentation for these
    messages.
    
    File does not exist
        Fileview can not open the requested file.  This message
        will occur if you invoke Fileview will a command line
        file that does not exist or specifies a path that does
        not exist.  This message will also occur if you type in
        an invalid file or path from the open dialog.
        
    Not a valid license Id
        You have entered an invalid license id.  You must provide
        a valid license id or cancel the dialog.
        
    Text Not Found
        You have invoked the Search... or Continue Search
        commands.  Fileview can not find a match for the search
        pattern.
        
    WM_COMMAND message nnnn not handled
        This message should never be displayed.  If it does, an
        internal error has occurred.  If you receive this
        message, please record the events leading to the message
        and contact support.
        

WIN.INI
    This section describes the contents of the [Fileview] section
    of the WIN.INI file.
    
    AOpn
        Indicates whether Fileview automatically displays the
        open dialog when invoked.  A value of 0 indicates that
        Fileview will not automatically display the dialog.  A
        value of 1 indicates that Fileview will automatically
        display the dialog.
        
    ARef
        Indicates whether Fileview automatically refreshes file.
        A value of 0 indicates that Fileview will not
        automatically refreshes file.  A value of 1 indicates
        that Fileview will automatically refreshes file.
        
    IniX
        The initial horizontal size of Fileview's window.
        
    iTab
        The initial vertical size of Fileview's window.
        
    iTab
        The number of spaces that tab expansion creates.
        
    lLinN
        Indicates whether line numbers will be displayed or not.
        A value of 0 indicates that line numbers are not
        displayed.  A value of 1 indicates that line numbers are
        displayed.
        
    lLinT
        Indicates whether line numbers or displacement values
        will be displayed.  A value of 0 indicates that
        displacement values are displayed.  A value of 1
        indicates that line numbers are displayed.
        
    LnFt
        Indicates whether displayed line numbers are displayed as
        a decimal or hexadecimal number.  A value of d indicates
        that line numbers are displayed as decimal numbers.  A
        value of h indicates that line numbers are displayed as
        hexadecimal numbers.
        
    lRul
        Indicates whether a ruler will be displayed.  A value of
        0 indicates that a ruler will not be displayed.  A value
        of 1 indicates that a ruler will be displayed.
        
    lSrchC
        Indicates whether case is respected or ignored.  A value
        of 0 indicates that case is respected.  A value of 1
        indicates that case is ignored.
        
    lSrchT
        Indicates whether wildcards or regular expressions are
        used.  A value of 0 indicates that wild card expressions
        will be used.  A value of 1 indicates that regular
        expressions will be used.
        
    lTab
        Indicates whether tabs in the file are expanded or not.
        A value of 0 indicates that tabs will not be expanded.  A
        value of 1 indicates that tabs will be expanded.
        
        
    Regn=hhhhhhhhh
        Is used to store your license identifier.
        
    
    

License Information
    Fileview is distributed as a shareware product.  All rights
    have been reserved by the author.  Fileview has not been
    released into the public domain.  If you use Fileview beyond
    an initial evaluation period, you must purchase a license.
    Two license options are available. You may purchase one
    license for each user of Fileview.  Alternatively, you may
    purchase a site license.
    


Duplication and Distribution Restrictions

    Fileview is a shareware product.  It may be copied and
    distributed for others to evaluate as long as the following
    rules are followed.  They are:
    
    1   The Fileview program, this documentation, and any other
        accompanying materials may not be modified in any way.
        
    2   A copy of this documentation and all accompanying
        materials must be distributed along with the program.
        
    3   You may not charge for distributing this program, except
        for a nominal media and handling charge. In any case,
        such a charge may not exceed $10.00.
        
    4   Users of Fileview must purchase a license for its use.
        One license per copy of Fileview, or the alternative site
        license, is required.  Note that this requirement allows
        you to make as many backup copies as you wish as long as
        you have a license per user or a site license.
        
    5   If you purchased a disk containing this software from a
        public domain/shareware software distributor, you have
        paid the media and handling charges as permitted in 3
        above.  You have not purchased the required license for
        Fileview.  Purchasing a license is required for continued
        use.
        

Ordering Information
    All orders for amounts less than two-hundred dollars ($200)
    must be pre-paid.  Purchase orders for site licenses of two-
    hundred dollars ($200) or more are subject to acceptance.
    Purchase orders that obligate the author to your company's
    terms and conditions are generally rejected.  Purchase orders
    must include:
    
       l    A list of items ordered with quantities
       l    Shipping address
       l    Billing address
       l    The name, address, and phone number of a
            knowledgeable individual whom we may contact should
            any question about this order arise.
    
    All orders for single user licenses will normally receive a
    registration id for each registration ordered.  All site
    licenses will normally receive a single registration id for
    each site license ordered regardless of the number of users
    in the license.  Disks are usually supplied in 3 1/2 inch
    format in either 720K or 1.44M sizes at our discretion.  If
    your needs differ from the above indicate your requirements
    on the order form.  Variations from the above are not
    generally a problem.  Printed documents or documents in
    electronic form other than the supplied .TXT format can be
    negotiated.  Other requests or requirements will be reviewed
    on an individual basis.
    
    
    Two rate scales are available for licensing Fileview. You may
    purchase a single user license or a site license. For either,
    you may simply purchase a license, or you may purchase a
    license and the current version on disk.
    
    
    Refer to the license applications following this section for
    current rates.
    
    
    The purchase of a license allows you to use Fileview and
    receive support.  As new versions are released, you may
    obtain them through the various shareware channels.  New
    versions will also be available directly from the author for
    a nominal materials and shipping charge.
    
    Fileview is registered by completing either the user or site
    application form and remitting the appropriate amount.   We
    do not currently accept credit cards.  Purchase Orders are
    accepted for site licenses only.
    
    Make checks payable to and send payments to:
    
          William L. Page
          
          P.O. Box 266
          
          Flagtown, New Jersey 08821-0266
          


    Note     Payments must be US funds.  Checks must be drawn on
        or payable through a US bank.  If you wish to remit a
        foreign check, we will attempt to have our bank process
        it through their collection department if you include a
        $7 fee.  Somehow that doesn't seem worth it.  Foreign
        users are probably better off sending cash.
        
    You can order the current version of the program when you
    register Fileview.  You should note the date of this document
    before ordering the current version.  If the date is
    relatively recent, you probably have the most current
    version.  If you have obtained Fileview from a shareware
    distributor, it is probably six to twelve months and several
    versions old.  When you register Fileview, the registration
    acknowledgement will indicate the current version of the
    program.  You have sixty days to order the current version at
    the same price at the price noted on the application.
    
                                
                        A.   User License
Fileview1.5Dec. 31, 1992

        Application for Single User License Registration
                          Fileview  1.5
                                


Date:

To:  William L. Page
     P.O. Box 266
     Flagtown, New Jersey 08821-0266

Please register FileView for:

     Name

     (Company)

     (Title)

     Address

     City, State Zip

     Windows version that I am currently using:

     I got FileView from (BBS & Phone #)



     +--------------------------------+---------+-------+---------+
     |  Item                          | Unit $  | Quant | Total $ |
     +--------------------------------+---------+-------+---------+
     |  FileView                      |    $10  |       |         |
     +--------------------------------+---------+-------+---------+
     |  Current Version on 3 1/2 disk |     $6  |       |         |
     +--------------------------------+---------+-------+---------+
     |         Total                                    |         |
     +--------------------------------------------------+---------+


Special Requirements:







                                
                        B.   Site License
Fileview1.5Dec. 31, 1992

            Application for Site License Registration
                          Fileview  1.5
                                
Date:

To:  William L. Page
     P.O. Box 266
     Flagtown, New Jersey 08821-0266

Please register FileView for:

     Name

     (Company)

     (Title)

     Address

     City, State Zip

     I got FileView from (BBS & Phone #)



     +--------------------------------+---------+--------+--------+
     |  Item                          | Unit $  | Quant  |Total $ |
     +--------------------------------+---------+--------+--------+
     |  First 10 Users                |   $100  |      1 |   $100 |
     +--------------------------------+---------+--------+--------+
     |  Users 11-20                   |     $9  |        |        |
     +--------------------------------+---------+--------+--------+
     |  Users 21-50                   |     $8  |        |        |
     +--------------------------------+---------+--------+--------+
     |  Users 50+                     |     $7  |        |        |
     +--------------------------------+---------+--------+--------+
     |  Current Version on 3 1/2 disk |    $12  |        |        |
     +--------------------------------+---------+--------+--------+
     |         Total                                     |        |
     +---------------------------------------------------+--------+

Special Requirements:









