diff --git a/Doc/using/configure.rst b/Doc/using/configure.rst index 50812358a690c3..fc08b7d134234d 100644 --- a/Doc/using/configure.rst +++ b/Doc/using/configure.rst @@ -813,6 +813,17 @@ also be used to improve performance. See the ``PyDoc_STRVAR()`` macro. + .. note:: + + Disabling doc strings also means that :func:`inspect.signature` cannot + retrieve signatures for built-in functions and methods implemented in C, + since the signatures for these functions are embedded in their docstrings + (generated by `Argument Clinic + `_). This may + affect tools and libraries that rely on introspecting built-in callables, + such as :func:`help` and some third-party frameworks. + + .. option:: --enable-profiling Enable C-level code profiling with ``gprof`` (disabled by default).