The following files are included in bliss.zip:

	Readme.txt		this file

	code.bli		compiler sources
	cswo.bli
	debug.bli
	declar.bli
	delay.bli
	driver.bli
	fin2ls.bli
	final.bli
	finlst.bli
	flowan.bli
	glodec.bli
	io.bli
	lexan.bli
	listc.bli
	lstpkg.bli
	mem.bli
	ncse.bli
	once.bli
	print.bli
	reshuf.bli
	syntax.bli
	t.b11
	tables.bli
	tnbind.bli
	tnlow.bli
	try.bli

	bliss.req		compiler include files
	errcodes.req
	errmsg.req
	externals.req
	final_tables.req
	rms.req
	room.req
	routines.req

	bliss-11.cld		command definition for B11 command

	makefile.com		script to compile and link bliss-11.exe

	e.b11			sample bliss-11 programs
	x.b11

The compiler is written in BLISS-64.  A BLISS-64 compiler may be
freely obtained from most DECUS web sites.  To compile and link
the BLISS-11 compiler, enter the command:

	@makefile

This is a not very smart make file but gets the job done.

To define the 'B11' command to execute the compiler, enter:

	SET COMMAND BLISS-11

If the location is the compiler should change from the current
directory then BLISS-11.CLD will have to be editted.

To use the compiler:

	B11 [switches] file

where the available switches are:

	/[NO]ZIP		generate code for speed rather than size

	/[NO]DEBUG		generate debug code

	/[NO]MARK		disable CSE recognition across mark points

	/[NO]STATISTICS		display statistics at end of compilation

	/[NO]ERRORS		write errors to the diagnostics file only

	/[NO]QUICK		enable fast compile

	/[NO]HYDRA		generate code for hydra

	/[NO]FINAL		enable (default) the 'final' phase

	/[NO]I_D		generate code for separate I and D spaces

	/[NO]PEEP		enable (default) peephole optimizations

	/[NO]EXPAND		show expanded macros in list file

	/[NO]UNAMES		generate unique names for symbols

	/[NO]PIC		generate position independent code

	/[NO]PAGE		pagenate list file

	/[NO]SHUFFLE		enable (default) register shuffling

	/[NO]OPTIMIZE		enable (default) certain optimizations

	/LIST=file		write the generated listing to the given file.
				the listing is written to sys$output
				by default.

	/DIAGNOSTICS=file	write error messages to the given file.
				diagnostics are written to sys$output
				by default.

	/DUMP=dump_type		dump the internal tables after the
				given phases.  The phases are FLOWAN,
				DELAY, TNBIND, and ALL.

The output of the compiler consists of a listing of the original
BLISS-11 source followed by an assembly language listing.  The
compiler does not generate any object code.

Caveats:

	the REQUIRE declaration has not been implemented.  Many
	language features have not been suitably tested.