[RFC PATCH 0/4] doc: use Hawkmoth for API documentation

Jani Nikula jani at nikula.org
Sun Aug 20 12:30:35 PDT 2017


Hawkmoth [1] is a minimalistic Sphinx C Domain autodoc directive
extension to incorporate formatted C source code comments into Sphinx
based documentation, by yours truly. See commit message of patch 2 for
details.

This series is probably more a real world test case for Hawkmoth than a
serious attempt at getting it merged to Notmuch. Nonetheless, I decided
to post it as food for thought. With hopes that one day it'll be a
serious and compelling alternative for Sphinx based C API documentation.

'make sphinx-html' is probably more interesting than 'make build-man'.

BR,
Jani.


[1] https://github.com/jnikula/hawkmoth


Jani Nikula (4):
  doc: add man section 3 handling
  doc: use hawkmoth for generating libnotmuch api documentation
  lib: fix the biggest hawkmoth offenders in notmuch.h
  lib: add reStructuredText bling for API documentation in notmuch.h

 doc/Makefile.local      |  10 ++--
 doc/conf.py             |  14 +++++
 doc/index.rst           |   1 +
 doc/man3/libnotmuch.rst |  20 +++++++
 lib/notmuch.h           | 139 ++++++++++++++++++++++++++----------------------
 5 files changed, 117 insertions(+), 67 deletions(-)
 create mode 100644 doc/man3/libnotmuch.rst

-- 
2.11.0



More information about the notmuch mailing list