From nobody Mon Dec 05 16:53:29 2022 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 4NQqPQ0ZYnz4k8jH; Mon, 5 Dec 2022 16:53:30 +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 4NQqPQ04RYz45Hq; Mon, 5 Dec 2022 16:53:30 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1670259210; 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=ZPZBrLzNcDHx/XYjbijHVPeV5j5/xC912aqsFqAeTZA=; b=A3LsHNsESJDI51YcdOpSr0/X2UlXqGdMI/FUrNk8416vn00sxOgIZ+u1KiPDOciE7h6FbS FT3K7heMaoCP4gocDdrD+9EatdvliQaLC7bkTunXw7lXeoK1HFV6b/Z1j7Z5SNW1DekoU5 PynjK+Ui43vZmTq7U5vhRc2pNSkRc3ZAORo1Bed8bUElA4J/ahNS59aTW5w3AoFj2H1arT wpYQ5ucDqz2UA/dZyJmjKAX2GU4dsjojpMU0RuvhZK/cbq44yj3QXOLVJvOsUC8hC+ajwY rpKZXw2T52o/LKJqnCxEnrtzlmf0J4nlj+SrsgFBbb/Kap1lh4VqZYPknAlW6g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1670259210; 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=ZPZBrLzNcDHx/XYjbijHVPeV5j5/xC912aqsFqAeTZA=; b=yJ436Sq/ScWbGADN+ErXX7D9p4+0czSSr8ZobE6k+fHDyMR5+UoVIpjVtUKHupcsad1rgU g8QKNgenb49ntct9R1pLMOdDFElLWyuriiEorFmMG1d7enEOaUdY4IfdcQL2oQcC0kGe51 MidDaNl4uv5ADGbQc2l1wdCNVGSFrm5YwjAnvkgSU4inxVceuKVl3msjgod0PZ2MJYn0Dn umwh9oqYrhJ50WXeHhLvOTI/oBFYilJg4M5JLNjJ0WjJ38kwOXDoH5uFyWGgLyMQ+zrOIn 9+VhVnfAUtMQtJG/QXinctiAf63XONIGYugF5XsRF1+c8oB5rh5XMG2mGc5kpQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1670259210; a=rsa-sha256; cv=none; b=ZsAsH9x3KSdDJ1voqYtFBJTJTMVJyIH8KOsI7Nlj6gcuTJ5nhE1CFg5tG58yyNKpuSxgaT O/ge2T01EAg20Bx9P32dB7fzRRQULSwNCbfKujBAFaQC92VyUY3YCViJmGX8vliPPSUCAq PfDsAVbtrsB9n4BOccfpVEFyCGV7kEq9fBFh0Bf4BEMrAr2IOWzofYjwU2v1YfN49FRDgC rtlVcdiXNn0fPBwfsxeVwjt1THwsV/3OfRFWyl1q0j/YmSO0NpXf49h78pFnJizHu7clDB +SePtZEmE3vVsu3yNqcHBwXa+OqWBU4FqokAEmt6qnFVJHE3jh0qzsUr92yeTw== 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 4NQqPP6FGRz152n; Mon, 5 Dec 2022 16:53:29 +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 2B5GrT6U068160; Mon, 5 Dec 2022 16:53:29 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 2B5GrTDD068159; Mon, 5 Dec 2022 16:53:29 GMT (envelope-from git) Date: Mon, 5 Dec 2022 16:53:29 GMT Message-Id: <202212051653.2B5GrTDD068159@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: 1be2773e631a - stable/12 - hier(7): remove text describing /usr/src layout 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/12 X-Git-Reftype: branch X-Git-Commit: 1be2773e631a5623eff634b855d2aac5786a63ad Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch stable/12 has been updated by mhorne: URL: https://cgit.FreeBSD.org/src/commit/?id=1be2773e631a5623eff634b855d2aac5786a63ad commit 1be2773e631a5623eff634b855d2aac5786a63ad Author: Mitchell Horne AuthorDate: 2022-11-01 15:15:18 +0000 Commit: Mitchell Horne CommitDate: 2022-12-05 16:53:00 +0000 hier(7): remove text describing /usr/src layout It poses a maintenance burden, since much of the information is duplicated in the src tree's README.md file. Readers who are interested enough in learning about the structure of the src tree can download it, or browse the README online. Have hier(7) just point them there instead. PR: 261349 Discussed with: freebsd-arch@, freebsd-doc@ lists Reviewed by: imp, emaste MFC after: 1 month Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D37135 (cherry picked from commit f0e4e021103c13ff3da4cdf1f9395754d069cbfb) --- README.md | 1 + share/man/man7/hier.7 | 130 ++------------------------------------------------ 2 files changed, 6 insertions(+), 125 deletions(-) diff --git a/README.md b/README.md index 63f4b47f1a84..a2e9e8f88679 100644 --- a/README.md +++ b/README.md @@ -33,6 +33,7 @@ Source Roadmap: | share | Shared resources. | | stand | Boot loader sources. | | sys | Kernel sources (see [sys/README.md](sys/README.md)). | +| targets | Support for experimental `DIRDEPS_BUILD` | | tests | Regression tests which can be run by Kyua. See [tests/README](tests/README) for additional information. | | tools | Utilities for regression testing and miscellaneous tasks. | | usr.bin | User commands. | diff --git a/share/man/man7/hier.7 b/share/man/man7/hier.7 index 8dd2882b239a..f0a51ab11622 100644 --- a/share/man/man7/hier.7 +++ b/share/man/man7/hier.7 @@ -608,132 +608,12 @@ see .El .Pp .It Pa src/ -.Bx , -third-party, and/or local source files -.Pp -.Bl -tag -width "kerberos5/" -compact -.It Pa bin/ -source code for files in /bin -.It Pa cddl/ -utilities covered by the Common Development and Distribution License -.It Pa contrib/ -source code for contributed software -.It Pa crypto/ -source code for contributed cryptography software -.It Pa etc/ -source code for files in -.Pa /etc -.It Pa gnu/ -utilities covered by the GNU General Public License -.It Pa include/ -source code for files in -.Pa /usr/include -.It Pa kerberos5/ -build infrastructure for Kerberos version 5 -.It Pa lib/ -source code for files in -.Pa /lib -and -.Pa /usr/lib -.It Pa libexec/ -source code for files in -.Pa /usr/libexec -.It Pa release/ -files required to produce a -.Fx -release -.It Pa rescue/ -source code for files in -.Pa /rescue -.It Pa sbin/ -source code for files in -.Pa /sbin -.It Pa secure/ -build directory for files in -.Pa /usr/src/crypto -.It Pa share/ -source for files in -.Pa /usr/share -.It Pa stand/ -boot loader source code -.It Pa sys/ -kernel source code -.Bl -tag -width Fl -compact -.It Pa amd64/ -AMD64 architecture support -.It Pa arm/ -ARM architecture support -.It Pa arm64/ -ARMv8 architecture support -.It Pa cam/ -.Xr cam 4 -and -.Xr ctl 4 -.It Pa cddl/ -CDDL-licensed optional sources, including ZFS -and DTrace -.It Pa ddb/ -.Xr ddb 4 -.It Pa fs/ -most filesystems -.It Pa dev/ -device drivers -.It Pa geom/ -.Xr geom 4 -.It Pa i386/ -i386 (32 bit) architecture support -.It Pa kern/ -main part of the kernel -.It Pa mips/ -MIPS architecture support -.It Pa net80211/ -.Xr net80211 4 -.It Pa netgraph/ -.Xr netgraph 4 -.It Pa netinet/ -.Xr inet 4 -.It Pa netinet6/ -.Xr inet6 4 -.It Pa netipsec/ -.Xr ipsec 4 -.It Pa netpfil/ -.Xr ipfw 4 -and -.Xr pf 4 -.It Pa opencrypto/ -.Xr crypto 7 -.It Pa powerpc/ -PowerPC/POWER architecture support -.It Pa riscv/ -RISC-V architecture support -.It Pa security/ -.Xr audit 4 -and -.Xr mac 4 -.It Pa sparc64/ -SPARC64 architecture support -.It Pa sys/ -kernel headers -.It Pa ufs/ -Unix File System -.It Pa x86/ -code shared by AMD64 and i386 architectures -.El -.It Pa targets/ -support for experimental DIRDEPS_BUILD -.It Pa tests/ -source code for files in -.Pa /usr/tests -.It Pa tools/ -tools used for maintenance and testing of .Fx -.It Pa usr.bin/ -source code for files in -.Pa /usr/bin -.It Pa usr.sbin/ -source code for files in -.Pa /usr/sbin -.El +source code; see +.Xr development 7 . +The layout of the source tree is described by the top-level +.Pa README.md +file. .Pp .It Pa tests/ The