git: 1be2773e631a - stable/12 - hier(7): remove text describing /usr/src layout

From: Mitchell Horne <>
Date: Mon, 05 Dec 2022 16:53:29 UTC
The branch stable/12 has been updated by mhorne:


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 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:
    (cherry picked from commit f0e4e021103c13ff3da4cdf1f9395754d069cbfb)
---             |   1 +
 share/man/man7/hier.7 | 130 ++------------------------------------------------
 2 files changed, 6 insertions(+), 125 deletions(-)

diff --git a/ b/
index 63f4b47f1a84..a2e9e8f88679 100644
--- a/
+++ b/
@@ -33,6 +33,7 @@ Source Roadmap:
 | share | Shared resources. |
 | stand | Boot loader sources. |
 | sys | Kernel sources (see [sys/](sys/ |
+| 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
 .It Pa src/
-.Bx ,
-third-party, and/or local source files
-.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
-.Pa /usr/lib
-.It Pa libexec/
-source code for files in
-.Pa /usr/libexec
-.It Pa release/
-files required to produce a
-.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
-.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
-.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
-.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
-.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
-.It Pa usr.bin/
-source code for files in
-.Pa /usr/bin
-.It Pa usr.sbin/
-source code for files in
-.Pa /usr/sbin
+source code; see
+.Xr development 7 .
+The layout of the source tree is described by the top-level
 .It Pa tests/