added documentation for parser and higher level packages

include/ur_rtde_driver/comm/package.h

@@ -33,10 +33,19 @@ namespace ur_driver
 {
 namespace comm
 {
+/*!
+ * \brief The URPackage a parent class. From that two implementations are inherited,
+ * one for the primary, one for the rtde interface (primary_interface::primaryPackage;
+ * rtde_interface::rtdePackage). The URPackage makes use of the template HeaderT.
+ */
 template <typename HeaderT>
 class URPackage
 {
 public:
+  /*!
+   * \brief Creates a new URPackage object.
+   */
+
   URPackage();
   virtual ~URPackage();
 

include/ur_rtde_driver/comm/parser.h

@@ -25,10 +25,22 @@ namespace ur_driver
 {
 namespace comm
 {
+/*!
+ * \brief The parser is a general paser. The namsepace rtde_interface and primary_interface both
+ * iclude classes which inherit from it (rtdeParser and primaryParser).
+ * The parser functionality also embodies a factory function taking in an uint8.
+ */
 template <typename HeaderT>
 class Parser
+
 {
 public:
+  /*!
+   * \brief declares the parse function.
+   *
+   * \param bp instant of class binaryParser
+   * \param results unique pointer
+   */
   virtual bool parse(BinParser& bp, std::vector<std::unique_ptr<URPackage<HeaderT>>>& results) = 0;
   using _header_type = HeaderT;
 

include/ur_rtde_driver/primary/primary_package.h

@@ -35,9 +35,17 @@ namespace ur_driver
 {
 namespace primary_interface
 {
+/*!
+ * \brief The PrimaryPackage is solely an abstraction level.
+ * It inherits form the URPackage and is also a parent class for primary_interface::RobotMessage,
+ * primary_interface::RobotState
+ */
 class PrimaryPackage : public comm::URPackage<PackageHeader>
 {
 public:
+  /*!
+   * \brief Creates a new PrimaryPackage object.
+   */
   PrimaryPackage() = default;
   virtual ~PrimaryPackage() = default;
 

include/ur_rtde_driver/rtde/rtde_package.h

@@ -35,9 +35,16 @@ namespace ur_driver
 {
 namespace rtde_interface
 {
+/*!
+ * brief The RTDEPackage is solely an abstraction level.
+ * It inherits form the URPackage and is also a parent class for rtde_interface::TextMessage.
+ */
 class RTDEPackage : public comm::URPackage<PackageHeader>
 {
 public:
+  /*!
+   * \brief Creates a new RTDEPackage object.
+   */
   RTDEPackage() = default;
   virtual ~RTDEPackage() = default;
 };