        Skeletal instructions for using the contents of this tar file
	    (list 1.8b.  WJS Apr 15.  Includes some readme info for 1.6s & 1.7s)

Files:

	This packaging of list expects to get the jdb and utils routines 
from the jgofsroot/XXXsrc/lib/jgofs.a library.  It assumes the existence 
of core.h.  These files are included in libupdXX.tar.  Consult the
comments in list.c (in this package) for its version requirements for
jdb, utils, & core.h

	This packaging of list expects the JGOFS-server-specific files 
default.h and inner.h in jgofsroot/XXXsrc/include.  These files are not
included in any distribution.



	list 1.8b changes the default of INCLUDE_ATTRIBUTES_SWITCH, which was
introduced with list 1.7.  As of list 1.8b,  the default for this switch
is TRUE.  Please see the list 1.7 documentation (below) for
a description of INCLUDE_ATTRIBUTES_SWITCH.
	This change is incompatible with existing scripts that use
list.  To retain compatibility, any of the following choices can be used
1) change jgofsroot/src/bin/makefile.list; eg, remove the -DINCLUDE_ATTRIBUTES_SWITCH 
   string from the SWITCHES assignment.  Then recompile and relink list;
   eg, jgofsroot/build.pl list
2) change the environment for scripts executing list to have an environment
   variable named INCLUDE_ATTRIBUTES_SWITCH whose value is 0; eg,
	export INCLUDE_ATTRIBUTES_SWITCH=0 in bash
3) change all list commands to include the  -a  switch

	list 1.8b also has a bug fix which allows choice 2 above to
work.



	list 1.8a implements a couple of bug fixes.

	In particular, it addresses a peculiarity of list when the -n switch
is NOT specified.  Note that -n is the default unless output is being
sent to a terminal.  When output is being sent to a terminal, list
emulates the more utility.  It modifies the terminal characteristics
to allow single character reads.
	It has been discovered that on Solaris systems, when list
attempted to restore the terminal characteristics on exit, it set the
EOF character to cntl-A instead of the default cntl-D.  In v 1.8a,
on exit, list will set the EOF character to cntl-D.
	This v 1.8a action does not completely address the problem.
First, the action applies only to Solaris systems.  Other OS'es may
be affected and require action.  Second, on a Solaris system, the
fix is inadequate in the (presumably rare) case where the EOF
character was NOT cntl-D before entering list.
	The eof character can be examined and set with the stty
utility if necessary.



	list 1.8 adds 2 switches relating to error text generated by list
Please see the list_output.doc and list_exitstatus.doc files for more
information about detecting list errors

1) By default, after a syntax error, list prints out its help.  The -nohelp
   switch will disable that print
2) The -errprefix switch instructs list to prefix the first of its error 
   lines with a user-specified string (defaulting to ***LISTERR***).



[from readme for list 1.7b]
	list 1.7 has switches that affect the way the variable attribute
list is sent to the user.
	list 1.7 has a new switch -aw.  This causes the width attribute
to be treated like the other attributes.  Pre-list-1.7, the width
attribute was not propagated, regardless of the propagation state of other
attributes.
	list 1.7 has a new parameter, INCLUDE_ATTRIBUTES_SWITCH, which
can be specified at compile time (as a compilation switch) and/or at
run time (as an environment variable).  If both are specified, the runtime
value takes precedence.  This parameter does 2 things.  First, it changes
list's behavior so that list does NOT propagate variable attributes.
Pre-list-1.7 unconditionally propagated all variable attributes except
the width attribute.  The 2nd thing the parameter does is enable the -a
runtime switch.  The -a switch asks list to propagate the variable
attributes.  (The -aw switch, above, controls the width attribute).  Thus,
	list_1.7_with_INCLUDE_ATTRIBUTES_SWITCH -a
is the same as
	list_all_versions_including_1.7_without_INCLUDE_ATTRIBUTES_SWITCH




[from readme for list 1.6c]
	The major new features of list 1.6c are described in list_output.doc
and list_exitstatus.doc.  Other features new since list 1.4:

	1) -n switch not needed if output is being sent to a file or pipe


	2) -m switch now allows user to specify the string to be 
	   substituted for "nd".  If the string is not numeric, 
	   it cannot begin with -.

	   This mod has introduced an incompatibility.  list cannot
	   distinguish between
		list -m subst_string object_spec
			and
		list -m object_spec output_spec

	   If there are no other switches that can be put between -m and
	   the object specifier, please explicitly specify the default -m
	   value
		list -m -9999.0 object_spec output_spec


	3) -finishinp specifies that list is to continue to access the object
	   being listed until the object signals EOF (even if, for example,
	   list cannot produce its own output due to, say, a full disk)


	4) -forceheader requires list to output variable list/comment info
	   even if it didn't get any data from the object (unless listing is
	   being done in -b format)
