[ 22/22] kernel-doc: bugfix - multi-line macros
From: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Date: 2013-09-29 20:02:50
Also in:
lkml
3.4-stable review patch. If anyone has any objections, please let me know. ------------------ From: Daniel Santos <redacted> commit 654784284430bf2739985914b65e09c7c35a7273 upstream. Prior to this patch the following code breaks: /** * multiline_example - this breaks kernel-doc */ #define multiline_example( \ myparam) Producing this error: Error(somefile.h:983): cannot understand prototype: 'multiline_example( \ ' This patch fixes the issue by appending all lines ending in a blackslash (optionally followed by whitespace), removing the backslash and any whitespace after it prior to appending (just like the C pre-processor would). This fixes a break in kerel-doc introduced by the additions to rbtree.h. Signed-off-by: Daniel Santos <redacted> Cc: Randy Dunlap <redacted> Cc: Michal Marek <redacted> Signed-off-by: Andrew Morton <akpm@linux-foundation.org> Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org> Cc: Ben Hutchings <redacted> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org> --- scripts/kernel-doc | 3 +++ 1 file changed, 3 insertions(+)
--- a/scripts/kernel-doc
+++ b/scripts/kernel-doc@@ -2045,6 +2045,9 @@ sub process_file($) { $section_counter = 0; while (<IN>) { + while (s/\\\s*$//) { + $_ .= <IN>; + } if ($state == 0) { if (/$doc_start/o) { $state = 1; # next line is always the function name