note about nullptr default args
diff --git a/docs/advanced.rst b/docs/advanced.rst
index 1c2e4f4..f23ac53 100644
--- a/docs/advanced.rst
+++ b/docs/advanced.rst
@@ -1007,6 +1007,15 @@
     py::class_<MyClass>("MyClass")
         .def("myFunction", py::arg_t<SomeType>("arg", SomeType(123), "SomeType(123)"));
 
+Sometimes it may be necessary to pass a null pointer value as a default
+argument. In this case, remember to cast it to the underlying type in question,
+like so:
+
+.. code-block:: cpp
+
+    py::class_<MyClass>("MyClass")
+        .def("myFunction", py::arg("arg") = (SomeType *) nullptr);
+
 Partitioning code over multiple extension modules
 =================================================