swig 4 has doxygen support
Swig 4.0 introduced a -doxygen
flag that allows converting doxygen comments into pydoc for automatic attachement to the bindings. It would be great to enable this. It will require some important reviewing work, because several of the comments are C++ specific.