allow apt-key module to work with binary key

Fix `mongodb_user` compatibility with MongoDB 2.2 (used in Debian 7).

Allow inventory to be read from a pipe

Add Solaris O/S distribution facts

docs fix ansible cfg loading order

fixed msg bug in library/cloud/quantum_network

Signed-off-by: Jochen Maes <jochen@sejo-it.be>

Expand sudo_user after variable merging

Document: with_file(glob) relative path and roles

Improve Markdown (and other) module doc output

Conflicts:
	library/system/user

first cut and docs for facts.d mechanism for setup module

openbsd_pkg: Add check_mode support.

Document the data argument for apt_key

implementing with_items list globbing made easier for modules

Fixing documentation error

Fix MySQL 5.6 compatibility

HP-UX virtualization facts

Fixed Issue #3193 - make rhn_register module compatible with EL 5

Conflicts:
	library/web_infrastructure/django_manage

setup epoch time doesn't have tics on Python 2.6.4 (Solaris).

hardcoded lists in ansible code, just add WITH_ITEMS_USES_LIST in a
comment anywhere, and of course, support recieving params as list.

Signed-off-by: Brian Coca <briancoca+dev@gmail.com>

  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

this works well for 'initial password setting' on user creation and avoids
having extra tasks and conditionals.
Signed-off-by: Brian Coca <briancoca+dev@gmail.com>

The biggest change has been to package_latest since it was previously
just comparing version numbers before and after an upgrade had run.
We now parse the output from a dry run instead.

Thanks to Johan Belin for triggering the discussion :).

docfix on file module, aliases for path parameter

- The html_ify filter now escapes HTML found in module documentation.
  THIS COULD AFFECT MORE THAN JUST MARKDOWN but I didn't see any modules
  expecting to use e.g. HTML entities or HTML tags in their
  documentation.

- The markdown_ify filter (used as jpfunc in markdown.j2) escapes at
  least a few Markdown in-line formatting characters.

- Improvements to markdown.j2:

    - Call jpfunc on the module name heading so that it gets escaped for
      Markdown (e.g. my_module_name becomes my\_module\_name).

    - Added paragraph breaks between paragraphs in the description.

    - Added examples heading, which is consistent with the notes heading
      below it.

Document that with_file and with_fileglob path is relative to
the files directory inside of a role.

Previous commit c3659741 expanded sudo_user during task construction,
but this is too early as it does not pick up variables set during
the play.

This commit moves sudo_user expansion to the runner after variables
have been merged.