some doc change proposals while

writing hk service.
Added Type.h in PoolRawAccess.h, compiler error
when not doing that

datapool/PoolRawAccess.h

@@ -3,6 +3,7 @@
 
 #include <framework/datapool/DataSetIF.h>
 #include <framework/datapool/PoolVariableIF.h>
+#include <framework/globalfunctions/Type.h>
 
 /**
  * This class allows accessing Data Pool variables as raw bytes.
@@ -79,9 +80,8 @@ public:
 	~PoolRawAccess();
 	/**
 	 * \brief	This operation returns a pointer to the entry fetched.
-	 * \details	This means, it does not return a pointer to byte "index", but to the start byte of
-	 * 			array entry "index". Example: If the original data pool array consists of an double
-	 * 			array of size four, getEntry(1) returns &(this->value[8]).
+	 * \details	Return pointer to the buffer containing the raw data
+	 *          Size and number of data can be retrieved by other means.
 	 */
 	uint8_t* getEntry();
 	/**

datapool/PoolVariable.h

@@ -112,8 +112,7 @@ public:
 	 * 					corresponds to.
 	 * \param dataSet	The data set in which the variable shall register itself. If NULL,
 	 * 					the variable is not registered.
-	 * \param setWritable If this flag is set to true, changes in the value attribute can be
-	 * 					written back to the data pool, otherwise not.
+	 * \param setReadWriteMode
 	 */
 	PoolVariable(uint32_t set_id, DataSetIF* dataSet,
 			ReadWriteMode_t setReadWriteMode) :

devicehandlers/DeviceHandlerBase.h

@@ -35,14 +35,14 @@ class StorageManagerIF;
 
 
 /**
- * \brief This is the abstract base class for device handlers.
- *
+ * @brief This is the abstract base class for device handlers.
+ * @details
  * Documentation: Dissertation Baetz p.138,139, p.141-149
  *
  * It features handling of @link DeviceHandlerIF::Mode_t Modes @endlink, communication with
  * physical devices, using the @link DeviceCommunicationIF, and communication with commanding objects.
  *
- * NOTE: RMAP is a legacy standard which is used for FLP.
+ * NOTE: RMAP is a standard which is used for FLP.
  * RMAP communication is not mandatory for projects implementing the FSFW.
  * However, the communication principles are similar to RMAP as there are two write and two send calls involved.
  *
@@ -57,7 +57,7 @@ class StorageManagerIF;
  * Components and drivers can send so called cookies which are used for communication
  * and contain information about the communcation (e.g. slave address for I2C or RMAP structs).
  *
- * \ingroup devices
+ * @ingroup devices
  */
 class DeviceHandlerBase: public DeviceHandlerIF,
 		public HasReturnvaluesIF,
@@ -87,8 +87,9 @@ public:
 
 
 	/**
-		 * This function is the device handler base core component and is called periodically.
-		 * General sequence:
+	 * @brief This function is the device handler base core component and is called periodically.
+	 * @details
+	 * General sequence, showing where abstract virtual functions are called:
 	 * If the State is SEND_WRITE:
 	 *   1. Set the cookie state to COOKIE_UNUSED and read the command queue
 	 *   2. Handles Device State Modes by calling doStateMachine().

objectmanager/ObjectManagerIF.h

@@ -79,11 +79,7 @@ public:
 };
 
 /**
- * Used to retrieve Target Interface Pointers of objects.
- * The object has to implement the SystemObject or SystemObjectIF at the very least,
- * otherwise NULL will be returned.
- * @param id
- * @return NULL or pointer to target interface specified by template object
+ * @brief Documentation can be found in the class method declration.
  */
 template <typename T>
 T* ObjectManagerIF::get( object_id_t id ) {

tmtcservices/AcceptsTelecommandsIF.h

@@ -12,7 +12,7 @@
 class AcceptsTelecommandsIF {
 public:
 	static const uint8_t INTERFACE_ID = CLASS_ID::ACCEPTS_TELECOMMANDS_IF;
-	static const ReturnValue_t ACTIVITY_STARTED = MAKE_RETURN_CODE(1);
+	static const ReturnValue_t ACTIVITY_STARTED = MAKE_RETURN_CODE(1); // is this used anywhere or can it be removed?
 	static const ReturnValue_t INVALID_SUBSERVICE = MAKE_RETURN_CODE(2);
 	static const ReturnValue_t ILLEGAL_APPLICATION_DATA = MAKE_RETURN_CODE(3);
 	static const ReturnValue_t SEND_TM_FAILED = MAKE_RETURN_CODE(4);