Generators: add debug statements to FixHepMC
Adds a few debug statements to FixHepMC. It took me way too long to figure out what was going on, so I took the liberty to also rename a few variables, restructure slightly and to add some more explanatory comments to make this more readable for the future.
cc @ewelina