Merge pull request #10 from mapleoin/revision-doc

add better revision description/documentation for git
Properly encode XML reserved entities (&,<,>)
replace XML entitties with dollar-curlies