We need to extend the xml interface and op-mode definitions to have a docs tag like:
<docs>
<text> foo bar</text>
<hint class="danger">if you do this you must know that....</hint>
<hint class="info">foo bar</hint>
<codeexample>set system ...</codeexample>
</docs>