Fixing formatting, mistargets, and terminology

Fixing:

    - Standardizing on formatting:
        CLI Example:    -> CLI Example::
        Usage::         -> CLI Example::

    - Making sure all function names match their examples

    - Other minor formatting issues
Adding missing docstrings and examples
Merge branch 'develop' of https://github.com/blast-hardcheese/salt into blast-hardcheese-develop

Conflicts:
	salt/modules/cron.py
	salt/modules/pip.py
	salt/modules/selinux.py
Targetting->Grains did not actually document how to target minions based on grains data.
Merge pull request #1219 from vitaliyf/develop

Targeting->Grains did not actually document how to target minions based on grain information.
Add an "osxdesktop" module that implements functions in a new virtual
"desktop" virtual module, such as lock, screensaver, get_output_volume,
and set_output_volume
Merge pull request #1220 from msabramo/osxdesktop

Add an "osxdesktop" module
setup.py falls down, does boom when building package for Debian Squeeze
Merge pull request #1221 from 0xDEC0DE/develop

setup.py falls down, goes boom when building package for Debian Squeeze
ignore code coverage outputs

Added code coverage outputs genereated by
coverage.py to .gitignore .  To generate code
coverage report, run this command:

  coverage run tests/runtests.py

To produce HTML coverage repot (`htmlcov/index.html`):

  coverage html --omit=tests/*

To produce Cobertura compliant XML for Jenkins:

  coverage xml --omit=tests/*
Merge pull request #1222 from baijum/code_coverage_outputs

ignore code coverage outputs
The current error message when salt is configured (as it is by default) to run as root suggests that salt can _only_ be run as root. Change this to point out that it is simply unable to switch to the target user and thus suggest that the user can be changed via configuration.
Added methods to shadow to set max days, min days, warn days, and inactive days.
Merge pull request #1228 from jeamland/patch-1

Make it clearer that a user-switch error can be solved through a configuration change
Merge pull request #1229 from knine/develop

Added methods to set max days, min days, warn days, and inactive days
Make onlyif and unless run with the same settings as the cmd itself.

The unless and onlyif checks should be executed with the same working
directory, user, group, shell, and environment as the command itself.
Take this example for instance:

createuser --no-superuser --no-createdb --no-createrole joe:
  cmd.run:
    - unless: psql --tuples-only -c 'SELECT rolname FROM
              pg_catalog.pg_roles;' | grep '^joe$'
    - user: postgres

Before this fix this state will fail during the unless check since its
beeing executed by root in a normal PostgreSQL setup.

In addition a bug where the effective gid was not reset when the
state returned early was fixed.
Merge branch 'develop' of git://github.com/saltstack/salt into develop
Merge pull request #1230 from uggedal/develop

Make onlyif and unless run with the same settings as the cmd itself.
updated salt.spec to use 0.9.9.1
Seeing if we can get pkgng to work with salt