add note about custom type casters (fixes #480)
diff --git a/docs/advanced/cast/custom.rst b/docs/advanced/cast/custom.rst
index 50b07db..c854e7f 100644
--- a/docs/advanced/cast/custom.rst
+++ b/docs/advanced/cast/custom.rst
@@ -77,3 +77,9 @@
             }
         };
     }} // namespace pybind11::detail
+
+.. warning::
+
+    When using custom type casters, it's important to declare them consistently
+    in every compilation unit of the Python extension module. Otherwise,
+    undefined behavior can ensue.