Fixes #8806

Fixes #8535

Looks like #6881 is also affected by this bug.

Currently when using lineinfile insertafter=EOF for a file that has no newline then the added line is not prefixed with a newline.
As a concrete example, ubuntu distro default /etc/ssh/sshd_config has no newline so lineinfile module cannot be used to add a new line to the end of the file.

directory

Fixes #5679

This reverts commit 2bfaacd1.

Fixes #6821

passed via this paramter is not passed via shell and so all shell features
will not work.

Added highlighting to parameter references in docs so that they standout a bit better.

The validate option is constructed similarly to the template command's
validate option. TestRunner.py has been updated to include two new
tests, one for passing and one for failing validation.

Closes #3992

Line in file would raise a TypeError exception if
the 'line' key was in params, but its value was None.

  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

Change a lineinfile example from /etc/host to /etc/hosts

instead of writing directly to original
Signed-off-by: Brian Coca <briancoca+dev@gmail.com>

A little more unit testing.

Added the backrefs parameter to the lineinfile module.
Added tests for the backrefs functionality of the lineinfile module.

Both modules seboolean and zfs have not been adapted since they defer from the default (either by having a 'null' or special state, or prefering "on"/"off" for state indication.