some StyleCop violations fixed

Large number of StyleCop violations are still outstanding.  This commit
mostly fixes spacings after curly brackets etc.
Documentation added to conform to StyleCop

Mostly empty Xml documentation tags have been added.  Still need to
actually write the documentation.
Some further StyleCop documentation