[Bug 108980] list of missing man pages

From: <bugzilla-noreply_at_freebsd.org>
Date: Thu, 07 Mar 2024 02:16:12 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=108980

Alexander Ziaee <concussious.bugzilla@runbox.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |concussious.bugzilla@runbox
                   |                            |.com

--- Comment #27 from Alexander Ziaee <concussious.bugzilla@runbox.com> ---
Hmm... a lot of these missing manual pages are pages that a running, set-up
system would have, they just don't come from src/share/man/*. I myself have
contributed some of new ones deliberately, such as "see x(7), if installed",
and even more flagrantly "see automount(8) or bsdisks(8)". I thought that was
very nice, if you have files in /media/ you didn't create, one of those is
creating them. One is in base and the other is pulled as a dependency by afaik
every desktop environment. The FreeBSD manual concisely tells you everything
you need to know.

Is this incorrect?

This concept also works... backwards, for example, we have manual pages that
are built unconditionally describing parts of the system that MINIMAL wouldn't
have, such as msdosfs(5). The synopsis says that you need to build it into your
kernel, so if someone doesn't have it, and they look for it in the manual, they
should know at first glance that... they could have it.

I think this behavior is reasonable and massively more useful than the manual
speaking authoratively as if the pages in src/share/man are all that exists.

-- 
You are receiving this mail because:
You are on the CC list for the bug.
You are the assignee for the bug.