| Summary: | sys-apps/portage - FEATURES="nodoc" does not cover /usr/share/gtk-doc | ||
|---|---|---|---|
| Product: | Portage Development | Reporter: | cronolio <salikov.alexey> |
| Component: | Enhancement/Feature Requests | Assignee: | Portage team <dev-portage> |
| Status: | RESOLVED DUPLICATE | ||
| Severity: | normal | CC: | floppym, gnome, salikov.alexey |
| Priority: | Normal | ||
| Version: | unspecified | ||
| Hardware: | All | ||
| OS: | Linux | ||
| See Also: | https://bugs.gentoo.org/show_bug.cgi?id=556352 | ||
| Whiteboard: | |||
| Package list: | Runtime testing required: | --- | |
|
Description
cronolio
2016-10-20 16:27:36 UTC
This sound like something that should be fixed/worked-around in portage, not individual packages. Apparently we need to support an extensible list of documentation directories. sys-power/upower-pm-utils-0.9.23-r2 media-libs/raptor-2.0.14 x11-libs/libxklavier-5.3 also have same issue. if it by portage. also us mentioned here https://wiki.gentoo.org/wiki/Project:GNOME/Gnome_Team_Ebuild_Policies#Handling_gtk-doc_documentation gtk-doc must be always installed in /usr/share/gtk-doc. Apparently we need to kill nonsense FEATURES and teach people to use INSTALL_MASK. (In reply to Michał Górny from comment #4) > Apparently we need to kill nonsense FEATURES and teach people to use > INSTALL_MASK. why i should compile and generate there doc if i will not install it ? (In reply to cronolio from comment #5) > (In reply to Michał Górny from comment #4) > > Apparently we need to kill nonsense FEATURES and teach people to use > > INSTALL_MASK. > > why i should compile and generate there doc if i will not install it ? FEATURES="nodoc" only removes files. You'd need a USE flag to control what is compiled/generated. (In reply to Zac Medico from comment #6) > (In reply to cronolio from comment #5) > > (In reply to Michał Górny from comment #4) > > > Apparently we need to kill nonsense FEATURES and teach people to use > > > INSTALL_MASK. > > > > why i should compile and generate there doc if i will not install it ? > > FEATURES="nodoc" only removes files. You'd need a USE flag to control what > is compiled/generated. i have -doc globally and it is not help me with gtk-doc. also it take 179M /usr/share/gtk-doc (In reply to cronolio from comment #7) This bug is about FEATURES="nodoc". Please file a separate bug if you want the gnome team to start making gtk-doc optional at build time. (In reply to Michał Górny from comment #4) > Apparently we need to kill nonsense FEATURES and teach people to use > INSTALL_MASK. Yeah, maybe so. The overlap with INSTALL_MASK functionality certainly makes nodoc redundant. 1) udisks and other stuff must NOT put gtk-doc's in other places than the default $prefix/share/gtk-doc. It has no business being in $prefix/share/$PVR at all, even less so with different applying of FEATURES=nodoc there. At one point in the past just ssuominen was moving them against our advice. This is the original bug reported here (the dead symbolic link QA notice) and should be fixed. 2) gtk-doc will not be made optional via a USE flag, because there are no extra runtime dependencies besides a tiny package that ships a .m4 file and a tool to very quickly fix up cross-references to point to your disk instead of online, where possible. Usually a full gtk-doc buildtime dependency tends to be wrong, or only for versions that aren't built from a full tarball; proper release tarballs using gtk-doc contain the documentation pre-built and have no generation during build (besides the link tweaking postinstall). gtk-doc's are usually developer documentations, if looking into what INSTALL_MASK future group feature to put it once this mgorny spearheaded feature gets done. The usual tool to look at these is dev-util/devhelp and other devhelp infrastructure using things, e.g gnome-builder IDE built-in integration into these API gtk-docs. commit 9d20cecd1876a6f483ac43ad205043bedbf6da11 Author: Mike Gilbert <floppym@gentoo.org> Date: Sat Oct 22 20:42:46 2016 -0400 sys-fs/udisks: stop symlinking gtk-doc Install html documentation in /usr/share/gtk-doc instead. Bug: https://bugs.gentoo.org/597628 Package-Manager: portage-2.3.2 .../udisks/{udisks-2.1.7.ebuild => udisks-2.1.7-r1.ebuild} | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) I leave it to the portage maintainers to ultimately decide what to do with this bug report. Sorry, that's 23e2baefa268a263c319287ccd6c4a8924d6b249; I pasted before pushing and had to rebase. *** This bug has been marked as a duplicate of bug 556352 *** |
