diff options
-rwxr-xr-x | scripts/kernel-doc | 38 |
1 files changed, 19 insertions, 19 deletions
diff --git a/scripts/kernel-doc b/scripts/kernel-doc index a7bf5f68aacb..9a08fb5c1af6 100755 --- a/scripts/kernel-doc +++ b/scripts/kernel-doc | |||
@@ -469,7 +469,7 @@ sub dump_section { | |||
469 | } else { | 469 | } else { |
470 | # print STDERR "other section '$name' = '$contents'\n"; | 470 | # print STDERR "other section '$name' = '$contents'\n"; |
471 | if (defined($sections{$name}) && ($sections{$name} ne "")) { | 471 | if (defined($sections{$name}) && ($sections{$name} ne "")) { |
472 | print STDERR "Error(${file}:$.): duplicate section name '$name'\n"; | 472 | print STDERR "${file}:$.: error: duplicate section name '$name'\n"; |
473 | ++$errors; | 473 | ++$errors; |
474 | } | 474 | } |
475 | $sections{$name} = $contents; | 475 | $sections{$name} = $contents; |
@@ -1820,7 +1820,7 @@ sub dump_struct($$) { | |||
1820 | }); | 1820 | }); |
1821 | } | 1821 | } |
1822 | else { | 1822 | else { |
1823 | print STDERR "Error(${file}:$.): Cannot parse struct or union!\n"; | 1823 | print STDERR "${file}:$.: error: Cannot parse struct or union!\n"; |
1824 | ++$errors; | 1824 | ++$errors; |
1825 | } | 1825 | } |
1826 | } | 1826 | } |
@@ -1841,7 +1841,7 @@ sub dump_enum($$) { | |||
1841 | push @parameterlist, $arg; | 1841 | push @parameterlist, $arg; |
1842 | if (!$parameterdescs{$arg}) { | 1842 | if (!$parameterdescs{$arg}) { |
1843 | $parameterdescs{$arg} = $undescribed; | 1843 | $parameterdescs{$arg} = $undescribed; |
1844 | print STDERR "Warning(${file}:$.): Enum value '$arg' ". | 1844 | print STDERR "${file}:$.: warning: Enum value '$arg' ". |
1845 | "not described in enum '$declaration_name'\n"; | 1845 | "not described in enum '$declaration_name'\n"; |
1846 | } | 1846 | } |
1847 | 1847 | ||
@@ -1859,7 +1859,7 @@ sub dump_enum($$) { | |||
1859 | }); | 1859 | }); |
1860 | } | 1860 | } |
1861 | else { | 1861 | else { |
1862 | print STDERR "Error(${file}:$.): Cannot parse enum!\n"; | 1862 | print STDERR "${file}:$.: error: Cannot parse enum!\n"; |
1863 | ++$errors; | 1863 | ++$errors; |
1864 | } | 1864 | } |
1865 | } | 1865 | } |
@@ -1887,7 +1887,7 @@ sub dump_typedef($$) { | |||
1887 | }); | 1887 | }); |
1888 | } | 1888 | } |
1889 | else { | 1889 | else { |
1890 | print STDERR "Error(${file}:$.): Cannot parse typedef!\n"; | 1890 | print STDERR "${file}:$.: error: Cannot parse typedef!\n"; |
1891 | ++$errors; | 1891 | ++$errors; |
1892 | } | 1892 | } |
1893 | } | 1893 | } |
@@ -2019,11 +2019,11 @@ sub push_parameter($$$) { | |||
2019 | $parameterdescs{$param_name} = $undescribed; | 2019 | $parameterdescs{$param_name} = $undescribed; |
2020 | 2020 | ||
2021 | if (($type eq 'function') || ($type eq 'enum')) { | 2021 | if (($type eq 'function') || ($type eq 'enum')) { |
2022 | print STDERR "Warning(${file}:$.): Function parameter ". | 2022 | print STDERR "${file}:$.: warning: Function parameter ". |
2023 | "or member '$param' not " . | 2023 | "or member '$param' not " . |
2024 | "described in '$declaration_name'\n"; | 2024 | "described in '$declaration_name'\n"; |
2025 | } | 2025 | } |
2026 | print STDERR "Warning(${file}:$.):" . | 2026 | print STDERR "${file}:$.: warning:" . |
2027 | " No description found for parameter '$param'\n"; | 2027 | " No description found for parameter '$param'\n"; |
2028 | ++$warnings; | 2028 | ++$warnings; |
2029 | } | 2029 | } |
@@ -2074,14 +2074,14 @@ sub check_sections($$$$$$) { | |||
2074 | } | 2074 | } |
2075 | if ($err) { | 2075 | if ($err) { |
2076 | if ($decl_type eq "function") { | 2076 | if ($decl_type eq "function") { |
2077 | print STDERR "Warning(${file}:$.): " . | 2077 | print STDERR "${file}:$.: warning: " . |
2078 | "Excess function parameter " . | 2078 | "Excess function parameter " . |
2079 | "'$sects[$sx]' " . | 2079 | "'$sects[$sx]' " . |
2080 | "description in '$decl_name'\n"; | 2080 | "description in '$decl_name'\n"; |
2081 | ++$warnings; | 2081 | ++$warnings; |
2082 | } else { | 2082 | } else { |
2083 | if ($nested !~ m/\Q$sects[$sx]\E/) { | 2083 | if ($nested !~ m/\Q$sects[$sx]\E/) { |
2084 | print STDERR "Warning(${file}:$.): " . | 2084 | print STDERR "${file}:$.: warning: " . |
2085 | "Excess struct/union/enum/typedef member " . | 2085 | "Excess struct/union/enum/typedef member " . |
2086 | "'$sects[$sx]' " . | 2086 | "'$sects[$sx]' " . |
2087 | "description in '$decl_name'\n"; | 2087 | "description in '$decl_name'\n"; |
@@ -2107,7 +2107,7 @@ sub check_return_section { | |||
2107 | 2107 | ||
2108 | if (!defined($sections{$section_return}) || | 2108 | if (!defined($sections{$section_return}) || |
2109 | $sections{$section_return} eq "") { | 2109 | $sections{$section_return} eq "") { |
2110 | print STDERR "Warning(${file}:$.): " . | 2110 | print STDERR "${file}:$.: warning: " . |
2111 | "No description found for return value of " . | 2111 | "No description found for return value of " . |
2112 | "'$declaration_name'\n"; | 2112 | "'$declaration_name'\n"; |
2113 | ++$warnings; | 2113 | ++$warnings; |
@@ -2186,7 +2186,7 @@ sub dump_function($$) { | |||
2186 | 2186 | ||
2187 | create_parameterlist($args, ',', $file); | 2187 | create_parameterlist($args, ',', $file); |
2188 | } else { | 2188 | } else { |
2189 | print STDERR "Warning(${file}:$.): cannot understand function prototype: '$prototype'\n"; | 2189 | print STDERR "${file}:$.: warning: cannot understand function prototype: '$prototype'\n"; |
2190 | return; | 2190 | return; |
2191 | } | 2191 | } |
2192 | 2192 | ||
@@ -2251,7 +2251,7 @@ sub tracepoint_munge($) { | |||
2251 | $tracepointargs = $1; | 2251 | $tracepointargs = $1; |
2252 | } | 2252 | } |
2253 | if (($tracepointname eq 0) || ($tracepointargs eq 0)) { | 2253 | if (($tracepointname eq 0) || ($tracepointargs eq 0)) { |
2254 | print STDERR "Warning(${file}:$.): Unrecognized tracepoint format: \n". | 2254 | print STDERR "${file}:$.: warning: Unrecognized tracepoint format: \n". |
2255 | "$prototype\n"; | 2255 | "$prototype\n"; |
2256 | } else { | 2256 | } else { |
2257 | $prototype = "static inline void trace_$tracepointname($tracepointargs)"; | 2257 | $prototype = "static inline void trace_$tracepointname($tracepointargs)"; |
@@ -2450,7 +2450,7 @@ sub process_file($) { | |||
2450 | } | 2450 | } |
2451 | 2451 | ||
2452 | if (($declaration_purpose eq "") && $verbose) { | 2452 | if (($declaration_purpose eq "") && $verbose) { |
2453 | print STDERR "Warning(${file}:$.): missing initial short description on line:\n"; | 2453 | print STDERR "${file}:$.: warning: missing initial short description on line:\n"; |
2454 | print STDERR $_; | 2454 | print STDERR $_; |
2455 | ++$warnings; | 2455 | ++$warnings; |
2456 | } | 2456 | } |
@@ -2468,10 +2468,10 @@ sub process_file($) { | |||
2468 | } | 2468 | } |
2469 | 2469 | ||
2470 | if ($verbose) { | 2470 | if ($verbose) { |
2471 | print STDERR "Info(${file}:$.): Scanning doc for $identifier\n"; | 2471 | print STDERR "${file}:$.: info: Scanning doc for $identifier\n"; |
2472 | } | 2472 | } |
2473 | } else { | 2473 | } else { |
2474 | print STDERR "Warning(${file}:$.): Cannot understand $_ on line $.", | 2474 | print STDERR "${file}:$.: warning: Cannot understand $_ on line $.", |
2475 | " - I thought it was a doc line\n"; | 2475 | " - I thought it was a doc line\n"; |
2476 | ++$warnings; | 2476 | ++$warnings; |
2477 | $state = 0; | 2477 | $state = 0; |
@@ -2483,7 +2483,7 @@ sub process_file($) { | |||
2483 | 2483 | ||
2484 | if (($contents ne "") && ($contents ne "\n")) { | 2484 | if (($contents ne "") && ($contents ne "\n")) { |
2485 | if (!$in_doc_sect && $verbose) { | 2485 | if (!$in_doc_sect && $verbose) { |
2486 | print STDERR "Warning(${file}:$.): contents before sections\n"; | 2486 | print STDERR "${file}:$.: warning: contents before sections\n"; |
2487 | ++$warnings; | 2487 | ++$warnings; |
2488 | } | 2488 | } |
2489 | dump_section($file, $section, xml_escape($contents)); | 2489 | dump_section($file, $section, xml_escape($contents)); |
@@ -2509,7 +2509,7 @@ sub process_file($) { | |||
2509 | } | 2509 | } |
2510 | # look for doc_com + <text> + doc_end: | 2510 | # look for doc_com + <text> + doc_end: |
2511 | if ($_ =~ m'\s*\*\s*[a-zA-Z_0-9:\.]+\*/') { | 2511 | if ($_ =~ m'\s*\*\s*[a-zA-Z_0-9:\.]+\*/') { |
2512 | print STDERR "Warning(${file}:$.): suspicious ending line: $_"; | 2512 | print STDERR "${file}:$.: warning: suspicious ending line: $_"; |
2513 | ++$warnings; | 2513 | ++$warnings; |
2514 | } | 2514 | } |
2515 | 2515 | ||
@@ -2539,7 +2539,7 @@ sub process_file($) { | |||
2539 | } | 2539 | } |
2540 | } else { | 2540 | } else { |
2541 | # i dont know - bad line? ignore. | 2541 | # i dont know - bad line? ignore. |
2542 | print STDERR "Warning(${file}:$.): bad line: $_"; | 2542 | print STDERR "${file}:$.: warning: bad line: $_"; |
2543 | ++$warnings; | 2543 | ++$warnings; |
2544 | } | 2544 | } |
2545 | } elsif ($state == 5) { # scanning for split parameters | 2545 | } elsif ($state == 5) { # scanning for split parameters |
@@ -2631,7 +2631,7 @@ sub process_file($) { | |||
2631 | } | 2631 | } |
2632 | } | 2632 | } |
2633 | if ($initial_section_counter == $section_counter) { | 2633 | if ($initial_section_counter == $section_counter) { |
2634 | print STDERR "Warning(${file}): no structured comments found\n"; | 2634 | print STDERR "${file}:1: warning: no structured comments found\n"; |
2635 | if (($function_only == 1) && ($show_not_found == 1)) { | 2635 | if (($function_only == 1) && ($show_not_found == 1)) { |
2636 | print STDERR " Was looking for '$_'.\n" for keys %function_table; | 2636 | print STDERR " Was looking for '$_'.\n" for keys %function_table; |
2637 | } | 2637 | } |