to convert some routines to functions
to update the README to reflect recent changes