[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <874j4i205j.fsf@trenco.lwn.net>
Date: Thu, 07 Nov 2024 14:40:08 -0700
From: Jonathan Corbet <corbet@....net>
To: Randy Dunlap <rdunlap@...radead.org>, 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
Randy Dunlap <rdunlap@...radead.org> writes:
> On 11/7/24 12:45 PM, Jonathan Corbet wrote:
>> anish kumar <yesanishhere@...il.com> writes:
>>
>>> Add a comprehensive debugging guide for ALSA audio issues, covering
>>> topics from bootup to runtime debugging. This document aims to help
>>> developers diagnose and resolve common audio problems in Linux.
>>>
>>> The guide includes sections on:
>>> - Bootup/bringup issues
>>> - Runtime debugging
>>> - XRUN debugging
>>> - Audio pops and clicks
>>>
>>> This addresses the lack of a centralized debugging resource for ALSA
>>> and should help improve the troubleshooting process for audio drivers.
>>>
>>> Inspired by discussions on LKML:
>>> https://lkml.org/lkml/2024/9/24/392
>>>
>>> Signed-off-by: anish kumar <yesanishhere@...il.com>
>>> ---
>>> Documentation/sound/soc/debug.rst | 334 ++++++++++++++++++++++++++++++
>>> Documentation/sound/soc/index.rst | 1 +
>>> 2 files changed, 335 insertions(+)
>>> create mode 100644 Documentation/sound/soc/debug.rst
>>
>> At a first glance, this seems useful.
>>
>> I was just looking at Sebastian's new debugging documentation:
>>
>> https://lore.kernel.org/all/20241028-media_docs_improve_v3-v1-0-2b1b486c223e@collabora.com/
>>
>> ... so my immediate thought is that this documentation should be
>> coherent and together, rather than scattered though the docs. Maybe
>> move this to process/debugging and integrate it with his work?
>
> and once again I disagree that these docs should be in Documentation/process/.
OK, I guess I missed that...where do you think we should put them?
jon
Powered by blists - more mailing lists