Re: [PATCH 1/2] firewire: core: add kerneldoc for outbound transaction-related symbols

[Takashi Sakamoto <o-takashi@sakamocchi.jp>]

On Tue, Oct 13, 2026 at 08:15:08PM +0900, Takashi Sakamoto wrote:
> The core provides helper functions and structures for initiating
> asynchronous transactions.
> 
> Add kerneldoc comments for these symbols.
> 
> Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>
> ---
>  Documentation/driver-api/firewire.rst |  3 ++
>  drivers/firewire/core-transaction.c   |  2 +
>  include/linux/firewire.h              | 61 +++++++++++++++++++++++++++
>  3 files changed, 66 insertions(+)
> ...
> diff --git a/drivers/firewire/core-transaction.c b/drivers/firewire/core-transaction.c
> index 33c4ea48c6c9..22cddb736289 100644
> --- a/drivers/firewire/core-transaction.c
> +++ b/drivers/firewire/core-transaction.c
> @@ -396,6 +396,8 @@ __must_hold(&card->transactions.lock)
>   * than when the request packet actually hits the wire.  On the other hand,
>   * transaction completion and hence execution of @callback may happen even
>   * before fw_send_request() returns.
> + *
> + * Context: Process context.
>   */
>  void __fw_send_request(struct fw_card *card, struct fw_transaction *t, int tcode,
>  		int destination_id, int generation, int speed, unsigned long long offset,

The above should be "Context: Any context.". Let me correct it when merging.


Regards

Takashi Sakamoto