From 754273b0a055cbbd14ef43a86d70bbc5ed00cdad Mon Sep 17 00:00:00 2001
From: Gary Russell <grussell@gopivotal.com>
Date: Wed, 14 Aug 2013 17:31:48 -0400
Subject: [PATCH] INT-3102 Document File DirectoryScanner Limitation

Must be prototype if used in multiple places.
---
 src/reference/docbook/file.xml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/reference/docbook/file.xml b/src/reference/docbook/file.xml
index 6491570c1f..1a388847a1 100644
--- a/src/reference/docbook/file.xml
+++ b/src/reference/docbook/file.xml
@@ -149,6 +149,14 @@
         <para>
             This gives you full freedom to choose the ordering, listing and locking strategies.
         </para>
+        <important>
+            It is important to understand that filters (including patterns, regex, prevent-duplicates etc) and lockers,
+            are actually used by the scanner. Any of these attributes set on the adapter are subsequently injected into the
+            scanner. For this reason, if you need to provide a custom scanner and you have multiple file inbound adapters
+            in the same application context, each adapter must be provided with its own instance of the scanner, either
+            by declaring separate beans, or declaring <code>scope="prototype"</code> on the scanner bean so that the
+            context will create a new instance for each use.
+        </important>
         <section id="file-tailing">
           <title>'Tail'ing Files</title>
           <para>