[docs] Re: make: OTHER_FILES

[Alexander Bokovoy]

On Tue, Nov 11, 2003 at 02:54:32PM +0300, Oleg A. Paraschenko wrote:
> > > > В дистрибутив исходников, IMHO, надо. Чтобы было, чем собирать :)
> > > 
> > >   Под "дистрибутивом" ("make dist") в make-файлах подразумевалось
> > > то, что получилось в результате генерации, лежит в tar.bz2-архиве, а
> > > затем этим архивом передаётся куда-то дальше.
> > Вот передается дальше оно в src.rpm, из которого собирается документация
> > в noarch.rpm. А как мы соберем эту документацию, если не будет
> > Makefiles?
> 
>   Ага, теперь понятно, куда это попадает. Всё забывал уточнить. Спасибо.
> 
>   Теперь всем такие вопросы:
> 
> * Я правильно понимаю, что архив должен быть таким, что если раскрыть его
> и сказать "make", то всё должно успешно собраться?
Да.
 
> * А зачем пересобирать, если в архиве есть готовые html и pdf?
Такие готовые html/pdf рассматриваются как бинарные объекты по аналогии с
binary-only коммерческими программами. Не забывайте о лицензиях на нашу
документацию -- инфраструктура для сборки из исходного формата является
обязательной частью исходников (за исключением системных компонент).
 
> * А почему бы не собирать src.rpm и noarch.rpm сразу, без дополнительного
> сохранения в архив?
> 
> * Я почти уверен, что на первый вопрос ответ "да". Поэтому я взял
> предыдущую версию 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. Что с этим делать?
> 
> * А уже есть опыт сборки rpm-пакетов с документацией через tgz-архив, или
> это пока только планы?
Есть пример в samba3. Там аналогичная система сборки.
 
> * Как rpm-скрипт запускает make: просто "make" или "make html-dir" или ещё
> как? Я хочу это знать чтобы разобраться с целью по умолчанию.
Цель по умолчанию неважна. Считайте, что в RPM будут генерироваться все
нужные работающие цели (html, pdf, chm, ...)
> 
> * В предыдущей версии архив оканчивался на tgz, сейчас -- на tar.bz2. Надо
> ли вернуть обратно?
Надо tar.bz2.

 
> * Предлагаю переименовать переменную OTHER_FILES в SRCDIST_FILES, чтобы её
> назначение было более понятно. Аргументы за/против?
Только за!

-- 
/ Alexander Bokovoy
Samba Team                      http://www.samba.org/
ALT Linux Team                  http://www.altlinux.org/
Midgard Project Ry              http://www.midgard-project.org/