lots of improvements to build script behaviour and clarifications and more information in README.md