Некоторые утилиты FreeBSD для сопровождения портов, например,
portupgrade(1), опираются на базу данных с именем
/usr/ports/INDEX, в которой отслеживаются
такие характеристики портов, как их зависимости. Файл
INDEX создаётся при помощи
ports/Makefile верхнего уровня по команде
make index, спускающейся в подкаталог
каждого порта и выполняющей в нём make
describe. Таким образом, если выполнение
make describe с каким-либо портом завершится
неудачно, то никому не удастся создать
INDEX, при этом много людей вскоре станут
несчастны.
Возможность генерировать этот файл очень важна вне
зависимости от того, какие параметры присутствуют в
make.conf, поэтому, пожалуйста,
избегайте, таких вещей, как использование декларации
.error, когда (к примеру) требования к
зависимости не было удовлетворено. (Смотрите
Раздел 12.15, <<Избегайте использования конструкции
.error>>.)
Если make describe выдаёт строчку, а не
ошибку, то для вас это пройдёт безболезненно. Обратитесь к
файлу bsd.port.mk, чтобы выяснить значение
выдаваемых строк.
Заметьте также, что запуск последней версии
portlint (как указано в следующем разделе)
приведёт к автоматическому запуску команды
make describe.
Этот, и другие документы, могут быть скачаны с https://download.freebsd.org/ftp/doc/.
По вопросам, связанным с FreeBSD, прочитайте
документацию прежде чем писать в
<questions@FreeBSD.org>.
По вопросам, связанным с этой документацией, пишите в рассылку
<doc@FreeBSD.org>.