thermal: cpu_cooling: fix kernel doc for is_cpufreq_valid
authorEduardo Valentin <eduardo.valentin@ti.com>
Wed, 17 Apr 2013 17:12:00 +0000 (17:12 +0000)
committerZhang Rui <rui.zhang@intel.com>
Wed, 24 Apr 2013 16:34:38 +0000 (00:34 +0800)
Update documentation for is_cpufreq_valid function so
that kernel-doc does not complain about return value.

Signed-off-by: Eduardo Valentin <eduardo.valentin@ti.com>
Acked-by: Amit Daniel Kachhap <amit.daniel@samsung.com>
Signed-off-by: Zhang Rui <rui.zhang@intel.com>
drivers/thermal/cpu_cooling.c

index 14c64b2a1466714268cb0959f7dc0460b988116e..b8b8a1ef85ed650677f0610aa581408b73307709 100644 (file)
@@ -97,8 +97,14 @@ static void release_idr(struct idr *idr, int id)
 /* Below code defines functions to be used for cpufreq as cooling device */
 
 /**
- * is_cpufreq_valid - function to check if a cpu has frequency transition policy.
+ * is_cpufreq_valid - function to check frequency transitioning capability.
  * @cpu: cpu for which check is needed.
+ *
+ * This function will check the current state of the system if
+ * it is capable of changing the frequency for a given @cpu.
+ *
+ * Return: 0 if the system is not currently capable of changing
+ * the frequency of given cpu. !0 in case the frequency is changeable.
  */
 static int is_cpufreq_valid(int cpu)
 {