A majority of functionality presented by bladeRF-flash is now duplicated
in the bladeRF-cli utility.
Now that the bladeRF USB interfaces have stabilized more and the
instructions for bootloader-based recovery are available, this program
is generally no longer needed. As such, it is being removed to avoid
future neglect and bitrot.
Adds a new include, doc/cmd_help.h. This is generated by
pandoc from doc/interactive-help.md. It's ugly, but that's
why it's programatically generated.
CMake will either generate a new cmd_help.{h,man} or copy them
in from cmd_help.{h,man}.in if pandoc isn't available.
Update cmd.c to use all of these new #defines. (It looks
cleaner now...!)
Remove the old get-interactive-commands.bash, which is no longer
a part of the build process. pandoc also generates a man page
snippet for insertion by help2man.
Also some editorial/spelling clarifications/corrections, and
adjustments for formatting.
Because of how man pages format things, it's easiest (maybe) to
use tabs and whatnot to designate indentation, etc, in the help
output.
This unfortunately makes some of the help output look relatively
crappy, but at least it is more consistent! :-)
Additional fixes/tweaks will ensue.
A little more lightweight than the doxygen approach,
and keeps the documentation harmonized with --help.
h/t to A. Maitland Bottoms for pointing me to this.