Mesa Turns To Hawkmoth For Improving Documentation

Written by Michael Larabel in Mesa on 28 October 2023 at 06:02 AM EDT. 4 Comments
With Mesa 24.0 the developers have switched from using Doxygen and Breathe for building documentation comments from source to instead use the newer but less heard of Hawkmoth.

Hawkmoth is a Sphinx extension to incorporate C and C++ source code comments from restructuredText into Sphinx-based documentation. Hawkmoth makes use of Clang and aims for improving the experience of documenting C/C++-based software projects using Sphinx. Hawkmoth is designed for simplicity. Those wishing to learn about Hawkmoth can do so via the GitHub project site.


For the past two months there has been a work-in-progress merge request to transition from Doxygen+Breathe to Hawkmoth. With this transition the macro documentation is said to be much better, the documentation build is less noisy, and a full documentation build is slightly faster while incremental builds are much faster.

Those wanting to learn more about Mesa's integration of Hawkmoth for building out the code documentation can learn more about it via this merge request.
Related News
About The Author
Michael Larabel

Michael Larabel is the principal author of and founded the site in 2004 with a focus on enriching the Linux hardware experience. Michael has written more than 20,000 articles covering the state of Linux hardware support, Linux performance, graphics drivers, and other topics. Michael is also the lead developer of the Phoronix Test Suite, Phoromatic, and automated benchmarking software. He can be followed via Twitter, LinkedIn, or contacted via

Popular News This Week