updated defs and readme