minor tweaks to readme, makefile
design notes