2024-02-10 17:12:08 +00:00
|
|
|
#!/usr/bin/env bash
|
2021-10-02 19:22:59 +00:00
|
|
|
#
|
|
|
|
# Doxygen input filter, which tries to fix documentation of callback
|
|
|
|
# method macros.
|
|
|
|
#
|
|
|
|
# This is used for .h files.
|
|
|
|
#
|
|
|
|
|
2021-10-03 11:05:17 +00:00
|
|
|
FILENAME="$1"
|
|
|
|
|
|
|
|
# Add \ingroup commands for the file, for each \addgroup in it
|
|
|
|
BASEFILE=$(echo "$FILENAME" | sed -e 's@.*src/pipewire/@pipewire/@; s@.*spa/include/spa/@spa/@; s@.*src/test/@test/@;')
|
|
|
|
|
2024-01-28 10:44:26 +00:00
|
|
|
printf "/** \\\\file\n\`%s\`\n" "$BASEFILE"
|
2021-10-03 21:02:11 +00:00
|
|
|
sed -n -e '/.*\\addtogroup [a-zA-Z0-9_].*/ { s/.*addtogroup /\\ingroup /; p; }' < "$FILENAME" | sort | uniq
|
2021-10-03 11:05:17 +00:00
|
|
|
echo " */"
|
|
|
|
|
2021-10-02 19:22:59 +00:00
|
|
|
# Add \sa and \copydoc for (struct *methods) callback macros.
|
|
|
|
# #define pw_core_add_listener(...) pw_core_method(c,add_listener,...) -> add \sa and \copydoc
|
|
|
|
# #define spa_system_read(...) spa_system_method_r(c,read,...) -> add \sa and \copydoc
|
2021-10-06 17:55:04 +00:00
|
|
|
#
|
|
|
|
# Also:
|
|
|
|
# Ensure all macros are included (also those defined inside a struct),
|
|
|
|
# by adding /** \ingroup XXX */ before each definition.
|
|
|
|
# Also ensure all opaque structs get included.
|
2024-01-28 10:44:26 +00:00
|
|
|
# Strip SPA_FORMAT_ARG_FUNC(1) etc. things that confuse doxygen
|
2021-10-02 19:22:59 +00:00
|
|
|
sed -e 's@^\(#define .*[[:space:]]\)\(.*_method\)\((.,[[:space:]]*\)\([a-z_]\+\)\(.*)[[:space:]]*\)$@\1\2\3\4\5 /**< \\copydoc \2s.\4\n\n\\sa \2s.\4 */@;' \
|
|
|
|
-e 's@^\(#define .*[[:space:]]\)\(.*_method\)\(_[rvs](.,[[:space:]]*\)\([a-z_]\+\)\(.*)[[:space:]]*\)$@\1\2\3\4\5 /**< \\copydoc \2s.\4\n\n\\sa \2s.\4 */@;' \
|
2021-10-06 17:55:04 +00:00
|
|
|
-e '/\\addtogroup/ { h; s@.*\\addtogroup \(.*\).*@/** \\ingroup \1 */@; x; }' \
|
|
|
|
-e '/#define \(PW\|SPA\)_[A-Z].*[^\\][ ]*$/ { x; p; x; }' \
|
|
|
|
-e 's@^\([ ]*struct \)\([a-zA-Z0-9_]*\)\(;.*\)$@/** \\struct \2 */\n\1\2\3@;' \
|
2024-01-28 10:44:26 +00:00
|
|
|
-e 's@^[ ]*SPA_FORMAT_ARG_FUNC([0-9, ]*)@@;' \
|
|
|
|
-e 's@[ ]*SPA_PRINTF_FUNC([0-9, ]*);@;@;' \
|
|
|
|
-e 's@^[ ]*SPA_WARN_UNUSED_RESULT@ @;' \
|
|
|
|
-e 's@ SPA_SENTINEL;@;@;' \
|
|
|
|
-e 's@ SPA_UNUSED,@,@;' \
|
2021-10-03 11:05:17 +00:00
|
|
|
< "$FILENAME"
|