PIPE is a general-purpose tool which adds Unix-like I/O redirection, etc.,
to DCL.  It allows combining DCL commands, "filters", and operators to make
simple and easy what would otherwise be complex and difficult.  For more 
information, please read PIPE.HLP.


Contents
========

This PIPE collection includes:

PIPE    The "magic" DCL procedure that allows combining DCL commands, etc.
	PIPE requires no special priviledges; it is not device driver 
	wizardry.  

Misc. Filters
        These are programs intended to be used with PIPE.  NOTE: Compiled 
	programs need no special treatment. Just compile as appropriate and 
	link, both without any special options. 

Sources
	Where appropriate, as well as "pipe stems" -- stub files for 
	building filters in various languages.

Documentation
	AAAREADME.TXT (this file), AAASUMMARY.TXT, and PIPE.HLP.  The 
	latter contains a collection of ideas on ways to use PIPE.


This PIPE collection includes NOT:

gawk, perl and most of the sources of the bigger EXE-files to keep this
distribution small. But you can ftp them from info.rz.uni-ulm.de,
/pub/VMS/misc , too.


Installation
============

1. Place these files in a (preferably empty) directory, into which you 
   have SET DEFAULT.

2. Enter

	$ @PIPE_LOGIN.COM
	$ @MAKEHELP

   This sets up the PIPE logical and symbol, plus a couple of others which
   are handy (but not essential to PIPE) and creates the pipe-HELP

3. To make PIPE a standard part of your work environment, edit your
   LOGIN.COM, adding a line like

	$ @disk:[direcory]PIPE_LOGIN

   The PIPE_LOGIN command file assumes that its location is that of the PIPE
   package; to work properly, it must be kept with the other files. 

4. If you wish to add PIPE.HLP to your standard help library, enter

	$ LIBR/ADD SYS$HELP:HELPLIB.HLB/help PIPE.HLP

   If you have added PIPE's help previously, replace ADD with REPLACE in the
   above command line. 

5. You may want to print a copy of AAASUMMARY.TXT as a handy overview of
   available filters, etc. 


Notes:
======

   Many of PIPE's filters are available in both DCL and compiled-language   
   form. This is deliberate, for flexibility.  There is _usually_ little
   difference, except for speed.  PIPE comes configured with my choices; 
   feel free to make your own. 

   TECO-based (.TEC) filters something of a special case; TECO is powerful
   and  fast, but doesn't need to be compiled.  It works well as a filter tool.
   And it's free.  Those considering writing filters might also consider the
   ICON or GAWK languages.  Another excellent source of PIPE filters and other
   Unix-style tools is the Software Tools collection. 


Credits:
========

  The base PIPE package, filters, etc., was written by Ken Wallewein,
  kenw@noah.arc.ab.ca.  PIPE may be freely distributed as long as nothing is
  removed from the package, including source code and indication of
  authorship. 

  A number of the filters in this collection, especially those written in 
  PASCAL, are by Thomas Hall.  Thanks, Tom!

  Contributions by others are most welcome.  
