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

Bug 241278

Summary: dev-libs/rlog: documentation installed outside /usr/share/doc/${PF}
Product: Gentoo Linux Reporter: Diego Elio Pettenò (RETIRED) <flameeyes>
Component: New packagesAssignee: Marcelo Goes (RETIRED) <vanquirius>
Status: RESOLVED FIXED    
Severity: minor CC: cpp+disabled
Priority: High    
Version: unspecified   
Hardware: All   
OS: Linux   
Whiteboard:
Package list:
Runtime testing required: ---

Description Diego Elio Pettenò (RETIRED) gentoo-dev 2008-10-11 10:44:40 UTC
[snip]
./usr/share/doc/rlog/html/rlog-1_83_87_2rlog_2Error_8h-source.html
./usr/share/doc/rlog/html/rlog-1_83_87_2rlog_2Lock_8h-source.html
./usr/share/doc/rlog/html/rlog-1_83_87_2rlog_2Mutex_8h-source.html
./usr/share/doc/rlog/html/rlog-1_83_87_2rlog_2RLogChannel_8h-source.html
./usr/share/doc/rlog/html/rlog-1_83_87_2rlog_2RLogNode_8h-source.html
./usr/share/doc/rlog/html/rlog-1_83_87_2rlog_2RLogPublisher_8h-source.html
./usr/share/doc/rlog/html/rlog-1_83_87_2rlog_2RLogTime_8h-source.html
./usr/share/doc/rlog/html/rlog-1_83_87_2rlog_2StdioNode_8h-source.html
./usr/share/doc/rlog/html/rlog-1_83_87_2rlog_2SyslogNode_8h-source.html
./usr/share/doc/rlog/html/rlog-1_83_87_2rlog_2rlog-c99_8h-source.html
./usr/share/doc/rlog/html/rlog-1_83_87_2rlog_2rlog-novariadic_8h-source.html
./usr/share/doc/rlog/html/rlog-1_83_87_2rlog_2rlog-prec99_8h-source.html
./usr/share/doc/rlog/html/rlog-1_83_87_2rlog_2rlog_8h-source.html
./usr/share/doc/rlog/html/rlog-1_83_87_2rlog_2rloginit_8h-source.html
./usr/share/doc/rlog/html/rlog-1_83_87_2rlog_2rloglocation_8h-source.html
./usr/share/doc/rlog/html/rlog_2Error_8h-source.html
./usr/share/doc/rlog/html/rlog_2Lock_8h-source.html
./usr/share/doc/rlog/html/rlog_2Mutex_8h-source.html
./usr/share/doc/rlog/html/rlog_2RLogChannel_8h-source.html
./usr/share/doc/rlog/html/rlog_2RLogNode_8h-source.html
./usr/share/doc/rlog/html/rlog_2RLogPublisher_8h-source.html
./usr/share/doc/rlog/html/rlog_2RLogTime_8h-source.html
./usr/share/doc/rlog/html/rlog_2StdioNode_8h-source.html
./usr/share/doc/rlog/html/rlog_2SyslogNode_8h-source.html
./usr/share/doc/rlog/html/rlog_2rlog-c99_8h-source.html
./usr/share/doc/rlog/html/rlog_2rlog-novariadic_8h-source.html
./usr/share/doc/rlog/html/rlog_2rlog-prec99_8h-source.html
./usr/share/doc/rlog/html/rlog_2rlog_8h-source.html
./usr/share/doc/rlog/html/rlog_2rloginit_8h-source.html
./usr/share/doc/rlog/html/rlog_2rloglocation_8h-source.html
./usr/share/doc/rlog/refman.pdf
dev-libs/rlog-1.3.7.tbz2

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 Samuli Suominen (RETIRED) gentoo-dev 2010-06-03 09:55:23 UTC
+  03 Jun 2010; Samuli Suominen <ssuominen@gentoo.org> rlog-1.4.ebuild:
+  Fix documentation directory wrt #241278 by Diego E. Pettenò. Mark amd64
+  stable wrt #322489.