Kernel/linux-next
1
0
Fork 0
mirror of https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git synced 2025-01-12 08:48:48 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

tracing: Put trace_puts() comment above trace_puts() macro for kernel doc

Browse Source 
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>
Signed-off-by: Jiri Kosina <jkosina@suse.cz>
This commit is contained in:
Steven Rostedt 2013-05-02 11:26:13 -04:00 committed by Jiri Kosina
parent 8ef726cb23
commit bcf312cf76
1 changed files with 2 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
include/linux/kernel.h
View File

@ -562,9 +562,6 @@ int __trace_bprintk(unsigned long ip, const char *fmt, ...);
extern __printf(2, 3) extern __printf(2, 3)
int __trace_printk(unsigned long ip, const char *fmt, ...); int __trace_printk(unsigned long ip, const char *fmt, ...);
extern int __trace_bputs(unsigned long ip, const char *str);
extern int __trace_puts(unsigned long ip, const char *str, int size);
/** /**
* trace_puts - write a string into the ftrace buffer * trace_puts - write a string into the ftrace buffer
* @str: the string to record * @str: the string to record
@ -600,6 +597,8 @@ extern int __trace_puts(unsigned long ip, const char *str, int size);
else \ else \
__trace_puts(_THIS_IP_, str, strlen(str)); \ __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); extern void trace_dump_stack(int skip);