Commit 65478428 authored Oct 04, 2012 by Daniel Santos Committed by Linus Torvalds Oct 06, 2012

kernel-doc: bugfix - multi-line macros



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 <daniel.santos@pobox.com>
Cc: Randy Dunlap <rdunlap@xenotime.net>
Cc: Michal Marek <mmarek@suse.cz>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>

parent 14864655

scripts/kernel-doc

+3 −0

Original line number	Diff line number	Diff line
		@@ -2046,6 +2046,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

Admin message