Hi,
since some packagers reverted my way to install the package docs of some of my contributed packages, I would like to discuss these issues here.
I actively avoid the %doc directive in my packages with separate -doc package for two reasons:
* i don't like the silly /usr/share/doc/packages/pkgname-doc, because /usr/share/doc/packages is _way_ too crowded already, and for common sense sake, the doc should be located in the doc hierarchy of the package itself: /usr/share/doc/packages/pkgname.
* the way, rpm copies the data (cp -pr) reverts the changes of %fdupes, which is a pity, since especially the docs tend to provide redundant data.
Does anybody agree with me?
Pete
Hi Pete
Am 24.08.2011 23:42, schrieb Hans-Peter Jansen:
Hi,
since some packagers reverted my way to install the package docs of some of my contributed packages, I would like to discuss these issues here.
I actively avoid the %doc directive in my packages with separate -doc package for two reasons:
- i don't like the silly /usr/share/doc/packages/pkgname-doc, because /usr/share/doc/packages is _way_ too crowded already, and for common sense sake, the doc should be located in the doc hierarchy of the package itself: /usr/share/doc/packages/pkgname.
I agree, when having doc as subpkg, then path should be
/usr/share/doc/packages/pkgname
and not
/usr/share/doc/packages/pkgname-doc
- the way, rpm copies the data (cp -pr) reverts the changes of %fdupes, which is a pity, since especially the docs tend to provide redundant data.
Does anybody agree with me?
Pete
Cheers
On Thu, 25 Aug 2011 02:11:08 +0200, Christian chris@computersalat.de wrote:
I agree, when having doc as subpkg, then path should be
/usr/share/doc/packages/pkgname
And? So you redefine the name rpm uses which is docdir if I remember correctly.
Philipp
On Thursday 25 August 2011, 05:07:55 Philipp Thomas wrote:
On Thu, 25 Aug 2011 02:11:08 +0200, Christian chris@computersalat.de
wrote:
I agree, when having doc as subpkg, then path should be
/usr/share/doc/packages/pkgname
And? So you redefine the name rpm uses which is docdir if I remember correctly.
Well, if I do:
%define _docdir /usr/share/doc/packages/python-polib
I harvest:
Executing(%doc): /bin/sh -e /var/tmp/rpm-tmp.22547 + umask 022 + cd /usr/src/packages/BUILD + cd polib-0.7.0 + DOCDIR=/var/tmp/python-polib-0.7.0-build/usr/share/doc/packages/python-polib/python-polib-doc + export DOCDIR + rm -rf /var/tmp/python-polib-0.7.0-build/usr/share/doc/packages/python-polib/python-polib-doc + /bin/mkdir -p /var/tmp/python-polib-0.7.0-build/usr/share/doc/packages/python-polib/python-polib-doc + cp -pr docs/_build/html /var/tmp/python-polib-0.7.0-build/usr/share/doc/packages/python-polib/python-polib-doc + exit 0
Up to /var/tmp/python-polib-0.7.0-build/usr/share/doc/packages/python-polib, it's fine, but %doc seems to insist of using the packages name as the last element.
Close, but no cigar.
Pete
Am Thursday 25 August 2011 09:05:21 schrieb Hans-Peter Jansen:
On Thursday 25 August 2011, 05:07:55 Philipp Thomas wrote:
On Thu, 25 Aug 2011 02:11:08 +0200, Christian chris@computersalat.de
wrote:
I agree, when having doc as subpkg, then path should be
/usr/share/doc/packages/pkgname
And? So you redefine the name rpm uses which is docdir if I remember correctly.
Since the (somewhat) suggested:
%define _docdir /usr/share/doc/packages/python-polib
failed, any other idea on how to manage %doc sanely without copying it manually?
Pete
-
Christian -
Hans-Peter Jansen -
Philipp Thomas