This is a Sphinx extension that implements the c:header
directive that
is inadvertently absent from Sphinx's built-in C domain. It works
similarly to the built-in py:module
directive.
At the beginning of the description of a header file in your documentation,
insert a corresponding c:header
directive as follows:
.. c:header:: <libfoobar.h>
The aforementioned creates an index entry of: libfoobar.h (C header).
For a real usage example, see the http://libcpr.org documentation. The corresponding Sphinx sources can be found at: https://github.com/dryproject/libcpr/tree/master/doc/manual
Refer to the PyPI Tutorial for installation instructions. If you have a modern Python environment, installation should be as easy as:
$ sudo pip install sphinxcontrib-cheader
To enable the extension, edit your Sphinx conf.py
configuration file to
include the extension name in the extensions
list; for example:
extensions = ['sphinxcontrib.cheader']
This is free and unencumbered public domain software. For more information,
see http://unlicense.org/ or the accompanying LICENSE
file.