Chapter 15 Обновление

Если вы заметите, что ваш порт устарел по сравнению с последней авторской версией, первым делом проверьте, что у вас находится самая последняя версия порта. Вы можете найти их в каталоге ports/ports-current на зеркальных FTP-серверах FreeBSD. Кроме того, вы можете использовать CVSup для поддержки актуальности всей Коллекции портов, как это описано в Руководстве.

Следующий шаг - это посылка сообщения электронной почты человеку, поддерживающему этот порт (мэйнтейнеру), если он указан в файле Makefile порта. Этот человек может уже работать над обновлением, или иметь причину не обновлять порт прямо сейчас (например, из-за проблем со стабильностью функционирования новой версии); вам нет нужды дублировать их работу. Заметьте, что неподдерживаемые порты перечисляются с адресом мэйнтейнера ports@FreeBSD.org; поылка сообщения на этот адрес. скорее всего, в данном случае не поможет.

Если мэйнтейнер просит вас выполнить обновление, либо им является ports@FreeBSD.org, то, пожалуйста, выполните обновление и сохраните результат рекурсивного diff между новым и старым каталогами порта (например, если каталог с модифицированным портом называется superedit, а оригинальный, совпадающий с находящимся в нашем дереве портов, superedit.bak, то сохраните результат выполнения команды diff -ruN superedit.bak superedit). Подойдёт как унифицированный, так и контекстный дифф, однако коммиттеры портов обычно предпочитают унифицированный формат. Отметьте использование опции -N--это одобряемый способ заставить diff корректно работать в случае добавления новых файлов или удаления старых. Перед тем, как посылать нам diff-файл, пожалуйста, проверьте его, чтобы убедиться в значимости всех внесённых изменений.

Лучше всего послать нам diff-файл, включив его в посылку по команде send-pr(1) (категория ports). Если вы собираетесь стать мэйнтейнером порта, обязательно поместите текст [maintainer update] в начале строки описания и/или задайте в поле ``Class'' вашего PR строчку maintainer-update. Будьте добры, в сообщении отметьте все добавленные или удалённые файлы, так как они будут непосредственно указаны CVS при выполнении операции коммита. Если diff-файл имеет размер, превышающий 20КБ, сожмите его и обработайте утилитой uuencode; в противном случае просто включите его как есть в PR.

Наконец, посмотрите, пожалуйста, раздел о Написании сообщений о проблемах в статье о Сообщениях об ошибках для получения дополнительной информации о том, как писать полезные сообщения о проблемах.