2025-09-30 13:20:59 +02:00
|
|
|
#!/usr/bin/env -S awk -f
|
|
|
|
|
# a no-nonsense source-to-markdown generator which scans for:
|
|
|
|
|
#
|
|
|
|
|
# /**
|
|
|
|
|
# * # foo
|
|
|
|
|
# *
|
|
|
|
|
# * this is markdown $(cat bar.md)
|
|
|
|
|
# */
|
|
|
|
|
#
|
|
|
|
|
# var foo; // comment with 2 leading spaces is markdown too $(date)
|
|
|
|
|
#
|
|
|
|
|
# easily refactorable to hash-based languages (py/bash/perl/lua e.g.)
|
|
|
|
|
# by changing the regexes
|
|
|
|
|
#
|
|
|
|
|
|
|
|
|
|
BEGIN{
|
2025-10-02 16:56:10 +02:00
|
|
|
# printf README.md until '# library functions'
|
|
|
|
|
system("grep -B9999 '# library functions' README.md")
|
2025-09-30 13:20:59 +02:00
|
|
|
print ""
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/\$(?![\(|"])/ { cmd=$0;
|
|
|
|
|
gsub(/^.*\$\(/,"",cmd);
|
|
|
|
|
gsub(/\).*/,"",cmd);
|
|
|
|
|
cmd | getline stdout; close(cmd);
|
|
|
|
|
sub(/\$\(.*\)/,stdout);
|
|
|
|
|
}
|
|
|
|
|
/\/\*\*/ { doc=1; sub(/^.*\/\*/,""); }
|
|
|
|
|
doc && /\*\// { doc=0;
|
|
|
|
|
sub(/[[:space:]]*\*\/.*/,"");
|
|
|
|
|
sub(/^[[:space:]]*\*[[:space:]]?/,"");
|
|
|
|
|
print
|
|
|
|
|
}
|
|
|
|
|
doc && /^[[:space:]]*\*/ { sub(/^[[:space:]]*\*[[:space:]]?/,"");
|
|
|
|
|
print
|
|
|
|
|
}
|
|
|
|
|
#!doc && /\/\/ / { sub(".*// ","");
|
|
|
|
|
# sub("# ","\n# ");
|
|
|
|
|
# sub("> ","\n> ");
|
|
|
|
|
# print
|
|
|
|
|
# }
|
