minor comments and doc updates + force encoding of file to UTF8

git-svn-id: https://svn.forgerock.org/openicf/trunk@6709 05b3e5af-d696-470f-a577-fd7599f74d3c