Re: [PATCH v27 1/7] Documentation/firmware: add imx/se to other_interfaces

[sashiko-bot@kernel.org]

Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider:
- [Low] The patch adds a `kernel-doc` directive referencing `drivers/firmware/imx/se_ctrl.c`, but this file does not exist in the source tree. This will cause Sphinx to emit a build warning or error when building the kernel documentation (`make htmldocs`).
--

--- Patch [1]: [PATCH v27 1/7] Documentation/firmware: add imx/se to other_interfaces ---
commit 11c72cefa6ce5b082289d8b3c32eb18ba17eea92
Author: Pankaj Gupta <pankaj.gupta@nxp.com>

Documentation/firmware: add imx/se to other_interfaces

This commit documents the i.MX SoC Service layer and character device drivers
for NXP hardware IPs such as the EdgeLock Enclave.

> diff --git a/Documentation/driver-api/firmware/other_interfaces.rst b/Documentation/driver-api/firmware/other_interfaces.rst
> index 06ac89adaafba..6c6fa9a0ba1df 100644
> --- a/Documentation/driver-api/firmware/other_interfaces.rst
> +++ b/Documentation/driver-api/firmware/other_interfaces.rst

[ ... ]

> @@ -49,3 +49,136 @@ of the requests on to a secure monitor (EL3).
>  
>  .. kernel-doc:: drivers/firmware/stratix10-svc.c
>     :export:
> +
> +NXP Secure Enclave Firmware Interface
> +=====================================

[ ... ]

> +When a user sends a command to the firmware, it registers its device_ctx
> +as waiter of a response from firmware.
> +
> +Enclave's Firmware owns the storage management over a Linux filesystem.
> +For this c_dev provisions a dedicated slave device called "receiver".
> +
> +.. kernel-doc:: drivers/firmware/imx/se_ctrl.c
> +   :export:

[Severity: Low]
Will this cause Sphinx build warnings?

It appears that drivers/firmware/imx/se_ctrl.c does not exist in the source
tree, which can cause make htmldocs to emit a build warning or error when it
attempts to extract the documentation.

Is this file missing from this patch series, or does the directive need to be
removed?

-- 
Sashiko AI review · https://sashiko.dev/#/patchset/20260715-imx-se-if-v27-0-bb7c45952f06@nxp.com?part=1