在Mesa 24.0中,开发人员已经从使用Doxygen和Breathe从源代码中进行构建文档注释,转而使用更新但不太熟悉的Hawkmoth。
Hawkmoth是一个Sphinx扩展,它将重构文本中的C和C++源代码注释合并到基于Sphinx的文档中。Hawkmoth利用Clang,旨在改善使用Sphinx记录基于C/C++的软件项目的体验。Hawkmoth是为简洁而设计的。那些想了解Hawkmoth的人可以通过
GitHub项目站点
。
在过去的两个月里,有一项正在进行的合并请求,要求从Doxygen+Breathe过渡到Hawkmoth。通过这种转换,据说宏文档会更好,文档构建的噪音更小,完整文档构建的速度略快,而增量构建的速度要快得多。
那些想了解更多关于Mesa集成Hawkmoth构建代码文档的人可以通过
此合并请求
.