Skip to main content

Build Status Coverage Code Style Documentation Status

Dual-licensed under MIT or the UNLICENSE.

A basic attempt at extending Sphinx and autodoc to work with C files.

The idea is to add support for similar directives that autodoc provides. i.e.

A function in my_c_file.c:

/**
 * A simple function that adds.
 *
 * @param a: The initial value
 * @param b: The value to add to `a`
 *
 * @returns The sum of `a` and `b`.
 *
 */
int my_adding_function(int a, int b) {
    return a + b;
    }

Could be referenced in documentation as:

.. autocfunction:: my_c_file.c::my_adding_function

With the resulting documentation output of:

int my_adding_function(int a, int b)

A simple function that adds.

Parameters:
  • a - The initial value

  • b - The value to add to a

Returns:

The sum of a and b

Requires

Similar Tools

  • hawkmoth a sphinx extension that which will document all of a C file. It supports being able to regex list files and have those files be documented.

  • breathe A doxygen output to sphinx tool.

Full Documentation

The complete documentation can be found at https://sphinx-c-autodoc.readthedocs.io/en/latest

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphinx_c_autodoc-1.7.0.tar.gz (32.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sphinx_c_autodoc-1.7.0-py3-none-any.whl (35.8 kB view details)

Uploaded Python 3

File details

Details for the file sphinx_c_autodoc-1.7.0.tar.gz.

File metadata

  • Download URL: sphinx_c_autodoc-1.7.0.tar.gz
  • Upload date:
  • Size: 32.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for sphinx_c_autodoc-1.7.0.tar.gz
Algorithm Hash digest
SHA256 e2e4d2014816ca99278b0a827e31144b62e5bb9fa4ac9b53635bf1fe50c6863c
MD5 0acf5ac510b187f8da04e7d052eac5ce
BLAKE2b-256 6bc13246a8e43c2915b4e732ab2c80995d4a7fdc62d962121424a9e50ac0ecb3

See more details on using hashes here.

Provenance

The following attestation bundles were made for sphinx_c_autodoc-1.7.0.tar.gz:

Publisher: release.yml on speedyleion/sphinx-c-autodoc

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file sphinx_c_autodoc-1.7.0-py3-none-any.whl.

File metadata

File hashes

Hashes for sphinx_c_autodoc-1.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6d0b5a6d6d1658509dbe04dee99654847cd15333db786661ae179f80b0d791ce
MD5 b37928bff96e974d9131d6edd213e0d6
BLAKE2b-256 45f39c476b23b74d8d150fe3ba7d39f5303405a836e1cf8327faeade301c963d

See more details on using hashes here.

Provenance

The following attestation bundles were made for sphinx_c_autodoc-1.7.0-py3-none-any.whl:

Publisher: release.yml on speedyleion/sphinx-c-autodoc

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page