fix readme instructions
tweaks to manuscript; makefile does not restore cache by default