updated docu, readme, examples