revised and expanded readme file