Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 296669

Summary: dev-util/bless: documentation installed outside /usr/share/doc/${PF}
Product: Gentoo Linux Reporter: Diego Elio Pettenò (RETIRED) <flameeyes>
Component: New packagesAssignee: Mike Auty (RETIRED) <ikelos>
Status: RESOLVED FIXED    
Severity: minor    
Priority: High    
Version: unspecified   
Hardware: All   
OS: Linux   
Whiteboard:
Package list:
Runtime testing required: ---

Description Diego Elio Pettenò (RETIRED) gentoo-dev 2009-12-12 23:32:21 UTC
You're getting this bug because the package in summary installs its documentation (or at least part of it) outside the usual /usr/share/doc/${PF} directory.

First, please keep in mind that this bug might not be noticeable for -r0 ebuilds, but it might be for -r1 and later, since if the ebuild has same name and version of the package, for -r0 it might correspond properly.

To fix this, if the package uses autotools, recent version (autoconf 2.61+) have two ./configure switches: --docdir and --htmldir to decide where to put the documentation. Older versions might require you override docdir/htmldir or other custom variables during make install.

For non-autotooled build systems, good luck, since I cannot tell you how to achieve the proper results, the same holds true with totally broken buildsystems even when based on autotools.

Thanks,
Diego
Comment 1 Mike Auty (RETIRED) gentoo-dev 2009-12-13 15:40:05 UTC
Ok, thanks for the notice, this has been fixed for the latest version.  I ended up using a patch to the makefile.am's since they contained lines like:

 install-data-local:
       $(INSTALL) -d $(DESTDIR)$(datadir)/doc/$(PACKAGE_NAME)

Is there a particular variable I could use instead of altering the above to be $(PACKAGE_NAME)-$(PACKAGE_VERSION)?  Ideally one that would get passed in by econf...  5:)
Comment 2 Diego Elio Pettenò (RETIRED) gentoo-dev 2009-12-13 16:28:43 UTC
autoconf 2.63 and later already have a --docdir option and a tied docdir variable in the Makefile.

So you should be able to just define doc_DATA = FILE1 FILE2 FILE3 instead of using custom rules.
Comment 3 Mike Auty (RETIRED) gentoo-dev 2009-12-13 17:01:54 UTC
Just committed a much better fix, thanks very much!  5:)
Comment 4 Mike Auty (RETIRED) gentoo-dev 2009-12-13 17:02:09 UTC
Doh, meant to leave that FIXED (sorry).