[devel] IA: rpm: how to install %docs properly

[devel] IA: rpm: how to install %docs properly

[Dmitry V. Levin]

[-- Attachment #1: Type: text/plain, Size: 693 bytes --]

Greetings!

Я заметил, что многие из вас делают типичную ошибку, включая
%_docdir/%name-%version только в один из подпакетов.

Например, в libxml2-2.4.23-alt1 под видом исправления установки было
сделано следующее:

%files
[...]
%dir %_docdir/%name-%version
%doc %_docdir/%name-%version/AUTHORS
[...]
%files devel
[...]
%doc %_docdir/%name-%version/html

В этом примере содержится 2 типовые ошибки:
1. В подпакете -devel не включен каталог %_docdir/%name-%version, что
  приводит к потерянным каталогам при обновлении.
2. Для файлов и каталогов, начинающихся с %_docdir, не нужно указывать
  %doc, ибо это уже заложено в rpm.

P.S. А в libxml2-python документация вообще не на месте.


--
ldv

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] IA: rpm: how to install %docs properly

[Igor Homyakov]

On Mon, Sep 30, 2002 at 12:53:44PM +0400, Dmitry V. Levin wrote:
> Greetings!

> Я заметил, что многие из вас делают типичную ошибку, включая
> %_docdir/%name-%version только в один из подпакетов.

> Например, в libxml2-2.4.23-alt1 под видом исправления установки было
> сделано следующее:

> %files
> [...]
> %dir %_docdir/%name-%version
> %doc %_docdir/%name-%version/AUTHORS
> [...]
> %files devel
> [...]
> %doc %_docdir/%name-%version/html

> В этом примере содержится 2 типовые ошибки:
> 1. В подпакете -devel не включен каталог %_docdir/%name-%version, что
>   приводит к потерянным каталогам при обновлении.
> 2. Для файлов и каталогов, начинающихся с %_docdir, не нужно указывать
>   %doc, ибо это уже заложено в rpm.

> P.S. А в libxml2-python документация вообще не на месте.


Если пакет разбит на части package, package-common ... 
документацию стоит включать только в один пакет ? 

по логике файлы должны принадлежать package-common,
но тогда они будут лежать  в 
%_docdir/%name-common-%version вместо %_docdir/%name-%version


--
Igor Homyakov
<homyakov at altlinux dot ru>
http://counter.li.org/cgi-bin/runscript/display-person.cgi?user=190141

Re: [devel] IA: rpm: how to install %docs properly

[Dmitry V. Levin]

[-- Attachment #1: Type: text/plain, Size: 1200 bytes --]

On Mon, Sep 30, 2002 at 01:10:16PM +0400, Igor Homyakov wrote:
> > Я заметил, что многие из вас делают типичную ошибку, включая
> > %_docdir/%name-%version только в один из подпакетов.
> 
> > Например, в libxml2-2.4.23-alt1 под видом исправления установки было
> > сделано следующее:
> 
> > %files
> > [...]
> > %dir %_docdir/%name-%version
> > %doc %_docdir/%name-%version/AUTHORS
> > [...]
> > %files devel
> > [...]
> > %doc %_docdir/%name-%version/html
> 
> > В этом примере содержится 2 типовые ошибки:
> > 1. В подпакете -devel не включен каталог %_docdir/%name-%version, что
> >   приводит к потерянным каталогам при обновлении.
> > 2. Для файлов и каталогов, начинающихся с %_docdir, не нужно указывать
> >   %doc, ибо это уже заложено в rpm.
> 
> > P.S. А в libxml2-python документация вообще не на месте.
> 
> Если пакет разбит на части package, package-common ... 
> документацию стоит включать только в один пакет ? 

Это зависит от характера документации.

> по логике файлы должны принадлежать package-common,
> но тогда они будут лежать  в 
> %_docdir/%name-common-%version вместо %_docdir/%name-%version

%name-common-%version - это не очень хорошо; лучше разложить вручную.


--
ldv

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] IA: rpm: how to install %docs properly

[Igor Homyakov]

On Mon, Sep 30, 2002 at 02:49:03PM +0400, Dmitry V. Levin wrote:
> > Если пакет разбит на части package, package-common ... 
> > документацию стоит включать только в один пакет ? 

> Это зависит от характера документации.

