                       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-procedure 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
===================

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 using the
-static option. Therefore no special dlls are required.

(I have yet to understand why everybody else seems to be using the
emx-port of the gcc. Anyway, the gcc/2 seems to have vanished from the
scene (i.e. the hobbes-server), so it could have been difficult for you
to get the dllc101.dll (=the gcc/2 runtime-dll). If you have a copy of
this dll, send me an e-mail and I will send you the non-static-version
of the exe-file (whose size is 8K compared to 50K). But in these days
of GigaBytes, this may not be an issue for you ;-)

Of course, you can always recompile the program by using your own
favourite compiler.


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
