OS/2 Professional/OS2PRO194.ISO/os2/wps/progs/lstpm/lstpm.hlp

OS/2 Help File | 1993-02-14 | 43KB | 854 lines

ΓòÉΓòÉΓòÉ 1. Oberon Software ΓòÉΓòÉΓòÉ

Oberon Software has been involved in the creation of OS/2 related products and
services since 1988.  Founded by Brady Flowers, Oberon Software (named for the
wood sprite in Shakespeare's "A Mid-Summer Night's Dream") is committed to
enhancing the software base for the ever growing community of OS/2 users and to
helping foster the growth and acceptance of OS/2 as the next generation in
operating systems for personal computers and workstations.

Oberon products are generally marketed as shareware to keep marketing overhead
to a minimum.  The savings can then be devoted to further development and
enhancements and customer service.  Please, support the shareware concept by
registering the shareware products which you use and by passing them along to
others for their inspection.

In addition to this program, Oberon Software offers the following products and
services:

o Oberon Terminal Emulator/2 (TE/2)
o Oberon FSHL Command Line Executive
o Consulting Services and Custom Programming

Several new products are planned for release in the near future. These will
include a programmer's Async Communications library/toolkit, enhancements to
all of our existing programs, and some new surprises.


ΓòÉΓòÉΓòÉ 1.1. Oberon Terminal Emulator/2 ΓòÉΓòÉΓòÉ

The Oberon Terminal Emulator/2, or TE/2, is Oberon Software's full featured,
easy to use, general purpose telecommunications program for OS/2. Developed
originally for OS/2 1.1, it was one the very first such programs written
specifically to take advantage of the power and capabilities of OS/2.  As OS/2
has grown, so has TE/2. It is now one of the most popular and widely
recommended telecommunications programs for OS/2!

TE/2's features include:

o One of the most complete script languages to be found in any telecomm program
  anywhere
o REXX/2 as a fully supported, optional script language
o Extensive facility for running external programs and protocols
o Multiple, 200 entry dialing directories
o Call logging
o Split screen chat mode
o 48 Assignable function keys
o Free technical support via the Oberon BBS!

TE/2 includes these file transfer protocols:

o XModem and XModem-1K
o YModem and YModem-G
o ZModem with automatic start-up and resume
o CompuServe(tm) B-Plus protocol
o Ascii file upload and capture

Supported terminal emulations include:

o Standard TTY (teletype) mode
o ANSI-BBS and enhanced ANSI
o VT100 (with VT102 and VT220 extensions)
o IBM 3101

Call, write, or FAX Oberon Software for more information on TE/2.


ΓòÉΓòÉΓòÉ 1.2. Oberon FSHL Command Line Executive ΓòÉΓòÉΓòÉ

FSHL, \ef' shel\ n. [Flowers' shell, named for Brady Flowers, software designer
during the late 20th century]: a program which greatly enhances the power a
user has when working at the OS/2 command prompt by adding aliases and macros,
enhanced and extended command line recall and editing functions, extended
command set, enhanced batch language, and provisions for user-created
extensions.

FSHL, Oberon Software's Alternative Command Line Executive for OS/2, layers
itself over the default OS/2 command line interpreter, CMD.EXE, to provide the
user with all of these extended services without sacrificing access to OS/2's
base level functionality!

These are just some of the features of FSHL:

o FSHL aliases allow the user to replace often typed, hard to type, or hard to
  remember commands with any other command of their preference.
o Full featured command line editor adds features to the OS/2 command prompt
  similar to those found in word processing programs.
o Recall previously typed commands:

   - One at a time
   - By matching a partially typed command
   - By selection from a list

o Extends the OS/2 batch language to allow access to FSHL's aliases and
  history.
o Dynamic pseudo environment variables to access system information such as the
  time and date, errorlevels, and window state.
o New built-in commands like:

   - Sweep to execute a given command over an entire directory tree.
   - Window to control the OS/2 text mode window in which FSHL is running from
     the command line or a batch file.
   - Prty to adjust the OS/2 priority at which a program will run.
   - And lots more!

