From nobody Fri Jun 9 19:58:24 2023 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4QdBhw6bm6z4cKQl; Fri, 9 Jun 2023 19:58:24 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QdBhw66bbz4KYK; Fri, 9 Jun 2023 19:58:24 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1686340704; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=2VZ/6BlETEcA+mAAMRblLyv8ec3+eOSnFDRBiB7nJVY=; b=kdtKcop18ggPaf2baa0MrzzuSWKuWbT/A4ZSQIl5B0vGFDMgqkVOop/FQMahftWh1ctxmb k6iauQGU17Nz70tRQBRucckuqpP4bdmp2KvZ3hEH2hyh5gjiqy6s+Gy8jvX6zz8MvmgMo4 k+P4+M+e6XKoznPLqi7SsBqCpIlkm6H5VfW44Qi37ext76IxfdDlZoupBC+EynE6MD968B APCkmTDIA9j7naafCkkTezNVh6CiQEJXk3tPf7T5g83NO/TF9Cr4UC3tnTB5EOZ2Bta+c8 GqMFyBQ/iNnG+ETLHx2+aIKhFp27TMDauNjUQMnod/fm4yi7/lVT/Lu33pL1dw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1686340704; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=2VZ/6BlETEcA+mAAMRblLyv8ec3+eOSnFDRBiB7nJVY=; b=eTxra2w830CiX3l9uewb8KAp7vI+M2ef2Jg4+mnElTNrCnS6g08MmvXmGHILZs4vnrsEXH CV5L5Pj+QrXTDoluSyJ7LuYMD+V1KG/e7qTQ1gJK6lY7rMG1ekBnLjnL9qalgM2ZVBjY4s MKs0COF5Tm3fNt5Dabhl/6+5qSQdsOYG3bS4AuWCWAaHFTObceecdWyHd3iW/YOwKXJwaK ol1QUowOCsOQCEWdk+vvDR1RRnFFVY3QWcRWRjBzXUhnkpX1uivVRtv95N7DNsZ/bYi6rN ElzkZeQeBlLeP8lA/zIdcJx82AKq++K2cEFZ8KfSA3nlgMHLtivOnbR56bmnig== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1686340704; a=rsa-sha256; cv=none; b=vcaBVw4+x325laB2d3cBUt9wBftd+PCCsJULKY6ZLTaEVBGpaOzE/BanP8KJbtbqhNF/tt iILQ7VABJMMMWnZB1EwhiH5PQZnmrOigpd+KBbhQ0j1tLpzc/4Ds0hsoqGGLt7IxcvPMl5 FBehpxELXssCssvvDXMuL6yoccY59SDmp/2apD6pLZ0FXMaoOPLGVuZDvqBFhWGFMOgX4R GRvq0zrdElkzecRZaOfy1DNDX9219l1UewG4giIINbs0qJMyoUVNMs5B2To84wl0hdTTBn AXYVnQpO6dO0RtPAUu49fIT8z0nJM6wIT/6Z2jI4nBfuurFohZmKWHub9hcazA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4QdBhw5DZNznbK; Fri, 9 Jun 2023 19:58:24 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 359JwOIq072466; Fri, 9 Jun 2023 19:58:24 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 359JwOYr072465; Fri, 9 Jun 2023 19:58:24 GMT (envelope-from git) Date: Fri, 9 Jun 2023 19:58:24 GMT Message-Id: <202306091958.359JwOYr072465@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Mitchell Horne Subject: git: 984f74caad01 - stable/13 - hier(7): drop list of /usr/include subdirectories List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: mhorne X-Git-Repository: src X-Git-Refname: refs/heads/stable/13 X-Git-Reftype: branch X-Git-Commit: 984f74caad01f2a8e3de38e61cd6800fcb609c29 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch stable/13 has been updated by mhorne: URL: https://cgit.FreeBSD.org/src/commit/?id=984f74caad01f2a8e3de38e61cd6800fcb609c29 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 , for instance) will either be following a more detailed man page, or consulting the header contents directly. Folks targeting standardized headers (#include ) 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: https://reviews.freebsd.org/D40000 (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 .Pp -.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 -.El -.It Pa dev/ -C include files for programming various -.Fx -devices -.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; -see -.Xr pbio 4 -.It Pa ppbus/ -parallel port bus; -see -.Xr ppbus 4 -.It Pa usb/ -USB subsystem -.El -.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 -.El -.It Pa geom/ -GEOM framework -.Bl -tag -width "kerberos5/" -compact -.It Pa concat/ -CONCAT GEOM class -.It Pa gate/ -GATE GEOM class -.It Pa mirror/ -MIRROR GEOM class -.It Pa nop/ -NOP GEOM class -.It Pa raid3/ -RAID3 GEOM class -.It Pa stripe/ -STRIPE GEOM class -.El -.It Pa libmilter/ -C include files for libmilter, -the -.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 -.El -.It Pa net80211/ -C include files for 802.11 wireless networking; -see -.Xr net80211 4 -.It Pa netinet/ -C include files for Internet standard protocols; -see -.Xr inet 4 -.It Pa netinet6/ -C include files for Internet protocol version 6; -see -.Xr inet6 4 -.It Pa netipsec/ -kernel key-management service; -see -.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; -see -.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 -.El -.It Pa vm/ -virtual memory; -see -.Xr vmstat 8 -.El -.Pp .It Pa lib/ shared and archive .Xr ar 1 Ns -type