patch 'power: fix some doxygen comments' has been queued to stable release 21.11.3

[Kevin Traynor]

Hi,

FYI, your patch has been queued to stable release 21.11.3

Note it hasn't been pushed to http://dpdk.org/browse/dpdk-stable yet.
It will be pushed if I get no objections before 11/28/22. So please
shout if anyone has objections.

Also note that after the patch there's a diff of the upstream commit vs the
patch applied to the branch. This will indicate if there was any rebasing
needed to apply to the stable branch. If there were code changes for rebasing
(ie: not only metadata diffs), please double check that the rebase was
correctly done.

Queued patches are on a temporary branch at:
https://github.com/kevintraynor/dpdk-stable

This queued commit can be viewed at:
https://github.com/kevintraynor/dpdk-stable/commit/5a4f6d16e87f274533ee1b2db1ae14b8e83e32b4

Thanks.

Kevin

---
>From 5a4f6d16e87f274533ee1b2db1ae14b8e83e32b4 Mon Sep 17 00:00:00 2001
From: Jerin Jacob <jerinj at marvell.com>
Date: Wed, 9 Nov 2022 20:24:10 +0530
Subject: [PATCH] power: fix some doxygen comments

[ upstream commit 58794bf8d2d577b18e8bd430fd6419274678b34e ]

Fix following syntax error reported by doxygen 1.9.5 version.

lib/power/rte_power.h:169: error: rte_power_freq_up has
@param documentation sections but no arguments
(warning treated as error, aborting now)

Fixes: d7937e2e3d12 ("power: initial import")

Signed-off-by: Jerin Jacob <jerinj at marvell.com>
---
 lib/power/rte_power.h | 55 -------------------------------------------
 1 file changed, 55 deletions(-)

diff --git a/lib/power/rte_power.h b/lib/power/rte_power.h
index c5759afa39..829a22380d 100644
--- a/lib/power/rte_power.h
+++ b/lib/power/rte_power.h
@@ -172,12 +172,4 @@ typedef int (*rte_power_freq_change_t)(unsigned int lcore_id);
  * frequencies.
  * Review each environments specific documentation for usage.
- *
- * @param lcore_id
- *  lcore id.
- *
- * @return
- *  - 1 on success with frequency changed.
- *  - 0 on success without frequency changed.
- *  - Negative on error.
  */
 extern rte_power_freq_change_t rte_power_freq_up;
@@ -187,14 +179,5 @@ extern rte_power_freq_change_t rte_power_freq_up;
  * frequencies.
  * Review each environments specific documentation for usage.
- *
- * @param lcore_id
- *  lcore id.
- *
- * @return
- *  - 1 on success with frequency changed.
- *  - 0 on success without frequency changed.
- *  - Negative on error.
  */
-
 extern rte_power_freq_change_t rte_power_freq_down;
 
@@ -203,12 +186,4 @@ extern rte_power_freq_change_t rte_power_freq_down;
  * available frequencies.
  * Review each environments specific documentation for usage.
- *
- * @param lcore_id
- *  lcore id.
- *
- * @return
- *  - 1 on success with frequency changed.
- *  - 0 on success without frequency changed.
- *  - Negative on error.
  */
 extern rte_power_freq_change_t rte_power_freq_max;
@@ -218,12 +193,4 @@ extern rte_power_freq_change_t rte_power_freq_max;
  * available frequencies.
  * Review each environments specific documentation for usage..
- *
- * @param lcore_id
- *  lcore id.
- *
- * @return
- *  - 1 on success with frequency changed.
- *  - 0 on success without frequency changed.
- *  - Negative on error.
  */
 extern rte_power_freq_change_t rte_power_freq_min;
@@ -232,12 +199,4 @@ extern rte_power_freq_change_t rte_power_freq_min;
  * Query the Turbo Boost status of a specific lcore.
  * Review each environments specific documentation for usage..
- *
- * @param lcore_id
- *  lcore id.
- *
- * @return
- *  - 1 Turbo Boost is enabled for this lcore.
- *  - 0 Turbo Boost is disabled for this lcore.
- *  - Negative on error.
  */
 extern rte_power_freq_change_t rte_power_turbo_status;
@@ -246,11 +205,4 @@ extern rte_power_freq_change_t rte_power_turbo_status;
  * Enable Turbo Boost for this lcore.
  * Review each environments specific documentation for usage..
- *
- * @param lcore_id
- *  lcore id.
- *
- * @return
- *  - 0 on success.
- *  - Negative on error.
  */
 extern rte_power_freq_change_t rte_power_freq_enable_turbo;
@@ -259,11 +211,4 @@ extern rte_power_freq_change_t rte_power_freq_enable_turbo;
  * Disable Turbo Boost for this lcore.
  * Review each environments specific documentation for usage..
- *
- * @param lcore_id
- *  lcore id.
- *
- * @return
- *  - 0 on success.
- *  - Negative on error.
  */
 extern rte_power_freq_change_t rte_power_freq_disable_turbo;
-- 
2.38.1

---
  Diff of the applied patch vs upstream commit (please double-check if non-empty:
---
--- -	2022-11-23 09:55:57.286441151 +0000
+++ 0007-power-fix-some-doxygen-comments.patch	2022-11-23 09:55:57.013149166 +0000
@@ -1 +1 @@
-From 58794bf8d2d577b18e8bd430fd6419274678b34e Mon Sep 17 00:00:00 2001
+From 5a4f6d16e87f274533ee1b2db1ae14b8e83e32b4 Mon Sep 17 00:00:00 2001
@@ -5,0 +6,2 @@
+[ upstream commit 58794bf8d2d577b18e8bd430fd6419274678b34e ]
+
@@ -13 +14,0 @@
-Cc: stable at dpdk.org
@@ -21 +22 @@
-index 47345e26df..7954299489 100644
+index c5759afa39..829a22380d 100644
@@ -24 +25 @@
-@@ -170,12 +170,4 @@ typedef int (*rte_power_freq_change_t)(unsigned int lcore_id);
+@@ -172,12 +172,4 @@ typedef int (*rte_power_freq_change_t)(unsigned int lcore_id);
@@ -37 +38 @@
-@@ -185,14 +177,5 @@ extern rte_power_freq_change_t rte_power_freq_up;
+@@ -187,14 +179,5 @@ extern rte_power_freq_change_t rte_power_freq_up;
@@ -52 +53 @@
-@@ -201,12 +184,4 @@ extern rte_power_freq_change_t rte_power_freq_down;
+@@ -203,12 +186,4 @@ extern rte_power_freq_change_t rte_power_freq_down;
@@ -65 +66 @@
-@@ -216,12 +191,4 @@ extern rte_power_freq_change_t rte_power_freq_max;
+@@ -218,12 +193,4 @@ extern rte_power_freq_change_t rte_power_freq_max;
@@ -78 +79 @@
-@@ -230,12 +197,4 @@ extern rte_power_freq_change_t rte_power_freq_min;
+@@ -232,12 +199,4 @@ extern rte_power_freq_change_t rte_power_freq_min;
@@ -91 +92 @@
-@@ -244,11 +203,4 @@ extern rte_power_freq_change_t rte_power_turbo_status;
+@@ -246,11 +205,4 @@ extern rte_power_freq_change_t rte_power_turbo_status;
@@ -103 +104 @@
-@@ -257,11 +209,4 @@ extern rte_power_freq_change_t rte_power_freq_enable_turbo;
+@@ -259,11 +211,4 @@ extern rte_power_freq_change_t rte_power_freq_enable_turbo;