ALTLinuxEdu

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

В данный момент (июнь 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".

ALTLinuxEdu: Docs/Build/CurrentWorkflow (last edited 2007-06-01 13:25:24 by VitalyOstanin)