fixes #2235: fix docs for directive replace:false

As discussed in #2235, the documentation for how directives behave regarding `replace: false` falls short of explaining what will happen to the contents of the current element.

This pull request has a minor change to the documentation to make explicit what happens in this case.