The directory structure is as follows:

  [A-Z]*/		     - hand-written platform-independent plugin source
  generated/		     - automatically generated VM source
  generated/*Plugin.c	     - automatically generated plugin source
  generated/LargeIntegers.c  - automatically generated plugin source
  unix/			     - hand-written Unix-specific VM source
  unix/[A-Z]*/		     - hand-written Unix-specific plugin source

Note that hand-written plugin source files must be in directories
whose names begin with a capital letter, and generated plugins in
files called "generated/*Plugin.c", in order for configure to
recognise them.  (With the exception of "generated/LargeIntegers.c",
since there always has to be someone who likes to make life difficult
by being different.)

"configure" (or more specifically the script "unix/util/mkfrags")
understands the following relationship: that

		generated/FooPlugin.c
	and	generated/sqFooPrims.c	(if present)
	and	unix/sqUnixFoo.c	(if present)

all belong to the same plugin "Foo.so".  It would make life *way* too
cosy if all future plugins and/or generated primitives and/or Unix
support were to continue in the same tradition.

					- Ian Piumarta, 12 August 2000
