diff --git a/Doxyfile b/Doxyfile index 912abc1..23f3e43 100644 --- a/Doxyfile +++ b/Doxyfile @@ -575,7 +575,7 @@ # to standard output. If FILTER_PATTERNS is specified, this tag will be # ignored. -INPUT_FILTER = +INPUT_FILTER = "awk -f scripts/doxy_filter.awk" # The FILTER_PATTERNS tag can be used to specify filters on a per file pattern # basis. Doxygen will compare the file name with each pattern and apply the diff --git a/include/command.h b/include/command.h index 0be7a69..e221546 100644 --- a/include/command.h +++ b/include/command.h @@ -89,6 +89,15 @@ #define BAREBOX_CMD_END \ }; +#define BAREBOX_CMD_HELP_START(_name) \ +static const __maybe_unused char cmd_##_name##_help[] = + +#define BAREBOX_CMD_HELP_USAGE(_name) "Usage: " _name +#define BAREBOX_CMD_HELP_SHORT(_text) _text +#define BAREBOX_CMD_HELP_OPT(_opt, _desc) _opt "\t" _desc +#define BAREBOX_CMD_HELP_TEXT(_text) +#define BAREBOX_CMD_HELP_END ; + #ifdef CONFIG_LONGHELP #define BAREBOX_CMD_HELP(text) .help = text, #else diff --git a/scripts/doxy_filter.awk b/scripts/doxy_filter.awk new file mode 100644 index 0000000..5ec0406 --- /dev/null +++ b/scripts/doxy_filter.awk @@ -0,0 +1,103 @@ +#!/usr/bin/awk + +/BAREBOX_CMD_HELP_START[[:space:]]*\((.*)\)/ { + + this_opt = 0; + my_usage = ""; + my_short = ""; + my_cmd = gensub("BAREBOX_CMD_HELP_START[[:space:]]*\\((.*)\\)", "\\1", "g"); + this_text = 0; + delete(my_text); + delete(my_opts); + next; +} + +/BAREBOX_CMD_HELP_USAGE[[:space:]]*\((.*)\)/ { + + $0 = gensub("<", "\\<", "g"); + $0 = gensub(">", "\\>", "g"); + $0 = gensub("BAREBOX_CMD_HELP_USAGE[[:space:]]*\\((.*)\\)", "\\1", "g"); + $0 = gensub("\\\\n", "", "g"); + my_usage = gensub("\"", "", "g"); + next; + +} + +/BAREBOX_CMD_HELP_SHORT[[:space:]]*\((.*)\)/ { + + $0 = gensub("<", "\\<", "g"); + $0 = gensub(">", "\\>", "g"); + $0 = gensub("BAREBOX_CMD_HELP_SHORT[[:space:]]*\\((.*)\\)", "\\1", "g"); + $0 = gensub("\\\\n", "", "g"); + my_short = gensub("\"", "", "g"); + next; + +} + +/BAREBOX_CMD_HELP_OPT[[:space:]]*\([[:space:]]*(.*)[[:space:]]*,[[:space:]]*(.*)[[:space:]]*\)/ { + + $0 = gensub("<", "\\<", "g"); + $0 = gensub(">", "\\>", "g"); + $0 = gensub("@", "\\\\@", "g"); + $0 = gensub("BAREBOX_CMD_HELP_OPT[[:space:]]*\\([[:space:]]*\"*(.*)\"[[:space:]]*,[[:space:]]*\"(.*)\"[[:space:]]*\\)", \ + " \\1 \\ \\ \\  \\2 ", "g"); + $0 = gensub("\\\\n", "", "g"); + my_opts[this_opt] = gensub("\"", "", "g"); + this_opt ++; + next; +} + +/BAREBOX_CMD_HELP_TEXT[[:space:]]*\((.*)\)/ { + + $0 = gensub("<", "\\<", "g"); + $0 = gensub(">", "\\>", "g"); + $0 = gensub("BAREBOX_CMD_HELP_TEXT[[:space:]]*\\((.*)\\)", "\\1", "g"); + $0 = gensub("\\\\n", "
", "g"); + my_text[this_text] = gensub("\"", "", "g"); + this_text ++; + next; +} + +/BAREBOX_CMD_HELP_END/ { + + printf "/**\n"; + printf " * @page " my_cmd "_command " my_cmd "\n"; + printf " *\n"; + printf " * \\par Usage:\n"; + printf " * " my_usage "\n"; + printf " *\n"; + + if (this_opt != 0) { + printf " * \\par Options:\n"; + printf " *\n"; + printf " * \n"; + n = asorti(my_opts, my_opts_sorted); + for (i=1; i<=n; i++) { + printf " * " my_opts[my_opts_sorted[i]] "\n"; + } + printf " *
\n"; + printf " *\n"; + } + + printf " * " my_short "\n"; + printf " *\n"; + + n = asorti(my_text, my_text_sorted); + if (n > 0) { + for (i=1; i<=n; i++) { + printf " * " my_text[my_text_sorted[i]] "\n"; + } + printf " *\n"; + } + + printf " */\n"; + + next; +} + +/^.*$/ { + + print $0; + +} +