makefile, readme, and some doc changes