
                       LOOK2 v3.3 DOCUMENTATION

  LOOK2 v3.3 - An OS/2 32-bit Fullscreen Directory/File Viewing Program 
                   Copyright (c) 1996-1999 BMT Micro, Inc.


   >>>>>>>>>>>>>>>>>>>>>>>> SHAREWARE SOFTWARE <<<<<<<<<<<<<<<<<<<<<<<<<

   This program is copyrighted software.  You may and are encouraged to
   copy and share it with others as long as it is copied in its entirety
   unmodified and no charge is made for it.  If you find LOOK2 useful in
   your OS/2 environment, please send a $20 registration fee to the address
   on the left below.  In return, you will receive a lifetime registration
   number that is valid for this and any future versions of LOOK2.
   Registered users will receive notifications when new versions of LOOK2
   are available to be downloaded.  Site licenses and multiple copy
   licenses are available

   %%%%%%%%%%%%%%%%%%%%%%%%%% DISCLAIMER %%%%%%%%%%%%%%%%%%%%%%%%%%%%%

   THE USER OF THE PROGRAM BY USING IT AGREES NOT TO HOLD BMT MICRO, INC.
   NOR ITS OWNERS NOR ITS EMPLOYEES LIABLE FOR ANY DAMAGE THAT MAY
   HAVE BEEN CAUSED BY EITHER THE PROPER OR IMPROPER FUNCTIONING OR
   BY THE USE OR MISUSE OF THE LOOK2 SYSTEM.

   %%%%%%%%%%%%%%%%%%%%%%%% END OF DISCLAIMER %%%%%%%%%%%%%%%%%%%%%%%%


   That being said, if you decide to become a registered user of LOOK2,
   PLEASE let us know of any bugs you encounter in LOOK2.  We may be
   contacted by mail or email at the addresses on the right below.  If
   there is a feature that you would like to see changed or added,
   please don't hesitate to let us know.  We cannot promise we will be
   able to implement your ideas, but we will do our best.

   Address registrations amd comments to:

   BMT Micro, Inc.                  800-414-4268 / 910-792-9100 Voice
   PO Box 15016                     800-346-1672 / 910-350-2937 FAX
   Wilmington, NC 28408
   USA

   Compuserve: 74031,307
   AOL: bmtmicro
   email: bmt@bmtmicro.com
   http://www.bmtmicro.com





                          TABLE OF CONTENTS



   1.  WHAT'S NEW IN V. 3.3, 3.2, 3.1, 3.0d, 3.0c, 3.0b, 3.0, 2.1

   2.  HOW TO REGISTER FOR LOOK2   - - - - - - - - - - - -  5

   3.  INTRODUCTION  - - - - - - - - - - - - - - - - - - -  6
       What is LOOK2?    - - - - - - - - - - - - - - - - -  6
       LOOK2 Philosophy  - - - - - - - - - - - - - - - - -  7


   4.  RUNNING LOOK2   - - - - - - - - - - - - - - - - - -  8
       Starting LOOK2    - - - - - - - - - - - - - - - - -  8
       Filespec Variations   - - - - - - - - - - - - - - -  8
       Directing LOOK2 with the Keyboard and Mouse - - - -  8
       Setting LOOK2 Options   - - - - - - - - - - - - - -  9
       The LOOK2FLAGS Environment Variable  - - - - - - -   9
       LOOK2 Options  - - - - - - - - - - - - - - - - - -  10


   5.  THE DIRECTORY SCREEN  - - - - - - - - - - - - - - - 14
       Directory Screen Option Commands  - - - - - - - - - 14
       Directory Screen Action Commands  - - - - - - - - - 15
       Directory Mouse Actions - - - - - - - - - - - - - - 17
       Directory Screen Locate Entry Mode  - - - - - - - - 18
       Directory Screen Usage Notes  - - - - - - - - - - - 18


   6.  THE FILE SCREEN   - - - - - - - - - - - - - - - - - 20
       File Screen Option Commands   - - - - - - - - - - - 20
       File Screen Action Commands   - - - - - - - - - - - 21
       File Screen Usage Notes   - - - - - - - - - - - - - 22


   7.  OTHER LOOK2 NOTES   - - - - - - - - - - - - - - - - 23


      WHAT'S NEW FOR VERSION 3.3

      o ALT-J (Go To Line) will work with unlimited line numbers
        regardless of file size.

      o Goto will now allow a user to specify how many additional
        lines to Go forward or backward in a file in addition to
        going to a specified line number.  In prior versions Goto
        would Go to a certain line number only.  Now you can Goto
        to a line number (as always) or specify +nnn lines
        forward or -nnn back.

      o Price for single copies changed to $20.00

      WHAT'S NEW FOR VERSION 3.2

      o The #1 request has been addressed:  LOOK2 now holds
        the sub-directory marker so that when you back out
        of a sub-directory you are no longer taken back to
        the top of the directory listing.

      o Changed pricing for multi-copy and site license pricing.

      o Created a special SYSOP price


      WHAT'S NEW FOR VERSION 3.1

      o Changed default color scheme

      o Changed directory/filename sort to case insensitive

      o Added icon


      WHAT'S NEW FOR VERSION 3.0d

      o Changed registration method, updated order forms.

      o Removed program expiration date.  LOOK2 no longer
        dies on a particular date.

      o Many thanks to Gary Bourque for saving and forwarding
        user suggestions and feedback.  We will begin planning
        regular updates to LOOK2

      WHAT'S NEW FOR VERSION 3.0c

      o LOOK2 is now the property of BMT Micro, Inc. 3.0c was
        never released to the public.
      
      WHAT'S NEW FOR VERSION 3.0b

      o Fix bug related to buffer size being too small to read
        some network drives.

      o Extend expiration date.


      WHAT'S NEW FOR VERSION 3.0

      o Fix related to sort keys input from the command line or
        LOOK2FLAGS environment variable losing their case sensitivity.

      o Fix page down in directory screen causing subsequent crash
        upon entry selection due to inaccurate calculation of current
        entry number.

      o Fix so that double-click on up/down arrows in file screen in
        OS/2 Window works.

      o Fix so trying to access a read-protected file doesn't cause
        LOOK2 to exit.

      o Fix so mouse pointer shadow doesn't remain upon exit in an
        OS/2 fullscreen.  (I know.  Trivial.  But, I was on a
        mission folks.)

      o Capability to quickly locate and go to directory screen
        entries via a search string.  See the section on "directory
        screen locate entry mode" for more details.

      o Capability to change ("touch") the date and time stamp of files.

      o Information on drive space, free space, and directory and file
        space used is now listed on screen footers.

      o Headers and footers enlarged to two lines each to allow for
        more commands and information.

      o Now compatible with sessions with video column sizes greater
        than 80 characters.  This does not change the potential number
        of directory screen columns, however it will expand the size
        of the viewable area of file screens.  Most importantly, LOOK2
        will be usable in these expanded column modes.

      o Video mode option and command now accept column count as well
        as row count.  WARNING: I have encountered an OS/2 3.0 bug in
        BVHVGA.DLL when switching modes in a full-screen to 50 lines.

      o The Space bar at a directory screen now toggles entry mark status.
        Alt-Space toggles all entries mark status.  Using the Space bar
        to mark/unmark will also cause the light bar to move to the next
        entry.  Insert and Delete will function as before, however.

      o The Slash key '/' now starts a case-sensitive search.
        The Backslash key '\' starts a case-insensitive search.

      o The Enter key will now function the same as the Escape key when
        in a file screen.  That is, you can use the Enter key to exit a
        file.

      o alt-1, alt-2, etc. now work like 1, 2, etc. to change the column
        count so it can be changed while in locate mode.

      o Default support for UNIX-like tar archives has been added.
        See the section on archive viewing for details.

      o Archive list files will now be stored in the directory designated
        by the TMP environment variable instead of the current directory.
        This was done to allow viewing archive files which are on unwritable
        media such as CD-ROM.  If TMP is not set, the current directory
        will be used.

      o The archive list file created by LOOK2 will now have a filename
        portion of its filespec which is the same as the archive
        file from which it was produced.  For example, if the archive
        is named FOO.ZIP the list file will be named FOO.LST.  The
        filename will be truncated to eight characters if the TMP
        directory is on a FAT file system to make sure the name fits.


                                 - 1 -


      o In file mode, the case sensitivlity toggle command has
        been changed from alt-S to alt-C.  The screen option switch
        is now C/c instead of S/s.

      o Cosmetic changes and other things which I probably have
        forgotten I did.

      o Tested on OS/2 Warp 3.0.

      o Improved registration process.

      o I now can be reached on the Internet at gbourque@ix.netcom.com.


      Many of the above ideas came from LOOK2 users.  Perhaps you
      recognize one which you suggested.  Thanks to everyone for your
      support, comments and suggestions!  You have helped make LOOK2
      a better program.


                                 - 2 -



      WHAT'S NEW FOR VERSION 2.1

         Version 2.1 contains bug fixes related to OS/2 2.1.

         A. Full-screen session freezes upon program exit.

         B. Speed up directory screen light bar in window session.

         C. alt-R command added to re-read directory,
            refresh directory screen;



      WHAT'S NEW FOR VERSION 2.0

         PLEASE NOTE THAT SOME OPTIONS AND COMMANDS HAVE CHANGED.
         Please review the documentation and help screens if you
         have problems.  If you are using OS/2 2.0 THIS VERSION REQUIRES
         the IBM OS/2 2.0 fixes in OS/2 2.0 Standard Edition Service Pack
         XR06055 or the mouse and synchronous child session execution will
         not work correctly.  SP XR06055 is available from your IBM
         representative and some BBSes.

     A.  LOOK2 v2.0 is now a 32-bit OS/2 2.x program.  As such LOOK2 is a
         faster, cleaner, more elegant program than before.  It is also
         larger.  This due not only to added functionality, but to the
         fact that 32-bit programs are, as a rule, 25%-30% larger that
         the same program compiled as 16-bit.  Please note that
         LOOK2 v2.0 will not run on OS/2 1.x.

     B.  LOOK2 is now HPFS/IFS compatible.  The program supports two
         IFS directory screen modes.  One will display one directory entry
         per line, allowing for long file names.   This is the default.
         The other screen is identical to the FAT system screen, except
         that long filenames will be compressed.  Filenames will be
         compressed as in the following example:

              A.long.HPFS.file.name
           will appear as
              A.long.H nam

         The entry will still be fully accessible.  Use alt-F to toggle
         between display modes.  Use the /F option to set your preference.

     C.  LOOK2 now supports archive content listing capability with six
         default types of archive files (ARC, ARJ, LZH, RAM, ZIP and ZOO).
         You can change the default definitions or add new ones using the
         /C option.  You must have the archive programs in your PATH to
         use this feature.


                                 - 3 -



         LOOK2 will display the archive listing as a file called
         <filename>.LST in the TMP directory, where <filename> is the
         filename portion of the archive list file filespec.  The
         filename will be truncated to eight characters if the TMP
         directory is on a FAT file system.  Whether to delete, keep or
         "prompt for the fate of" the list file is controlled by the /A
         option or alt-A command.

     D.  LOOK2 now supports changing the basic attributes of directory
         entries.  The T command controls this function and works with
         marked entries.  View the directory entries in one column mode
         to see their attribute settings.

     E.  LOOK2 now supports almost as many video lines modes as OS/2
         under SVGA.  3-109 in windowed mode and 12,14,21,23-30,
         33-34,39-43,45-50,54-60 in fullscreen mode are all valid.
         If you want a good laugh, run LOOK2 after entering MODE 80,3
         in a OS/2 window, or MODE 80,12 in a OS/2 fullscreen.

     F.  You can now execute DOS .COM, .EXE, and .BAT programs from LOOK2.
         (.EXE programs now do not have to have an .EXE extension)
         You can designate a DOS text editor as your default LOOK2 editor.

     G.  Ascending and descending sort keys are now supported.  Enter a sort
         key in lowercase for ascending; uppercase for descending.

     H.  Page scrolling in the directory menu with a mouse is now possible
         by left-clicking or left-click-holding the arrows in the upper
         and lower right corners of the screen.

     I.  Printing has always been possible in LOOK2.  It just wasn't
         documented.  Just bring up the Copy prompt and copy the entry
         to LPT1 or whatever LPT port you use.
         Try not to print binary files.

     J.  The alt-O command shells to an OS/2 prompt from the file or
         the directory screen.  Uses the shell program specified in
         the OS2_SHELL environment variable in CONFIG.SYS.

     K.  Mouse clicks on [] prompts will perform that response.

     L.  New /M option to set mouse-per-second (mousematic) rate.

     M.  The alt-C command (directory case) has been dropped.
         The /C option now has a new function.

     N.  Various bug fixes, beautification and cleanup have be performed.


                                 - 4 -



   2.  HOW TO REGISTER FOR LOOK2.

   LOOK2 IS SHAREWARE.  As such, you are expected, if you continue to
   use it after an initial trial period, to register and pay for the use
   of it.  What is the length of the trial period?  Well, I leave that
   partially up to you and partially up to me.  Those of us who have
   used shareware pretty much know when we are done trialing a product
   and have added it to our set of tools.  When you reach that point
   with LOOK2, please register.

   Registration is easy!  You will be registered for life and
   you will help all my hard work pay off.  Here's what to do:

      1.  Read the included registration form and choose a mode
          of registration (voice, mail, fax, email, etc) and a mode
          of payment (check, credit card, etc).

      2.  In as short a time as possible, you will receive correspondence
          containing a registration number for each name registered
          along with instructions on how to invoke LOOK2's registration
          process.

      3.  When you receive the number, start up LOOK2 for registration
          and enter your name and number to it.  Now you are registered.

      5.  As a registered user you will be notified of any new
          versions of LOOK2 and how to download them from a local or
          national bulletin board.

   Corporate multi-user accounts are available, please write for prices.

                                 - 5 -



   3.  INTRODUCTION.


   WHAT IS LOOK2?

   LOOK2 is a 32-bit text-based OS/2 directory/file viewing and
   manipulation program.  I decided to write LOOK2 because I felt
   there were no adequate directory/file tools for OS/2 at that time.
   LOOK2 provides some of the same features of other popular file
   viewers and adds some of its own that none of the others provide.


   Just some of LOOK2's features are:

   o  Directory history.

   o  Mouse support.

   o  Multiple video modes.

   o  Full HPFS/IFS directory support.

   o  Multiple ascending/descending sort key directory sorting
      capability with automatic sorting.

   o  File viewing in hexadecimal mode.

   o  Toggling between hex and text mode maintaining file position.

   o  Direct go to line or offset capability.

   o  Text editor invocation.

   o  OS/2 and DOS synchronous or asynchronous program execution.

   o  Ability to mark and copy, move, delete or change the attributes of
      groups of files and subdirectories at once.

   o  Deletion of empty or non-empty directories.

   o  And more!


                                 - 6 -



   LOOK2 PHILOSOPHY

     One of the main features I wanted to include in LOOK2 was the
   ability to "travel" around among files, directories and drives and
   still be able to easily get back where I started.  With this in mind,
   I built in a directory history feature that, when enabled, remembers
   each directory you have viewed.  Pressing the ESCAPE key from a
   directory screen takes you back to the directory you were in before
   the current one, if one exists.

     That being the case, ESCAPE will never cause LOOK2 to terminate.
   ESCAPE is the backout key in LOOK2.  If you're like me, you find it
   annoying when ESCAPE is used prominently to move around in a program
   and also causes the program to terminate, because you often exit the
   program unintentionally.  So, F10 is the only keystroke that will
   cause LOOK2 to terminate.


                                 - 7 -



   4. RUNNING LOOK2.

   STARTING LOOK2

      LOOK2 is invoked from an OS/2 command prompt by typing

        LOOK2 [options] [drive:][path][file]


   FILESPEC VARIATIONS

   If the drive\dir\file (filespec) data is the name of a file, the
   file will be displayed for viewing.  If it is a directory, the
   directory will displayed.  If it contains valid wildcards, any files
   matching the wildcard will be queued for display and the first
   matching file will be displayed.  If no filespec is entered, the
   current directory will be displayed.

   If the file or directory cannot be found, LOOK2 displays a message and
   displays the current directory.  If the wildcard had no matches,
   LOOK2 displays a message and then goes to the directory screen either
   of the current directory or the directory (if found) included in the
   wildcard spec.  Please note that the wildcard portion of the filespec
   is for files, not paths.  So, while the following spec is valid...

      LOOK2 F:\LOOK2\L*.?


   This next one is invalid...

      LOOK2 F:\LO**\LOOK2.EXE



   DIRECTING LOOK2 WITH THE KEYBOARD OR THE MOUSE

   LOOK2 may be controlled either by a variety of keystrokes or mouse
   actions.  To enter a command either press the upper-cased letter of a
   command listed in the top row of a directory or file screen or click
   it with the left mouse button.

   To change an option setting either press ALT and the letter of the
   option or click the option (right of 'Opts:' on the top row) with the
   left mouse button.  When an option is enabled, it will be uppercase;
   when disabled, lowercase.  Note, that while directory column count is
   one of the options that can be clicked with the mouse, the
   corresponding keyboard command does not require the ALT key to be
   pressed, but it may be.

   ESCAPE is the backout key in LOOK2.  The right mouse button is
   equivalent to ESCAPE.

   In directory viewing mode, the mouse may be used on the arrows in
   the upper and lower right corners of the screen to page scroll.


                                 - 8 -



   In file viewing mode, the mouse may be used on the right scroll bar
   to scroll through the file.  Also, the cursor may be placed on a text
   item by clicking the left mouse button.   This is useful when using
   Microsoft QuickHelp as a monitor under OS/2 since QuickHelp searches
   for the subject at the cursor location when alt-Q is pressed.


   SETTING LOOK2 OPTIONS

   Any number of LOOK2 options may be included before the filespec. A LOOK2
   option has the following format.

      /o[data]

   Where o is an option letter or number and data is some required or
   optional data for the option.  If the option is of the on/off
   variety, the '+' or '-' sign may be included to override settings in
   the LOOK2FLAGS environment variable, where '+' is on and '-' is off.
   If the '+' or '-' are omitted, '+' is the default.  The options do
   not have to be separated by spaces and may be upper or lower case.
   Do not use a '-' in lieu of the '/'.  For example to turn off any
   sounds LOOK2 may produce enter:

      LOOK2 /B-

   Many LOOK2 options correspond to LOOK2 commands to the directory screen
   or file screen or both.



   THE LOOK2FLAGS ENVIRONMENT VARIABLE

   Any option may be included in the LOOK2FLAGS environment variable.
   When placed there, they will effect any execution of LOOK2.  Note that
   command line options always override the environment variable.  The
   LOOK2FLAGS environment variable may be set in CONFIG.SYS or in any
   .CMD file you run to initialize command prompt sessions.  Do not
   placed filespecs to be viewed in LOOK2FLAGS, only options are
   allowed.  For example to turn off sound, place the following in
   CONFIG.SYS or a .CMD file.

      SET LOOK2FLAGS=/B-


                                 - 9 -



   LOOK2 OPTIONS

     /1bf       Sets border colors where b is the background color and
                f is the foreground color.

                Valid colors are:
                Color        Value    Color           Value

                Black        0        Dark Grey       8
                Blue         1        Light Blue      9
                Green        2        Light Green     A
                Cyan         3        Light Cyan      B
                Red          4        Light Red       C
                Magenta      5        Light Magenta   D
                Brown        6        Light Yellow    E
                Light Grey   7        White           F

                Please note that colors 8-F used for background colors
                will cause the foreground to blink in a full-screen session.

     /2bf       Sets text colors where b is the background color and
                f is the foreground color.

     /3bf       Sets marked text colors where b is the background color and
                f is the foreground color.

     /A[D|K|P]  Dispatch action on listing file produced from an archive
                (e.g. .ZIP) file.  D = delete, K = keep, P = prompt.
                Default is 'D'.  Corresponding command is alt-A.

     /B[+-]     Turns beep mode on or off.  Defaults are on and '+'.
                Corresponding command is alt-B.

     /Cext~pgm~opt1~[optn~]
                Defines an archive file listing program where ext is the
                archive file extension, pgm is the archive program and
                opt(s) are the options (commands) to be passed to the
                archive program.  The code for examining an archive is
                not contained in LOOK2.  What LOOK2 does is try to execute
                a child program passing it appropriate parameters to
                produce the listing file.  You must have the archive
                programs in your PATH.

                WARNING!  DO NOT DEFINE AN ARCHIVE PROGRAM IN SUCH A WAY
                AS TO CAUSE THE PROGRAM TO PROMPT FOR KEYBOARD INPUT
                DURING EXECUTION.  DOING SO WILL CAUSE THE LOOK2 SESSION
                TO LOCK UP.

                                 - 10 -



                LOOK2 has seven default archive program definitions as
                follows:

                   Archive type    Program name    Options
                   ------------    ------------    -------
                       ARC         ARC2.EXE        v
                       ARJ         ARJ2.EXE        l
                       LZH         LHA2.EXE        l /v /o
                       RAM         LOADRAM2.EXE    /G /Q
                       TAR         TAR.EXE         -tvf
                       ZIP         PKUNZIP2.EXE    -vn
                       ZOO         ZOO2.EXE        l

                As an example, the LZH definition in the /C option would be:

                  /CLZH~LHA2.EXE~l~/v~/o~

                Then, when you execute the Arc command on the LZH directory
                entry FOO.LZH, the following command would be excuted:

                  LHA2 l /v /o FOO.LZH

                OS/2 versions of the archive programs must be used.
                These programs are available at little or no fee from BBS'es
                everywhere.  If you have these utilities with different names
                you may rename them or override the default definition using
                /C.

                See the /A option, Arc command and the alt-A command.


     /Dn        Sets number of columns in the directory screen where n is
                1 - 5.  The fewer the number of columns the more information
                LOOK2 can display.  Corresponding commands are 1, 2, 3, 4, 5
                or alt-1 - alt-5.


     /Efile~ops~...
                Filespec of text editor program to be invoked when the
                E command is executed and the operands to be passed to it.
                THIS CAN BE A DOS PROGRAM.

                Where:
                file  -   Text editor filespec, may be file name only or
                          drive\dir\file.  Include the file extension.
                          If name only must be in PATH=.  Default is EPM.EXE
                ops   -   Any operands (options) to be passed to the editor.
                          Must be separated by '~'.

                See the /X option.

     /F[+-]     IFS (HPFS) directory screen mode.  '-' Fully expands long
                filenames (as much as will fit on one line).  '+' compresses
                long filenames in a screen that looks like the typical
                LOOK2 screen for FAT file systems.  Default is '-'.
                Corresponding command is alt-F.

     /I[+-]     Turns directory history tracking on or off.  Default is on.
                Corresponding command is alt-I.

                                 - 11 -



     /K[k|K][f|F][e|E][s|S][d|D][t|T][a|A]
                Directory menu sort keys where possible settings are any
                combination and sequence of:

                k or K  -  Kind (directory or file)
                f or F  -  File name
                e or E  -  File extension
                s or S  -  File size
                d or D  -  File last write date
                t or T  -  File last write time
                a or A  -  File attributes

                Lowercase sort key causes ascending sort.
                Uppercase sort key causes descending sort.
                Default is kfe.

     /L[+-]     Causes (in directory screen) scroll down from bottom or
                scroll up from top to "loop" back to the other end.  When
                off, LOOK2 beeps when a scroll passed top or bottom of list
                is attempted.  Default is off.
                Corresponding command is alt-L.

     /Mn        Set mouse-per-second (mousematic) rate.  Valid values are
                1 - 1000.  Default is 20.

     /Pn        Number of seconds LOOK2 displays a message before the message
                is cleared.  Valid values are 0 - 9.  Zero (0) means the
                message will not be cleared until a keyboard or mouse action
                occurs.  Default is 3.

     /S[+-]     Sets text search case sensitivity.  Default is off.
                Corresponding command is alt-S.


     /Tn        Set the width of a tab character and a horizontal scroll.
                Valid values are 0-8.  Default is 8.  The alt-T command
                toggles text display tab expansion on and off.

     /V[col,]row
                Set video display mode column and line count.  Valid values
                are many.  On a SVGA monitor, 3-109 in windowed mode and
                12,14,21, 23-30,33-34,39-43,45-50,54-60 in fullscreen mode
                are all valid.  On an XGA monitor 133 columns is valid.
                Larger than 80 columns are also valid in window command
                session.  Default is setting of session when LOOK2 is
                started.  Corresponding command is alt-V.

     /W[+-]     Turn on or off long line wrapping in text file viewing mode.
                Default is off.  Corresponding command is alt-W.

     /Xn        Set default screen type of program executed with the
                X command or the E command.  Valid settings are:

                                 - 12 -



                0  -  Get definition from the program.
                1  -  Full-screen.
                2  -  Windowed.
                8  -  Whatever LOOK2 is currently running under.

                Default is 0.  Note that this option is really useful
                to set how to execute window-compatible or DOS programs.
                Obviously, PM programs will always execute as PM
                programs, and non-window-compatible text-based OS/2
                programs will always executed in a fullscreen.
                But, window-compatible text-based OS/2 programs and
                DOS programs will be influenced by this option.

     /Yn        Number of seconds LOOK2 remains in directory entry locate
                mode after the latest keystroke.  Valid values are 0 - 9.
                Zero (0) means the the user must actively exit this mode.
                Default is 5.

     /Z[+-]     Turn on or off directory entry locate mode case sensitivity.
                Default is off.  Corresponding command is alt-C.


                                 - 13 -



   5.  THE DIRECTORY SCREEN.

   The LOOK2 directory screen presents a list of the entries in the
   current directory plus all the drives on your computer.  The first
   entry will be highlighted.  By using the direction keys or
   single-clicking the mouse, you may highlight any entry.  By pressing
   ENTER or double-clicking the mouse on an entry, the entry will be
   opened.  That is, either the file will be displayed or the directory
   or drive will be entered and displayed.  Some directory screen
   commands operate on the currently highlighted entry.

   Directories are identified by an up-arrow or down-arrow prefix.
   Up-arrow indicates the parent directory and will prefix only '..'.
   Down-arrow indicates a subdirectory.  Drives are identified by a ':'
   in the second position and always appear last in the display.


   DIRECTORY SCREEN OPTION COMMANDS

   The settings of the directory screen options are displayed on the
   right side of the top line of the display next to the 'Opts:'
   heading.  Letter settings in uppercase indicate the option is on;
   lowercase indicates the option is off.  The settings 1, 2, 3, 4, 5
   in column 73 indicate the number of directory columns.


   The setting may be toggled by single-clicking the option setting with
   the left mouse button or by the following keyboard actions.

   1 - 5  -  Changes directory menu to the specified number of columns
             The fewer the columns, the more information per entry is
             displayed.  Alt-1 - alt-5 works the same.

             In the one column display the information displayed is:
             Filename  Extension  Size  Date  Time  Attributes

             One column of information above is removed from the right (left
             in IFS mode) for each one column increase in the display.
             Corresponding command line option /D.

   alt-A  -  Toggle archive list file dispatch action.  Corresponding
             command line option /A.  See also the /C option.

   alt-B  -  Toggle beep on or off.  Corresponding command line option /B.

   alt-C  -  Toggle directory entry locate mode case sensitiviyy.
             Corresponding command line option /Z.

   alt-F  -  Toggle directory screen display type for non-FAT systems.
             Corresponding command line option /F.


                                 - 14 -



   alt-I  -  Toggle directory history on or off.  When on, user will be
             able to return to previously visited directories by pressing
             ESCAPE or the right mouse button.  Corresponding command line
             option /I.

   alt-L  -  Toggle directory scroll looping on or off.  When on, scrolls up
             from top or down from bottom will "loop" to the other end.
             Corresponding command line option /L.

   alt-O  -  Shells to a OS/2 command prompt.  Uses the shell program
             specified in the OS2_SHELL environment variable in CONFIG.SYS.
             Enter 'exit' to return to LOOK2.

   alt-V  -  Prompts for video lines mode.  Corresponding command line
             option /V.



   DIRECTORY SCREEN ACTION COMMANDS

   For commands in upper and lower case, the upper case letter is the command
   hot key.

   HOME, END, UP, DOWN, LEFT, RIGHT, PAGE-UP, PAGE-DOWN
               -  Move light bar to highlight an entry name.

   ENTER       -  Go to a new drive or directory or open a file for viewing.

   INSERT      -  Marks the current entry for group copy, move or delete.
                  Parent directories and drives cannot be marked.  When
                  a entry is marked, a flashing check mark will appear
                  between the filename and its extension.

   DELETE      -  Unmarks the current entry.

   alt-INSERT  -  Marks all entries.

   alt-DELETE  -  Unmarks all entries.

   SPACE       -  Toggles the mark status of the current entry and moves
                  light bar to the next entry.

   alt-SPACE   -  Toggles the mark status of the all entries.


                                 - 15 -



   Arc         -  Prompts whether to create a listing file of the current
                  entry.  You may change the current archive programs
                  options at this point. If LOOK2 cannot determine the
                  archive's type from its extension, it will prompt you
                  for it.  See /A option, the /C option and the alt-A
                  command.

   aTtr        -  Prompts for new basic attributes of the current entry
                  or marked entries.  Enter any of the following:

                     A or a  --  Archive
                     H or h  --  Hidden
                     S or s  --  System
                     R or r  --  Read-only

                  Uppercase turns the attribute on; lowercase turns it off.

   Copy        -  Prompts the user for a location (directory or file)
                  and copies the current entry or the marked entries to
                  the location the user specifies.

   Delete      -  Prompts the user for verification and deletes
                  current entry or the marked entries.


   Edit        -  Invokes the editor specified in the /E option (or
                  EPM.EXE if /E not entered) to edit the current entry.
                  Directories and drives cannot be edited.  See the /E and
                  /X options.

   eXec        -  Prompts for arguments to the OS/2 or DOS program entry
                  and whether or not the program should be executed
                  asynchronously then the executes the current entry
                  if it has a .EXE, .COM, .CMD or .BAT extension.
                  (.EXE programs do not have to have an .EXE extension.)
                  If the program is executed  synchronously, the program
                  must terminate before control will return to LOOK2.  If
                  executed asynchronously, the program executes completely
                  separate of and continues to execute even after LOOK2
                  terminates.  See the /X option.

   mKdir       -  Prompts for a new directory name and creates it.

   sPec        -  Prompts for a new filespec (directory, file or wildcard)
                  and displays it.

   Move        -  Prompts for a location (directory or file) and
                  moves the current entry or the marked entries to
                  the location the user specifies.

   tOuch       -  Prompts for a new date-time stamp for the current
                  current entry or the marked entries.  Defaults to
                  present date and time.

   Rename      -  Prompts for a new name and renames the current entry
                  to that name.


                                 - 16 -



   Sort        -  Prompts the user for sort keys and sorts the current
                  directory display accordingly.  Multiple sort keys are
                  allowed.  Drive letters are not included in the sort.
                  Possible values are any combination and sequence of:

                     k or K  --  Kind (directory or file)
                     f or F  --  File name
                     e or E  --  File extension
                     s or S  --  File size
                     d or D  --  File last write date
                     t or T  --  File last write time
                     a or A  --  File attributes

                  Lowercase sort key causes ascending sort.  Uppercase
                  sort key causes descending sort.  The default is kfe.
                  Once sort keys are entered, they are active for any new
                  directory LOOK2 displays until they are changed or
                  cleared.  If you request a sort but enter no keys
                  (i.e just press enter), the current sort keys are
                  cleared and no sorting is performed until new sort
                  keys are entered.

   ESCAPE      -  Go to previous directory in history or exit directory
                  screen locate mode.

   F1          -  Display help screens.

   F2          -  Enter/exit directory screen locate mode.

   F10         -  Terminate LOOK2.



   DIRECTORY MOUSE ACTIONS

   Left click commands to execute.

   Left click options to toggle.

   Left click a directory entry to highlight it.

   Left double-click a directory entry to open a file or enter a
   directory or drive.

   Left-click or left-click-hold arrows in upper and lower right
   corners to page scroll.

   Left-click on [] prompts (e.g. [Y]/[n]) will execute that response.

   Right click is the same as ESCAPE.


                                 - 17 -



   DIRECTORY SCREEN LOCATE ENTRY MODE

   Pressing F2 or clicking the 's' Opts: will place LOOK2 into locate mode.
   Pressing F2 again or clicking the 'S' Opts: will take LOOK2 out of locate
   mode.

   If the locate mode duration is not set to zero with the /Y option then
   LOOK2 will automatically exit locate mode after the number of seconds
   specified in /Y have passed after the last keystroke or mouse event
   has occured.  The default timeout is five seconds.

   Once in locate mode the 'S' Opts: become uppercase, the command list will
   change and the search string delimiters "><" will appear on the second
   header line.

   Characters entered while in locate mode will set up a search string
   which will be used to locate entry names.  The search string will
   appear between the "><" delimiters.  LOOK2 will highlight the
   nearest forward entry including the current one that best matches
   the string.  As the string gets longer the search either will get
   more precise and the entry you are looking for will be isolated; or
   the search will become invalid, in which case the last invalid character
   is remove from the string.  The search will wrap around to the top of
   the screen if need be.

   Only common printable characters will be passed to the search string.
   Backspace or Delete may be used to shorten the string.  ESC clears
   the string.  Movement keys, some option changes, and column count changes
   will still function while in locate mode.  (Use alt-1, alt-2 for column
   count changes in locate mode.)  F3 will re-search for the current string.
   Pressing Enter will exit locate mode and open the current entry.  Upon
   exiting locate mode the search string is cleared.

   Case sensitivity is controlled by the /Z option and the alt-C command.

   Locate mode will operate with any directory screen sort criteria, but
   obviously the best results will be achieved when the entries are sorted
   by filename and extension.

   See also the /Y and /Z options.



   DIRECTORY SCREEN USAGE NOTES


   To print, Copy the entry to LPT1 or whatever LPT port you use.

   If a subdirectory is the object of a copy command, then the target
   name entered will be an existing or new directory.

   Only the Attribute, Copy, Move and Delete commands can be operated
   upon marked entries.  Other commands can be executed upon the current
   entry while entries are marked.  But, be aware: Some commands force a
   re-read of the directory which clears all marks.

   Group copies to a file target do NOT concatenate, so there is no
   reason to do this.

   Moves across drives are not allowed.  Use the Copy, then the Delete
   commands.


                                 - 18 -



   If a file has the read-only attribute set, LOOK2 will notify the user
   upon a delete request, but will carry out the deletion if the user
   desires.

   If you try to delete a non-empty directory, LOOK2 will warn you that you
   are about to do so.  You may then abort or proceed with the deletion.

   Pressing ESCAPE or clicking the right mouse button will clear a dialog
   box and abort the corresponding function.

   Pressing ESCAPE or clicking the right mouse button will cause LOOK2 to
   go to the previously displayed directory.


                                 - 19 -



   6.  THE FILE SCREEN.

   The LOOK2 file screen presents a single file to be viewed.  The
   direction keys or mouse actions on the scroll bar on the right may be
   used to scroll through the file.  The file may be displayed in either
   text or hex mode.  Lines may be wrapped if desired.


   FILE SCREEN OPTION COMMANDS

   The settings of the files screen options are displayed on the right
   side of the top line of the display next to the 'Opts:' heading.
   Letter settings in uppercase indicate the option is on; lowercase
   indicates the option is off.

   A setting may be toggled by single-clicking the option setting with
   the left mouse button or by the following keyboard actions.

   alt-B  -  Toggle beep on or off.  Corresponding command line option /B.

   alt-H  -  Toggle hex display on or off.

   alt-O  -  Shells to a OS/2 command prompt.  Uses the shell program
             specified in the OS2_SHELL environment variable in CONFIG.SYS.
             Enter 'exit' to return to LOOK2.

   alt-S  -  Toggle case sensitivity of text searches.
             Corresponding command line option /S.

   alt-T  -  Toggle expansion of tabs on or off.  The tab width is
             set by the /T option.  Default is 8.

   alt-W  -  Toggle line wrap on or off.  Corresponding command line
             option /W.

   alt-V  -  Prompts for video lines mode.  Corresponding command line
             option /V.


                                 - 20 -



   FILE SCREEN ACTION COMMANDS

   For commands in upper and lower case, the upper case letter is the command
   hot key.

   HOME, END, UP, DOWN, LEFT, RIGHT, PAGE-UP, PAGE-DOWN
               -  Scroll through file.

   alt-LEFT    -  Go to column one.

   Goto        -  Prompts for a line number in text mode or a hex or
                  decimal offset in hex mode and goes to it or moves
                  +nnn or -nnn lines from the current line number.

   sPec        -  Prompts for a new filespec (directory, file or wildcard)
                  and displays it.

   Quit        -  Go to next file in wildcard match list if wildcard
                  was input.  Goes to directory screen if at end of
                  end of wildcard list or no wildcard was input.

   \           -  Prompts for a string and then searches forward for it
                  case-insensitively starting at the current position.

   /           -  Prompts for a string and then searches forward for it
                  case-sensitively starting at the current position.

   ESCAPE      -  Exit file.

   ENTER       -  Exit file.

   F1          -  Display help screens.

   F2          -  Prompts for a string and then searches forward for it
                  starting at the current position.  Use alt-S to turn
                  case sensitivity on or off.  See the '\' and '/' commands.

   F3          -  Searches again for the last input string.  Case sensitivity
                  may be toggled in between searches.

   F10         -  Terminate LOOK2.


                                 - 21 -



   FILE MOUSE ACTIONS

   Left click commands to execute.

   Left click options to toggle.

   Double left click scroll bar arrows to go to the top or bottom of
   the file.

   Left click or left click and hold on arrows to scroll up or down a
   line at a time.

   Left click or left click and hold on scroll bar body above or below
   elevator to scroll up or down a page at a time.

   Left click on text to place cursor.  This is useful when running
   QuickHelp as a monitor since QuickHelp will do an automatic search on
   the subject above the cursor when alt-Q is pressed.

   Right click is the same as ESCAPE.



   FILE SCREEN USAGE NOTES

   Files with certain extensions will be brought up initially in hex mode.
   The currently supported extensions are:

      .EXE
      .COM
      .DLL
      .OBJ
      .LIB
      .SYS (except CONFIG.SYS)
      .DRV
      .BIN
      .FNT
      .BMP
      .GIF
      .ARC
      .ARJ
      .LZH
      .RAM
      .ZIP
      .ZOO
      .INI
      .IFS

   When wrap mode is on, scroll actions still move by the text line.  So,
   if a line is wrapped once, scrolling passed it will cause the LOOK2 to
   scroll two screen lines.

   Toggling between text and hex modes will keep the current file
   position.  When you toggle from hex to text mode after scrolling in
   hex mode LOOK2 must search for the current position from the top or
   bottom of the file in order to determine the line number.  So, there
   may be a slight delay when viewing large files.

   Searches done from hex mode will place the display in text mode.

   Text marks set on file searches are cleared when a message is cleared.


                                 - 22 -



   Use the Goto command to move to a line number in text mode or a hex or
   decimal offset in hex mode.   You can also move forward or backward
   in a file based on your current line number by specifying the numbers
   of lines in this format: +nnn  (moves foward nnn number of lines from
   the current line number)  -nnn (moves backwards nnn number of lines
   from the current line number.)

   Pressing ESCAPE or clicking the right mouse button will clear a dialog
   box and abort the corresponding function.

   Pressing ESCAPE or clicking the right mouse button will cause LOOK2 to
   go to the current directory display.



   7. OTHER LOOK2 NOTES


   LOOK2 uses a separate thread to clear messages displayed upon the
   screen.  The /P command sets the number of seconds LOOK2 displays a
   message before clearing it.  Valid settings are 0 through 9.  Zero (0)
   turns off timed message clearing.  The default is three seconds.

   If a message is displayed, any keystroke or mouse action will clear
   it immediately.  The action will then be carried out.  The exception
   is ESCAPE (and right mouse button).  If these are input when a message
   is displayed, the message is cleared, but the ESCAPE action is not
   carried over to the parent screen.  So, ESCAPE can be used to clear a
   message at any time.  NOTE:  Some special messages cannot be cleared
   by a keystroke, but will clear themselves in a second or two.

                                 - 23 -
