git: 984f74caad01 - stable/13 - hier(7): drop list of /usr/include subdirectories

From: Mitchell Horne <>
Date: Fri, 09 Jun 2023 19:58:24 UTC
The branch stable/13 has been updated by mhorne:


commit 984f74caad01f2a8e3de38e61cd6800fcb609c29
Author:     Mitchell Horne <>
AuthorDate: 2023-05-10 12:52:47 +0000
Commit:     Mitchell Horne <>
CommitDate: 2023-06-09 19:48:06 +0000

    hier(7): drop list of /usr/include subdirectories
    It is nice to have, however, the location of this information means that
    it will naturally be missed by developers adding or removing directories
    to the layout, so it trends out-of-date and it is out-of-date.
    The target audience for hier(7) is users and administrators. It is not
    expected to be a place that programmers should go to learn about the
    purposes of the different C headers provided by FreeBSD.
    Program authors needing FreeBSD-specific interfaces or libraries
    (#include <sys/queue.h>, for instance) will either be following a more
    detailed man page, or consulting the header contents directly. Folks
    targeting standardized headers (#include <sys/time.h>) will not need
    hier(7) to tell them where those headers are under /usr/include.
    In other words, this is more detail than necessary for this document.
    I'd go as far as to say that many of the existing entries in this list
    do little more than parrot the name of the directory.
    With all this in mind, let's drop the maintenance burden.
    Reviewed by:    imp, emaste
    MFC after:      1 week
    Sponsored by:   The FreeBSD Foundation
    Differential Revision:
    (cherry picked from commit c3b611e153e0480a354559f82fe5dc4c455bad4e)
 share/man/man7/hier.7 | 143 --------------------------------------------------
 1 file changed, 143 deletions(-)

diff --git a/share/man/man7/hier.7 b/share/man/man7/hier.7
index 00784986062a..96225e8d33d0 100644
--- a/share/man/man7/hier.7
+++ b/share/man/man7/hier.7
@@ -215,149 +215,6 @@ and
 .It Pa include/
 standard C include files
-.Bl -tag -width "kerberos5/" -compact
-.It Pa arpa/
-C include files for Internet service protocols
-.It Pa bsnmp/
-C include files for the SNMP daemon
-.It Pa c++/
-C++ include files
-.It Pa cam/
-C include files for the Common Access Methods Layer
-.Bl -tag -width "kerberos5/" -compact
-.It Pa scsi/
-SCSI device on top of CAM
-.It Pa dev/
-C include files for programming various
-.Bl -tag -width "kerberos5/" -compact
-.It Pa ic/
-various header files describing driver- and bus-independent
-hardware circuits
-.It Pa ofw/
-Open Firmware support
-.It Pa pbio/
-8255 PPI cards;
-.Xr pbio 4
-.It Pa ppbus/
-parallel port bus;
-.Xr ppbus 4
-.It Pa usb/
-USB subsystem
-.It Pa fs/
-.Bl -tag -width "kerberos5/" -compact
-.It Pa fdescfs/
-per-process file descriptors file system
-.It Pa msdosfs/
-MS-DOS file system
-.It Pa nfs/
-C include files for NFS (Network File System) version 2, 3 and 4
-.It Pa nullfs/
-loopback file system
-.It Pa procfs/
-process file system
-.It Pa smbfs/
-SMB/CIFS file system
-.It Pa udf/
-UDF file system
-.It Pa unionfs
-union file system
-.It Pa geom/
-GEOM framework
-.Bl -tag -width "kerberos5/" -compact
-.It Pa concat/
-.It Pa gate/
-GATE GEOM class
-.It Pa mirror/
-.It Pa nop/
-NOP GEOM class
-.It Pa raid3/
-RAID3 GEOM class
-.It Pa stripe/
-.It Pa libmilter/
-C include files for libmilter,
-.Xr sendmail 8
-mail filter API
-.It Pa machine/
-machine-specific C include files
-.It Pa net/
-miscellaneous network C include files
-.Bl -tag -width Fl -compact
-.It Pa altq/
-C include files for alternate packet queuing; see
-.Xr altq 4
-.It Pa net80211/
-C include files for 802.11 wireless networking;
-.Xr net80211 4
-.It Pa netinet/
-C include files for Internet standard protocols;
-.Xr inet 4
-.It Pa netinet6/
-C include files for Internet protocol version 6;
-.Xr inet6 4
-.It Pa netipsec/
-kernel key-management service;
-.Xr ipsec 4
-.It Pa netsmb/
-SMB/CIFS requester
-.It Pa nfs/
-C include files for NFS (Network File System) version 2 and 3 (legacy)
-.It Pa openssl/
-OpenSSL (Cryptography/SSL toolkit) headers
-.It Pa protocols/
-C include files for Berkeley service protocols
-.It Pa rpc/
-remote procedure calls;
-.Xr rpc 3
-.It Pa rpcsvc/
-definition of RPC service structures; see
-.Xr rpc 3
-.It Pa security/
-PAM; see
-.Xr pam 3
-.It Pa sys/
-system C include files (kernel data structures)
-.\" .It Pa tcl/
-.\" Tcl language;
-.\" see
-.\" .Xr Tcl n
-.\" .Bl -tag -width "kerberos5/" -compact
-.\" .It Pa generic/
-.\" ???
-.\" .It Pa unix/
-.\" ???
-.\" .El
-.It Pa ufs/
-C include files for UFS (The U-word File System)
-.Bl -tag -width "kerberos5/" -compact
-.It Pa ffs/
-Fast file system
-.It Pa ufs/
-UFS file system
-.It Pa vm/
-virtual memory;
-.Xr vmstat 8
 .It Pa lib/
 shared and archive
 .Xr ar 1 Ns -type