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 。