o Extended options on existing OS/2 commands.
o All 48 function keys programmable as text macros.
o Two separate, powerful programming APIs allow third party developers to
  extend the basic FSHL command set and to allow applications to call back into
  FSHL to access its services.
o Free technical support via the Oberon BBS!


ΓòÉΓòÉΓòÉ 1.3. Consulting Services and Custom Programming ΓòÉΓòÉΓòÉ

Any of Oberon Software's products may be customized to meet your company's
specific needs.  Or, if you need something totally new, Oberon Software
specializes in the areas of:

o Asynch/Telecommunications Software
o Interprocess Communications

   - Network Environment
   - Standalone

o Presentation Manager Based Software
o OS/2 Programmer and User Training
o Migrating DOS applications to OS/2

Please, contact Oberon Software for references and further information.


ΓòÉΓòÉΓòÉ 2. Extended Help ΓòÉΓòÉΓòÉ

Welcome to Oberon Software's LST for OS/2 Presentation Manager!  LstPM can be
used for viewing just about any text or data file on your system, either as
text (ASCII or EBCDIC) or as a hexadecimal "dump" representation.  You can
invoke LstPM by installing a WPS program object for it on your desktop or in
the folder of your choice and clicking on its icon, from the OS/2 command line
with an optional file name as parameter, or by dragging and dropping a selected
file or files onto its icon.

For additional information, refer to the help for:

o Installing LstPM
o Starting LstPM

You may also be interested in information regarding:

o Registering LstPM
o Oberon Software Products
o Copyright, License, and Warranty


ΓòÉΓòÉΓòÉ 2.1. Installing LstPM ΓòÉΓòÉΓòÉ

There are three files which need to be installed on your harddisk for proper
operation of LstPM:

LSTPM.EXE           LstPM program executable file.  This should be placed in a
                    directory specified in your PATH if you wish to run LstPM
                    from the command line.
REGEXPUT.DLL        Regular Expression support library.  This must be placed in
                    a directory specified in your LIBPATH.
LSTPM.HLP           LstPM help file.  This must be placed in a directory
                    specified by your HELP environment variable in order to
                    have help active while running LstPM.

Once LstPM is installed on your hard disk, open the OS/2 Templates Folder,
select a Program Object Template with the left mouse button and then, using the
right mouse button, drag it onto the desktop or into the folder of your choice.
When the Settings Notebook appears, fill in the following:

o Path and file name should be set to the full path/name to LSTPM.EXE (i.e.,
  where you place the file in the step above).
o Parameters should be set to %*  This will allow you to invoke LstPM by
  dropping a file object on its program icon.
o Working directory may be left blank or set to any directory of your choice.

Click on the notebook tab labeled General and, on that page, set the Title to
LstPM or a title of your preferance.

If you wish, you may select the notebook tab labled Association and use that
page to associate file types with LstPM.  For instance, if you add the type
Plain Text to LstPM's associations, then LstPM will become an option for "Open"
on the context menu of any and all files which have this type.  You may also
use this page to specify file name extensions to associate with LstPM.  Click
on the "Help" button on this notebook page for further information on
associations.


ΓòÉΓòÉΓòÉ 2.2. Starting LstPM ΓòÉΓòÉΓòÉ

If you have created a program object, you may start LstPM by simply clicking on
its icon.  Alternately, you may drag and drop a file object from the "Drives"
folder onto LstPM's icon to invoke LstPM and load that file automatically.

From the OS/2 command line, you may simply type "LSTPM" and an optional file
name to start the program.  If you do not specify a file name, LstPM will come
up with the last viewed file loaded.  If you specify an ambiguous file name,
the first thing you will see is LstPM's File Open Dialog. Otherwise, the file
specified will be loaded if it exists and is accessable.


ΓòÉΓòÉΓòÉ 2.3. Registering LstPM ΓòÉΓòÉΓòÉ

Copies of LstPM for personal use are free!  If you find the program to be of
value, you are encouraged to make a gift ($20 suggested) and become a
supporter.  Technical support is available to LstPM supporters through the
Oberon Software bulletin board system or by phone at no charge.