я имел в виду README TODO и т.д.

> > по логике файлы должны принадлежать package-common,
> > но тогда они будут лежать  в 
> > %_docdir/%name-common-%version вместо %_docdir/%name-%version

> %name-common-%version - это не очень хорошо; лучше разложить вручную.

как это сделать "красиво" ?
возможно переопределить %_docdir ?

--
Igor Homyakov
<homyakov at altlinux dot ru>
http://counter.li.org/cgi-bin/runscript/display-person.cgi?user=190141

Re: [devel] IA: rpm: how to install %docs properly

[Igor Homyakov]

On Mon, Sep 30, 2002 at 03:40:19PM +0400, Dmitry V. Levin wrote:
> %install
> [...]
> %__mkdir_p $RPM_BUILD_ROOT%_docdir/%name-%version
> %__install -p -m644 список_файлов \
> 	$RPM_BUILD_ROOT%_docdir/%name-%version/

кстати, что надо  использовать $RPM_BUILD_ROOT или %buildroot ? 

--
Igor Homyakov
<homyakov at altlinux dot ru>
http://counter.li.org/cgi-bin/runscript/display-person.cgi?user=190141

Re: [devel] IA: rpm: how to install %docs properly

[Dmitry V. Levin]

[-- Attachment #1: Type: text/plain, Size: 876 bytes --]

On Mon, Sep 30, 2002 at 03:06:18PM +0400, Igor Homyakov wrote:
> > > Если пакет разбит на части package, package-common ... 
> > > документацию стоит включать только в один пакет ? 
> 
> > Это зависит от характера документации.
> 
> я имел в виду README TODO и т.д.

Если документация не распадается на компоненты, то можно и в -common.

> > > по логике файлы должны принадлежать package-common,
> > > но тогда они будут лежать  в 
> > > %_docdir/%name-common-%version вместо %_docdir/%name-%version
> 
> > %name-common-%version - это не очень хорошо; лучше разложить вручную.
> 
> как это сделать "красиво" ?
> возможно переопределить %_docdir ?

Как красиво - не знаю.
Пока делаю так:

%install
[...]
%__mkdir_p $RPM_BUILD_ROOT%_docdir/%name-%version
%__install -p -m644 список_файлов \
	$RPM_BUILD_ROOT%_docdir/%name-%version/
[...]
%files
%_docdir/%name-%version


--
ldv

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] IA: rpm: how to install %docs properly

[Dmitry V. Levin]

[-- Attachment #1: Type: text/plain, Size: 354 bytes --]

On Mon, Sep 30, 2002 at 03:36:55PM +0400, Igor Homyakov wrote:
> > %install
> > [...]
> > %__mkdir_p $RPM_BUILD_ROOT%_docdir/%name-%version
> > %__install -p -m644 список_файлов \
> > 	$RPM_BUILD_ROOT%_docdir/%name-%version/
> 
> кстати, что надо  использовать $RPM_BUILD_ROOT или %buildroot ? 

Дело вкуса.
Но лучше в одном файле не смешивать.


--
ldv

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] IA: rpm: how to install %docs properly

[Alexey I. Froloff]

