Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 702940 - x11-misc/picom-7.5 IUSE=doc should not be used to control whether to install man pages
Summary: x11-misc/picom-7.5 IUSE=doc should not be used to control whether to install ...
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: All All
: Normal normal (vote)
Assignee: Bernard Cafarelli
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2019-12-14 22:20 UTC by Esteve Varela Colominas
Modified: 2019-12-16 10:26 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 Esteve Varela Colominas 2019-12-14 22:20:44 UTC
The "doc" flag is currently documented as:

    Add extra documentation (API, Javadoc, etc). It is
    recommended to enable per package instead of globally

However, the flag is required to install the regular man pages. I'm not sure if this should be that way due to the asciidoc dependency, but I'd expect this flag to toggle building docs stored under /usr/doc, not the regular program's man pages. If this really needs an option, maybe turn it on by default?
Comment 1 Bernard Cafarelli gentoo-dev 2019-12-16 09:37:34 UTC
Good point, thanks for the report!

Upstream flag is for doc and man pages at same time (and asciidoc) though that current release only has man pages

I will fix in a similar way to some packages with same issue:
* adding local description to explain this is yet another package needing long train of dependencies to buid man pages not included by default
* and make it enabled by default
Comment 2 Larry the Git Cow gentoo-dev 2019-12-16 10:26:40 UTC
The bug has been closed via the following commit(s):

https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=8d970c3e1e2303d6a251f9a05aae797385eae153

commit 8d970c3e1e2303d6a251f9a05aae797385eae153
Author:     Bernard Cafarelli <voyageur@gentoo.org>
AuthorDate: 2019-12-16 09:39:33 +0000
Commit:     Bernard Cafarelli <voyageur@gentoo.org>
CommitDate: 2019-12-16 10:26:16 +0000

    x11-misc/picom: add local description and enable by default USE=doc
    
    The flag controls doc and man pages build at same time, detail this and
    enable so users get man pages
    
    Closes: https://bugs.gentoo.org/702940
    Package-Manager: Portage-2.3.82, Repoman-2.3.20
    Signed-off-by: Bernard Cafarelli <voyageur@gentoo.org>

 x11-misc/picom/metadata.xml      | 1 +
 x11-misc/picom/picom-7.5.ebuild  | 2 +-
 x11-misc/picom/picom-9999.ebuild | 2 +-
 3 files changed, 3 insertions(+), 2 deletions(-)