apt.py: clarify warnings when python-software-properties is absent
Improve pkgrepo documentation

Formatting fixes, as well as the addition of a recommendation to install
python-software-properties on Ubuntu.
Merge pull request #8330 from terminalmage/issue8321

pkgrepo warnings/documentation improvements