Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 891123 - app-text/zathura add back IUSE=man to control dependency on sphinx
Summary: app-text/zathura add back IUSE=man to control dependency on sphinx
Status: RESOLVED DUPLICATE of bug 890589
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Piotr Karbowski (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2023-01-16 12:34 UTC by Cedric Sodhi
Modified: 2023-01-19 09:31 UTC (History)
1 user (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 Cedric Sodhi 2023-01-16 12:34:51 UTC
As by 837710, the USE flag "doc" should have been renamed to "man", not removed. Reflecting this build-time option is important because otherwise all of sphinx is pulled in as BDEPEND.
Comment 1 Piotr Karbowski (RETIRED) gentoo-dev 2023-01-16 14:28:01 UTC

*** This bug has been marked as a duplicate of bug 890589 ***
Comment 2 Piotr Karbowski (RETIRED) gentoo-dev 2023-01-16 14:34:50 UTC
Marked this as duplicate. The manpages are not to be togglable part of package, therefore those will always be installed.
Comment 3 Cedric Sodhi 2023-01-18 12:27:39 UTC
What do you mean by

> The manpages are not to be togglable part of package

? They evidently are as by upstream's design and also there is IUSE=man

> $ q use -eD man
> global[man] Build and install man pages
Comment 4 Piotr Karbowski (RETIRED) gentoo-dev 2023-01-18 14:56:26 UTC
The conditional installation of man pages is frowned upon, you could take a look at https://bugs.gentoo.org/689684 as example.

I do not quite consider sphinx being that of an issue to generate man pages on the side and ship them out of dev.gentoo.org, but you are free to reason with it.
Comment 5 Cedric Sodhi 2023-01-18 15:11:56 UTC
Thank you for the reference. Reading the description, though, the mentioned rationale suggests that the policy does not fully apply here (unless the manpages are being prebuilt)

> Rationale: manpages are basic documentation for installed software.  While additional dependencies are inconvenient for users, not building manpages is harmful.  Including (optionally or unconditionally) prebuilt manpages is a good compromise.

Gentoo is about configurability and giving the user a choice. Here, the user would be patronized into a *definitely* undesirable situation, because they explicitly do not want to install the entirety of Sphinx plus dependencies (which is fairly large).

I don't understand how binding bug 689684 is, since IUSE=man is a very real and established thing. I would suggest we consider practicability before ideology and leave IUSE=man on zathura, too. I have yet to meet a user who would have a problem with that.
Comment 6 Piotr Karbowski (RETIRED) gentoo-dev 2023-01-18 15:47:01 UTC
I do expect the man IUSE to be thing of the past and phased out. I more lean into prebuilding man pages than adding this IUSE, though considering the effort vs gain, do you actually consider sphinx to be a bloat, that you have strong opinion about not having it around?
Comment 7 Cedric Sodhi 2023-01-18 17:43:36 UTC
I generally have a strong opinion about unwanted dependencies, but that shall not be the issue here. This is a principal problem and not about my personal wish. By bug 689684 the maintainer "should" pre-compile the manpages, but I don't expect you to that.

I hold the opinion that bug 689684 is wholly ill-conceived by as few as 6 votes affecting thousands of users. Until that is straightened out we can as well suffer the consequences.
Comment 8 Piotr Karbowski (RETIRED) gentoo-dev 2023-01-19 09:31:32 UTC
I will pregenerate man pages and distribute them as such, dropping sphinx dependency. I did not expected people to feel this strong about rather harmless package that does not even need much compute to install. Will get it done around weekend.