View previous topic :: View next topic |
Author |
Message |
flexibeast Guru
![Guru Guru](/images/ranks/rank_rect_3.gif)
Joined: 04 Apr 2022 Posts: 382 Location: Naarm/Melbourne, Australia
|
Posted: Tue Aug 13, 2024 6:40 am Post subject: Install Texinfo files by default? |
|
|
Hi all,
i've just added an ebuild (nncp) to my overlay (flexibeast). Upstream doesn't provide any man pages; the documentation is in Texinfo format. The "Installed files" page of the Policy Guide states:
Quote: | Packages must not disable installing manpages via USE flags (e.g. USE=man or USE=doc). |
However, it doesn't discuss whether or not Texinfo files should be installed by default or only available via the `doc` flag.
The description for the `doc` flag states "Add extra documentation (API, Javadoc, etc)." In this instance, i feel that the Texinfo files are not extra documentation; they are the documentation. Still, as i'm keenly aware that many Gentoo users have rather strong feelings about perceived 'bloat', my ebuild currently doesn't install the Texinfo files unless the `doc` flag is enabled.
Can anyone clarify what the policy is in this sort of case? |
|
Back to top |
|
![](templates/gentoo/images/spacer.gif) |
Genone Retired Dev
![Retired Dev Retired Dev](/images/ranks/rank-retired.gif)
![](images/avatars/21004157514287ab2b29021.jpg)
Joined: 14 Mar 2003 Posts: 9592 Location: beyond the rim
|
Posted: Tue Aug 13, 2024 11:10 am Post subject: |
|
|
The ebuild should install info files unconditionally. Portage has internal support for removing them via FEATURES=noinfo if people really don't want them (same as with manpages).
USE=doc should be reserved for cases where installing documenation would either require heavy processing, add extra dependencies or increase the package size significantly (as in double- or triple-digit megabyte ranges) while not being strictly required by the software itself. |
|
Back to top |
|
![](templates/gentoo/images/spacer.gif) |
flexibeast Guru
![Guru Guru](/images/ranks/rank_rect_3.gif)
Joined: 04 Apr 2022 Posts: 382 Location: Naarm/Melbourne, Australia
|
Posted: Tue Aug 13, 2024 11:44 am Post subject: |
|
|
Great, thanks - i've just added an -r1 ebuild which installs the info files unconditionally. |
|
Back to top |
|
![](templates/gentoo/images/spacer.gif) |
|