[docs] Re: Сборочная среда

[Oleg A. Paraschenko]

  Добрый вечер,

On Thu, 3 Mar 2005 11:39:19 +0300
Kirill Maslinsky <kirill at altlinux.ru> wrote:

...
> > > 2. Вывод, я думаю, нет смысла направлять в
> > > output/$(DOC_NAME)-html-dir, всё равно все модули будут собираться
> > > по-отдельности, так что достаточно output/html-dir или даже просто
> > > html-dir. 
> > 
> >   Лучше оставить как есть. Там замешаны некоторые
> >   историческо-технические
> > сложности типа rm -rf $(OUTPUT) в make clean.
> 
> Ну, для этого output/html-dir всё равно годится. 
> Чтобы пояснить, почему я считаю нужным убрать оттуда $(DOCUMENT_NAME),
> лучше опишу-ка, как будет происходить процесс сборки модуля.
> 
> 1. В момент сборки .src.rpm вызывается простейший скрпит для сборки 
> с одним параметром -- путём к главному файлу собираемого документа.
> 
> 1.1. Скрипт содержит вызов make с параметрами.
> 
> 1.2. Путь к главному собираемому файлу может быть произвольным. 
> В типичном случае такой файл будет находиться в подкаталоге со 
> стандартным именем doc (которое, скорее всего, не совпадает с именем
> документа). 
> Мои эксперименты показали, что произвольный путь в качестве 
> ${DOCUMENT_NAME} текущим Makefile'ам задать нельзя. 
> Делать при сборке cd в подкаталог с главным собираемым файлом 
> совершенно не хочется.
> 
> 2. После сборки вывод должен оказаться в каталоге со стандартным 
> именем (например, output/html-dir). В этом имени совершенно 
> нежелательно иметь переменную часть (${DOCUMENT_NAME}).
> 
> 3. Вывод из output/html-dir переносится туда, где должны лежать файлы 
> модуля.
> 

  В другой ветке этого обсуждения я упомянул, что делать какие-либо
изменения очень не хочется. Более того, и не можется. Я был бы очень
благодарен, если вместо исправления среды сборки будет сделан скриптовый
workaround для приведения результатов в нужный вид.

> > > 3. Не знаю, нужно ли какое-нибудь специальное обращение с временными
> > > файлами, если предполагается автоматическая пересборка в hasher?
> > 
> >   Вопроса не понял. Проще будет поместить в hasher и посмотреть.
> Угу, посмотрим.
> 
> > > 4. Думаю, стоит туда положить и Вашу документацию по Makefile'ам, 
> > > причём в идеале -- в xml, а сборку в html включить в сборку пакета 
> > > alt-docs-build. 
> > 
> >   Я думаю, что надо положить этот xml-документ в cvs, но куда именно?
> > Подскажите название папки.
> Я думаю, что в CVS не нужно класть ничего, что Вы хотели бы когда-нибудь
> опубликовать в документации ALT. Нужно положить этот документ в Кучу. 
> См. ftp://ftp.altlinux.org/pub/docs/adt_policy.tar.gz

  Мне казалось, что куча была создана для тех, кто не может писать в
ДокБуке и не имеет доступа в CVS. Тем не менее, сейчас попробую выложить.

> 
> -- 
> Kirill Maslinsky
> ALT Linux Documentation Team
> 
> _______________________________________________
> docs mailing list
> docs at altlinux.ru
> https://lists.altlinux.ru/mailman/listinfo/docs
> 


-- 
Oleg Paraschenko  olpa@ http://xmlhack.ru/  XML news in Russian