SpecTips/doc: различия между версиями

Текущая версия от 18:05, 19 октября 2008

Использование %doc

В спек-файле нельзя одновременно использовать конструкции

%doc <абсолютный-путь-в-%_docdir в %buildroot>

и

%doc <относительный-путь в каталоге, полученном в %prep>

Это является особенностью^[1] реализации RPM: когда выполняется %doc второго вида, то каталог %_docdir сначала удаляется, потом заново создаётся, и в него копируются файлы, указанные в виде относительных путей. При повторном указании %doc второго вида каталог %_docdir не удаляется.

В этом примере в %doc попадут только Changes и AUTHORS, без README:

%build
touch Changes
%install
install -pD -m644 /dev/null %buildroot%_docdir/%name-%version/README
%files
%doc %_docdir/%name-%version
%doc Changes
%doc AUTHORS

Сборка пакета при этом остановится с ошибкой:

Wrote: /usr/src/RPM/SRPMS/name-2.1.3-alt1.src.rpm
error: create archive failed on file 
/usr/src/tmp/name-buildroot/usr/share/doc/name-2.1.3/README: 
cpio: open failed - Bad file descriptor

Ссылки

↑ http://lists.altlinux.org/pipermail/devel/2008-October/080757.html

http://lists.altlinux.org/pipermail/devel/2008-October/080670.html

[1] ttp://lists.altlinux.org/pipermail/devel/2008-October/080757.html

[1]

@@ Строка 1: / Строка 1: @@
-{{викифицировать}}
+[[Category:Devel]]
-<pre>
+== Использование %doc ==
-On Thu, Oct 16, 2008 at 04:02:00PM +0400, Vitaly Ostanin wrote:
-> Обнаружил, что при наличии в спеке в %files
-> такой строки
-> %doc %_defaultdocdir/%name-%version
->
-> пакет не собирается со странными
-> сообщениями:
->
-> Wrote: /usr/src/RPM/SRPMS/heartbeat-2.1.3-alt1.src.rpm
-> error: create archive failed on file
-> /usr/src/tmp/heartbeat-buildroot/usr/share/doc/heartbeat-2.1.3/AUTHORS:
-> cpio: open failed - Bad file descriptor
->
-> RPM build errors:
->     File listed twice: /etc/ha.d/resource.d/ldirectord
->     File listed twice: /usr/lib/ocf/resource.d/heartbeat/ldirectord
->     File listed twice: /usr/share/doc/heartbeat-2.1.3
->
-> Если эту строку удалить, то пакет
-> собирается нормально.
-Нельзя одновременно использовать
+В спек-файле нельзя одновременно использовать конструкции
-%doc <абсолютный-путь-в-дефолтном-каталоге>
+ %doc <абсолютный-путь-в-%_docdir в %buildroot>
-%doc <относительный-путь>
+и
+ %doc <относительный-путь в каталоге, полученном в %prep>
-Это связано с тем, что, когда выполняется %doc второго вида,
+Это является особенностью<ref>http://lists.altlinux.org/pipermail/devel/2008-October/080757.html</ref> реализации RPM: когда выполняется <tt>%doc</tt> второго вида, то каталог <tt>%_docdir</tt> сначала удаляется, потом заново создаётся, и в него копируются файлы, указанные в виде относительных путей. При повторном указании %doc второго вида каталог <tt>%_docdir</tt> не удаляется.
-то дефолтный каталог сначала удаляется, потом заново создаётся,
-и в него копируются <относительные-пути>.
+В этом примере в %doc попадут только Changes и AUTHORS, без README:
+<pre>
 %build
 touch Changes
@@ Строка 37: / Строка 18: @@
 %doc %_docdir/%name-%version
 %doc Changes
+%doc AUTHORS
+</pre>
-Когда "%doc Changes" будет исполнен, то он "затрёт" README.
+Сборка пакета при этом остановится с ошибкой:
+<pre>
+Wrote: /usr/src/RPM/SRPMS/name-2.1.3-alt1.src.rpm
+error: create archive failed on file
+/usr/src/tmp/name-buildroot/usr/share/doc/name-2.1.3/README:
+cpio: open failed - Bad file descriptor
+</pre>
-Executing(%doc): /bin/sh -e /tmp/.private/at/rpm-tmp.96021
+== Ссылки ==
-+ umask 022
+<references/>
-+ /bin/mkdir -p /tmp/.private/at/BUILD
+# http://lists.altlinux.org/pipermail/devel/2008-October/080670.html
-+ cd /tmp/.private/at/BUILD
-+ DOCDIR=/tmp/.private/at/test-buildroot/usr/share/doc/test-0
-+ export DOCDIR
-+ rm -rf /tmp/.private/at/test-buildroot/usr/share/doc/test-0
-+ /bin/mkdir -p /tmp/.private/at/test-buildroot/usr/share/doc/test-0
-+ cp -prL Changes /tmp/.private/at/test-buildroot/usr/share/doc/test-0
-+ chmod -R go-w /tmp/.private/at/test-buildroot/usr/share/doc/test-0
-+ chmod -R a+rX /tmp/.private/at/test-buildroot/usr/share/doc/test-0
-+ exit 0
-</pre>