From nobody Mon Oct 17 14:42:47 2022 X-Original-To: doc@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 4MrfqC1V2Wz4g6p6 for ; Mon, 17 Oct 2022 14:42:47 +0000 (UTC) (envelope-from bugzilla-noreply@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 4MrfqC09ggz3GTF for ; Mon, 17 Oct 2022 14:42:47 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (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 4MrfqB6Nfrzs96 for ; Mon, 17 Oct 2022 14:42:46 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 29HEgkSm094466 for ; Mon, 17 Oct 2022 14:42:46 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 29HEgk6P094465 for doc@FreeBSD.org; Mon, 17 Oct 2022 14:42:46 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 261349] Modernise hier(7) Date: Mon, 17 Oct 2022 14:42:47 +0000 X-Bugzilla-Reason: CC X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Manual Pages X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Some People X-Bugzilla-Who: mhorne@freebsd.org X-Bugzilla-Status: In Progress X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: bugs@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: cc Message-ID: In-Reply-To: References: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@freebsd.org MIME-Version: 1.0 ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1666017767; 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: in-reply-to:in-reply-to:references:references; bh=eobt+l/cQN9gdIVQMOzSwijp9vL4DcHLMcBNg5gGdvw=; b=OscMEdveO4KTfEm0Qs8G+2K71PGvC9JiqOrAFFeVsCaOum8cCXyVp0iMPU62QQ54APFXKu Sps/AF7g26w4oc5HU5R2qJaqnJYGrtfuWsokQU1i+Jnv3Fw+ZfNehthV0URFm29Pb2o5TS IlA3PrQ+AMEOVCgssZACCE0ZJFLyyg9/b7Qqqj+nAQKUk+IVcitQ/ZD5oMagDvtZ76li6I UJCxGCgXWfLoR/Q9AhnzFOoYYMFrk6vkJXZgo/IssEc0NbHlak0icizg9GBjzY9I+aWLEJ SkCQlih94oLK92ITsFR1gf0M41WAuDB2aKoFa+pwUBFMZJEcj/IvBrMB1kOKDw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1666017767; a=rsa-sha256; cv=none; b=u42QOKlqu0ZM04Nk3Yg4KeEtNewBeTWpoFiBpx1dkNupD6uEggmjvKAN24oAoeByfda8pS c4SCjt6ONFOitMHFAUOoW38WBYKOs9ddiGA/+ZakYK0Yos7BfUaawIk5kJFt/HpVQXPfp3 lFjxZBvLiPdPVd1RtvcD8qiBJaGD4PgKnp8GY7uKAhlh0AXwlAzjyCnaih14s+cIwAjqUe uQOEGxLm1In3pnQxPskksKonJ5TF/mO1li1u9sgK8eB6fGbnZ6TYhPL7HcjjG8ElF30oPD dtOMdxzgjBUKih7FvZ/s/xq7cd8+6gKJepuD4kBb+Hrv6J9jKEbkBC+OLL3tqA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D261349 Mitchell Horne changed: What |Removed |Added ---------------------------------------------------------------------------- CC| |mhorne@freebsd.org --- Comment #7 from Mitchell Horne --- (In reply to Graham Perrin from comment #0) In my opinion, maintaining a complete list of the directories under /usr/sr= c in hier(7) is unproductive. It will always tend to be out of date or incomplet= e in some way, for little gain. The source of truth for this layout information = is /usr/src/README.md; I think we should point readers there instead. I note that the information is duplicated again in the Developer's Handbook [1], and is differently outdated (stand/ is missing, at least). This further illustrates the problem. If folks find my take agreeable, I have the bandwidth and interest to take = on the task of removing this information from hier(7) and augmenting README.md= as necessary. [1] https://docs.freebsd.org/en/books/developers-handbook/introduction/#introdu= ction-layout --=20 You are receiving this mail because: You are on the CC list for the bug.=