update of the README + various debug + code cleanup