[<prev] [next>] [thread-next>] [day] [month] [year] [list]
Message-Id: <20190626172859.16113-1-corbet@lwn.net>
Date: Wed, 26 Jun 2019 11:28:55 -0600
From: Jonathan Corbet <corbet@....net>
To: linux-doc@...r.kernel.org
Cc: Mauro Carvalho Chehab <mchehab+samsung@...nel.org>,
Jani Nikula <jani.nikula@...ux.intel.com>,
linux-kernel@...r.kernel.org, Jonathan Corbet <corbet@....net>
Subject: [PATCH v3 0/4] docs: Automatically mark up function references
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
Powered by blists - more mailing lists