changes and xml comments and fixes