From c6500aec7f8d7e1439b793e97ec0814bdaa59d96 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Johan=20Andre=CC=81n?= Date: Mon, 9 Nov 2015 16:21:04 +0100 Subject: [PATCH] =doc 18878 Document gotcha about missing tilde --- akka-docs-dev/rst/scala/http/routing-dsl/directives/index.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/akka-docs-dev/rst/scala/http/routing-dsl/directives/index.rst b/akka-docs-dev/rst/scala/http/routing-dsl/directives/index.rst index 5c434fc5b5..cf5945c7b5 100644 --- a/akka-docs-dev/rst/scala/http/routing-dsl/directives/index.rst +++ b/akka-docs-dev/rst/scala/http/routing-dsl/directives/index.rst @@ -138,6 +138,9 @@ transformations, both (or either) on the request and on the response side. Composing Directives -------------------- +.. note:: Gotcha: forgetting the ``~`` (tilde) character in between directives can often result in perfectly valid + Scala code that compiles but lead to your composed directive only containing the up to where ``~`` is missing. + As you have seen from the examples presented so far the "normal" way of composing directives is nesting. Let's take a look at this concrete example: