5.6. COMMENT

Содержит однострочное описание порта. Пожалуйста, соблюдайте следующие правила:

  1. Старайтесь делать строку COMMENT длиной не больше, чем 70 символов, так как эта строка будет использована командой pkg info (см. pkg-info(8)) для отображения однострочного описания порта;

  2. Не включайте сюда название пакета (или номер версии программного обеспечения);

  3. Комментарий должен начинаться с заглавной буквы и не заканчиваться точкой;

  4. Не начинайте комментарий с неопределённого артикля (A или An);

  5. Имена пишутся с заглавной буквы (например, Apache, JavaScript, Perl);

  6. Для перечислений используйте английскую Оксфордскую запятую (англ. Oxford comma) (например, green, red, and blue);

  7. Используйте программу проверки орфографии.

Вот пример:

COMMENT=	Cat chasing a mouse all over the screen

В файле Makefile переменная COMMENT должна следовать сразу за переменной MAINTAINER.

Этот, и другие документы, могут быть скачаны с http://ftp.FreeBSD.org/pub/FreeBSD/doc/.

По вопросам, связанным с FreeBSD, прочитайте документацию прежде чем писать в <questions@FreeBSD.org>.

По вопросам, связанным с этой документацией, пишите в рассылку <doc@FreeBSD.org>.