[PATCH v2 1/3] docs: kernel-doc: fix stale intel_audio.c path in examples

From: Kit Dallege

Date: Sun Mar 15 2026 - 13:05:58 EST


intel_audio.c was moved from drivers/gpu/drm/i915/ to
drivers/gpu/drm/i915/display/. Update the example paths in the
kernel-doc guide and its Chinese and Italian translations.

Assisted-by: Claude:claude-opus-4-6
Signed-off-by: Kit Dallege <xaum.io@xxxxxxxxx>
---
Documentation/doc-guide/kernel-doc.rst | 4 ++--
Documentation/translations/it_IT/doc-guide/kernel-doc.rst | 4 ++--
Documentation/translations/zh_CN/doc-guide/kernel-doc.rst | 4 ++--
3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/Documentation/doc-guide/kernel-doc.rst b/Documentation/doc-guide/kernel-doc.rst
index 8d2c09fb36e4..8b579b06ba33 100644
--- a/Documentation/doc-guide/kernel-doc.rst
+++ b/Documentation/doc-guide/kernel-doc.rst
@@ -550,7 +550,7 @@ internal: *[source-pattern ...]*

Example::

- .. kernel-doc:: drivers/gpu/drm/i915/intel_audio.c
+ .. kernel-doc:: drivers/gpu/drm/i915/display/intel_audio.c
:internal:

identifiers: *[ function/type ...]*
@@ -588,7 +588,7 @@ doc: *title*

Example::

- .. kernel-doc:: drivers/gpu/drm/i915/intel_audio.c
+ .. kernel-doc:: drivers/gpu/drm/i915/display/intel_audio.c
:doc: High Definition Audio over HDMI and Display Port

Without options, the kernel-doc directive includes all documentation comments
diff --git a/Documentation/translations/it_IT/doc-guide/kernel-doc.rst b/Documentation/translations/it_IT/doc-guide/kernel-doc.rst
index bac959b8b7b9..cd8bb579d5a2 100644
--- a/Documentation/translations/it_IT/doc-guide/kernel-doc.rst
+++ b/Documentation/translations/it_IT/doc-guide/kernel-doc.rst
@@ -558,7 +558,7 @@ internal: *[source-pattern ...]*

Esempio::

- .. kernel-doc:: drivers/gpu/drm/i915/intel_audio.c
+ .. kernel-doc:: drivers/gpu/drm/i915/display/intel_audio.c
:internal:

identifiers: *[ function/type ...]*
@@ -587,7 +587,7 @@ doc: *title*

Esempio::

- .. kernel-doc:: drivers/gpu/drm/i915/intel_audio.c
+ .. kernel-doc:: drivers/gpu/drm/i915/display/intel_audio.c
:doc: High Definition Audio over HDMI and Display Port

Senza alcuna opzione, la direttiva kernel-doc include tutti i commenti di
diff --git a/Documentation/translations/zh_CN/doc-guide/kernel-doc.rst b/Documentation/translations/zh_CN/doc-guide/kernel-doc.rst
index fb2bbaaa85c1..b35f2582cd96 100644
--- a/Documentation/translations/zh_CN/doc-guide/kernel-doc.rst
+++ b/Documentation/translations/zh_CN/doc-guide/kernel-doc.rst
@@ -434,7 +434,7 @@ internal: *[source-pattern ...]*

例子::

- .. kernel-doc:: drivers/gpu/drm/i915/intel_audio.c
+ .. kernel-doc:: drivers/gpu/drm/i915/display/intel_audio.c
:internal:

identifiers: *[ function/type ...]*
@@ -467,7 +467,7 @@ doc: *title*

例子::

- .. kernel-doc:: drivers/gpu/drm/i915/intel_audio.c
+ .. kernel-doc:: drivers/gpu/drm/i915/display/intel_audio.c
:doc: High Definition Audio over HDMI and Display Port

如果没有选项,kernel-doc指令将包含源文件中的所有文档注释。
--
2.53.0