documentation and makefile fixes