On Wed, 19 Jun 2019 12:42:39 +0200 Peter Zijlstra <peterz@xxxxxxxxxxxxx> wrote: > No, the other way around, Sphinx can recognize local files and treat > them special. That way we keep the text readable. > > Same with that :c:func:'foo' crap, that needs to die, and Sphinx needs > to be taught about foo(). I did a patch to make that latter part happen, but haven't been able to find the time to address the comments and get it out there. It definitely cleaned up the source files a lot and is worth doing. Will try to get back to it soon. The local file links should be easy to do; we shouldn't need to add any markup for those. jon
