Add documentation (doc lines) to variant reporting components

In order for the variant reporting lister to be really helpful, we need to add doc lines to modules and their parameters, as well as vcf_id and vcf_description to filters. The wording of the documentation is up for debate. Suggestions welcome!

This PR also fixes one minor bug and removes an unnecessary parameter.
In `Genome/VariantReporting/Suite/Joinx/HomoPolymer/Adaptor.pm` the word is written "homopolymer" but here it's "homo-polymers".  (It's also strange that this is named `...::HomoPolymer::HomopolymerFilter` with different choice of "P"s.)