A license is required for use of LstPM by corporations and institutions, and
for its commercial distribution.

You may obtain a license for the use of LstPM by contacting Oberon Software.
The license is for perpetual, non-exclusive use of the version.  Purchase
orders and invoicing are acceptable.

The fee for a license depends on the estimated number of copies of the program
that you will use.  The fee applies to one site.  For local area networks, one
copy must be licensed for each computer that will be using the program on the
network.  To use the discount schedule below, estimate the total number of
copies that you may eventually use.

    Number of users(copies)    Price per copy
       1   to 10                 $ 25.00
       11  to 25                   24.00
       26  to 50                   23.00
       51  to 75                   22.00
       76  to 100                  21.00
       101 to 125                  20.00

       Over 125: unlimited      $2500.00

Regardless of the quantity, only one set of materials will be sent to you.  You
may then make as many copies of LstPM as are licensed. Maintenance is free and
technical support is available via telephone or through the Oberon Software
bulletin board system at no charge.  Licensed users of LstPM will receive
notification of future upgrades.


ΓòÉΓòÉΓòÉ 2.4. Copyright, License, and Warrantee ΓòÉΓòÉΓòÉ

This electronic document and the program files LSTPM.EXE, LSTPM.HLP, and
LSTPM.INF ("the  software") are copyrighted by Oberon Software and the author,
Brady Flowers.  The copyright owner hereby licenses you to use the software
given these restrictions:

o The program shall be supplied in its original, unmodified form, which
  includes this documentation;

o For-profit use without a license is prohibited;

o The program may not be included - or bundled - with other goods or services.
  Exceptions may be granted upon written request only.

o No fee is charged; an exception is granted to not for profit user's groups,
  which are permitted to charge a small fee (not to exceed $5) for materials,
  handling, postage, and general overhead.  No other organization is permitted
  to charge any amount for distribution of copies of the software or
  documentation, or to include copies of the software or documentation with
  sales of their own products.

The Regular Expression Engine provided in the dynamic link library
REGEXPUT.DLL, used by in LstPM, is derived from previously copyrighted
software.  This is the copyright notice from the source code to that section of
the software:


Copyright (c) 1986 by University of Toronto.
Written by Henry Spencer.  Not derived from licensed software.

Permission is granted to anyone to use this software for any purpose on any
computer system, and to redistribute it freely, subject to the following
restrictions:

 1. The author is not responsible for the consequences of use of this software,
    no matter how awful, even if they arise from defects in it.

 2. The origin of this software must not be misrepresented, either by explicit
    claim or by omission.

 3. Altered versions must be plainly marked as such, and must not be
    misrepresented as being the original software.

Slight alterations were made to Mr. Spencer's software in the process of
porting it to the OS/2 environment.  Mr. Spencer's original source code is
available to the public for download from the Oberon Software User Support BBS.

There is no warranty of any kind.  The copyright owner may not be held liable
for any damages, including any lost profits or other incidental or
consequential damages arising out of or inability to use the software.  By
using the software, you agree to this.

The software and documentation are:

   Copyright (C) 1990-1993 by
   Oberon Software and Brady Flowers
   Mankato, MN, USA


ΓòÉΓòÉΓòÉ 3. Help for Keys ΓòÉΓòÉΓòÉ

The following information is availble regarding LstPM's keyboard interface:

o Menus
o Scrolling Text
o Dialog Boxes


ΓòÉΓòÉΓòÉ 3.1. Menu Item Selection ΓòÉΓòÉΓòÉ

You can select any item from the action bar menu by typing Alt-letter where
"letter" is the underlined letter in the menu item text.  For example, the File
menu item text has the letter "F" underlined so it may be accessed by typing
Alt-F.  Alternately, you may activate the action bar by pressing and releasing
the Alt key or by pressing and releasing the the F10 key.  Thereafter, you may
select an item by pressing the key corresponding to the underlined letter in
the menu item text or by moving the highlight to that item with the arrow keys
and pressing Enter when it is highlighting the desired item.

