read:

Syntax:	read ( "filename" )
	read ( "filename" , L )

Description:

	read() reads the file identified by the "filename". The file
	is opened with read access, and all of the contents are read.
	The file identified by the 1st argument must contain data that
	is in RLaB format.  The entities in the file are installed in
	the global symbol table, overwriting any existing
	entities. Upon completion the file is closed.

	Example:

		read("bunch_of_data_in_a_file");

	The second form of the read function allows the data in the
	file to be read into a list variable L. The
	global-symbol-table is untouched (except for L).

	Example:

		read("bunch_of_data", X);

	The contents of the file `bunch_of_data' are read and stored
	in the list variavle X. Except for the creation/modification
	of the variable X, the global-symbol-table is unchanged.

See Also: FILES, close, getline, open, readb, readm, write, writeb, 
          writem

Future Enhancements:

	read() should have the option to list the contents of a file
	without actually reading them into the symbol table. 
