		Release notes-outer_brev 2.1  (Jul 06)
		  (includes 2.0b & 2.0/2.0a release notes)

	The 2.1 release adds enhancement to the string comparison
operators.  It also adds 2 options to control the appearance of web
pages produced by outer.

1) Case-blind string comparison
	Older versions of outer's string comparison operators (eq, lt, etc)
did exact string comparisons.  In version 2.1, new operators have been
added to do case-blind comparisons.  The new operators are the upper-case
of the old ones.  Example:
		cruiseid eq "al9402"
returns FALSE if cruiseid is AL9402.  The new
		cruiseid EQ "al9402"
will return TRUE if cruiseid is AL9402.

2) Wild-card string comparison.
	A new string operator, like, has been added.  It allows a search
string to include one or more underscores, each to match exactly 1 character.
Search strings may also include one or more percent characters, each to
match 0 or more characters.  To search for an underscore or percent,
precede it with a backslash.  Examples:
		cruiseid like "AL%"
does the same thing as the old
		cruiseid begins_with "AL"
		variable like "%\_whatever"
does the same thing as the old
		variable ends_with "_whatever"
	A case-blind LIKE operator has also been added.
	Note: the percent character has become "overloaded".  Before
the parser gets the selection string, other code interprets the percent
sign as indicating a hexadecimal encoding of the following 2 characters.
To get past this, it will generally be necessary to encode the
percent sign itself; eg, cruiseid like "AL%25" (the ASCII code for
a percent is hex 25)

3) Control of background color of web pages
	The BACKGROUND_COLOR environment variable controls the
background color of web pages outer produces.  If not present in the
environment, the value defaults the the value of the compile-time
switch BACKGROUND_COLOR.  If this switch is not specified, the browser
will control the background color.
	The value of the BACKGROUND_COLOR parameter is a 6 digit
hexadecimal string.  Example:
		setenv BACKGROUND_COLOR 00ff00

4) Control of the "header" line of web pages.
	The DISPLAY_DATA_URL environment variable controls whether or
not the URL of the displayed data is itself displayed as a header line.
If not present in the environment, the value defaults to the value of
the compile_time switch DISPLAY_DATA_URL.
	Please see outer_brev_switches.doc for information about
the formatting of TRUE/FALSE switches such as DISPLAY_DATA_URL

=================

	The 2.0b release has no functional changes from the 2.0a release.
However, it introduces an incompatibilty with existing method compilations
(please see below)

	This release reflects a reorganization of the files used by 
outer.  In particular, outer_utils.c and the .c files previously drawn 
from path_info_routines.tar and trigram_utils.tar are now drawn from the 
jgofs_root/src/lib/jgofs.a library.  The .h files previously drawn from 
path_info_routines.tar and trigram_utils.tar are now looked for in
the jgofs_root/src/include directory.  Accordingly, outer_utils.c, 
path_info_routines.tar, and trigram_utils.tar have been
dropped from this distribution.
	Compilation of outer now requires more .h files.  These
.h files are installed as part of library installation, and
existing method compilation scripts most likely will find them
without the necessity of modifying said scripts.  However, a
new switch, -DINNEROPTIONS, is now required.  Please see
outer_brev_switches.doc.
	Because building outer is a part of building most methods, 
this release includes a "makefile fragment" designed to be included 
via the make "include" directive in each makefile.inner.  This file, 
outer_make_macros.include, is not required for building methods whose
make files haven't been explicitly altered to use it

	Un-tar'ing the libupd.tar file in the outer_brev installation
directory is NOT sufficient to allow outer to be built.  A library
must be built and/or make files must be altered to point to correct
file locations.  In general, the libupd.tar file should be moved to
jgofs_root/src/lib, un-tar'ed there, and its make file(s) executed
"from there".  Please consult the libupd documentation.

=================

	outer_brev v 2 addresses a problem that arose with the .brev
feature.  Briefly, .brev implementations prior to v 2 would stop calling
inner's ioreadrec_ entry when outer no longer wanted any data, and then
start calling again when it wanted new data.  Depending on how inner
was supplying the data, this could cause problems.
        To address this, outer_brev v 2 will call inner until inner
supplies EOF, whether or not outer intends to display the data.  This means
that, in a .brev situation, outer_brev v 2 will call inner many more times
than outer_brev 1.5 did.
	Details (including how to return to 1.5 behavior) are available in 
the outer_brev.doc file mentioned below.

	The comments at the top of outer_brev.c are the most complete
documentation of the changes in this release.  The outer_brev_revision.doc
file contains older source comments removed from outer_brev.c for
convenience.  The outer_brev_switches.doc file summarizes available 
compilation switches.  Most compilation options are also available as 
environment variables at runtime.  The outer_brev.doc file is a discussion 
of the ".brev" data listing feature.
