NOTE:  These tests test ONLY the parsing of the control file; they do
not test that the GCT does what the control file tells it; that's done
elsewhere.   (Tests are somewhat sketchy.)

NOT ERRORS:
	Mixing options and instrumentation (they're the same thing).
	Duplicate filenames, clashing options (setting and turning off
		in same option statement, for example):  results undefined.

Here are the parameters used in designing the tests:


Control file:	present/absent
Control file:	empty, non-empty

Comments:	none, whole-line, partial line.
Comments:	First char in file

White space:	before (, after (, before ), after ), before -, after -,
		before filename, after filename, before option
		keyword, after option keyword, before instrumentation
		keyword, after instrumentation keyword, before routine 
		keyword, after routine keyword.

No White space:	before (, after (, before ), after ), before -, after -,
		before filename, before option
		keyword, before instrumentation
		keyword, before routine keyword


			TOP LEVEL

top-level option directive / none
top-level instrumentation directive / none
no file description / singleton file / -file / parenthesized file

Top-level Option directive:  empty, keyword alone, one option, two
		options, unterminated. 
Top level option:	negated, unnegated
Top-level Instrumentation directive:  empty, keyword alone, one option, two
		options, unterminated
Top level instrumentation:	negated, unnegated

file-description:  empty, unterminated, file-only, more than just file.
With "routine" keyword in file-level directive.


			FILE LEVEL

file-level option directive / none
file-level instrumentation directive / none
no routine description / singleton routine / -routine / parenthesized routine

File-level Option directive:  empty, keyword alone, one option, two
		options, unterminated. 
File level option:	negated, unnegated
File-level Instrumentation directive:  empty, keyword alone, one option, two
		options, unterminated
File level instrumentation:	negated, unnegated


routine-description:  empty, unterminated, file-only, more than just file.
routine-description:  with "routine" keyword / without.


			ROUTINE LEVEL

routine-level option directive / none
routine-level instrumentation directive / none
Further level of parenthesis nesting.

routine-level Option directive:  empty, keyword alone, one option, two
		options, unterminated. 
routine level option:	negated, unnegated
routine-level Instrumentation directive:  empty, keyword alone, one option, two
		options, unterminated
routine level instrumentation:	negated, unnegated


			OPTIONS:

FILES:	default off, settable only at global level.
INSTRUMENT:  default on; settable at file level, routine level.
MACROS:  default: off; settable at global and file level.
instrumentation	#illegal

			INSTRUMENTATION 

loop 
branch
multi 
operator 
operand 
routine
cliche 
flavor
flavors		#illegal.
