Added top level makefile, update text
Added top level makefile, update text

Mostly clean up of comments for some function headers.
Top level make file supports make check.

jnealtowns/infra,jnealtowns/infra,jnealtowns/infra