[docs] Re: документация по docbook

Fr. Br. George george на altlinux.ru
Ср Фев 23 23:17:28 MSK 2005


On Wed, Feb 23, 2005 at 08:57:53PM +0200, Michael Shigorin wrote:
> On Wed, Feb 23, 2005 at 10:48:01AM +0300, Kirill Maslinsky wrote:
> > Безусловно стоит начать оформлять документы из Кучи в качестве пакетов
> > в Сизифе, но для этого нужно написать стандартный spec для модуля. 
> > Я уже просил помочь мне в этом, но никто, к сожалению, не откликнулся.
> 
> А в чём проблемы с имеющимися alt-docs-*.spec?
	А ты в них смотрел? Они представляют собой команду cp -r. Всё.
Вру, не всё. Ещё альтернативы и симлинки, чтобы хоть какой-то reuse
обеспечивался. Предполягается, что сборка html-ей из DB производилась
вручную, бубном и камланием. По крайней мере всё, к кому _я_ обращался с
просьбой этот процесс хоть немного автоматизировать, отвечали или
жизнерадостным смехом, или мрачным молчанием.

[2all] Давайте всё-таки этот вопрос проясним. Фиг с ним, с .spec,
возможно, это не всем понятный синтаксис. Но описать на языке sh процесс
превращения типового DB-документа (например, того, что в
http://docs.altlinux.ru/alt/devel/ch03s06.html) в html и перечислить те пакеты,
которые для этого нужно установить? Это помогло бы решить бездну проблем
потенциальным майнтейнерам пакетов с документацией. В силу этих проблем,
кстати, у ALT сейчас имеется таковых майнтейнеров ровно пятеро, из них
трое не пользуются никаким DB, и четверо майнтейнят по одному пакету.

[2mike] Или четверо не пользуются?

-- 
			George V Kouryachy (aka Fr. Br. George)
			mailto:george at altlinux_ru


Подробная информация о списке рассылки docs