{#3516}: document XML lock icon (and clean up xml documentation generally, and note the UTF-8 rule explicitly

git-svn-id: http://gforge.hl7.org/svn/fhir/trunk/build@3246 2f0db536-2c49-4257-a3fa-e771ed206c19