integrating the examples in the navigation menus added make tests, updated

* doc/*: integrating the examples in the navigation menus
* doc/examples/*: added make tests, updated the navigation,
  added a new test, cleanups, updates.
Daniel
38 files changed