[camel] 01/05: Add notice about the suppression of the extended placeholders

[gn...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

gnodet pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/camel.git

commit ec465ce731f1150153be3eace50212fc33786f5a
Author: Guillaume Nodet <gn...@gmail.com>
AuthorDate: Wed Feb 12 15:58:13 2020 +0100

    Add notice about the suppression of the extended placeholders
---
 .../modules/ROOT/pages/camel-3x-upgrade-guide.adoc | 44 ++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/docs/user-manual/modules/ROOT/pages/camel-3x-upgrade-guide.adoc b/docs/user-manual/modules/ROOT/pages/camel-3x-upgrade-guide.adoc
index 97f5daf..957a6c3 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-3x-upgrade-guide.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-3x-upgrade-guide.adoc
@@ -445,3 +445,47 @@ Remove the method `getProcessors` from `Pipeline` as you should use the `next` m
 The `@Experimental` annotation is moved from `meta-annotations` JAR to `camel-api`
 and moved from package `org.apache.camel.meta` to `org.apache.camel`.
 And the meta-annotations has been removed.
+
+==== Property Placeholders
+
+The support for out-of-band property placeholders has been removed.
+This means that XML that were using the `http://camel.apache.org/schema/placeholder`
+namespace and that the java builders using the `.placeholder(key, value).` have to
+be modified.
+
+[source,java]
+----
+    from("direct:start")
+        .multicast()
+        .placeholder("stopOnException", "stop")
+        .to("mock:a")
+----
+should be rewritten as:
+[source,java]
+----
+    from("direct:start")
+        .multicast()
+        .stopOnException("{{stop}}")
+        .to("mock:a")
+----
+
+and
+[source,xml]
+----
+   <route>
+        <from uri="direct:start"/>
+        <multicast prop:stopOnException="stop">
+            <to uri="mock:a"/>
+        </multicast>
+    </route>
+ ----
+should be rewritten as:
+[source,xml]
+----
+   <route>
+        <from uri="direct:start"/>
+        <multicast stopOnException="{{stop}}">
+            <to uri="mock:a"/>
+        </multicast>
+    </route>
+ ----