Текущий процесс работы с пакетами документации

В данный момент (июнь 2007 г) пакеты документации разрабатываются в git, собираются в gear с помощью hasher.

В репозиториях git в бранче master находятся файлы для сборки в пакет rpm: .gear-rules и rpm spec.

В бранче heap находится сама документация: файлы License, docinfo, каталог doc с самими документами. Перед сборкой пакета бранч heap сливается в master.

Для сборки rpm пакета нужно проверить следующие условия:

1. Бранч master существует и содержит файлы .gear-rules и docs-doc_name-author.spec. Кроме того, могут быть другие файлы - результат сливания бранча heap. Если в бранче master остались каталоги вида linux_basics.kirill.060307, их нужно удалить - это наследие того времени, когда документация собиралась из тарболов, полученных в "Куче".
2. Бранч heap существует и содержит актуальную документацию. Если бранча нет, его нужно создать, поместив актуальную документацию в подкаталог doc/, а файлы docinfo и License в корень бранча.
3. Перед сборкой пакета бранч heap был слит в бранч master.

4. Файл .gear-rules (бранч master) выглядит примерно так:

   copy: doc/*
   tar.bz2: . name=linux_basics.kirill
   

   Обычно для этого нужно добавить строку с copy и упростить строку с tar.bz2.

5. В спек файле (бранч master) нужно изменить (для сборки в hasher)

   BuildRequires: rpm-build-docs >= 0.4
   

   на

   BuildRequires(pre): rpm-build-docs >= 0.4
   

   Вызов макроса setup (теперь в тарболе нет указания даты)

   %setup -q -n %module_id
   

6. Если при сборке hasher выдаёт ошибку о неправильном значении Packager, нужно добавить это поле

   Packager: ALT Docs Team <docs@packages.altlinux.org>
   

   Как правило, это поле уже добавлено автоматически макросом setup_docs_module.
7. Префикс пакета с документацией: "docs-". Имя автора должно присутствовать и быть суффиксом в имени rpm пакета. Полностью имя пакета выглядит примерно так: docs-doc_name-author... Это наследие костылей с поиском зависимостей по ссылкам вида "adt:whatis_alt.kirill".