[salt] clean up and document

clean up for pep8 and document uptodate
Be more explicit in the pacman module

If we are going to be more explicit, we should be more explicit
throughout the entire thing.  From issue 10519.