* This enable a user to configure uri in get_xml function

timeit shows a speedup of ~3x on Python 2.7.5 x86_64.
It also makes the code a bit shorter.

Revert "No longer need to reference 'version_added' in docs for these, as this was quite a while ago."

This reverts commit ff0a41d4.

  Migrated all examples: in DOCUMENTATION=''' string to standalone EXAMPLES=''' string
  Added deprecation warning to moduledev.rst and remove deprecated example from it
  Fixed up a few typos and uppercased some acronyms.
  add consistency to how EXAMPLES are formatted

Support the state parameter in the list_vms command to filter the
VM's to list based on their state.

Enable virt module to work with different libvirt connection uris. This allow to work with all libvirt supported VMs.

Examples must use "name" parameter instead of "guest" for virt module, both works though but code explicitly expects name as the guest VM identifier.

 - added terse syntax to modules.rst
 - added description of special variables to template module

module is missing

Make pep8 tests run against the library directory as well, and associated tweaks (mostly to indentation) in the library
directory.

whitespace + remove deprecated YAML parser (migration script lives in examples/scripts and warning was added
in 0.6 release)

Add encoding lines to python modules such that they can take unicode options if they are fed them, since the
AnsibleModule stuff no longer base64 encodes for simplicity and speed reasons.

future

Port the file module over to the new common code infrastructure + cleanup some redundant imports since the module code already imports those things.

Tweak alias consistency a bit.  'package' has never been documented, but since it works, make it work in both places.
'name' is the preferred form.  Similarly, take 'name' for the 'guest' argument to the 'virt' module.

The ohai and facter modules use /usr/bin/logger to log the fact that
they have been invoked.  I added 'import os' to the ping module
so that it could have the same syslog statements as the other modules.
I separated the condensed:
    shlex.split(open(argfile, 'r').read())
into two separate statements similar to the other modules.