Restructure documentation (in progress)

etc/doxygen/pages/0.Overview.dox

+/**
+\page RobotAPI RobotAPI Overview
+
+The ArmarX project RobotAPI is based on the ArmarXCore Framework.
+
+\par Components
+RobotAPI provides the following components
+- armarx::ComponentX: ComponentX description
+
+Each component can provide several properties which are set on command line or via a configuration file.
+See \ref componentproperties for an overview of properties.
+
+\par Applications
+- armarx::ApplicationY: Description of ApplicationY
+
+\par interface Interface Documentation
+Documentation of interfaces available in ArmarXCore is available on the \ref slicedocumentation "Slice Documentation" page.
+*/

etc/doxygen/pages/1.Installation.dox

+/**
+\addtogroup Installation
+
+\defgroup RobotAPI-Installation RobotAPI Installation
+\ingroup RobotAPI
+\ingroup Installation
+
+RobotAPI depends on ArmarXCore and ArmarXGui which must be installed.
+*/

etc/doxygen/pages/2.Tutorials.dox

+/**
+\addtogroup Tutorials
+
+\defgroup RobotAPI-Tutorials RobotAPI Tutorials
+\ingroup RobotAPI
+\ingroup Tutorials
+
+...
+*/

etc/doxygen/pages/RobotAPI-API-4-remoterobot.dox → etc/doxygen/pages/3.HowTos.RemoteRobot.dox

 /**
-\defgroup remoterobot Robot State and Remote Robot
-\ingroup api-robotapi
+\page RobotAPI-HowTos-RemoteRobot Robot State and Remote Robot
+\ingroup RobotAPI-HowTos
 
 \section remoterobot-start Starting a RobotStateComponent
 

etc/doxygen/pages/3.howto → etc/doxygen/pages/3.HowTos.dox

 /**
-\page robotapi-howtos HowTos
+\addtogroup HowTos
 
-\subpage robotapi-howtos-eigen-from-pose
+\defgroup RobotAPI-HowTos RobotAPI HowTos
+\ingroup RobotAPI
+\ingroup HowTos
 
-\page robotapi-howtos-eigen-from-pose How to convert a Variant pose into an Eigen Matrix
+\page RobotAPI-HowTos-Eigen-From-Pose How to convert a Variant pose into an Eigen Matrix
+\ingroup RobotAPI-HowTos
 
 \code
 #include <RobotAPI/libraries/robotstate/remote/ArmarPose.h>

etc/doxygen/pages/4.FAQ.dox

+/**
+\addtogroup FAQ
+
+\defgroup RobotAPI-FAQ RobotAPI FAQ
+\ingroup RobotAPI
+\ingroup FAQ
+
+...
+*/

etc/doxygen/pages/5.Components.dox

+/**
+\addtogroup Components
+
+\defgroup RobotAPI-Components RobotAPI Components
+\ingroup RobotAPI
+\ingroup Components
+
+...
+*/

etc/doxygen/pages/API-RobotAPI.dox

-/**
-
-  \defgroup api-robotapi RobotAPI
-
-*/

etc/doxygen/pages/RobotAPI-API-1-overview.dox

- /*!
- * \defgroup robotapi-overview Overview
- * \ingroup api-robotapi
- *
- * The ArmarX project RobotAPI is based on the ArmarXCore Framework.
- * 
- * \par Components
- * RobotAPI provides the following components
- * - armarx::ComponentX: ComponentX description
- * 
- * Each component can provide several properties which are set on command line or via a configuration file.
- * See \ref componentproperties for an overview of properties.
- * 
- * \par Applications
- * - armarx::ApplicationY: Description of ApplicationY
- *
- * \par interface Interface Documentation
- * Documentation of interfaces available in ArmarXCore is available on the \ref slicedocumentation "Slice Documentation" page.
- */

etc/doxygen/pages/RobotAPI-API-3-states.dox

-/**
-
-  \defgroup robotapi-states States
-  \ingroup api-robotapi
-
-*/

etc/doxygen/pages/mainpage.dox

-/*! \mainpage
- 
-- \subpage robotapi-overview
-- \subpage remoterobot
-
- */
+/**
+\mainpage
+\ref RobotAPI "RobotAPI Overview"
+*/

etc/doxygen/pages/slicedocumentation.dox

-/**
- \page robotapi-slicedocumentation Slice Documentation
- \ingroup api-robotapi
- <a href="slice/index.html"> Slice Documentation </a>
-*/