]> www.infradead.org Git - users/dwmw2/linux.git/commitdiff
ACPI: irq: Fix some kernel-doc issues
authorXiongfeng Wang <wangxiongfeng2@huawei.com>
Tue, 8 Nov 2022 01:46:23 +0000 (09:46 +0800)
committerRafael J. Wysocki <rafael.j.wysocki@intel.com>
Thu, 10 Nov 2022 19:21:35 +0000 (20:21 +0100)
The following commit change the second parameter of acpi_set_irq_model()
but forgot to update the function description. Let's fix it.

  commit 7327b16f5f56 ("APCI: irq: Add support for multiple GSI domains")

Also add description of parameter 'gsi' for
acpi_get_irq_source_fwhandle() to avoid the following build W=1 warning.

  drivers/acpi/irq.c:108: warning: Function parameter or member 'gsi' not described in 'acpi_get_irq_source_fwhandle'

Fixes: 7327b16f5f56 ("APCI: irq: Add support for multiple GSI domains")
Signed-off-by: Xiongfeng Wang <wangxiongfeng2@huawei.com>
Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
drivers/acpi/irq.c

index 1cc4647f78b86d70875f84615b1c131e64d7a4b5..c2c786eb95abc1fed2a773cee1ebf0080c8de6c8 100644 (file)
@@ -94,6 +94,7 @@ EXPORT_SYMBOL_GPL(acpi_unregister_gsi);
 /**
  * acpi_get_irq_source_fwhandle() - Retrieve fwhandle from IRQ resource source.
  * @source: acpi_resource_source to use for the lookup.
+ * @gsi: GSI IRQ number
  *
  * Description:
  * Retrieve the fwhandle of the device referenced by the given IRQ resource
@@ -297,8 +298,8 @@ EXPORT_SYMBOL_GPL(acpi_irq_get);
 /**
  * acpi_set_irq_model - Setup the GSI irqdomain information
  * @model: the value assigned to acpi_irq_model
- * @fwnode: the irq_domain identifier for mapping and looking up
- *          GSI interrupts
+ * @fn: a dispatcher function that will return the domain fwnode
+ *     for a given GSI
  */
 void __init acpi_set_irq_model(enum acpi_irq_model_id model,
                               struct fwnode_handle *(*fn)(u32))