		trigram_utils 1.2		Apr 04

	This packaging of trigram_utils assumes different
locations for various files.  In particular, the "critical"
library routines, trigram and un_trigram, are not in this package.
It is assumed that they have been previously installed in the
"system" library, jgofsroot/XXXsrc/lib/jgofs.a
	This packaging now contains only stand-alone binary
routines.  The make file builds the binaries into directory ../../bin.
If the makefile is located in jgofsroot/XXXsrc/YYY, the build
will conform to JGOFS structure (assuming one WANTS the binary in
../bin!)
        outer_utils.c (typically part of the jgofs.a library) contains
functions trigram and un_trigram which alter strings by replacing
"objectionable" characters by their hex equivalents and converting such
strings back to the originals. The programs in trigram_utils variously 
use and test those functions

	Easiest way to build not much more than trigram_utils:
		cd jgofsroot
		./build YYY  [or ./opt-build YYY]
	To build more exactly
		/bin/csh
		cd jgofsroot
		source build-env [or source opt-build-env]
		cd XXXsrc/YYY
		make -f makefile.trigram

	The package includes test programs which are NOT built
by the above instructions.  They are built by the make command
		make -f makefile.trigram program_name
Program name must include the directory of the desired executable.
If one is "in" XXXsrc/YYY, I believe that ../../bin/program_name
will work, but no guarantees.

	Base documentation is that for the trigram/un_trigram routines.
Doc is available in the source, outer_utils.c (most likely in 
jgofsroot/XXXsrc/lib)
	trigram_util.c is an image interface to the utilities.  It
links with trigram/un_trigram; hence, it needs the jgofs.a library.  Doc is
available at the top of the source code.  When interacting with "the" shell,
the following syntax seems to preserve blanks, etc
		set tmp="`trigram_util 'string_to_be_trigrammed'`"
	trigram_fortran.c is a FORTRAN interface to the utilities.  It
consists of 2 functions named trigram_ and un_trigram_ (apparently the
Sun and SGI FORTRAN compilers (at least) add underscores to FORTRAN
function names when generating refs & defs).  It needs trigram/un_trigram
from the jgofs.a library.  Doc is available at the top of the source code.
	test_trigram_fortran.f is a FORTRAN test program for trigram_fortran.c.
It needs trigram_fortran.o and trigram/un_trigram from the jgofs.a library.  
No doc is available - sorry.  Please read the code.
