Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 314101 - media-gfx/nip2: documentation installed outside /usr/share/doc/${PF}
Summary: media-gfx/nip2: documentation installed outside /usr/share/doc/${PF}
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: New packages (show other bugs)
Hardware: All Linux
: High minor (vote)
Assignee: Gentoo Graphics Project
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2010-04-09 12:28 UTC by Diego Elio Pettenò (RETIRED)
Modified: 2010-11-10 05:57 UTC (History)
2 users (show)

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 2010-04-09 12:28: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 Peter Volkov (RETIRED) gentoo-dev 2010-06-25 11:03:47 UTC
I'm not sure it's worth efforts in this case so suggestions are welcome. nip2 uses two pathes in sources:

#define NIP_DOCPATH "$VIPSHOME" G_DIR_SEPARATOR_S "share" G_DIR_SEPARATOR_S \
        "doc" G_DIR_SEPARATOR_S PACKAGE G_DIR_SEPARATOR_S "html"
#define VIPS_DOCPATH "$VIPSHOME" G_DIR_SEPARATOR_S "share" G_DIR_SEPARATOR_S \
        "doc" G_DIR_SEPARATOR_S "vips" G_DIR_SEPARATOR_S "html"

Fixed nip2 path is an easy task, but it's impossible to fix vips path as we'll have either to rebuild nip2 every time vips is bumped or we'll end with broken paths and unopenable documentation. In other words, fixing nip2 path is half of solution while fixing both paths will introduce nontrivial dependencies into packages. Is there any need to fix nip2 path only?
Comment 2 Samuli Suominen (RETIRED) gentoo-dev 2010-06-25 11:08:41 UTC
a bit of a hassle, but...

symlink to vips ebuild to keep the path constant? 
something like `dosym /usr/share/doc/${PF}/html /usr/share/vips/html`?
Comment 3 Peter Volkov (RETIRED) gentoo-dev 2010-11-10 05:55:17 UTC
vips fixed in 7.22.4.
Comment 4 Peter Volkov (RETIRED) gentoo-dev 2010-11-10 05:57:19 UTC
And nip2 fixed in 7.22.3. Thank you for report.
And thank you Samuli for suggestion. I've just kept installation of symlinks in both packages...