makefile and docs changes