When a pulldown menu or a submenu is visible, you may select an item from these
menus by pressing the underlined letter key (the Alt key is optional in this
case) or by moving the highlight with the arrow keys and pressing Enter

The System Menu (the icon with the horizontal bar in the upper left corner of
the window frame) may be activated from the keyboard by pressing Alt-SpaceBar.

You may exit any menu without making a selection by pressing the ESC key.

Some menu items have an associated accelerator key associated with them.  For
example, F3 is associated with the Exit item on the File menu.  These
accelerator keys are always available whenever LstPM's main window or its
action bar has the focus.


ΓòÉΓòÉΓòÉ 3.2. Scrolling Text ΓòÉΓòÉΓòÉ

You may move the viewing window forward and back through the file a line at a
time using the Up and Down Arrow Keys or a page at a time using the Page Up and
Page Down Keys.  You may move the viewing window left or right about 1
character width at a time using the Left and Right Arrow Keys.  Pressing
Control+Left Arrow will return the display to the beginning the line.  The Home
and End Keys will move the display to the beginning and end of the file
respectively.


ΓòÉΓòÉΓòÉ 3.3. Dialog Boxes ΓòÉΓòÉΓòÉ

Dialog boxes are usually divided into groups of controls (buttons, entry
fields, list boxes, etc.).  The TAB key will move the highlight from control to
control regardless of group boundaries; Shift+TAB will do the same in the
reverse direction.  The Arrow Keys will move the highlight from control to
control always staying within the current group of controls.

