Текущий процесс работы с пакетами документации
В данный момент (июнь 2007 г) пакеты документации разрабатываются в git, собираются в gear с помощью hasher.
В репозиториях git в бранче master находятся файлы для сборки в пакет rpm: .gear-rules и rpm spec.
В бранче heap находится сама документация: файлы License, docinfo, каталог doc с самими документами. Перед сборкой пакета бранч heap сливается в master.
Для сборки rpm пакета нужно проверить следующие условия:
- Бранч master существует и содержит файлы .gear-rules и docs-doc_name-author.spec. Кроме того, могут быть другие файлы - результат сливания бранча heap. Если в бранче master остались каталоги вида linux_basics.kirill.060307, их нужно удалить - это наследие того времени, когда документация собиралась из тарболов, полученных в "Куче".
- Бранч heap существует и содержит актуальную документацию. Если бранча нет, его нужно создать, поместив актуальную документацию в подкаталог doc/, а файлы docinfo и License в корень бранча.
- Перед сборкой пакета бранч heap был слит в бранч master.
Файл .gear-rules (бранч master) выглядит примерно так:
copy: doc/* tar.bz2: . name=linux_basics.kirill
Обычно для этого нужно добавить строку с copy и упростить строку с tar.bz2.В спек файле (бранч master) нужно изменить (для сборки в hasher)
BuildRequires: rpm-build-docs >= 0.4
на
BuildRequires(pre): rpm-build-docs >= 0.4
Вызов макроса setup (теперь в тарболе нет указания даты)
%setup -q -n %module_id
Если при сборке hasher выдаёт ошибку о неправильном значении Packager, нужно добавить это поле
Packager: ALT Docs Team <docs@packages.altlinux.org>
Как правило, это поле уже добавлено автоматически макросом setup_docs_module.- Префикс пакета с документацией: "docs-". Имя автора должно присутствовать и быть суффиксом в имени rpm пакета. Полностью имя пакета выглядит примерно так: docs-doc_name-author... Это наследие костылей с поиском зависимостей по ссылкам вида "adt:whatis_alt.kirill".