[PATCH v1 1/1] ACPI: resource: Amend kernel-doc style

[PATCH v1 1/1] ACPI: resource: Amend kernel-doc style

[Andy Shevchenko]

The functions are referred as func() in the kernel-doc. The % (percent)
character makes the rendering for constants as described in the respective
documentation. Amend all these.

Fixes: 8e345c991c8c ("ACPI: Centralized processing of ACPI device resources")
Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
---
 drivers/acpi/resource.c | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/drivers/acpi/resource.c b/drivers/acpi/resource.c
index bc8050d8a6f5..56df4599d360 100644
--- a/drivers/acpi/resource.c
+++ b/drivers/acpi/resource.c
@@ -871,7 +871,7 @@ bool acpi_dev_resource_interrupt(struct acpi_resource *ares, int index,
 EXPORT_SYMBOL_GPL(acpi_dev_resource_interrupt);
 
 /**
- * acpi_dev_free_resource_list - Free resource from %acpi_dev_get_resources().
+ * acpi_dev_free_resource_list - Free resource from acpi_dev_get_resources().
  * @list: The head of the resource list to free.
  */
 void acpi_dev_free_resource_list(struct list_head *list)
@@ -991,7 +991,7 @@ static int __acpi_dev_get_resources(struct acpi_device *adev,
  *
  * The resultant struct resource objects are put on the list pointed to by
  * @list, that must be empty initially, as members of struct resource_entry
- * objects.  Callers of this routine should use %acpi_dev_free_resource_list() to
+ * objects.  Callers of this routine should use acpi_dev_free_resource_list() to
  * free that list.
  *
  * The number of resources in the output list is returned on success, an error
@@ -1032,7 +1032,7 @@ static int is_memory(struct acpi_resource *ares, void *not_used)
  * The resultant struct resource objects are put on the list pointed to
  * by @list, that must be empty initially, as members of struct
  * resource_entry objects.  Callers of this routine should use
- * %acpi_dev_free_resource_list() to free that list.
+ * acpi_dev_free_resource_list() to free that list.
  *
  * The number of resources in the output list is returned on success,
  * an error code reflecting the error condition is returned otherwise.
-- 
2.50.1

Re: [PATCH v1 1/1] ACPI: resource: Amend kernel-doc style

[Rafael J. Wysocki]

On Wed, Jun 17, 2026 at 11:06 AM Andy Shevchenko
<andriy.shevchenko@linux.intel.com> wrote:
>
> The functions are referred as func() in the kernel-doc. The % (percent)
> character makes the rendering for constants as described in the respective
> documentation. Amend all these.
>
> Fixes: 8e345c991c8c ("ACPI: Centralized processing of ACPI device resources")
> Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
> ---
>  drivers/acpi/resource.c | 6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)
>
> diff --git a/drivers/acpi/resource.c b/drivers/acpi/resource.c
> index bc8050d8a6f5..56df4599d360 100644
> --- a/drivers/acpi/resource.c
> +++ b/drivers/acpi/resource.c
> @@ -871,7 +871,7 @@ bool acpi_dev_resource_interrupt(struct acpi_resource *ares, int index,
>  EXPORT_SYMBOL_GPL(acpi_dev_resource_interrupt);
>
>  /**
> - * acpi_dev_free_resource_list - Free resource from %acpi_dev_get_resources().
> + * acpi_dev_free_resource_list - Free resource from acpi_dev_get_resources().
>   * @list: The head of the resource list to free.
>   */
>  void acpi_dev_free_resource_list(struct list_head *list)
> @@ -991,7 +991,7 @@ static int __acpi_dev_get_resources(struct acpi_device *adev,
>   *
>   * The resultant struct resource objects are put on the list pointed to by
>   * @list, that must be empty initially, as members of struct resource_entry
> - * objects.  Callers of this routine should use %acpi_dev_free_resource_list() to
> + * objects.  Callers of this routine should use acpi_dev_free_resource_list() to
>   * free that list.
>   *
>   * The number of resources in the output list is returned on success, an error
> @@ -1032,7 +1032,7 @@ static int is_memory(struct acpi_resource *ares, void *not_used)
>   * The resultant struct resource objects are put on the list pointed to
>   * by @list, that must be empty initially, as members of struct
>   * resource_entry objects.  Callers of this routine should use
> - * %acpi_dev_free_resource_list() to free that list.
> + * acpi_dev_free_resource_list() to free that list.
>   *
>   * The number of resources in the output list is returned on success,
>   * an error code reflecting the error condition is returned otherwise.
> --

Applied as 7.2-rc material, thanks!