Revert "Revert "Merge pull request #565 from Terrycloth/clarifying-text-in-user-manual""

This reverts commit 59dc503f25fe5d29fb5b7ce0a88038f0fe0691c7.
usermanual: add missing DOCTYPE preambles to xml files