linux-kernel - Re: [RFC PATCH] ALSA: Add debugging guide for audio issues

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [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