[docs] Re: current makefiles again (was: Tuning and profiling)

[Vitaly Ostanin]

On Tue, 2 Dec 2003 20:16:37 +0300
"Oleg A. Paraschenko" <olpa на xmlhack.ru> wrote:

>   Привет!
> 
> On Tue, 2 Dec 2003 18:10:17 +0300
> Vitaly Ostanin <vyt на vzljot.ru> wrote:
> 
> ...
> > > 
> > >   Ок, готов. Начать отрывать?
> > 
> > Тебе виднее, когда начать, но в итоге лучше оторвать :)
> > Спасибо.
> 
>   Насколько я понял, ты сейчас тоже работаешь над make-файлами.
>   Чтобы не
> возникло конфликтных изменений, я бы хотел дождаться, когда у
> тебя будет логический конец, код в cvs и пауза на пару дней.

Нет, я не работаю над Makefiles из cvs docs. Точнее, пытался,
перенося их под win32, но по времени и сложности оказалось проще
использовать свой вариант из make2.

> > > > Зависимость вида
> > > > %.xinclude: %.xml
> > > > накладывает лишние ограничения на имя документа и имя
> > > > файла после объединения.
> > > 
> > >   А именно, что тут лишнее?
> > 
> > Не будет работать
> > make DOCUMENT_NAME=article.docbook
> 
>   Будет. "article.docbook.xinclude" будет зависеть от
>   article.docbook.xml.

Ошибся, я имею в виду
make XML=article.docbook

да, в docs это редкая ситуация, это нужно только для обработки
произвольных документов (внешних для cvs docs). Однако это тоже
принципиальное ограничение.

> > Будет сложно переписывать правила везде, где используется
> > прибитое гвоздями расширение .xinclude
> 
>   С этим согласен. Но надо же в какой-то момент переставать
>   делать
> косвенные ссылки и писать явно что от чего зависит. Мне
> кажется, что замена ".xinclude" на "$(xinclude)" ничего не
> даёт.

Мне кажется по-другому. Прошу прощения, сейчас нет времени
закопаться в cvs docs и аргументировать.

> > Да, Makefiles переписывались для сборки с учётом
> > зависимостей, но причём тут тотальная шаблонность? Мы же не
> > проект на С собираем с тучей файлов.
> 
>   Думаю, что стили написания смешивать нехорошо. Результат
>   будет
> объединять недостатки как одного, так и другого подхода.
> 
> > 
> > > > Почему нельзя воспользоваться зависимостями через
> > > > переменные$(XINCLUDED): $(XML)
> > > > , как это было сделано в make2 ?
> > > 
> > >   $(XINCLUDED) и $(XML) зависят от $(DOCUMENT_ROOT).
> > >   Соответственно,
> > > получается единственное правило.
> > > 
> > >   %.xinclude: %.xml может раскрываться в несколько правил,
> > >   например:
> > > 
> > > xxx.xinclude: xxx.xml
> > > sdfjhk.xinclude:  sdfjhk.xml
> > > allother.xinclude:  allother.xml
> > > enough.xinclude: enough.xml
> > > 
> > >   Соответственно, в варианте с % можно говорить:
> > > 
> > > $ make tmp/xxx.xinclude tmp/sect2.xinclude
> > > tmp/sect2.xinclude
> > 
> > Цель этой команды?
> 
>   Собрать с помощью xinclude несколько файлов, находящихся в
>   одном
> каталоге.
> 
>   Да, в alt docs на каждый текстовый модуль свой каталог. Но
>   зачем делать это принципиальным ограничением?

Похоже, что уже незачем.

> > >   или хотя бы
> > > 
> > > $ make tmp/sect1.xinclude
> > > 
> > >   совершенно не заботясь об установке DOCUMENT_ROOT.
> > 
> > Имеется в виду переменная DOCUMENT_NAME ? О её установке и
> > так не нужно заботиться.
> 
>   В том случае, если имя файла совпадает с именем каталога.
> 
>   Хочу заметить, что обратная ситуация вполне возможна.
>   Допустим, в
> каталоге"xxx" есть файл "xxx.xml", и я хочу временно внести
> исправления в"xxx.xml". Чтобы не править по живому, я создаю
> копию "tmp.xml".

Можно запускать
make DOCUMENT_NAME=tmp ...

<skipped/>

> > Я не вижу смысла писать комментарии на английском для
> > русскоязычных коллег,
> 
>   Может быть, я слишком пуганая ворона, но мой подход: в
>   программах все
> символы (в том числе и комментарии) должны укладываться в
> ASCII.

Это отмирающее ограничение.

> > и даже русский текст в koi8 (вероятно) на
> > системе в cp1251 нечитаем. См. Makefile.pstricks
> 
>   А уж русский язык тем более не должен присутствовать, ибо
> koi8 vs cp1251 vs cp866. 

В XML этой проблемы нет.

> Кстати, а почему для alt docs выбрана кодировка windows?

С чего ты взял? Выбран XML, в котором можно использовать и
смешивать разные кодировки.

<skipped/>

-- 
Regards, Vyt
mailto:  vyt на vzljot.ru
JID:     vyt на vzljot.ru
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20031204/dfd7cd04/attachment.bin