Added documentation comments; switched on XML generation in the project ...

This is the first half of documentation comments.