[BUG #7831] generate widget markup
minor doc fix