made some stylistic changes, added a few more examples, and expanded several descriptions in the new man-style docstrings
made some stylistic changes, added a few more examples, and expanded several descriptions in the new man-style docstrings

fedora-conary/conary,fedora-conary/conary,fedora-conary/conary,fedora-conary/conary,fedora-conary/conary