Add name mangling problems and solutions to readme

tidy-up readme file a bit