Replace:false in directive doesn't "append" as documented

[JakobJingleheimer]

According to the documentation:

replace - if set to true then the template will replace the current element, rather than append the template to the element.

As identified by #2235, the documented behaviour does not match the actual current behaviour.

[petebacondarwin]

Hi @jshado1 - Thanks for submitting this pull request. Unfortunately there are a number of problems.

It is failing numerous tests: see https://travis-ci.org/angular/angular.js/builds/6431249.
It would also need to have new unit tests to demonstrate the issue it is solving.
We also need you to sign the CLA and to commit message would need to be fixed up.

At the moment it is not in a state to merge. Can you fix this and provide a new PR instead?

[JakobJingleheimer]

@petebacondarwin I submitted the CLA.

Hoping to discuss proposed changes in the issue I opened for this: #2235