waf: add some documentation of our custom stuff
waf: rename dependency names to use always '-' instead of '_'

This is a little more consistent with dependency names that also act as
options. Having both styles like before was a little confusing. Also, just
use the -- declaration everywhere it was missing and make parse_features
always do the -- check for options.