cosmetic improvemrnts

plus a little bit more in-code documentation