10.1.运行 make describe

FreeBSD 的几个维护工具，如 portupgrade(1)，依赖于一个名为/usr/ports/INDEX 的数据库，该数据库跟踪诸如port依赖关系之类的项目。INDEX 是由顶层ports/Makefile 通过 make index 创建的，该文件会进入每个port子目录并在那里执行 make describe 。因此，如果 make describe 在任何port中失败，就无法生成 INDEX，许多人会很快变得不高兴。

如果 make describe 产生字符串而不是错误消息，则一切可能是安全的。请参阅 bsd.port.mk 以了解生成的字符串的含义。

还要注意，运行最新版本的 portlint （如下一节中指定的版本）将自动运行 make describe 。