                       SELECT
                       ======

This program reads all lines from the standard input and puts selected
lines on the standard output.


This is especially useful if you are looking for a quick way to
eliminate all the garbage certain system-commands like pstat put out.

Just look for a pattern in the garbage-lines and exclude all lines
which match that pattern (see example-procedure ps.cmd). (Using
the default option -me).

Or look for a common pattern in the lines you are interested in
(or the single line you are interested in) and include that line(s)
(see example-procedures free.cmd and bytes.cmd). (Using the
option -mi).


The program looks for the pattern anywhere in the range specified
by the -cf and -ct options. If you want to check for a pattern that
always occurs on the same fixed location, just set the exact
boundaries via the -cf and -ct options.

The pattern must not contain blanks, that is why you have to
substitute blanks by the character specified by the -b option
(the default value is -b).


For redirection of the standard in- and output use the pipe (|)
or the < and > symbols. Of course, the program works for any ascii
input file and is useful for other purposes than just truncating
of system commands.

Apropos truncating: Use the -f and -t options to truncate each line
before it is put on the standard output - just the columns
specified by -f and -t are printed.


SYSTEM REQUIREMENTS: ------ dllc101.dll needed ---------
===================

I ran the program on a no-name 386DX40 under OS/2 3.0 Warp. There
should be no problems, however, using ANY other machine
running OS/2 2.x (there are no programming-tricks, as you can
see from the source-code).

For compiling, I used the GNU GCC/2 2.6.1 compiler. Therefore,
the program requires the dllc101.dll in a directory specified in
the LIBPATH-statement in your config.sys. You can get this dll from
the hobbes.nmsu.edu or any comparable shareware-server.
For example, on the March 1995 Hobbes-CDROM you can find it in the
file base261.zip which is located in the \32bit\unix\gcc2_261
directory.


REGISTRATION
============

This program is freeware, so registration is not required! You can
freely copy it, upload it to any Internet, CompuServe or BBS site
and otherwise distribute it by all means - and freely use it!   ;-)
(Of course, no warranties involved!)

You are not allowed, though, to sell the program!



Please, send any comments, suggestions, bug-reports etc. to
me via Internet:

     e8525101@student.tuwien.ac.at

If you feel like it, send a small donation or a postcard
to:

     Franz Steiger
     Kreuzgasse 31/1/22
     A-1180 Wien
     AUSTRIA/Europe
