[PATCH 0/3 v2] docs: function automarkup, now with 80% fewer regexes!

From: Jonathan Corbet
Date: Fri Jun 21 2019 - 19:52:13 EST


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