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

Bug 425214

Summary: 'dohtml -r ${directory}/' has undocumented behavior
Product: Gentoo Hosted Projects Reporter: Arfrever Frehtes Taifersar Arahesis <arfrever.fta>
Component: PMS/EAPIAssignee: PMS/EAPI <pms>
Severity: normal    
Priority: Normal    
Version: unspecified   
Hardware: All   
OS: All   
Package list:
Runtime testing required: ---

Description Arfrever Frehtes Taifersar Arahesis 2012-07-08 06:59:50 UTC
'dohtml -r ${directory}' installs e.g. /usr/share/doc/${PF}/html/${directory}/${file}.

With Portage, 'dohtml -r ${directory}/' installs e.g. /usr/share/doc/${PF}/html/${file}, so it behaves similarly to
'dohtml -r ${directory}/*', but it also installs files/directories whose names start with a dot (except names equal to "." and "..").

Currently at least 138 ebuilds in gentoo-x86 rely on this behavior.

If this behavior is intentional, then it should be documented.
Comment 1 Ulrich Müller gentoo-dev 2014-09-13 11:20:17 UTC
The council has deprecated dohtml in its 20140909 meeting, see bug 520546.
Comment 2 Michał Górny archtester Gentoo Infrastructure gentoo-dev Security 2014-09-13 12:41:46 UTC
Comment 3 Ulrich Müller gentoo-dev 2014-09-13 13:11:39 UTC
"doins -r a/b/c/" behaves like "doins -r a/b/c", because it is the same path if "c" is a directory. Especially, the last pathname component is "c" in both cases.

This is in line with the pathname resolution as specified in and with the behaviour of coreutils (e.g. basename and dirname utilities).

I fail to see in what way this would be undocumented.
Comment 4 Ulrich Müller gentoo-dev 2014-09-13 13:24:27 UTC
We also shouldn't reuse this bug (which is about dohtml) for an unrelated issue. If doins in Portage behaves differently from what is described in comment #3, I suggest opening a new bug.