updated docu, less typos, more style