Replace - Clarified regex docs

[EvanK]

SUMMARY

Clarified the ramifications of python's MULTILINE modifier, as well as negated character sets and the unexpected effects they can have in matching across multiple lines (see #26712).

ISSUE TYPE

• Docs Pull Request

COMPONENT NAME

replace module

ANSIBLE VERSION

ansible 2.2.0.0
  config file = /Users/ekaufman/.ansible.cfg
  configured module search path = Default w/o overrides

[ansibot]

The test ansible-test sanity --test ansible-doc --python 2.6 failed with the following error:

Command "ansible-doc replace" returned exit status 1.
>>> Standard Error
[ERROR]: unable to parse
/root/src/github.com/ansible/ansible/lib/ansible/modules/files/replace.py
ERROR! module replace missing documentation (or could not parse documentation): Parsing produced an empty object.

The test ansible-test sanity --test ansible-doc --python 2.7 failed with the following error:

Command "ansible-doc replace" returned exit status 1.
>>> Standard Error
[ERROR]: unable to parse
/root/src/github.com/ansible/ansible/lib/ansible/modules/files/replace.py
ERROR! module replace missing documentation (or could not parse documentation): Parsing produced an empty object.

The test ansible-test sanity --test ansible-doc --python 3.5 failed with the following error:

Command "ansible-doc replace" returned exit status 1.
>>> Standard Error
[ERROR]: unable to parse
/root/src/github.com/ansible/ansible/lib/ansible/modules/files/replace.py
ERROR! module replace missing documentation (or could not parse documentation): Parsing produced an empty object.

The test ansible-test sanity --test ansible-doc --python 3.6 failed with the following error:

Command "ansible-doc replace" returned exit status 1.
>>> Standard Error
[ERROR]: unable to parse
/root/src/github.com/ansible/ansible/lib/ansible/modules/files/replace.py
ERROR! module replace missing documentation (or could not parse documentation): Parsing produced an empty object.

The test ansible-test sanity --test validate-modules failed with the following error:

lib/ansible/modules/files/replace.py:60:1: E302 DOCUMENTATION is not valid YAML

click here for bot help