added note about args/kwargs limitation
diff --git a/docs/advanced.rst b/docs/advanced.rst
index 2e647ca..3ebf83e 100644
--- a/docs/advanced.rst
+++ b/docs/advanced.rst
@@ -1546,6 +1546,11 @@
provided. Please refer to the other examples for details on how to iterate
over these, and on how to cast their entries into C++ objects.
+.. warning::
+
+ Unlike Python, pybind11 does not allow combining normal parameters with the
+ ``args`` / ``kwargs`` special parameters.
+
Partitioning code over multiple extension modules
=================================================