add Doxygen comment.

I add your very helpful example as doxygen comment.

Best regards

Olaf