It took me a loooong time to get back to this, but here's another crack at automatically marking up "function()" so we can get rid of all that unsightly :c:func: gunk in our docs. This time, it's implemented as a pass over the doctree after everything's read and the references resolved, and the result is certainly far more robust than my first attempt. Jonathan Corbet (3): Docs: An initial automarkup extension for sphinx docs: remove :c:func: annotations from xarray.rst kernel-doc: Don't try to mark up function names Documentation/conf.py | 3 +- Documentation/core-api/xarray.rst | 270 ++++++++++++++--------------- Documentation/sphinx/automarkup.py | 80 +++++++++ scripts/kernel-doc | 2 +- 4 files changed, 218 insertions(+), 137 deletions(-) create mode 100644 Documentation/sphinx/automarkup.py -- 2.21.0
