Messages in this thread Patch in this message | | | Subject | [PATCH] tracing/trivial: Put trace_puts() comment above trace_puts() macro for kernel doc | From | Steven Rostedt <> | Date | Thu, 02 May 2013 11:26:13 -0400 |
| |
Kernel-doc gives the following warning:
DOCPROC Documentation/DocBook/kernel-api.xml Warning(/include/linux/kernel.h:590): No description found for parameter 'ip' Warning(/include/linux/kernel.h:590): No description found for parameter 'ip'
Due to the externs between the the comment and the trace_puts() macro. This is fixed by moving the externs below the macro and keeping the macro and comment directly together.
Reported-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Steven Rostedt <rostedt@goodmis.org>
diff --git a/include/linux/kernel.h b/include/linux/kernel.h index 2dac79c..2675814 100644 --- a/include/linux/kernel.h +++ b/include/linux/kernel.h @@ -586,9 +586,6 @@ int __trace_printk(unsigned long ip, const char *fmt, ...); * Returns: 0 if nothing was written, positive # if string was. * (1 when __trace_bputs is used, strlen(str) when __trace_puts is used) */ - -extern int __trace_bputs(unsigned long ip, const char *str); -extern int __trace_puts(unsigned long ip, const char *str, int size); #define trace_puts(str) ({ \ static const char *trace_printk_fmt \ __attribute__((section("__trace_printk_fmt"))) = \ @@ -599,6 +596,8 @@ extern int __trace_puts(unsigned long ip, const char *str, int size); else \ __trace_puts(_THIS_IP_, str, strlen(str)); \ }) +extern int __trace_bputs(unsigned long ip, const char *str); +extern int __trace_puts(unsigned long ip, const char *str, int size); extern void trace_dump_stack(int skip);
| |