make-help.awk

#!/usr/bin/awk -f

# Print target name and description of Makefile
# The script expect:
# - 'make -qp' as input
# - '$(info ### description ###)' as one of the target's commands

BEGIN {
    FS=":"
    print "Targets:"
}

/^[a-zA-Z0-9][^$#\/\t=]*:([^=]|$)/ {
    split($1,A,/:/)
    target=A[1]
    while (length($0) > 0) {
        getline
        if ($0 ~ /^[[:space:]]+\$\(info #+/) {
            split($0,B,/#+/)
            printf "  %-20s %s\n", target, B[2]
        }
    }
}