Наиболее часто совершаемые ошибки в секции %changelog

На этой странице приведены некоторые советы о том, как рекомендуется оформлять секцию %changelog в ваших spec-файлах.

• весь список изменений обязательно должен быть на английском языке. Не используйте русских описаний! Это применимо не только к секции %changelog, но и к спеку в целом. Комментарии на русском не только могут помешать другим мэйнтейнерам/пользователям разобраться в вашем спеке, но даже помешать установке, обновлениию и удалению пакета! (см., к примеру, bug #6949)

• при наличии подпунктов предлагается выделять их отсутпом в «два пробела плюс». Следование этому правилу избавит вас от наступания на эту багу: http://lists.altlinux.ru/pipermail/sisyphus/2005-August/066182.html

• если вы адаптировали спек из другого дистрибутива или используете спек вашей локальной сборки, то рекомендуется удалять старые записи в %changelog, которые не имеют отношения к сборке для ALT Linux.

<wRAR> php-coder: а вставлять в пакет старые чейнджлоги – это читерство ;)

• для повышения читабельности и аккуратности в оформлении будет не лишним, если вы выравняете ваши записи по 70 знаков в строке (set tw=70 для vim)

• проверяйте записи с изменениями, Summary и %description на предмет орфографических ошибок и опечаток! Эта, казалось бы, мелочь портит общее впечатление не только о мэйнтейнере, но даже и о дистрибутиве в целом!

Смотри также

• Использование add_changelog?