[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <109984d7-98f7-4b2a-8fee-1f7b30230a44@infradead.org>
Date: Thu, 7 Nov 2024 20:53:37 -0800
From: Randy Dunlap <rdunlap@...radead.org>
To: Jonathan Corbet <corbet@....net>, anish kumar <yesanishhere@...il.com>,
lgirdwood@...il.com, broonie@...nel.org, perex@...ex.cz, tiwai@...e.com,
Sebastian Fricke <sebastian.fricke@...labora.com>
Cc: linux-kernel@...r.kernel.org, linux-doc@...r.kernel.org,
linux-sound@...r.kernel.org
Subject: Re: [RFC PATCH] ALSA: Add debugging guide for audio issues
On 11/7/24 2:25 PM, Jonathan Corbet wrote:
> Randy Dunlap <rdunlap@...radead.org> writes:
>
>> I see a few possibilities, none perfect:
>>
>> a. in Documentation/driver-api/debug/ [not quite driver-api though]
>
> No, it's not API stuff, and not limited to drivers.
>
>> b. in Documentation/core-api/ along with debugging-via-ohci1394.rst
>> [maybe in a new /debug/ subdir]
>
> Again, not really API stuff.
>
>> c. in (new) Documentation/debug/ and invite the kernel debugging
>> community to add some of their docs here as well.
>
> If we really want to separate the mechanics of kernel development from
> the associated process information - not always an easy separation, IMO
> - we could make a top-level "development" directory, put a lot of the
> other relevant stuff there, and include the debugging stuff. It seems
> really weird to put debugging by itself, though; it's only part of the
> picture.
I could go with that.
>
> Why is Documentation/process so bad?
Documentation/process/ is meta-documentation about kernel social "standards"
among other things. It is "soft" documentation, whereas debugging (IMHO) is
"hard" documentation.
But hey, it's all your baby. Do whatever pleases you. :)
--
~Randy
Powered by blists - more mailing lists