许多 FreeBSD port 维护工具, 例如 portupgrade(1), 会依赖于一个名为 /usr/ports/INDEX 的数据库的正确性, 它提供了关于 port 的相关信息, 例如依赖关系等等。 INDEX 是由顶级的 ports/Makefile 通过 make index 来建立的, 这个命令会进入每一个 port 的子目录, 并在那里执行 make describe。 因此, 如果某个 port 的 make describe 失败, 就没有人能生成 INDEX, 人们很快会变得不高兴。
注意: 无论在 make.conf 中设置了什么选项, 这个文件都应能够正确地生成。 因此, 应避免在 (例如) 某个依赖关系无法满足时使用 .error。 (参见 第 12.16 节。)
如果 make describe 只是产生一个字符串, 而不是错误信息, 可能就没什么问题。 请参见 bsd.port.mk 以了解所生成的串的意义。
最后要说明的是, 新版本的 portlint (在下一节中将进行介绍) 将会自动地运行 make describe。