Improve doxygen documentation for the VariantBuilder API

-Add full doxygen for all public API functions
-Improve/consolidate class-level comments

Resolves #322
Merge pull request #372 from broadinstitute/dr_improve_variant_builder_doxygen

Improve doxygen documentation for the VariantBuilder API