10.1.运行 make describe

一些 FreeBSD ports 维护工具， 例如 portupgrade(1)， 依赖于一个名为 /usr/ports/INDEX 的数据库， 它能够记录诸如 port 依赖关系之类的项目。 INDEX 是由顶层的 ports/Makefile 通过 make index 创建的， 它将进入每个 port 子目录并在那里执行 make describe。因此， 如果 make describe 在任何一个 port 中失败了， 就没有人能够生成 INDEX ，许多人很快就会不高兴了。

注意

无论 make.conf 中有什么选项， 都能生成这个文件是非常重要的， 因此请避免做这样一些事情， 例如当依赖关系不被满足时使用 .error 语句。(参见避免使用 .error 结构）。

如果 make describe 产生了一个字符串而不是错误信息， 那么一切都可能是安全的。 参见 bsd.port.mk 以了解产生的字符串的含义。

还需要注意的是， 运行最新版本的 portlint (如下一节所述) 将导致 make describe 的自动运行。