Update build documentation and README

Please proofread!
It might be even nicer to add a more explicit control over debug output.. let's think about that separately.