Date: Thu, 27 Oct 2022 02:26:03 +0000 From: Pau Amma <pauamma@freebsd.org> To: Mitchell Horne <mhorne@freebsd.org> Cc: "freebsd-doc@FreeBSD.org" <freebsd-doc@freebsd.org> Subject: Re: Documentation of /usr/src directory layout Message-ID: <b2eefa41a8b3fa60960a4bb73c8cfea9@freebsd.org> In-Reply-To: <b453ee35-e0ae-127c-cc22-1193d44c9bd4@freebsd.org> References: <b453ee35-e0ae-127c-cc22-1193d44c9bd4@freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On 2022-10-26 16:07, Mitchell Horne wrote: > Hello, > > Currently, hier(7) contains detailed but outdated [1] documentation of > the directory structure under /usr/src. The src tree's README.md file > duplicates much of this information by maintaining a distinctly > incomplete table. Noting that (on 13.1 at least) README.md is a lightly markdownized version of README. If they're not going to be kept consistent going forward, one should be removed. (As mentioned elsethread, keeping README.md makes sense given GitHub and others display it by default.) Re removing that info from hier(7) instead of updating it, a possible disadvantage I see to that is people without source losing access to it. I'm not familiar with the audience: how likely is it that people without source installed will have a need for (a more current version of) that part of it? -- #BlackLivesMatter #TransWomenAreWomen #AccessibilityMatters #StandWithUkrainians English: he/him/his (singular they/them/their/theirs OK) French: il/le/lui (iel/iel and ielle/ielle OK) Tagalog: siya/niya/kaniya (please avoid sila/nila/kanila)
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?b2eefa41a8b3fa60960a4bb73c8cfea9>