From eec6394a342fb92fba5270eee11c83f1d895e9fb Mon Sep 17 00:00:00 2001
From: Tobias Bosch <tbosch1009@gmail.com>
Date: Wed, 21 May 2014 16:02:34 -0700
Subject: [PATCH] docs($compile): deprecate `replace` directives

BREAKING CHANGE:

The `replace` flag for defining directives that
replace the element that they are on will be removed in the next
major angular version.
This feature has difficult semantics (e.g. how attributes are merged)
and leads to more problems compared to what it solves.
Also, with WebComponents it is normal to have custom elements in the DOM.
---
 src/ng/compile.js | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/ng/compile.js b/src/ng/compile.js
index 698f1d801117..e5f77f148e5c 100644
--- a/src/ng/compile.js
+++ b/src/ng/compile.js
@@ -59,7 +59,6 @@
  *       template: '<div></div>', // or // function(tElement, tAttrs) { ... },
  *       // or
  *       // templateUrl: 'directive.html', // or // function(tElement, tAttrs) { ... },
- *       replace: false,
  *       transclude: false,
  *       restrict: 'A',
  *       scope: false,
@@ -248,7 +247,7 @@
  * api/ng.$sce#getTrustedResourceUrl $sce.getTrustedResourceUrl}.
  *
  *
- * #### `replace`
+ * #### `replace` ([*DEPRECATED*!], will be removed in next major release)
  * specify where the template should be inserted. Defaults to `false`.
  *
  * * `true` - the template will replace the current element.