git: 82e1e0e0f471 - stable/13 - hier(7): document /home/ and /usr/home/

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


commit 82e1e0e0f4714823eb716b9b574444041be21239
Author:     Mitchell Horne <>
AuthorDate: 2023-05-10 12:53:56 +0000
Commit:     Mitchell Horne <>
CommitDate: 2023-06-09 19:48:07 +0000

    hier(7): document /home/ and /usr/home/
    Reviewed by:    imp
    MFC after:      1 week
    Sponsored by:   The FreeBSD Foundation
    Differential Revision:
    (cherry picked from commit 36db6b04962a01ff7b21592def02d4c570dac939)
 share/man/man7/hier.7 | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/share/man/man7/hier.7 b/share/man/man7/hier.7
index e46c226f9c2c..91c8f3328384 100644
--- a/share/man/man7/hier.7
+++ b/share/man/man7/hier.7
@@ -90,6 +90,10 @@ file descriptor files;
 .Xr \&fd 4
+.It Pa /home/
+user HOME directories.
+This is a symlink to
+.Pa /usr/home/
 .It Pa /etc/
 system configuration files and scripts
@@ -214,6 +218,12 @@ and
 .Xr bsdinstall 8
 .It Pa include/
 standard C include files
+.It Pa home/
+users' HOME directories;
+the layout is not standardized, but a typical interactive user
+.Dv beastie
+might receive their own directory under
+.Pa /usr/home/beastie
 .It Pa lib/
 shared and archive