git: 36db6b04962a - main - hier(7): document /home/ and /usr/home/

From: Mitchell Horne <mhorne_at_FreeBSD.org>
Date: Wed, 10 May 2023 13:27:56 UTC
The branch main has been updated by mhorne:

URL: https://cgit.FreeBSD.org/src/commit/?id=36db6b04962a01ff7b21592def02d4c570dac939

commit 36db6b04962a01ff7b21592def02d4c570dac939
Author:     Mitchell Horne <mhorne@FreeBSD.org>
AuthorDate: 2023-05-10 12:53:56 +0000
Commit:     Mitchell Horne <mhorne@FreeBSD.org>
CommitDate: 2023-05-10 13:25:17 +0000

    hier(7): document /home/ and /usr/home/
    
    Reviewed by:    imp
    MFC after:      1 week
    Sponsored by:   The FreeBSD Foundation
    Differential Revision:  https://reviews.freebsd.org/D40002
---
 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 ff11289436a1..b6759dd6e65b 100644
--- a/share/man/man7/hier.7
+++ b/share/man/man7/hier.7
@@ -90,6 +90,10 @@ file descriptor files;
 see
 .Xr \&fd 4
 .El
+.It Pa /home/
+user HOME directories.
+This is a symlink to
+.Pa /usr/home/
 .It Pa /etc/
 system configuration files and scripts
 .Pp
@@ -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
 .Pp
 .It Pa lib/
 shared and archive