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.

Fix broken link in django_manage doc

Protect None value in setup module (ansible 1.2)

Fix a typo in the docs.

Fixed module rhn_register name in examples section

Examples showed that modules name is rhnreq_ks, when it actually is rhn_register.