Em Fri, 29 Aug 2025 14:55:22 +0700 Bagas Sanjaya <bagasdotme@xxxxxxxxx> escreveu: > ASoC codec and platform driver docs contain reference to writing ALSA > driver docs, as an external link. Use :doc: directive for the job > instead. > > Signed-off-by: Bagas Sanjaya <bagasdotme@xxxxxxxxx> > --- > Documentation/sound/soc/codec.rst | 4 ++-- > Documentation/sound/soc/platform.rst | 4 ++-- > 2 files changed, 4 insertions(+), 4 deletions(-) > > diff --git a/Documentation/sound/soc/codec.rst b/Documentation/sound/soc/codec.rst > index af973c4cac9309..b9d87a4f929b5d 100644 > --- a/Documentation/sound/soc/codec.rst > +++ b/Documentation/sound/soc/codec.rst > @@ -131,8 +131,8 @@ The codec driver also supports the following ALSA PCM operations:- > int (*prepare)(struct snd_pcm_substream *); > }; > > -Please refer to the ALSA driver PCM documentation for details. > -https://www.kernel.org/doc/html/latest/sound/kernel-api/writing-an-alsa-driver.html > +Please refer to the :doc:`ALSA driver PCM documentation > +<../kernel-api/writing-an-alsa-driver>` for details. > > > DAPM description > diff --git a/Documentation/sound/soc/platform.rst b/Documentation/sound/soc/platform.rst > index 7036630eaf016c..bd21d0a4dd9b0b 100644 > --- a/Documentation/sound/soc/platform.rst > +++ b/Documentation/sound/soc/platform.rst > @@ -45,8 +45,8 @@ snd_soc_component_driver:- > ... > }; > > -Please refer to the ALSA driver documentation for details of audio DMA. > -https://www.kernel.org/doc/html/latest/sound/kernel-api/writing-an-alsa-driver.html > +Please refer to the :doc:`ALSA driver documentation > +<../kernel-api/writing-an-alsa-driver>` for details of audio DMA. Don't use relative paths for :doc:. They don't work well, specially when one uses SPHINXDIRS. The best is o use Documentation/kernel-api/writing-an-alsa-driver.rst and let automarkup figure it out. As we have a checker, broken references generate warnings at build time. Regards, Mauro
