
		Green Hills Software Fortran Library

The Green Hills Sofware Fortran Library implements all of the runtime library
functions required by Green Hills Software Fortran compilers.  The Green Hills
Software Fortran Libary is written in the C language.  It can be compiled only
with a Green Hills Software C compiler!

The functions in the Green Hills Software Fortran Library make use of many
standard C Library functions.  These functions must be available to use the
Green Hills Software Fortran Library.  If you have a unix compatible target
system then these functions will certainly be available.  If your target system
is not unix compatible and you do not have some or all of the C Library
functions then you can use the Green Hills Software C Library.

If you have received the Green Hills Software C Library as well as the Green
Hills Software Fortran Library then you must first build the Green Hills
Software C Library.  You must implement, or forgo using anything that depends
on, all of the functions in the "os.c" module.  Some of these functions are
not required by the Green Hills Software C Library itself, they are required
only for the Green Hills Software Fortran Library.  These functions are
documented as such in "os.c".  If someone previously brought up the C Library
you may have to go back and implement those functions to bring the C Library
up to the full level required by Fortran.

The functions in the Green Hills Software Fortran Library make use of many
of the function implemented only in the Green Hills Software Math Library.
In order to use the Green Hills Software Fortran Library you must also
bring up the Green Hills Software Math Library.  It does not require any
customization, just follow the installation instructions included with it.

To bring up the Green Hills Software Fortran Library just compile the C source
files in this directory.  There is no customization required.

	The first complication is that the -X167 (dbnopromotefloat) compile
	time option must be specified when compiling "fmath.c".  The -X167
	compile time option must not be specified when compiling any of the
	other files!

	The second complication is that some of the files include the two
	UNIX include files: <types.h> and <stat.h>.  Samples of these files
	for non-UNIX systems are included in the include directory at the same
	level as this directory.  Under UNIX System V these files appear as
	<sys/types.h> and <sys/stat.h> to solve this problem compile the files
	with the compile time option -I/usr/include/sys.

This directory consists of the following files:

	Fortran Library
		Install all of the object files produced from the `.c' files
		in this directory, except for fnative.c and fcctrl.c, in
		a library in the same manner as the C Library and the Math
		Library.
	
	fcctrl.c:
		This file is to be linked into a program if one wants carriage
		control characters to be interpreted by the library.  If this
		file is not linked into a program carriage control characters
		are output as printable characters.

	fnative.c
		This file should normally be linked into all programs.  If this
		file is not linked into a program then the library will convert
		all floating point numbers passed to it from IEEE floating
		point format to VAX floating point format before writing
		them to unformatted I/O files.  The reverse conversion will
		be done upon reading floating point numbers from unformatted
		I/O files.  This allows reading and writing of VAX unformatted
		data files by machines with IEEE floating point with the same
		byte ordering (little endian) as the VAX (such as NS32000,
		Fairchild Clipper, Intel 386, Weitek XL).  This option can cause
		overflows, underflows, and loss of precision in unformatted
		I/O.  It should only be ommitted by programs which originally
		were compiled for the VAX and must use existing unformmatted
		data files.
