Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 297963 - gpe-utils/gpe-edit: documentation installed outside /usr/share/doc/${PF}
Summary: gpe-utils/gpe-edit: documentation installed outside /usr/share/doc/${PF}
Status: RESOLVED INVALID
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: New packages (show other bugs)
Hardware: All Linux
: High minor
Assignee: GPE Desktop project
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2009-12-22 21:03 UTC by Diego Elio Pettenò (RETIRED)
Modified: 2009-12-28 04:02 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Diego Elio Pettenò (RETIRED) gentoo-dev 2009-12-22 21:03:27 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 Angelo Arrifano (RETIRED) gentoo-dev 2009-12-28 04:02:44 UTC
First of all, thanks for the QA report.

The file in question /usr/share/doc/gpe/gpe-edit.html (and many others) are part of the GPE documentation system which can be viewable by gpe-helpviewer. The concept is somewhat similar to gtk-doc, which installs into /usr/share/gtk-doc/ .

Upstream puts all GPE documentation in /usr/share/doc/gpe so, unless compliance is strictly required, I think it is a good idea to keep it in that way.