From nobody Wed May 10 13:27:56 2023
X-Original-To: dev-commits-src-main@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 4QGbSF0z6Zz49tnB;
	Wed, 10 May 2023 13:27:57 +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 4QGbSF0KZgz3QQv;
	Wed, 10 May 2023 13:27:57 +0000 (UTC)
	(envelope-from git@FreeBSD.org)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim;
	t=1683725277;
	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=vNSgBu6KElfWUNOYTfCduiNoT/qs9peUtJVF3FhmzP4=;
	b=ubf3bWKiwYmRJm1LfI2beZrf5jJitr395GB3nMSjDo3FnlYy73SbL9rrEuinRIvTaKoPST
	CPVauPqOakbnJANVLQFjC4wp7Bs76XqjsEAXfhEh06ZL3A5bsZ9ekqSTDPSWy9+V2cBWqy
	fSUs+vVreV7G6VHppg66q5lH1y7qvzM9dMKuL4jr7P3K49QrSuaYIFS7yjySioOtf7a4YA
	BFTlxfgDugTQG+HP2ReMTDnWdXCeTYQSWi/rFI2DaLb+9uirvqLG3PvSkK29rot8e+HUAS
	X/1Rp1DMgcTCDk0uohgR9nW5Qbby4Uno+9CRfbEVMHTD4ryt9zoMExgs4PTM7Q==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org;
	s=dkim; t=1683725277;
	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=vNSgBu6KElfWUNOYTfCduiNoT/qs9peUtJVF3FhmzP4=;
	b=Bqj8JI7m8WysOOs1QfVd+LoWXU6aHx3Mh5XG47XOMBsc1SJmw2CU9WkPgxI5pUyYakFuwS
	l2oI3fYp0pvYdYqxEweu2QiD9tvgXUFSoVhbyv5Fak6z7jKIWdbh87yOfs8ZgHjksuPu4H
	uVERgUHnmy174kEd9exwnKLj6XOJrcAR6D0YgBkudd9P9CJljThvDBZ/Jc180XmNtn/lzl
	mYRpFz57KIcBxIbeddW96TnQMWBfQHtbuwxfcZgqdTJAMaaetnhwV5vkr3vB4RXORLYU6i
	tCCUlYVuBc6PJAaXP+lZr7iZ3BB0HfHNhBDa1VxcoJNynjkL7/ZpS0UOrIXlMw==
ARC-Authentication-Results: i=1;
	mx1.freebsd.org;
	none
ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1683725277; a=rsa-sha256; cv=none;
	b=YtHo9gkIloe+3a1nLjAi693sfgWcLeOEEP/YL8PYQ4fXjSYOflyI7NQnEOrcADDHTWIymV
	eGZOev5KuO+Qv146lLwu39UhdxClpqgxnaRUlyOQxFoXB/gNduGzXzxB8dC2+Sf6CBpkZA
	kHu7slVIMVPJKGnsdNnclgjTLXCUupeZJIBVn0uyDMSWupZ/KCYS1j6nwMYAzi0Q1vPTdR
	6uXxVyXT4/dAtdpFl0egSmlDqnGaF94ob2OF66CWyRNEQ7tuueqsV/htIdI8bba8j+xN7I
	+iYUL+MSGiRNmldoMcoOjBWLzHLVB58Xo3cj0uSKM1rkVl2HObqFnYWw+x+dFQ==
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 4QGbSD6GLyz1BhX;
	Wed, 10 May 2023 13:27:56 +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 34ADRu3l088511;
	Wed, 10 May 2023 13:27:56 GMT
	(envelope-from git@gitrepo.freebsd.org)
Received: (from git@localhost)
	by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 34ADRu0P088510;
	Wed, 10 May 2023 13:27:56 GMT
	(envelope-from git)
Date: Wed, 10 May 2023 13:27:56 GMT
Message-Id: <202305101327.34ADRu0P088510@gitrepo.freebsd.org>
To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org,
        dev-commits-src-main@FreeBSD.org
From: Mitchell Horne <mhorne@FreeBSD.org>
Subject: git: 36db6b04962a - main - hier(7): document /home/ and /usr/home/
List-Id: Commit messages for the main branch of the src repository <dev-commits-src-main.freebsd.org>
List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main
List-Help: <mailto:dev-commits-src-main+help@freebsd.org>
List-Post: <mailto:dev-commits-src-main@freebsd.org>
List-Subscribe: <mailto:dev-commits-src-main+subscribe@freebsd.org>
List-Unsubscribe: <mailto:dev-commits-src-main+unsubscribe@freebsd.org>
Sender: owner-dev-commits-src-main@freebsd.org
X-BeenThere: dev-commits-src-main@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: 36db6b04962a01ff7b21592def02d4c570dac939
Auto-Submitted: auto-generated
X-ThisMailContainsUnwantedMimeParts: N

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