Buttons are selected by moving the highlight to the desired button and pressing
the SpaceBar or, if the button's text contains an underlined letter, by
pressing Alt+letter (see also the discussion on accelerator keys in the help
for menus

Usually a dialog box will have one button with a special highlight. This is the
default button which is invoked by pressing Enter. If the dialog has a button
labeled Cancel, this button may be invoked by pressing the ESC key.

Some controls have special rules for keystrokes:

o Entry fields are not exited via the TAB key.  To exit an entry field, press
  Enter (the default button will not be invoked).

o When a List Box has the highlight, the arrow keys will move the highlight
  within the list box up and down (or scroll the list box left and right if it
  has a horizontal scroll bar).  Exit a List Box using the TAB key.

o Spin Buttons and Combo Boxes behave analogously to List Boxes.

o Select or deselect a Check Box by pressing the SpaceBar while the Check Box
  has the highlight.

o Move the selection within a group of Radio Buttons using the Arrow Keys.


ΓòÉΓòÉΓòÉ 4. Help for File Menu ΓòÉΓòÉΓòÉ

The File menu.

The File menu has the following items:

o Open
o Pick List
o Previous File
o File Info


ΓòÉΓòÉΓòÉ 4.1. Help for Open ΓòÉΓòÉΓòÉ

Selecting the Open option on the File Menu will allow you to select a new file
to view by using the Open File Dialog wherein may navigate your way to the file
you are interested in through a series of List Boxes which allow you to select
the Disk Drive, Directory, and the File Name.


ΓòÉΓòÉΓòÉ 4.2. Help for Pick ΓòÉΓòÉΓòÉ

Oberon LST for PM retains a list of names for all files which have been
previously viewed along with current position in the file and whether the file
was last viewed as ASCII or Hex.  When the Pick menu option is selected, you
will be presented with a List Box containing the names of the previously viewed
files with the most recent at the top, the eldest at the end.

To select a file from the list, highlight the name in the List Box and press
Enter or click on the button labeled Open. You may also, simply double click on
the file name in the List Box. To delete a file name from the list, highlight
the file name and click on the button labeled Delete.

To exit the Pick Dialog without selecting a file, press ESCape or click on the
button labeled Cancel

Note that if a file is reloaded via the Open Dialog, it will subsequently
appear more than once in the Pick List.  If it is reloaded via the Pick List
however, it will simply be migrated to the top of the list.


ΓòÉΓòÉΓòÉ 4.3. Help for Previous ΓòÉΓòÉΓòÉ

If you select the Previous option from the File Menu, the currently viewed file
will be exchanged the the most recent file in the Pick List.


ΓòÉΓòÉΓòÉ 4.4. Help for File Info ΓòÉΓòÉΓòÉ

When you select the File Info option from the File Menu, a dialog will be
displayed that contains informations regarding the currently viewed file:

 File PathName
 File Size, Allocation Size, and EA Size
 File Date and Time of Creation, Modification and Last Access
 File Attributes
 Executable File Flags if applicable

Press Enter or ESCape or click on the button labeled Okay to close this dialog.


ΓòÉΓòÉΓòÉ 5. Help for Search Menu ΓòÉΓòÉΓòÉ

The Search menu.

The Search menu has the following items:

o Search
o Next


ΓòÉΓòÉΓòÉ 5.1. Help for Search ΓòÉΓòÉΓòÉ

The Search menu item invokes the Text Search Dialog which you may use to search
the currently displayed file for specified text.  You will be allowed to enter
the text for which to search and to choose from several options:

o Search from the top of file or from the current location.
o Match the case of the search text exactly or ignore character case.
o Whether the specified text is a Regular Expression or the exact text.
o Direction in which to search (forward or reverse).


ΓòÉΓòÉΓòÉ 5.2. Search Next ΓòÉΓòÉΓòÉ

If a previous search has been issued, this menu item will be available and
selecting it will re-invoke the previous search starting from the line after
the previous match if it is still visible in the window or from the top line of
the window.


ΓòÉΓòÉΓòÉ 6. Help for Options Menu ΓòÉΓòÉΓòÉ

The Options menu.

The Options menu has the following items:

o View
o Font
o Colors
o Tabs
o Codepage


ΓòÉΓòÉΓòÉ 6.1. Help for View ΓòÉΓòÉΓòÉ

There are three viewing modes available for files in LstPM, accessable from the
View submenu on the Options menu.

o Text
o Text+Line #'s
o Hex

In Text Mode, the file is displayed as normal, textual data, much as it would
be displayed in a text editor.

Text+Line #'s Mode is identical to text mode except that the line number of
each line is displayed before the line.  This mode is useful for a variety of
purposes.  Be aware that LstPM's Search function works on the line numbers
themselves. Thus, you can use this as an easy "goto line" function.  I.e., to
go to line 100 in the file, set the view to Text+Line #'s and search for
"100:".

In Hex Mode the file is treated as purely binary data, this is very useful for
viewing executable or object module files and some data files. In this mode,
the display is divided into three parts.  On the left side is offset into the
file given in hexadecimal.  In the center are 16 columns which give the actual
value of each byte in the file, again in hexadecimal. On the far right are 16
columns which display the ASCII characters associated with the corresponding
bytes.  If a given byte of data is not printable, a period is placed in its
position.

Hex mode may not be very useful when an EBCDIC codepage is active because the
entire display, including the offsets and hex values are also displayed in
EBCDIC.


ΓòÉΓòÉΓòÉ 6.2. Help for Font ΓòÉΓòÉΓòÉ

The Font item on the Options menu invokes a dialog which allows you to choose
how to display the file with regards to font face and size.  You are limited to
those fonts which you have installed on your system. This will usually be at
least the standard System Font, a monospaced version of the System Font,
Helvetica, Times Roman, and Courier but you may have other fonts installed,
including ATM (Postscript) fonts.  LstPM queries the system to find which fonts
are available.

For help manipulating this dialog see the help for Font Selection


ΓòÉΓòÉΓòÉ 6.3. Help for Colors ΓòÉΓòÉΓòÉ

The Colors item on the Options menu invokes a dialog which allows you to choose
which colors to use when displaying files.  You will be able to select
foreground color and background color independantly.

For help manipulating this dialog see the help for Color Selection


ΓòÉΓòÉΓòÉ 6.4. Help for Tabs ΓòÉΓòÉΓòÉ

The Tabs item on the Options menu invokes a dialog which allows you to input a
numeric value.  This value controls how tab characters are expanded when
displaying files.  If the number is greater than zero, all tab characters will
be translated into that many space characters before being displayed.  If the
number is zero, tab characters are not translated and will be displayed using
whatever character the current font uses for the TAB character (usually a small
circle).

For help manipulating this dialog see the help for Tab Settings


ΓòÉΓòÉΓòÉ 6.5. Help for Codepage ΓòÉΓòÉΓòÉ

The Codepage item on the Options menu has a submenu which will allow you to
look at the available codepages for either ASCII or EBCDIC character encoding
schemes.  Each of these has, in turn, a submenu presenting the available
codepages.  Not all codepage selections will work with all fonts and codepage
selection may not work at all if you do not have this feature enabled in your
CONFIG.SYS file.  Searching for text, tab expansion, and hex mode will not work
as expected when using an EBCDIC codepage.

See the OS/2 Command Reference for more information on codepages.


ΓòÉΓòÉΓòÉ 7. Help for Regular Expressions ΓòÉΓòÉΓòÉ

REGULAR EXPRESSION SYNTAX

A regular expression is zero or more branches, separated by '|'.  It matches
anything that matches one of the branches.

A branch is zero or more pieces, concatenated.  It matches a match for the
first, followed by a match for the second, etc.

An atom is a regular expression in parentheses (matching a match for the
regular expression), a range (see below), '.' (matching any single character),
'^' (matching the null string at the beginning of the input string), '$'
(matching the null string at the end of the input string), a '\' followed by a
single character (matching that character), or a single character with no other
significance (matching that character).

A piece is an atom possibly followed by '*', '+', or '?'.

o An atom followed by '*' matches a sequence of 0 or more matches of the atom.
o An atom followed by '+' matches a sequence of 1 or more matches of the atom.
o An atom followed by '?' matches a match of the atom, or the null string.

A range is a sequence of characters enclosed between square brackets '[' and
']'.  It normally matches any single character from the sequence.  If the
sequence begins with '^', it matches any single character not found in the rest
of the sequence.  If two characters in the sequence are separated by '-', this
is shorthand for the full list of ASCII characters between them (e.g. '[0-9]'
matches any decimal digit).  To include a literal ']' in the sequence, make it
the first character (following a possible '^').  To include a literal '-', make
it the first or last character.

EXAMPLES

  The regular expression: "go*d"
  Would match any of: "gd", "god", "good", "gooooooood".

  The regular expression: "^[Dd]ear [A-Z]"
  Would match the first six characters of "Dear John" or "dear Me"
  if the string is found as the first thing on the line in which it occurs.

  The regular expression: "[^Dd]ear [A-Z]"
  Would NOT match either "Dear John" or "dear Me" regardless of
  where they occurred on the line.  It would match the first six
  characters of either "Bear Country" or "Fear And Loathing" anywhere
  on the line however.

  The regular expression:
           "^[_a-zA-Z].*\(.*\)[ \t]*(/\*.*\*/[ \t]*)*$"
  Would match any "C" language function definition!  If you understand
  this last example, however, please refer to the note regarding
  C-style backslash notation

AMBIGUITY

If a regular expression could match two different parts of the input string, it
will match the one which begins earliest.  If both begin in the same place but
match different lengths, or match the same length in different ways, life gets
messier, as follows.

In general, the possibilities in a list of branches are considered in
left-to-right order, the possibilities for '*', '+', and '?' are considered
longest-first, nested constructs are considered from the outermost in, and
concatenated constructs are considered leftmost-first.  The match that will be
chosen is the one that uses the earliest possibility in the first choice that
has to be made.  If there is more than one choice, the next will be made in the
same manner (earliest possibility) subject to the decision on the first choice.
And so forth.

For example, '(ab|a)b*c' could match 'abc' in one of two ways.  The first
choice is between 'ab' and 'a'; since 'ab' is earlier, and does lead to a
successful overall match, it is chosen.  Since the 'b' is already spoken for,
the 'b*' must match its last possibility (the empty string) since it must
respect the earlier choice.

In the particular case where no '|'s are present and there is only one '*',
'+', or '?', the net effect is that the longest possible match will be chosen.
So 'ab*', presented with 'xabbbby', will match 'abbbb'.  Note that if 'ab*' is
tried against 'xabyabbbz', it will match 'ab' just after 'x', due to the
begins-earliest rule.  (In effect, the decision on where to start the match is
the first choice to be made, hence subsequent choices must respect it even if
this leads them to less-preferred alternatives.)


ΓòÉΓòÉΓòÉ 8. Help for Dialog Boxes ΓòÉΓòÉΓòÉ

LstPM has a number of dialog boxes for performing various tasks.  They include:

o Open File Dialog
o Pick Dialog
o Font Dialog
o Color Dialog
o Product Information Dialog


ΓòÉΓòÉΓòÉ 8.1. Product information ΓòÉΓòÉΓòÉ

If you select Product information from the Help Menu, you will be shown a
simple dialog containing the name of the program, copyright and date
information, and contact information for Oberon Software.


ΓòÉΓòÉΓòÉ 8.2. Help For Open File Dialog ΓòÉΓòÉΓòÉ

You may navigate your way to the file you are interested in through a series of
Dropdown-List Boxes which allow you to select the Disk Drive, Directory, and
the File Name, you may type the name directly into an entry field.

When the desired file name is displayed in the Entry Field, press Enter or
click on the button labeled OK to load the file.  If the desired file is
visible in the File List Box, you may proceed directly to loading the file by
double clicking on its name.

To exit the Open Dialog without selecting a file, press ESCape or click on the
button labled Cancel.

It is also possible to use the List Boxes and Entry Field in conjunction with
each other:

Enter a Disk Drive letter and colon in the Entry Field and the List Boxes will
readjust themselves to indicate the current directory on that drive.

If you enter an Ambiguous File Spec, the Filename Filter will be reset such
that the File List Box displays only matching files.

You may do any combination of the above.

Example: To display all files with the extension ".txt" in the "bin" directory
of drive D:, Enter:

    D:\bin\*.txt


ΓòÉΓòÉΓòÉ 8.3. Help For Text Search Dialog ΓòÉΓòÉΓòÉ

Enter the text string for which you wish to search into the entry field. This
string may be the exact text you wish to locate or it may be the the exact text
in all respects save for character case depending on the setting of the Case
sensitive checkbox.  If the Regular expression checkbox is checked the text
will be treated as a pattern to match via the rules for Regular Expression
evaluation.

Check the box labeled Search from top if you wish to start the search from the
beginning of the file; otherwise the search will commence from either the line
immediately following the last successful search if this line is still visible
in the window or from the top line in the window if there was no prior,
successful search or if the line has been moved so as to no longer be visible.

The Forward and Reverse check boxes control the direction of the search.

While the search is in progress, a special dialog box is displayed.  You may
cancel the search by pressing the ESC key or by clicking on the Cancel button
in the dialog.  After a successful search, you will be given the opportunity to
continue searching or to stop and return to viewing the file.  The line
containing the found text will be highlighted and will remain highlighted until
you initiate another search, view a different file, or exit LstPM.

Once a search has been performed, the Next item on the Search menu will be
enabled.  Selecting this item will repeat the last search with all of the same
options.  Search Next will always search from the current location as described
above (i.e., the Search from top option will not be active).


ΓòÉΓòÉΓòÉ 8.4. Help for Pick File Dialog ΓòÉΓòÉΓòÉ

This List Box contains a list of all files which have been previously viewed
with LstPM excluding the currently viewed file and any which you may have
deleted.

You may select a file from the list and return to viewing that file at the same
location within the file as left off.  Double-click on the name of the desired
file to select it for re-viewing, or move the List Box highlight to the file
name and press Enter to reload the file.  Press ALT+D or click on the Delete
button to remove the highlighted file from the list.  Press ESC or click on the
Cancel button to exit the dialog without changing the currently viewed file.

You may use OS/2's drag and drop to drop one or more file objects into the Pick
List Box.  Each file dropped here is added to the top of the pick list.


ΓòÉΓòÉΓòÉ 8.5. Help for Font Selection ΓòÉΓòÉΓòÉ

Choose a font name, style, and size from the various drop-lists and customize
the font by selecting Outline, Underline or Strikeout in any combination.  When
you have selected the font you want to use, press the OK button.  Use the
Cancel button to exit this dialog without resetting the font.


ΓòÉΓòÉΓòÉ 8.6. Help for Color Selection ΓòÉΓòÉΓòÉ

Select the desired foreground and background colors from their respective List
Boxes and press Enter or click on the Set button to accept your choice.  Press
ESC or click on the Cancel button to exit the dialog without changing the color
setting.


ΓòÉΓòÉΓòÉ 8.7. Help for Tab Settings ΓòÉΓòÉΓòÉ

If you enter a non-zero number in the entry field in this dialog, any TAB
characters found in the viewed file will be expanded as many Space characters.
If you enter a zero, TAB characters will not be expanded and will instead be
represented by the actual ASCII symbol for the TAB character (a small circle).


ΓòÉΓòÉΓòÉ <hidden> Help for Searching Dialog ΓòÉΓòÉΓòÉ

Click on the Cancel button or press the ESC key at any time to interrupt the
search process.


ΓòÉΓòÉΓòÉ <hidden> Help for Found Dialog ΓòÉΓòÉΓòÉ

The result of your last search was a success!  Click on the Again button to
search for the next occurance or on the Stop button to return to viewing the
file.


ΓòÉΓòÉΓòÉ <hidden> Help for Set Button ΓòÉΓòÉΓòÉ

Use the Set button to set the current options and exit the dialog.


ΓòÉΓòÉΓòÉ <hidden> Help for Cancel Button ΓòÉΓòÉΓòÉ

Use the Cancel button to exit the dialog without resetting any options.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Oberon Software
518 Blue Earth Street
Mankato, MN 56001-2142 USA
Phone: [phone]
FAX: [phone]
BBS: 507-388-1154
CompuServe: 72510,3500
GEnie: B.FLOWERS
MCI Mail: oberon/413-5847


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

An ambiguous file name is one which contains one or more special wildcard
characters '*' and/or '?'.  These are used for specifying groups of files which
match a particular pattern.  For example, "*.doc" will match all filenames
which end with the characters ".doc" and "myfile.?" will match all filenames
which begin with the characters "myfile." followed by no more than one more
character.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

ASCII and EBCDIC are two different coding schemes for encoding the characters
we see displayed on our computer screens.  Each one associates a character
(i.e., a letter, numeral, punctuation mark, etc.) with a number from 0 to 255.
The ASCII character set is most commonly used on personal computers and the
EBCDIC character set is used on IBM mainframe computers.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Select a file or directory object from the desktop or a folder using the left
mouse button, hold the right button down while moving the mouse pointer; the
icon will move with the mouse pointer. Move the pointer to the desired location
and release the mouse button to drop the object.

You can select and drag multiple objects if you hold the Control key down while
you make your selections or by dragging the mouse pointer with the left button
down to draw a box around the items you wish to select.

You may drop a file or directory object on LstPM's program object icon (on the
desktop or in a folder), on LstPM's window or on its icon while it is running,
or on the Pick List Dialog In the first case, this is the equivalent of
starting LstPM with that file name as a parameter; in the second case, it is
the equivalent of selecting that file via LstPM's File Open Dialog. Only file
objects may be dropped on the Pick List; each file dropped here is added to the
list.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Please note that the '\t' used in the example to imply a TAB character is there
for illustration only because an actual TAB character is difficult to display
within the context of the IPF.  The C-style backslash notation for tabs,
newlines, etc. is NOT supported by this regular exression engine. Because of
the '^' and '$' metacharacters and the fact that matches cannot occur across
line boundaries, the loss of '\n' and '\r' should be no hardship.  If you need
to specify a TAB, you may simply enter an actual TAB character.