Skip to content
forked from jessevdk/cldoc

clang based documentation generator for C and C++

License

Notifications You must be signed in to change notification settings

rvkennedy/markdoc

 
 

Repository files navigation

markdoc is a fork of cldoc, 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. markdoc produces markdown output intended for jekyll-based static sites such as GitHub pages.

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.

About

clang based documentation generator for C and C++

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 43.2%
  • HTML 33.5%
  • CoffeeScript 10.2%
  • JavaScript 8.7%
  • CSS 2.6%
  • C++ 1.1%
  • Other 0.7%