cleanup some of the incorrect info in docstrings and add the debian/ubuntu pkg install example in in readme