[docs] Re: make: OTHER_FILES

[Oleg A. Paraschenko]

  Привет!

  Спасибо за комментарии. Не зря Vyt говорит, что спрашивать надо в
рассылке, а не лично: можно неожиданно узнать о чём-то новом.

On Tue, 11 Nov 2003 15:37:30 +0300
Vitaly Ostanin <vyt на vzljot.ru> wrote:

...
> > On Tue, 11 Nov 2003 11:57:17 +0200
> > Alexander Bokovoy <a.bokovoy на sam-solutions.net> wrote:
> > 
...

> > 
> > * Я правильно понимаю, что архив должен быть таким, что если
> > раскрыть его и сказать "make", то всё должно успешно собраться?
> 
> Не обязательно. Релизный архив с исходными текстами должен
> включать всё нужно для их сборки, или все зависимости, нужные для
> сборки, а также описание процесса сборки. Это необязательно
> просто make.
> 
> > * А зачем пересобирать, если в архиве есть готовые html и pdf?
> 
> См. моё письмо в этом же треде. Архивов должно быть несколько, в
> том числе архив только с исходными документами.

  Комментарии -- отдельным письмом.


> 
> > * А почему бы не собирать src.rpm и noarch.rpm сразу, без
> > дополнительного сохранения в архив?
> 
> rpm обычно собираются из архивов, иногда с дополнениями. Вообще
> тарболлы - обычная форма распространения программ/документов, rpm
> - это их дальнейшая упаковка.

  Тут я имел в виду, что возможно, имеет смысл "make srcrpm" или
"make noarchrpm". Но это, наверное, непросто.

> 
> > * Я почти уверен, что на первый вопрос ответ "да". Поэтому я
> > взял предыдущую версию make-файлов, сделал tgz из
> > DOCS_ROOT/admin и попробовал сделать эксперимент:
> > 
> > 
> > $ tar ztf admin.tgz
> > Makefile
> > ../tmp/doc-template-old/Makefile.check
> > ../tmp/doc-template-old/Makefile.clean
> > ...
> > admin.xml
> > $ tar zxf admin.tgz
> > ...
> > tar: ../tmp/doc-template-old/Makefile.dist: Member name
> > contains `..'...
> > tar: Выход, отложенный по результатам предыдущих ошибок
> > 
> > Почему возникла ошибка -- понятно. А как вы боретесь с ней в
> > скрипте для rpm?
> 
> Пока никак, когда дойдёт до rpm - исправлением.

  Да, наверное, стоит подождать.

> 
> > * Архив содержит admin.xml, но не содержит остальных файлов,
> > которые он включает в себя посредством XInclude. Что с этим
> > делать?
> 
> Архив должен либо включать остальные файлы, либо иметь ссылку на
> них в описании. При этом .src.rpm должен иметь зависимости на
> пакеты с этими файлами.

  Реализация и того, и другого достаточно сложна. На сейчас предлагаю
такое простое решение: в архив идёт результат сборки XInclude.

> 
> Определить список сущностей, включаемых в итоговых документ,
> можно в последних версиях libxml2.

  Здорово. Благодарить тебя?

> 
> > * А уже есть опыт сборки rpm-пакетов с документацией через
> > tgz-архив, или это пока только планы?
> 
> В этом проекте - нет, другие проекты собирают именно так (php,
> samba, AFAIK). Опыт здесь особо не нужен, так как нет критичных
> сложностей.

  Я просто хотел быть уверенным, что никому ничего не сломаю.

> 
> > * Как rpm-скрипт запускает make: просто "make" или "make
> > html-dir" или ещё как? Я хочу это знать чтобы разобраться с
> > целью по умолчанию.
> 
> В разделе %build спека пишут команды сборки, это даже не
> обязательно make, так что цель по умолчанию не так важна. Что в
> спеке напишут, то и выполнится - прибитого гвоздями скрипта нет.

  А вдруг на сегодня было бы 1000 спеков, в которых прописано
"make alles".

> 
> > * В предыдущей версии архив оканчивался на tgz, сейчас -- на
> > tar.bz2. Надо ли вернуть обратно?
> 
> Не стоит.
> 
> > * Предлагаю переименовать переменную OTHER_FILES в
> > SRCDIST_FILES, чтобы её назначение было более понятно.
> > Аргументы за/против?
> 
> За, с таким же аргументом :)
> 
> <skipped/>
> 
> -- 
> Regards, Vyt
> mailto:  vyt на vzljot.ru
> JID:     vyt на vzljot.ru


-- 
Oleg