Documentation of /usr/src directory layout

2022-10-26 Thread Mitchell Horne
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. I propose that we reduce the maintenance overhead by keeping o

Re: Documentation of /usr/src directory layout

2022-10-26 Thread Ed Maste
On Wed, 26 Oct 2022 at 12:07, Mitchell Horne wrote: > > I propose that we reduce the maintenance overhead by keeping one of > these lists as the source of truth. README.md is the more natural option > here: being located at the root of the src tree it is more discoverable > (especially for those n

Re: Documentation of /usr/src directory layout

2022-10-26 Thread Mitchell Horne
On 10/26/22 15:06, Ed Maste wrote: On Wed, 26 Oct 2022 at 12:07, Mitchell Horne wrote: I propose that we reduce the maintenance overhead by keeping one of these lists as the source of truth. README.md is the more natural option here: being located at the root of the src tree it is more discove

Re: Documentation of /usr/src directory layout

2022-10-26 Thread Allan Jude
On 2022-10-26 14:41, Mitchell Horne wrote: On 10/26/22 15:06, Ed Maste wrote: On Wed, 26 Oct 2022 at 12:07, Mitchell Horne wrote: I propose that we reduce the maintenance overhead by keeping one of these lists as the source of truth. README.md is the more natural option here: being located at

Re: Documentation of /usr/src directory layout

2022-10-26 Thread Pau Amma
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