up-to-date installation instructions (MAC) and some helper functions