[-- Attachment #1: Type: text/plain, Size: 649 bytes --]

On Mon, Sep 30, 2002 at 03:40:19PM +0400, Dmitry V. Levin wrote:
> Как красиво - не знаю.
> Пока делаю так:

> %install
> [...]
> %__mkdir_p $RPM_BUILD_ROOT%_docdir/%name-%version
> %__install -p -m644 список_файлов \
> 	$RPM_BUILD_ROOT%_docdir/%name-%version/
> [...]
> %files
> %_docdir/%name-%version

Кстати, feature request. Насколько я раскопал, в rpm железно
забито копирование %doc'ов в %_docdir/%name-%version, хочется
иметь возможность переопределить этот каталог на, например,
%_docdir/%name/%version.

P.S. Ну и до кучи про rpm - группы Documentation/*, что с ними
решили? И как насчет Development/Objective-C ?

-- 
Regards,
Sir Raorn.

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] IA: rpm: how to install %docs properly

[Dmitry V. Levin]

[-- Attachment #1: Type: text/plain, Size: 751 bytes --]

On Mon, Sep 30, 2002 at 08:14:55PM +0400, Alexey I. Froloff wrote:
> > Как красиво - не знаю.
> > Пока делаю так:
> 
> > %install
> > [...]
> > %__mkdir_p $RPM_BUILD_ROOT%_docdir/%name-%version
> > %__install -p -m644 список_файлов \
> > 	$RPM_BUILD_ROOT%_docdir/%name-%version/
> > [...]
> > %files
> > %_docdir/%name-%version
> 
> Кстати, feature request. Насколько я раскопал, в rpm железно
> забито копирование %doc'ов в %_docdir/%name-%version, хочется
> иметь возможность переопределить этот каталог на, например,
> %_docdir/%name/%version.

Это как?

> P.S. Ну и до кучи про rpm - группы Documentation/*, что с ними

Ничего не решили (не хватило кворума для принятия решения).

> решили? И как насчет Development/Objective-C ?

Легко.


--
ldv

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] IA: rpm: how to install %docs properly

[Alexey I. Froloff]

[-- Attachment #1: Type: text/plain, Size: 1503 bytes --]

On Tue, Oct 01, 2002 at 10:15:43AM +0400, Dmitry V. Levin wrote:
> > Кстати, feature request. Насколько я раскопал, в rpm железно
> > забито копирование %doc'ов в %_docdir/%name-%version, хочется
> > иметь возможность переопределить этот каталог на, например,
> > %_docdir/%name/%version.
> Это как?
Показываю:

%files
%doc AUTHORS README

В rpm-tmp.X видим 

cp -R AUTHORS README %_defaultdocdir/%name-%version

Вот этот %_defaultdocdir/%name-%version (естественно в rpm-tmp
ун попадет уже в подставленном виде с %name = имени текущего
пакета) в rpm забит железно:

build/files.c:
/* XXX WATCHOUT: buf is an arg */
    {   const char *ddir, *n, *v;

        (void) headerNVR(pkg->header, &n, &v, NULL);

>       ddir = rpmGetPath("%{_docdir}/", n, "-", v, NULL);
        strcpy(buf, ddir);
        ddir = _free(ddir);
    }

/* XXX FIXME: this is easy to do as macro expansion */
[skipped a bit...]

    appendStringBuf(pkg->specialDoc, "cp -pr ");
    appendStringBuf(pkg->specialDoc, specialDocBuf);
    appendLineStringBuf(pkg->specialDoc, " \"$DOCDIR\"");

Вот хотелось бы переопределить этот *DOCDIR самому, чтобы
посто прописать %doc в пакете, а rpm сам все куда надо
скопировал бы...

Есть идея оформить это макросом, которому бы передавались имя
пакета и версия...

> > P.S. Ну и до кучи про rpm - группы Documentation/*, что с ними
> Ничего не решили (не хватило кворума для принятия решения).
:-(

> > решили? И как насчет Development/Objective-C ?
> Легко.
Отлично!

-- 
Regards,
Sir Raorn.

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] IA: rpm: how to install %docs properly

[Dmitry V. Levin]

[-- Attachment #1: Type: text/plain, Size: 205 bytes --]

On Tue, Oct 01, 2002 at 09:08:51PM +0400, Alexey I. Froloff wrote:
> > > решили? И как насчет Development/Objective-C ?
> > Легко.
> Отлично!

Как, кстати, лучше, "Objective-C" или "Objective C"?


--
ldv

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] IA: rpm: how to install %docs properly

[Yuri N. Sedunov]

On 1 Октябрь 2002 10:15, Dmitry V. Levin wrote:


> Ничего не решили (не хватило кворума для принятия решения).
>
> > решили? И как насчет Development/Objective-C ?
>
> Легко.

А также легко с Education|Edutainment не получится?
Новые версии tuxtype и gtypist давно хотят в Сизиф.

-- 
Yuri N. Sedunov

Re: [devel] IA: rpm: how to install %docs properly

[Alexey I. Froloff]

[-- Attachment #1: Type: text/plain, Size: 276 bytes --]

On Tue, Oct 01, 2002 at 09:17:15PM +0400, Dmitry V. Levin wrote:
> > > > решили? И как насчет Development/Objective-C ?
> > > Легко.
> > Отлично!
> Как, кстати, лучше, "Objective-C" или "Objective C"?
Objective-C, судя по info gcc и другим источникам.
-- 
Regards,
Sir Raorn.

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] IA: rpm: how to install %docs properly

[Dmitry V. Levin]

[-- Attachment #1: Type: text/plain, Size: 377 bytes --]

On Wed, Oct 02, 2002 at 03:03:29PM +0400, Yuri N. Sedunov wrote:
> > Ничего не решили (не хватило кворума для принятия решения).
> >
> > > решили? И как насчет Development/Objective-C ?
> >
> > Легко.
> 
> А также легко с Education|Edutainment не получится?

Легко с группами 1-го уровня не бывает.

На каком имени остановимся,
Education, Educational или Edutainment?


--
ldv

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] IA: rpm: how to install %docs properly

[Yuri N. Sedunov]

On 4 Октябрь 2002 01:32, Dmitry V. Levin wrote:
> On Wed, Oct 02, 2002 at 03:03:29PM +0400, Yuri N. Sedunov wrote:
> > > Ничего не решили (не хватило кворума для принятия решения).
> > >
> > > > решили? И как насчет Development/Objective-C ?
> > >
> > > Легко.
> >
> > А также легко с Education|Edutainment не получится?
>
> Легко с группами 1-го уровня не бывает.
>
> На каком имени остановимся,
> Education, Educational или Edutainment?

1. Education
- gtypist
- typespeed
- программы из проекта kdeedu
...

2. Education/Games (Games/Educational)
- TuxType и другие из проекта Tux4kids 
...

Кстати, может найдется желающий собрать Tux{Math,Paint}?

-- 
Yuri N. Sedunov

Re: [devel] IA: rpm: how to install %docs properly

[Dmitry V. Levin]

[-- Attachment #1: Type: text/plain, Size: 202 bytes --]

On Fri, Oct 04, 2002 at 07:29:36AM +0400, Yuri N. Sedunov wrote:
> > Education, Educational или Edutainment?
> 
> 1. Education
> 2. Education/Games (Games/Educational)
Перевод на русский язык?


--
ldv

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] IA: rpm: how to install %docs properly

[Yuri N. Sedunov]

On 4 Октябрь 2002 13:23, Dmitry V. Levin wrote:
> On Fri, Oct 04, 2002 at 07:29:36AM +0400, Yuri N. Sedunov wrote:
> > > Education, Educational или Edutainment?
> >
> > 1. Education
> > 2. Education/Games (Games/Educational)
>
> Перевод на русский язык?

Гхм...
1. Обучение
2. Обучение/Игры (Игры/Обучающие)

-- 
Yuri N. Sedunov

Re: [devel] IA: rpm: how to install %docs properly

[Dmitry V. Levin]

[-- Attachment #1: Type: text/plain, Size: 312 bytes --]

On Fri, Oct 04, 2002 at 02:30:09PM +0400, Yuri N. Sedunov wrote:
> > > > Education, Educational или Edutainment?
> > >
> > > 1. Education
> > > 2. Education/Games (Games/Educational)
> >
> > Перевод на русский язык?
> 
> Гхм...
> 1. Обучение
> 2. Обучение/Игры (Игры/Обучающие)

Done for rpm-4.0.4-alt5


--
ldv

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] IA: rpm: how to install %docs properly

[at]

On Mon, Sep 30, 2002 at 12:53:44PM +0400, Dmitry V. Levin wrote:
> Я заметил, что многие из вас делают типичную ошибку, включая
> %_docdir/%name-%version только в один из подпакетов.

> 1. В подпакете -devel не включен каталог %_docdir/%name-%version, что
>   приводит к потерянным каталогам при обновлении.

У меня есть два вопроса:

1) почему это приводит к потере каталогов при обновлении?

2) справедливо ли это требование для других каталогов, которые совместно
используются группой пакетов? Так -- правильно?

%files base
%dir	%privlib/File
	%privlib/File/Basename.pm
	%privlib/File/Compare.pm
	%privlib/File/Copy.pm
	%privlib/File/Find.pm
	%privlib/File/Path.pm
	%privlib/File/Spec.pm
%dir	%privlib/File/Spec
	%privlib/File/Spec/Functions.pm
	%privlib/File/Spec/Unix.pm
	%privlib/File/stat.pm
	%privlib/File/Temp.pm

%files
%dir	%privlib/File
	%privlib/File/CheckTree.pm
	%privlib/File/DosGlob.pm
%dir	%privlib/File/Spec
	%privlib/File/Spec/Cygwin.pm
	%privlib/File/Spec/Epoc.pm
	%privlib/File/Spec/Mac.pm
	%privlib/File/Spec/OS2.pm
	%privlib/File/Spec/VMS.pm
	%privlib/File/Spec/Win32.pm

Re: [devel] IA: rpm: how to install %docs properly

[Dmitry V. Levin]

[-- Attachment #1: Type: text/plain, Size: 837 bytes --]

On Sat, Oct 19, 2002 at 02:34:54AM +0400, at@turbinal.org wrote:
> > Я заметил, что многие из вас делают типичную ошибку, включая
> > %_docdir/%name-%version только в один из подпакетов.
> 
> > 1. В подпакете -devel не включен каталог %_docdir/%name-%version, что
> >   приводит к потерянным каталогам при обновлении.
> 
> У меня есть два вопроса:
> 
> 1) почему это приводит к потере каталогов при обновлении?

Как правило, сперва удаляется пакет, содержащий каталог, и только потом пакет,
не содержащий каталог; как следствие, в системе остается этот каталог.

> 2) справедливо ли это требование для других каталогов, которые совместно
> используются группой пакетов? Так -- правильно?

Как правило, справедливо.

Очень нежелательно разделять таким образом обычные файлы, ибо это приводит
к избыточным сборочным зависимостям.


--
ldv

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] IA: rpm: how to install %docs properly

[Igor Homyakov]

On Sat, Oct 19, 2002 at 03:03:32PM +0400, Dmitry V. Levin wrote:
> On Sat, Oct 19, 2002 at 02:34:54AM +0400, at@turbinal.org wrote:
> > > Я заметил, что многие из вас делают типичную ошибку, включая
> > > %_docdir/%name-%version только в один из подпакетов.

а как правильно ? 

у меня package-contrib содержит /usr/share/doc/package-version
это не коректно ?

--
Igor Homyakov
<homyakov at altlinux dot ru>
http://counter.li.org/cgi-bin/runscript/display-person.cgi?user=190141

Re: [devel] IA: rpm: how to install %docs properly

[Dmitry V. Levin]

[-- Attachment #1: Type: text/plain, Size: 371 bytes --]

On Mon, Oct 21, 2002 at 03:26:32PM +0400, Igor Homyakov wrote:
> > > > Я заметил, что многие из вас делают типичную ошибку, включая
> > > > %_docdir/%name-%version только в один из подпакетов.
> 
> а как правильно ? 

Если подпакеты содержат файлы в общих каталогах (напр.
/usr/share/doc/package-version), то и сами каталоги должны принадлежать
этим подпакетам.


--
ldv

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] IA: rpm: how to install %docs properly

[at]

On Sat, Oct 19, 2002 at 03:03:32PM +0400, Dmitry V. Levin wrote:
> Как правило, сперва удаляется пакет, содержащий каталог, и только потом пакет,
> не содержащий каталог; как следствие, в системе остается этот каталог.

Откуда такое правило?

Name: foobar
Version: 1.0
Release: alt1
%package devel
PreReq: foobar = %version-%release

должны (насколько я понимаю)

устанавливаться: в порядке: foobar, foobar-devel;
удаляться: в порядке: foobar-devel, foobar.

Да/нет?

Re: [devel] IA: rpm: how to install %docs properly

[Dmitry V. Levin]

[-- Attachment #1: Type: text/plain, Size: 669 bytes --]

On Tue, Oct 22, 2002 at 12:21:25AM +0400, at@turbinal.org wrote:
> > Как правило, сперва удаляется пакет, содержащий каталог, и только потом пакет,
> > не содержащий каталог; как следствие, в системе остается этот каталог.
> 
> Откуда такое правило?
> 
> Name: foobar
> Version: 1.0
> Release: alt1
> %package devel
> PreReq: foobar = %version-%release
> 
> должны (насколько я понимаю)
> 
> устанавливаться: в порядке: foobar, foobar-devel;

Да.

> удаляться: в порядке: foobar-devel, foobar.

Нет.

Если нужно _этого_ добиться, то следует использовать
Requires(pre,postun): foobar = %version-%release
(не проверял, но согласно документации должно работать).


--
ldv

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]