History

kernel-doc/rst: add support for struct/union/enum member references

Link "&foo->bar", "&foo->bar()", "&foo.bar", and "&foo.bar()" to the struct/union/enum foo definition. The members themselves do not currently have anchors to link to, but this is better than nothing, and promotes a universal notation.

Jani Nikula committed 10 years ago

Commit f3341dc1 parent 47ae7ae1 file · +5 −0Browse files

Showing the changes to scripts/kernel-doc (1 of 1 file). Show all

Unified · Split

scripts/kernel-doc+5−0
@@ -214,6 +214,8 @@ my $type_enum_full = '\&(enum)\s*([_\w]+)'; · 213 unmodified lines
214my $type_struct_full = '\&(struct)\s*([_\w]+)';214my $type_struct_full = '\&(struct)\s*([_\w]+)';
215my $type_typedef_full = '\&(typedef)\s*([_\w]+)';215my $type_typedef_full = '\&(typedef)\s*([_\w]+)';
216my $type_union_full = '\&(union)\s*([_\w]+)';216my $type_union_full = '\&(union)\s*([_\w]+)';
217my $type_member = '\&([_\w]+)((\.|->)[_\w]+)';
218my $type_member_func = $type_member . '\(\)';
217 219
218# Output conversion substitutions.220# Output conversion substitutions.
219# One for each output format221# One for each output format
@@ -282,6 +284,9 @@ my $blankline_text = ""; · 62 unmodified lines
282# rst-mode284# rst-mode
283my @highlights_rst = (285my @highlights_rst = (
284 [$type_constant, "``\$1``"],286 [$type_constant, "``\$1``"],
287 # Note: need to escape () to avoid func matching later
288 [$type_member_func, "\\:c\\:type\\:`\$1\$2\\\\(\\\\) <\$1>`"],
289 [$type_member, "\\:c\\:type\\:`\$1\$2 <\$1>`"],
285 [$type_func, "\\:c\\:func\\:`\$1()`"],290 [$type_func, "\\:c\\:func\\:`\$1()`"],
286 [$type_struct_full, "\\:c\\:type\\:`\$1 \$2 <\$2>`"],291 [$type_struct_full, "\\:c\\:type\\:`\$1 \$2 <\$2>`"],
287 [$type_enum_full, "\\:c\\:type\\:`\$1 \$2 <\$2>`"],292 [$type_enum_full, "\\:c\\:type\\:`\$1 \$2 <\$2>`"],