记录 makefile 中使用的变量

Question

我为 Arduino 维护了一个相当复杂的 makefile。这个 makefile 有很多可以由用户定制的变量。

我想自动执行为所有这些变量生成文档的任务。

我第一个想到的是Doxygen。经过一些研究，我发现 Doxygen不支持 makefile

那么记录 makefile 中可用的不同配置变量的最佳方法是什么？

Answer 1

您可以只编写一个脚本，读取 Makefile 并查找特殊注释。与 doxygen 的原理相同。喜欢：

### VAR:CC CC defines the binary of the C compiler
CC = gcc

只需在脚本中构建一些数据结构，然后将它们转储到您希望的任何位置：LaTeX、Markdown、HTML、Textfile...