Bug 273777 - pkgbase: Library manpages should be in the -dev packages
Summary: pkgbase: Library manpages should be in the -dev packages
Status: Closed FIXED
Alias: None
Product: Base System
Classification: Unclassified
Component: misc (show other bugs)
Version: 15.0-CURRENT
Hardware: Any Any
: --- Affects Only Me
Assignee: dfr
URL:
Keywords: pkgbase
Depends on:
Blocks:
 
Reported: 2023-09-14 09:07 UTC by dfr
Modified: 2023-11-13 08:24 UTC (History)
2 users (show)

See Also:


Attachments
Add dev tags to library manpages unless MANSPLITPKG is enabled (1.06 KB, patch)
2023-09-14 13:43 UTC, dfr
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description dfr 2023-09-14 09:07:42 UTC
I have a simple base image for containers which contains just core shared libraries, SSL libraries and certificates. This image is about 30MB, of which 10MB is library manpages.

It seems to me that library manpages are mainly a resource for developers and should be packaged with the other compile-time files such as include files and static libraries. I suggest that manpages for libraries should move to the -dev package unless MK_MANSPLITPKG is set.
Comment 1 Mina Galić freebsd_triage 2023-09-14 09:23:49 UTC
sounds good to me!
Comment 2 Emmanuel Vadot freebsd_committer freebsd_triage 2023-09-14 09:28:59 UTC
(In reply to dfr from comment #0)

Maybe we should just set MANSPLITPKG by default (or even remove the option and always generate -man package).
Comment 3 Mina Galić freebsd_triage 2023-09-14 09:35:13 UTC
do we have a dependency level like, 'suggests' or 'recommends' like deb has?
Comment 4 dfr 2023-09-14 10:17:15 UTC
An example of space savings:

localhost/freebsd15-minimal                      latest-aarch64               175687352406  11 hours ago        78.1 MB
localhost/freebsd15-minimal                      latest-amd64                 21c251e45183  11 hours ago        57 MB

Not quite like-for-like but the aarch64 image was built with manpages contained in the regular library packages and the amd64 one was after splitting them out to the -dev package.
Comment 5 dfr 2023-09-14 13:43:31 UTC
Created attachment 244839 [details]
Add dev tags to library manpages unless MANSPLITPKG is enabled
Comment 6 Mina Galić freebsd_triage 2023-09-14 13:48:52 UTC
that looks plausible.
Comment 7 Emmanuel Vadot freebsd_committer freebsd_triage 2023-09-14 14:04:24 UTC
Why not just enabling MANSPLITPKG as I suggested ?
Comment 8 dfr 2023-09-14 14:10:01 UTC
Mostly because I already had this mostly written before you suggested that. I still think it might be worth opening up a discussion about splitting out manpages by default on pkgbase@ though.

If we enable MANSPLITPKG by default, should we merge that to stable/14 and stable/13? If not, this patch would still help to reduce image sizes for those branches.
Comment 9 Emmanuel Vadot freebsd_committer freebsd_triage 2023-09-14 14:16:29 UTC
We could merge it back anywhere, pkgbase is still supposed to be beta :)
Comment 10 dfr 2023-09-14 14:40:15 UTC
I opened https://reviews.freebsd.org/D41861 to flip the MANSPLITPKG switch.