Yes they can work together. I presented on that at the Summit, you should have been there.
On Thu, May 2, 2019 at 9:15 AM Leif Hedstrom <zw...@apache.org> wrote: > +1 on docs. > > However , I think it’s a bit of a mess now with Doxygen sometimes, and > normal Sphinx docs (most of the time?). It seems we should have one way of > documenting our interfaces and APIs, no? I find often times, Doxygen can > get in the way of code formatting / indentation, specially when inlined. I > really dislike that. > > It’s probably time to decide. If we decide to go Full R on Doxygen, > someone has to shepherd that and start working on it. If not, I think we > should drop all Doxygen in favor of just Sphinx. Unless Sphinx and Doxygen > work together in some way that is above my pay grade ? > > — Leif > > Found this: https://breathe.readthedocs.io/en/latest/ > > > On May 2, 2019, at 06:19, Alan Carroll > <solidwallofc...@verizonmedia.com.invalid> wrote: > > > > They shouldn't become invalid during the callback invocation, but may > after > > the callback returns. > > > > As for Doxygen, perhaps I am simply weird in that I like to have > > documentation for API that I call. I guess I'm just not smart enough to > > deduce the meaning and function from only the function and parameter > names. >
