documentation and somw minor tweaks to the Makefile