fix namespace problem and update a transformation that seems to be forgotten yesterday ...

general cleanup. - add more comments - add the license - make the code better readable

the html files used for chm compiling differ in detail from our normal manual pages. The target format is reflected by the $is-chm variable which is used to <if> in and out the interesting parts. Further add some more utility snippets.