diff mbox series

powercap: make documentation reflect code

Message ID e40a76dbc4d17d0bc80daf95e259fcd6cc6d48e2.1599733531.git.amitk@kernel.org
State New
Headers show
Series powercap: make documentation reflect code | expand

Commit Message

Amit Kucheria Sept. 10, 2020, 10:27 a.m. UTC
Fix up documentation of the struct members to reflect reality. Also
fixup a stray whitespace.

Signed-off-by: Amit Kucheria <amitk@kernel.org>

---
 include/linux/powercap.h | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

-- 
2.25.1

Comments

Rafael J. Wysocki Sept. 10, 2020, 5:23 p.m. UTC | #1
On Thu, Sep 10, 2020 at 12:28 PM Amit Kucheria <amit.kucheria@linaro.org> wrote:
>

> Fix up documentation of the struct members to reflect reality. Also

> fixup a stray whitespace.

>

> Signed-off-by: Amit Kucheria <amitk@kernel.org>

> ---

>  include/linux/powercap.h | 11 +++++------

>  1 file changed, 5 insertions(+), 6 deletions(-)

>

> diff --git a/include/linux/powercap.h b/include/linux/powercap.h

> index 4537f57f9e42f..3d557bbcd2c71 100644

> --- a/include/linux/powercap.h

> +++ b/include/linux/powercap.h

> @@ -44,19 +44,18 @@ struct powercap_control_type_ops {

>  };

>

>  /**

> - * struct powercap_control_type- Defines a powercap control_type

> - * @name:              name of control_type

> + * struct powercap_control_type - Defines a powercap control_type

>   * @dev:               device for this control_type

>   * @idr:               idr to have unique id for its child

> - * @root_node:         Root holding power zones for this control_type

> + * @nr_zones:          counter for number of zones of this type

>   * @ops:               Pointer to callback struct

> - * @node_lock:         mutex for control type

> + * @lock:              mutex for control type

>   * @allocated:         This is possible that client owns the memory

>   *                     used by this structure. In this case

>   *                     this flag is set to false by framework to

>   *                     prevent deallocation during release process.

>   *                     Otherwise this flag is set to true.

> - * @ctrl_inst:         link to the control_type list

> + * @node:              linked-list node

>   *

>   * Defines powercap control_type. This acts as a container for power

>   * zones, which use same method to control power. E.g. RAPL, RAPL-PCI etc.

> @@ -129,7 +128,7 @@ struct powercap_zone_ops {

>   *                     this flag is set to false by framework to

>   *                     prevent deallocation during release process.

>   *                     Otherwise this flag is set to true.

> - * @constraint_ptr:    List of constraints for this zone.

> + * @constraints:       List of constraints for this zone.

>   *

>   * This defines a power zone instance. The fields of this structure are

>   * private, and should not be used by client drivers.

> --


Applied with some changelog edits as 5.9-rc material, thanks!
diff mbox series

Patch

diff --git a/include/linux/powercap.h b/include/linux/powercap.h
index 4537f57f9e42f..3d557bbcd2c71 100644
--- a/include/linux/powercap.h
+++ b/include/linux/powercap.h
@@ -44,19 +44,18 @@  struct powercap_control_type_ops {
 };
 
 /**
- * struct powercap_control_type- Defines a powercap control_type
- * @name:		name of control_type
+ * struct powercap_control_type - Defines a powercap control_type
  * @dev:		device for this control_type
  * @idr:		idr to have unique id for its child
- * @root_node:		Root holding power zones for this control_type
+ * @nr_zones:		counter for number of zones of this type
  * @ops:		Pointer to callback struct
- * @node_lock:		mutex for control type
+ * @lock:		mutex for control type
  * @allocated:		This is possible that client owns the memory
  *			used by this structure. In this case
  *			this flag is set to false by framework to
  *			prevent deallocation during release process.
  *			Otherwise this flag is set to true.
- * @ctrl_inst:		link to the control_type list
+ * @node:		linked-list node
  *
  * Defines powercap control_type. This acts as a container for power
  * zones, which use same method to control power. E.g. RAPL, RAPL-PCI etc.
@@ -129,7 +128,7 @@  struct powercap_zone_ops {
  *			this flag is set to false by framework to
  *			prevent deallocation during release process.
  *			Otherwise this flag is set to true.
- * @constraint_ptr:	List of constraints for this zone.
+ * @constraints:	List of constraints for this zone.
  *
  * This defines a power zone instance. The fields of this structure are
  * private, and should not be used by client drivers.