From nobody Mon Oct 17 14:42:47 2022 X-Original-To: bugs@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 4MrfqC1V0pz4g72T 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 4MrfqB6K8cz3G5K for ; Mon, 17 Oct 2022 14:42:46 +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 4MrfqB5Q4Czs0j 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 29HEgkxm094457 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 29HEgkQX094456 for bugs@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: bugs@FreeBSD.org Subject: [Bug 261349] Modernise hier(7) Date: Mon, 17 Oct 2022 14:42:47 +0000 X-Bugzilla-Reason: AssignedTo 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: Bug reports List-Archive: https://lists.freebsd.org/archives/freebsd-bugs List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-bugs@freebsd.org MIME-Version: 1.0 ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1666017766; 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=O7mTIZBOqLJzQjSTJeijt5ns9duApuuPP6SsKG90ZAk=; b=x3Mo4eNX9WrdwL19WWdWzGSTvgEUBd62DAxSGoCL09JY+OoNzgSM64RjncIZS7mG21ZgRi iSVPg+GqnjazEjHWMGC6FS9pYm5gHbsrbex9G5f+zhlmZbuJWb6ishs11amO407VqMCko4 nRpN8byWv/RoH/VoPkRgir64sgh4ESPgbaRYKTlv4i2nJJwj5BTG/z7Yg3PthsaSf0odS0 zwHpBwmwBqAZzJzyu9hQ5rjHuH6+ILNAutpssDHcN2xyufMFNDNfvIpQjufhg91708R8ho 17jB6840+N2Apvt40GLbstEXGBdp5ypUhtabodsfdfIEGTEeoA5Jt6wrVoRVZg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1666017766; a=rsa-sha256; cv=none; b=kyF2xb9n4HJnciGIroJajt6/Y8ovTNLmf/lQYtw1qd47xNH/LjcDbXmdDjz0EajH1xXBVu cQkUC2Xdlx3HNE39xTXgdTaKNK4Mt476FN5lKJKFt5u2gvFzqMAyPgs9HWLvvH70aK38Zv pdozBmAuAx3ntGWNfKEYgHKRnyTMpKYgjmDPxuowN3z4wzYIUjvJANRzCIRnbRqsm7+1t/ m9G/ZpMVYv7LUYCpthXJWFw3cuXCfX4JiMyhy5bNvd+Obn/ktcJu7fzEwAjU5qKN6i904o Xgyp7FvIzWEQ6tIoHmz3jA3TFStTYD2hUYb7nrjWRapBUxYTcfx1ZOt+5QvQbg== 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 the assignee for the bug.=