improved documentation and install confirmation on OSX