Spec

Заголовок spec-а

Summary

Значение тэга Summary должно начинаться с заглавной буквы. В конце Summary не должно быть точки.

Group

Указанная группа должна находиться в списке групп, известном RPM. Этот список располагается в файле /usr/lib/rpm/GROUPS, находящемся в пакете rpm.

Patch

Рекомендуемое именование патчей:

• NAME-VERSION-ORIGIN-WHAT.patch, где
  • NAME и VERSION — имя и версия пакета, для которого сделан патч,
  • ORIGIN — аббревиатура источников патча (обычно дистрибутивов),
  • WHAT — краткое описание патча.

Если патч образован из нескольких частей, полученных из разных источников, ORIGIN должен включать аббревиатуры всех источников. Аббревиатура ALT Linux / Sisyphus — alt. Для патчей, полученных на основе системы контроля версий, ORIGIN должен включать в себя дату или номер ревизии.

В описании патча рекомендуется пользоваться следующими сокращениями:

• makefile — патчи, затрагивающие исключительно Makefile*,
• bound — проверки на границы (буфера, целых чисел и т. д.),
• config — патчи, затрагивающие исключительно конфигурационные файлы,
• configure — патчи, затрагивающие исключительно configure*,
• doc — патчи, затрагивающие исключительно документацию,
• fixes — кумулятивные патчи/исправления по надёжности и/или безопасности,
• format — патчи на использование форматирования строк (типа printf),
• install — патчи на выполнение make install непривилегированным пользователем,
• linux — патчи для портирования По на Linux,
• man — патчи, затрагивающие исключительно man-страницы,
• texinfo — патчи, затрагивающие исключительно документацию в формате texinfo,
• tmp — патчи, предназначенные для решения различных вопросов, связанных с временными файлами,
• vitmp — патчи для поддержки vitmp(1)
• warnings — патчи, исправляющие предупреждения, выданные компилятором

Requires, PreReq

При наличии логических зависимостей между пакетами внутри одного spec-файла, пакетная зависимость между ними должна включать полную версию пакета, например так:

Requires: %name = %epoch:%version-%release

BuildRequires, BuildPreReq

Тэг BuildRequires используется для хранения результатов работы buildreq. По этой причине дополнительные сборочные зависимости, не находящиеся buildreq, рекомендуется хранить в тэге BuildPreReq.

BuildRoot

Тэг BuildRoot бесполезен для RPM из Sisyphus: обработку BuildRoot RPM производит самостоятельно.

BuildHost

Новый опциональный тэг в Sisyphus RPM. Позволяет переопределить имя сборочного хоста. По умолчанию используется, как и в остальных версиях RPM, результат вызова uname(2).

%description

Описание пакета должно содержать информацию, интересную его пользователю, а не сборщику:

• Описание программы или инструмента должно содержать их функционал, а не особенности реализации (язык, используемые библиотеки и т.д.)
• Описание библиотеки должно содержать язык программирования, для которого предназначена библиотека и решаемую задачу
• ...

%clean

Sisyphus RPM автоматически очищает BuildRoot пакета (с помощью макроса %clean_buildroot). Таким образом, ручная очистка BuildRoot является ненужной (а точнее - вредной, поскольку повышает вероятность ошибки).

Если секция %clean пуста, то рекомендуется вообще не включать её в spec-файл.

%files

В отличие от других веток RPM, Sisyphus RPM автоматически подставляет в начало каждой секции %files и в начало каждого файла, включаемого с помощью %files -f, директиву %defattr со значением макроса %_defattr.

Таким образом, ручное указание %defattr является излишним.