[PATCH v3 04/13] devtools: handle multiple drivers in doc check

[Thomas Monjalon]

22/10/2026 19:44, David Marchand:
> -	report=$($selfdir/parse-flow-support.sh $code $doc)
> +	code_support=$($selfdir/parse-flow-support.sh $code)
> +	report=$(
> +		for category in item action; do
> +			section="rte_flow ${category}s]"
> +			code_items=$(echo "$code_support" | sed -n "/$section/,/]/p" |
> +				sed '/]/d' |        # ignore section title
> +				sed 's, *=.*,,' |   # keep only item name
> +				sed '/^$/d' |       # remove empty lines
> +				sort -u)

This parsing is used below.
This is an opportunity for a function.

> +			doc_items=$(sed -n "/$section/,/]/p" "$doc" |
> +				sed '/]/d' |        # ignore section title
> +				sed 's, *=.*,,' |   # keep only item name
> +				sed '/^$/d' |       # remove empty lines
> +				sort -u)
> +			{
> +				# items documented but not in code
> +				items_not_in "$doc_items" "$code_items"
> +				# items in code but not documented in any doc for the code directory
> +				all_doc_items=$(
> +					for drv in $(docs_for_code $code); do
> +						d=$rootdir/doc/guides/nics/features/$drv.ini
> +						sed -n "/$section/,/]/p" "$d" |
> +							sed '/]/d' |        # ignore section title
> +							sed 's, *=.*,,' |   # keep only item name
> +							sed '/^$/d'         # remove empty lines
> +					done | sort -u
> +				)
> +				items_not_in "$code_items" "$all_doc_items"
> +			} | sed "s,^,$category ,"   # prefix with category name
> +		done
> +	)