doctor: share/python no longer needed in PATH

Check for HOMEBREW_PREFIX/share/python and python3
in PATH and tell about the new location and that
files from there can be removed. Also instructions
on how to upgrade python packages are given.