On a few places, it sometimes need to indicate a negation of a parameter, like: !@fshared This pattern happens, for example, at: kernel/futex.c and it is perfectly valid. However, kernel-doc currently transforms it into: !**fshared** This won't do what it would be expected. Fortunately, fixing the script is a simple matter of storing the "!" before "@" and adding it after the bold markup, like: **!fshared**
Showing the changes to scripts (1 of 1 file). Show all
Unified · Split
| @@ -213,6 +213,7 @@ my $type_constant = '\b``([^\`]+)``\b'; · 212 unmodified lines | ||
| 213 | 213 | my $type_constant2 = '\%([-_\w]+)'; |
| 214 | 214 | my $type_func = '(\w+)\(\)'; |
| 215 | 215 | my $type_param = '\@(\w*((\.\w+)|(->\w+))*(\.\.\.)?)'; |
| 216 | +my $type_param_ref = '([\!]?)\@(\w*((\.\w+)|(->\w+))*(\.\.\.)?)'; | |
| 216 | 217 | my $type_fp_param = '\@(\w+)\(\)'; # Special RST handling for func ptr params |
| 217 | 218 | my $type_fp_param2 = '\@(\w+->\S+)\(\)'; # Special RST handling for structs with func ptr params |
| 218 | 219 | my $type_env = '(\$\w+)'; |
| @@ -237,6 +238,7 @@ my @highlights_man = ( · 18 unmodified lines | ||
| 237 | 238 | [$type_typedef, "\\\\fI\$1\\\\fP"], |
| 238 | 239 | [$type_union, "\\\\fI\$1\\\\fP"], |
| 239 | 240 | [$type_param, "\\\\fI\$1\\\\fP"], |
| 241 | + [$type_param_ref, "\\\\fI\$1\$2\\\\fP"], | |
| 240 | 242 | [$type_member, "\\\\fI\$1\$2\$3\\\\fP"], |
| 241 | 243 | [$type_fallback, "\\\\fI\$1\\\\fP"] |
| 242 | 244 | ); |
| @@ -258,7 +260,7 @@ my @highlights_rst = ( · 15 unmodified lines | ||
| 258 | 260 | [$type_union, "\\:c\\:type\\:`\$1 <\$2>`"], |
| 259 | 261 | # in rst this can refer to any type |
| 260 | 262 | [$type_fallback, "\\:c\\:type\\:`\$1`"], |
| 261 | − [$type_param, "**\$1**"] | |
| 263 | + [$type_param_ref, "**\$1\$2**"] | |
| 262 | 264 | ); |
| 263 | 265 | my $blankline_rst = "\n"; |
| 264 | 266 | |