/cldoc

clang based documentation generator for C and C++

Primary LanguagePythonGNU General Public License v2.0GPL-2.0

Build Status

cldoc is a clang based documentation generator for C and C++. cldoc tries to solve the issue of writing C/C++ software documentation with a modern, non-intrusive and robust approach.

Features

  • Uses clang to robustly parse even the most complex C++ projects without additional effort from the user.
  • Requires zero configuration.
  • Uses markdown for documentation formatting.
  • Generates an xml description of the API which can be reused for other purposes.
  • Uses a simple format for documenting your code.
  • Supports cross-referencing in documentation.
  • Generates a single file, javascript based web application to render the documentation.
  • Integrates seamlessly with your existing website.
  • Lightning fast client-side searching using a pregenerated search index.
  • Generates a formatted documentation coverage report and integrates it in the website.

For more information, please visit http://jessevdk.github.com/cldoc.

Requirements

cldoc requires clang 3.9 or later to be installed on the system.

Get started now!

To get started using cldoc, please have a look at Getting started to install cldoc. Then explore how to document your code so that cldoc can extract it. Finally go and read Generating site to find out how to use the cldoc command in your project to generate the documentation.

Example

For an easy introduction into using cldoc, please have a look at the example project and corresponding generated documentation.