For the record, I hope that this is the version I will actually merge. It
adds an extension to automatically recognize references to functions and
create cross references for them, eliminating the need to use the unsightly
:c:func:``function`` notation.
Since v2 little has happened:
- Expand the skip list of system-call names that we shouldn't even
try to mark up.
- Improve the comments in the extension code slightly
- Add a paragraph to the doc-guide discouraging use of :c:func:
Jonathan Corbet (4):
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
docs: Note that :c:func: should no longer be used
Documentation/conf.py | 3 +-
Documentation/core-api/xarray.rst | 270 ++++++++++++++---------------
Documentation/doc-guide/sphinx.rst | 13 +-
Documentation/sphinx/automarkup.py | 93 ++++++++++
scripts/kernel-doc | 2 +-
5 files changed, 239 insertions(+), 142 deletions(-)
create mode 100644 Documentation/sphinx/automarkup.py
--
2.21.0
