extensively commented lib/<filename>.txt files added;  all code changes commented