* [PATCH -next 1/3] powerpc: boot: Fix a typo in partial_decompress() comment
@ 2024-04-07 6:39 Yang Li
2024-04-07 6:39 ` [PATCH -next 2/3] powerpc: Fix kernel-doc comments in fsl_gtm.c Yang Li
` (3 more replies)
0 siblings, 4 replies; 7+ messages in thread
From: Yang Li @ 2024-04-07 6:39 UTC (permalink / raw
To: arnd, mpe, npiggin, christophe.leroy, aneesh.kumar, naveen.n.rao
Cc: Yang Li, linuxppc-dev, linux-kernel
This commit adds kernel-doc style comments with complete parameter
descriptions for the function partial_decompress().
Signed-off-by: Yang Li <yang.lee@linux.alibaba.com>
---
arch/powerpc/boot/decompress.c | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/arch/powerpc/boot/decompress.c b/arch/powerpc/boot/decompress.c
index 977eb15a6d17..6835cb53f034 100644
--- a/arch/powerpc/boot/decompress.c
+++ b/arch/powerpc/boot/decompress.c
@@ -101,7 +101,7 @@ static void print_err(char *s)
* @input_size: length of the input buffer
* @outbuf: output buffer
* @output_size: length of the output buffer
- * @skip number of output bytes to ignore
+ * @_skip: number of output bytes to ignore
*
* This function takes compressed data from inbuf, decompresses and write it to
* outbuf. Once output_size bytes are written to the output buffer, or the
--
2.20.1.7.g153144c
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [PATCH -next 2/3] powerpc: Fix kernel-doc comments in fsl_gtm.c
2024-04-07 6:39 [PATCH -next 1/3] powerpc: boot: Fix a typo in partial_decompress() comment Yang Li
@ 2024-04-07 6:39 ` Yang Li
2024-04-07 17:09 ` Randy Dunlap
2024-04-07 6:39 ` [PATCH -next 3/3] powerpc/rtas: Add kernel-doc comments to smp_startup_cpu() Yang Li
` (2 subsequent siblings)
3 siblings, 1 reply; 7+ messages in thread
From: Yang Li @ 2024-04-07 6:39 UTC (permalink / raw
To: arnd, mpe, npiggin, christophe.leroy, aneesh.kumar, naveen.n.rao
Cc: Yang Li, linuxppc-dev, linux-kernel
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain; charset=n, Size: 1462 bytes --]
Fix some function names in kernel-doc comments.
Signed-off-by: Yang Li <yang.lee@linux.alibaba.com>
---
arch/powerpc/sysdev/fsl_gtm.c | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/arch/powerpc/sysdev/fsl_gtm.c b/arch/powerpc/sysdev/fsl_gtm.c
index 39186ad6b3c3..71e07883eb48 100644
--- a/arch/powerpc/sysdev/fsl_gtm.c
+++ b/arch/powerpc/sysdev/fsl_gtm.c
@@ -77,7 +77,7 @@ struct gtm {
static LIST_HEAD(gtms);
/**
- * gtm_get_timer - request GTM timer to use it with the rest of GTM API
+ * gtm_get_timer16 - request GTM timer to use it with the rest of GTM API
* Context: non-IRQ
*
* This function reserves GTM timer for later use. It returns gtm_timer
@@ -110,7 +110,7 @@ struct gtm_timer *gtm_get_timer16(void)
EXPORT_SYMBOL(gtm_get_timer16);
/**
- * gtm_get_specific_timer - request specific GTM timer
+ * gtm_get_specific_timer16 - request specific GTM timer
* @gtm: specific GTM, pass here GTM's device_node->data
* @timer: specific timer number, Timer1 is 0.
* Context: non-IRQ
@@ -276,7 +276,7 @@ EXPORT_SYMBOL(gtm_set_timer16);
* crop precision of the "usec" argument, thus usec is limited to 16 bits
* (single timer width).
*/
-int gtm_set_exact_timer16(struct gtm_timer *tmr, u16 usec, bool reload)
+int gtm_set_exact_utimer16(struct gtm_timer *tmr, u16 usec, bool reload)
{
/* quite obvious, frequency which is enough for µSec precision */
const int freq = 1000000;
--
2.20.1.7.g153144c
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [PATCH -next 3/3] powerpc/rtas: Add kernel-doc comments to smp_startup_cpu()
2024-04-07 6:39 [PATCH -next 1/3] powerpc: boot: Fix a typo in partial_decompress() comment Yang Li
2024-04-07 6:39 ` [PATCH -next 2/3] powerpc: Fix kernel-doc comments in fsl_gtm.c Yang Li
@ 2024-04-07 6:39 ` Yang Li
2024-04-07 17:11 ` Randy Dunlap
2024-04-07 17:05 ` [PATCH -next 1/3] powerpc: boot: Fix a typo in partial_decompress() comment Randy Dunlap
2024-04-08 4:25 ` Michael Ellerman
3 siblings, 1 reply; 7+ messages in thread
From: Yang Li @ 2024-04-07 6:39 UTC (permalink / raw
To: arnd, mpe, npiggin, christophe.leroy, aneesh.kumar, naveen.n.rao
Cc: Yang Li, linuxppc-dev, linux-kernel
This commit adds kernel-doc style comments with complete parameter
descriptions for the function smp_startup_cpu().
Signed-off-by: Yang Li <yang.lee@linux.alibaba.com>
---
arch/powerpc/platforms/cell/smp.c | 2 ++
1 file changed, 2 insertions(+)
diff --git a/arch/powerpc/platforms/cell/smp.c b/arch/powerpc/platforms/cell/smp.c
index 30394c6f8894..bdb7adde798d 100644
--- a/arch/powerpc/platforms/cell/smp.c
+++ b/arch/powerpc/platforms/cell/smp.c
@@ -55,6 +55,8 @@ static cpumask_t of_spin_map;
/**
* smp_startup_cpu() - start the given cpu
*
+ * @lcpu: Logical CPU ID of the CPU to be started.
+ *
* At boot time, there is nothing to do for primary threads which were
* started from Open Firmware. For anything else, call RTAS with the
* appropriate start location.
--
2.20.1.7.g153144c
^ permalink raw reply related [flat|nested] 7+ messages in thread
* Re: [PATCH -next 1/3] powerpc: boot: Fix a typo in partial_decompress() comment
2024-04-07 6:39 [PATCH -next 1/3] powerpc: boot: Fix a typo in partial_decompress() comment Yang Li
2024-04-07 6:39 ` [PATCH -next 2/3] powerpc: Fix kernel-doc comments in fsl_gtm.c Yang Li
2024-04-07 6:39 ` [PATCH -next 3/3] powerpc/rtas: Add kernel-doc comments to smp_startup_cpu() Yang Li
@ 2024-04-07 17:05 ` Randy Dunlap
2024-04-08 4:25 ` Michael Ellerman
3 siblings, 0 replies; 7+ messages in thread
From: Randy Dunlap @ 2024-04-07 17:05 UTC (permalink / raw
To: Yang Li, arnd, mpe, npiggin, christophe.leroy, aneesh.kumar,
naveen.n.rao
Cc: linuxppc-dev, linux-kernel
On 4/6/24 11:39 PM, Yang Li wrote:
> This commit adds kernel-doc style comments with complete parameter
> descriptions for the function partial_decompress().
>
> Signed-off-by: Yang Li <yang.lee@linux.alibaba.com>
Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Thanks.
> ---
> arch/powerpc/boot/decompress.c | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/arch/powerpc/boot/decompress.c b/arch/powerpc/boot/decompress.c
> index 977eb15a6d17..6835cb53f034 100644
> --- a/arch/powerpc/boot/decompress.c
> +++ b/arch/powerpc/boot/decompress.c
> @@ -101,7 +101,7 @@ static void print_err(char *s)
> * @input_size: length of the input buffer
> * @outbuf: output buffer
> * @output_size: length of the output buffer
> - * @skip number of output bytes to ignore
> + * @_skip: number of output bytes to ignore
> *
> * This function takes compressed data from inbuf, decompresses and write it to
> * outbuf. Once output_size bytes are written to the output buffer, or the
--
#Randy
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH -next 2/3] powerpc: Fix kernel-doc comments in fsl_gtm.c
2024-04-07 6:39 ` [PATCH -next 2/3] powerpc: Fix kernel-doc comments in fsl_gtm.c Yang Li
@ 2024-04-07 17:09 ` Randy Dunlap
0 siblings, 0 replies; 7+ messages in thread
From: Randy Dunlap @ 2024-04-07 17:09 UTC (permalink / raw
To: Yang Li, arnd, mpe, npiggin, christophe.leroy, aneesh.kumar,
naveen.n.rao
Cc: linuxppc-dev, linux-kernel
On 4/6/24 11:39 PM, Yang Li wrote:
> Fix some function names in kernel-doc comments.
>
> Signed-off-by: Yang Li <yang.lee@linux.alibaba.com>
> ---
> arch/powerpc/sysdev/fsl_gtm.c | 6 +++---
> 1 file changed, 3 insertions(+), 3 deletions(-)
>
> diff --git a/arch/powerpc/sysdev/fsl_gtm.c b/arch/powerpc/sysdev/fsl_gtm.c
> index 39186ad6b3c3..71e07883eb48 100644
> --- a/arch/powerpc/sysdev/fsl_gtm.c
> +++ b/arch/powerpc/sysdev/fsl_gtm.c
> @@ -77,7 +77,7 @@ struct gtm {
> static LIST_HEAD(gtms);
>
> /**
> - * gtm_get_timer - request GTM timer to use it with the rest of GTM API
> + * gtm_get_timer16 - request GTM timer to use it with the rest of GTM API
ack
> * Context: non-IRQ
> *
> * This function reserves GTM timer for later use. It returns gtm_timer
> @@ -110,7 +110,7 @@ struct gtm_timer *gtm_get_timer16(void)
> EXPORT_SYMBOL(gtm_get_timer16);
>
> /**
> - * gtm_get_specific_timer - request specific GTM timer
> + * gtm_get_specific_timer16 - request specific GTM timer
ack
> * @gtm: specific GTM, pass here GTM's device_node->data
> * @timer: specific timer number, Timer1 is 0.
> * Context: non-IRQ
> @@ -276,7 +276,7 @@ EXPORT_SYMBOL(gtm_set_timer16);
> * crop precision of the "usec" argument, thus usec is limited to 16 bits
> * (single timer width).
> */
> -int gtm_set_exact_timer16(struct gtm_timer *tmr, u16 usec, bool reload)
> +int gtm_set_exact_utimer16(struct gtm_timer *tmr, u16 usec, bool reload)
No, change the kernel-doc comment instead. Otherwise the caller will fail to link.
> {
> /* quite obvious, frequency which is enough for µSec precision */
> const int freq = 1000000;
thanks.
--
#Randy
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH -next 3/3] powerpc/rtas: Add kernel-doc comments to smp_startup_cpu()
2024-04-07 6:39 ` [PATCH -next 3/3] powerpc/rtas: Add kernel-doc comments to smp_startup_cpu() Yang Li
@ 2024-04-07 17:11 ` Randy Dunlap
0 siblings, 0 replies; 7+ messages in thread
From: Randy Dunlap @ 2024-04-07 17:11 UTC (permalink / raw
To: Yang Li, arnd, mpe, npiggin, christophe.leroy, aneesh.kumar,
naveen.n.rao
Cc: linuxppc-dev, linux-kernel
On 4/6/24 11:39 PM, Yang Li wrote:
> This commit adds kernel-doc style comments with complete parameter
> descriptions for the function smp_startup_cpu().
>
> Signed-off-by: Yang Li <yang.lee@linux.alibaba.com>
> ---
> arch/powerpc/platforms/cell/smp.c | 2 ++
> 1 file changed, 2 insertions(+)
>
> diff --git a/arch/powerpc/platforms/cell/smp.c b/arch/powerpc/platforms/cell/smp.c
> index 30394c6f8894..bdb7adde798d 100644
> --- a/arch/powerpc/platforms/cell/smp.c
> +++ b/arch/powerpc/platforms/cell/smp.c
> @@ -55,6 +55,8 @@ static cpumask_t of_spin_map;
> /**
> * smp_startup_cpu() - start the given cpu
> *
> + * @lcpu: Logical CPU ID of the CPU to be started.
Does this work with the blank line between the function and parameter?
(i.e., no kernel-doc warnings?)
Usually it's done without the extra line.
Otherwise the additional line for @lcpu: looks good to me.
Thanks.
> + *
> * At boot time, there is nothing to do for primary threads which were
> * started from Open Firmware. For anything else, call RTAS with the
> * appropriate start location.
--
#Randy
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH -next 1/3] powerpc: boot: Fix a typo in partial_decompress() comment
2024-04-07 6:39 [PATCH -next 1/3] powerpc: boot: Fix a typo in partial_decompress() comment Yang Li
` (2 preceding siblings ...)
2024-04-07 17:05 ` [PATCH -next 1/3] powerpc: boot: Fix a typo in partial_decompress() comment Randy Dunlap
@ 2024-04-08 4:25 ` Michael Ellerman
3 siblings, 0 replies; 7+ messages in thread
From: Michael Ellerman @ 2024-04-08 4:25 UTC (permalink / raw
To: Yang Li, arnd, npiggin, christophe.leroy, aneesh.kumar,
naveen.n.rao
Cc: Yang Li, linuxppc-dev, linux-kernel
Yang Li <yang.lee@linux.alibaba.com> writes:
> This commit adds kernel-doc style comments with complete parameter
> descriptions for the function partial_decompress().
This change log doesn't match the subject or the patch.
cheers
> Signed-off-by: Yang Li <yang.lee@linux.alibaba.com>
> ---
> arch/powerpc/boot/decompress.c | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/arch/powerpc/boot/decompress.c b/arch/powerpc/boot/decompress.c
> index 977eb15a6d17..6835cb53f034 100644
> --- a/arch/powerpc/boot/decompress.c
> +++ b/arch/powerpc/boot/decompress.c
> @@ -101,7 +101,7 @@ static void print_err(char *s)
> * @input_size: length of the input buffer
> * @outbuf: output buffer
> * @output_size: length of the output buffer
> - * @skip number of output bytes to ignore
> + * @_skip: number of output bytes to ignore
> *
> * This function takes compressed data from inbuf, decompresses and write it to
> * outbuf. Once output_size bytes are written to the output buffer, or the
> --
> 2.20.1.7.g153144c
^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2024-04-08 4:25 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2024-04-07 6:39 [PATCH -next 1/3] powerpc: boot: Fix a typo in partial_decompress() comment Yang Li
2024-04-07 6:39 ` [PATCH -next 2/3] powerpc: Fix kernel-doc comments in fsl_gtm.c Yang Li
2024-04-07 17:09 ` Randy Dunlap
2024-04-07 6:39 ` [PATCH -next 3/3] powerpc/rtas: Add kernel-doc comments to smp_startup_cpu() Yang Li
2024-04-07 17:11 ` Randy Dunlap
2024-04-07 17:05 ` [PATCH -next 1/3] powerpc: boot: Fix a typo in partial_decompress() comment Randy Dunlap
2024-04-08 4:25 ` Michael Ellerman
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).