Updated doc and examples

* Updated examples in doxygen
* Added differences beetwen short and long description
* Fixed documentation problems