Hi guys,

my 2p about that if you don't mind.

I think that ideally, we should try to find a way to pass the doxygen documentation into Sphinx.

If it is too much work to figure out, then of your 3 variants,  (3) would be my preferred choice because it puts the documentation as close to the code that is actually documented, i.e. the wrapped C++ code. If the code has already been structured as your (1), this is most likely because the Python function does more than the C++ function, and the documentation should be in the overriden Python function then. Your variant (2) is just too ugly to my taste.

Best wishes,

Luc


_______________________________________________
cctbxbb mailing list
cctbxbb@phenix-online.org
http://phenix-online.org/mailman/listinfo/cctbxbb