From nobody Wed May 10 13:27:54 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 4QGbSB60MVz49tyM; Wed, 10 May 2023 13:27:54 +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 4QGbSB57rhz3Q9Q; Wed, 10 May 2023 13:27:54 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1683725274; 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=DPHRis6luCLix5IYVr29++ibszKp7khtrr5X0s+sJBE=; b=BYBQR3jmF5kNJ8nj68mgheA7e3dsvuGChGHSPDAmOjeia6P/zyLZ5fW1NCzWoaMyJCoECk vk8pQVbvtxclvtdvtCqNOCMqCUZrAMUdR/2n0vUs9M3MUV9j3Afo2inO2C/KCMJYRPqnAf k0LzwaqVx3I1VaM6+f8ibPbcUFtr1FeYWZV+56N3Dgy9eg+h5mcKBKaTOqoWnQMlx1TWmo GlhIjqYYdMhZv4EtTTZdPS2WbZoN/1CtSgEh0chkMe3t1Pwqr6pYx8aGbrPlaF/D5/tUnr 4jOvIYL1KQMojmsVNsZ7p1MEFs10YiBDDLmY2x0uqYa2vDKsPZ7tUaqoYtuRQg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1683725274; 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=DPHRis6luCLix5IYVr29++ibszKp7khtrr5X0s+sJBE=; b=pMk2XRr/ba1Z3FC1ZS98wICuixil0gaCnjqJm0QnAOTFBHEKAdaCw+R6E54UIDj4rydMDg 6365BHkelkGI29K/ACXUNdJ6+pgjR7hMFHBzeSxj3U4Hyj7fFMKLYSTg6K3XURCvwE601V wZkQty4neh+8/eK7nliluAZAZllktIDDV0y1h0jC9KY3SLXcsj+9OceyhKbMfdjqVn+xEY JtqbInJb5XQZ23tmgYTVxAY1wJA38I9JFZP8MsbHhyXtN/9KAobBfF091vINQIVMDsRwph nnsw1p9PM74Duf80BbG3zaQuze/ptRxNvy5JM8LX/tIvNNzVy5jcA/yMkLJ4Rw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1683725274; a=rsa-sha256; cv=none; b=W+4DxNm1q3YxiXQGna+Hyn62KCIrBmgyjlAt6XItxZ6IWpruAPExxtzSFb9pHAErJCPH3E Y86LGLwjBhNBKrmRZgCrLJYLUE3BBihnZP4cvqdGoLkPb76uDN+Sr+omThGVKWNOahy3/n DXxQv5UeXZZZBrfZ/EeyvBclkVQLa1lUIm7YrFMsUUK6n6fo0ODQWaBxEmIQI2kVSFroO8 Lun0VIePgwlzjDJAC5J0tgHYnW7X/gT4MXjWWZ4+Ofsfc5Ivffr+GZzFR+pOhQ7qmjjAcW bXMeLNF/aXIImoeaqQMTlLdAXG2Hge4VQwsG5zAu1pwzWANzRkuGaeQ5Cn4sHg== 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 4QGbSB4BzTz1BnW; Wed, 10 May 2023 13:27:54 +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 34ADRsDI088465; Wed, 10 May 2023 13:27:54 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 34ADRsNa088464; Wed, 10 May 2023 13:27:54 GMT (envelope-from git) Date: Wed, 10 May 2023 13:27:54 GMT Message-Id: <202305101327.34ADRsNa088464@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mitchell Horne Subject: git: c3b611e153e0 - main - 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/main X-Git-Reftype: branch X-Git-Commit: c3b611e153e0480a354559f82fe5dc4c455bad4e Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by mhorne: URL: https://cgit.FreeBSD.org/src/commit/?id=c3b611e153e0480a354559f82fe5dc4c455bad4e commit c3b611e153e0480a354559f82fe5dc4c455bad4e Author: Mitchell Horne AuthorDate: 2023-05-10 12:52:47 +0000 Commit: Mitchell Horne CommitDate: 2023-05-10 13:17:41 +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 --- 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 bb00923118c1..ef6785150af8 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