[docs] I: новая сборочная среда

[Kirill Maslinsky]

Господа!

С сегодняшнего дня в Сизифе доступен пакет rpm-build-docs, 
в котором несколько средств для автоматизации процесса 
превращения документа в Куче в пакет в Сизифе (т. е. 
сборочная среда). Спасибо Лёше Гладкову! (legion@)

К сожалению, rpm-build-docs пока не документирован, поэтому 
сделаю несколько комментариев по тому, что там есть:

docs_genspec
------------
Утилита, которая из указанного архива с документом (из Кучи)
вынимает docinfo и на основе данных из него строит типичный спек-файл.
Она умеет также обновлять уже имеющийся спек-файл (если он был 
некогда сгенерён этой же утилитой и не испорчен до неузнаваемости).

docsbuild
---------
Скрипт, который запускает процесс сборки документации из исходного 
формата в html. В одном из аргументов ему передаётся название исходного
формата. Дальше он смотрит по таблице, какая функция отвечает за сборку
из этого формата в html и запускает эту функцию. Принципиально 
разрабатывался как расширяемый -- чтобы легко было добавлять новые 
функции для сборки html из других форматов.

Пользователь не должен вручную запускать docsbuild, он запускается при
сборке пакета при помощи rpm-макроса, которому docs_genspec проставит нужные 
аргументы. У пользователя остаётся возможность добавить в спеке этому
макросу любые дополнительные параметры для сборки (Естественно, их
должна понимать сборочная функция для этого формата).

RPM-макросы
-----------
Нужны для того, чтобы не повторять стандартные операции в каждом спеке. 
Кроме того, последовательное использование макросов позволит при любых 
изменениях в этих стандартных операциях (т. е. в сборочной среде) 
_автоматически_ пересобирать пакеты с документацией, _ничего_ не изменяя
в самих спеках (т. е. полностью без вмешательства человека).


-- 
Kirill Maslinsky
uALT Linux Documentation Team
-------------- next part --------------
z'╣ЛmjшZr··э╡г+╧╤чtж╕zz-jЖ╒∙╕Еy<╘y╙i√'╤*'Ч≤)╡('jш╚y(Ё{_=o+^╟7╛rz-jЖ╒∙╕ЕyJЕ├шiЪЫb╡ш√ыb·Лk╩Зb╔ЙФj)v┤,Щ╚miхfz{lЪm4ГMВвЩЖЦn}СOз╤ж°├g╖╣╦╖