From nobody Wed May 10 14:19:41 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 4QGcc71fNdz49xd7; Wed, 10 May 2023 14:19:51 +0000 (UTC) (envelope-from freebsd@gndrsh.dnsmgr.net) Received: from gndrsh.dnsmgr.net (br1.CN84in.dnsmgr.net [69.59.192.140]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 4QGcc64SzQz3q5t; Wed, 10 May 2023 14:19:50 +0000 (UTC) (envelope-from freebsd@gndrsh.dnsmgr.net) Authentication-Results: mx1.freebsd.org; none Received: from gndrsh.dnsmgr.net (localhost [127.0.0.1]) by gndrsh.dnsmgr.net (8.13.3/8.13.3) with ESMTP id 34AEJfct054240; Wed, 10 May 2023 07:19:41 -0700 (PDT) (envelope-from freebsd@gndrsh.dnsmgr.net) Received: (from freebsd@localhost) by gndrsh.dnsmgr.net (8.13.3/8.13.3/Submit) id 34AEJf1x054239; Wed, 10 May 2023 07:19:41 -0700 (PDT) (envelope-from freebsd) From: "Rodney W. Grimes" Message-Id: <202305101419.34AEJf1x054239@gndrsh.dnsmgr.net> Subject: Re: git: 36db6b04962a - main - hier(7): document /home/ and /usr/home/ In-Reply-To: <202305101327.34ADRu0P088510@gitrepo.freebsd.org> To: Mitchell Horne Date: Wed, 10 May 2023 07:19:41 -0700 (PDT) CC: src-committers@freebsd.org, dev-commits-src-all@freebsd.org, dev-commits-src-main@freebsd.org Reply-To: rgrimes@freebsd.org X-Mailer: ELM [version 2.4ME+ PL121h (25)] List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-main@freebsd.org X-BeenThere: dev-commits-src-main@freebsd.org MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=US-ASCII X-Rspamd-Queue-Id: 4QGcc64SzQz3q5t X-Spamd-Bar: ---- X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; ASN(0.00)[asn:13868, ipnet:69.59.192.0/19, country:US] X-Rspamd-Pre-Result: action=no action; module=replies; Message is reply to one we originated 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 > AuthorDate: 2023-05-10 12:53:56 +0000 > Commit: Mitchell Horne > 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/ /usr is "contains the majority of user utilities and applications" it should not contain home directories. I do not know when this move to usr came about it was traditionally /home. I do not know why /usr/home even exists, it is not needed by anything I am aware of. If we have a compatible link it should be, usr/home -> ../home and /home should be the directory. > .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 > -- Rod Grimes rgrimes@freebsd.org