DOE OSTI · 1890187
CMinx: A CMake Documentation Generator
Abstract
This manuscript introduces CMinx, a program for generating application programming interface (API) documentation written in the CMake language, and CMake modules in particular. Since most of CMinx’s intended audience is comprised of C/C++ developers, CMinx is designed to operate similar to Doxygen, the de facto C/C++ API documentation tool. Specifically, developers annotate their CMake source with “documentation” comments, which are traditional CMake block comments starting with an extra “[” character. The documentation comments, written in reST, describe to the reader how the functions, parameters, and variables should be used. Running CMinx on the annotated source code generates reST files containing the API documentation. The reST files can then be converted into static websites with tools such as Sphinx or easily converted to another format via Pandoc.
Explore related subjects
Keep this discovery
Explore connections, maps & timelines
Butler, Branden, Richard, Ryan M.. 2022-09-27. CMinx: A CMake Documentation Generator. https://doi.org/10.21105/joss.04680. https://searchnasa.com/record/osti%3A1890187/cminx-a-cmake-documentation-generator
Citations retain the original authors and DOI and include this site’s record URL. If this discovery service contributed to your research, you can also cite Search NASA by Indiciae: BibTeX · RIS.