Added HomogeneousMagneticMaterial class to represent magnetic materials for polarized neutron scattering

Insert new header comment block, remove old one, manually improve file comments (defines / implements), change brief function description to doxygen format, remove some outcommented code

Refined calculation of specular reflection/transmission in alternative convention: calculations are now numerically stable.