记录 makefile 中使用的变量

【问题标题】：Documenting variables used in makefile记录 makefile 中使用的变量
【发布时间】：2013-06-20 09:18:25
【问题描述】：

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

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

我首先想到的是 Doxygen。经过一番研究，我发现 Doxygen doesn't support makefile

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

【问题讨论】：

【解决方案1】：

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

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

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

【讨论】：