		A NAMELIST emulator for VAX FORTRAN

The NAMELIST emulator for VAX FORTRAN is intended to provide an easy-to-use
namelist function similar to that available from IBM, CDC, and Cray Research,
among others.  A comprehensive set of instructions is provided in the file
NAMELIST.HLP, which is suitable for inclusion in the system help library;
however, these instructions assume familiarity with namelists in general.

Some of the salient points concerning the use of this emulator are:

	Usage of the emulator consists of the following steps:
	    1) A call to NAMELIST is made to initialize the namelist
		table for a given namelist group
	    2) A call to READNAME is made to read from the namelist
		input stream
	    3) A call to WRITENAME is made to write to the namelist
		output stream

	All VAX FORTRAN numerical data types are supported.

	Character and Hollerith strings are not supported.

	Only arrays of one dimension with a lower bound of 1 are
	    currently supported and no bounds checking is done.

	Any group names declared in a NAMELIST call are global and
	    must be unique.  An effect of this is that multiple calls
	    to NAMELIST with the same group name are ignored.
	    Variable names are local to a particular namelist group
	    and may appear elsewhere.

	String literals which are used in namelist calls should be just
	   that, literals, since the emulator stores only their addresses
	   and does not copy them.  If character variables are used they
	   should not be modified or else unpredictable behavior may result.

	Names of variables or group names must appear in the namelist
	   input stream, and in calls to READNAME or WRITENAME, exactly
	   as they were declared in the NAMELIST call since no lower to
	   upper conversion or blank stripping is done.

	The optimizer in the Version 1 compiler as been know to store
	   a temporary variable and reassign it after a READNAME call
	   is made, hence overwriting the read in value.  This is a
	   rare occurence and a test has not yet been made to see if it
	   occurs with Version 2.  If it does occur, try /NOOP for that
	   module or explicitly declare a COMMON containing the variable
	   to force the optimizer to leave it alone.


Despite this long list of restrictions and qualifications, the namelist
emulator is very easy to use and should help in the conversion of codes
brought to the VAX from other machines and in applications requiring
a namelist function.

This release consists only of a binary library (NAMELIST.OLB) since the
emulator is being revised to remove many of the above restrictions, and
since the code is occasionally messy.  The library NAMEV1.OLB contains a
VMS V1 library for those not running Version 2.  It is identical except
for lack of COMPLEX*16 support.  Neither library can be used with G_floating
variables. If anyone finds any bugs or has any suggestions please notify
me at the address below so the next version of the emulator can be
improved.

	Capt Randall G Rushe
	AFWL/ARLO
	Kirtland AFB, NM  87ll7

	(505) 844-2496
