doc and Makefile updates