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

Reply via email to