ACPI: PCI: update kernel-doc line comments

Tian Tao · rafaeljw · commit 8e8883cef6ce · 2020-09-25T18:14:17.000+02:00
Update kernel-doc line comments to fix warnings reported by make W=1:

drivers/acpi/pci_root.c:71: warning: Function parameter or
member 'handle' not described in 'acpi_is_root_bridge'

Signed-off-by: Tian Tao &lt;tiantao6@hisilicon.com&gt;
[ rjw: Subject and changelog edits ]
Signed-off-by: Rafael J. Wysocki &lt;rafael.j.wysocki@intel.com&gt;
diff --git a/drivers/acpi/pci_root.c b/drivers/acpi/pci_root.c
@@ -62,7 +62,7 @@ static DEFINE_MUTEX(osc_lock);
 
 /**
  * acpi_is_root_bridge - determine whether an ACPI CA node is a PCI root bridge
- * @handle - the ACPI CA node in question.
+ * @handle:  the ACPI CA node in question.
  *
  * Note: we could make this API take a struct acpi_device * instead, but
  * for now, it's more convenient to operate on an acpi_handle.

Original file line number	Diff line number	Diff line change
`@@ -62,7 +62,7 @@ static DEFINE_MUTEX(osc_lock);`
`62`	`62`
`63`	`63`	`/**`
`64`	`64`	`* acpi_is_root_bridge - determine whether an ACPI CA node is a PCI root bridge`
`65`		`- * @handle - the ACPI CA node in question.`
	`65`	`+ * @handle: the ACPI CA node in question.`
`66`	`66`	`*`
`67`	`67`	`* Note: we could make this API take a struct acpi_device * instead, but`
`68`	`68`	`* for now, it's more convenient to operate on an acpi_handle.`