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