Mirrors/knx
1
0
Fork 0
mirror of https://github.com/thelsing/knx.git synced 2025-10-26 10:26:25 +01:00
Code Issues Packages Projects Releases Wiki Activity

remove @brief and enable JAVADOC_AUTOBRIEF in doxygen

Browse Source
This commit is contained in:
Thomas Kunze 2019-05-27 20:08:04 +02:00
parent 9cbd9a0760
commit 88f5c4214a
5 changed files with 27 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
doc/Doxyfile
View File

@ -187,7 +187,7 @@ SHORT_NAMES = NO
# description.)
# The default value is: NO.
JAVADOC_AUTOBRIEF = NO
JAVADOC_AUTOBRIEF = YES
# If the QT_AUTOBRIEF tag is set to YES then doxygen will interpret the first
# line (until the first dot) of a Qt-style comment as the brief description. If

12
src/knx/address_table_object.h
View File

@ -2,7 +2,7 @@
#include "table_object.h"
/**
* @brief This class represents the group address table. It provides a mapping between tranport layer
* This class represents the group address table. It provides a mapping between tranport layer
* service access points (TSAP) and group addresses. The TSAP can be imagined as an index to the array
* of group adresses.
*
@ -13,7 +13,7 @@ class AddressTableObject: public TableObject
{
public:
/**
* @brief The contructor.
* The contructor.
* @param platform This parameter is only passed to the custructor of TableObject an not used by this class.
*/
AddressTableObject(Platform& platform);
@ -21,11 +21,11 @@ public:
uint8_t *save(uint8_t *buffer);
uint8_t *restore(uint8_t *buffer);
/**
* @brief returns the number of group addresses of the object.
* returns the number of group addresses of the object.
*/
uint16_t entryCount();
/**
* @brief Get the group address mapped to a TSAP.
* Get the group address mapped to a TSAP.
*
* @param tsap The TSAP of which to get the group address for.
*
@ -33,7 +33,7 @@ public:
*/
uint16_t getGroupAddress(uint16_t tsap);
/**
* @brief Get the TSAP mapped to a group address.
* Get the TSAP mapped to a group address.
*
* @param groupAddress the group address of whicht to get the TSAP for.
*
@ -41,7 +41,7 @@ public:
*/
uint16_t getTsap(uint16_t groupAddress);
/**
* @brief Check if the address table contains a group address.
* Check if the address table contains a group address.
*
* @param groupAddress the group address to check
*

16
src/knx/interface_object.h
View File

@ -51,17 +51,17 @@ enum ObjectType
};
/**
* @brief This class represents and interface object. See section 4 of @cite knx:3/4/1.
* This class represents and interface object. See section 4 of @cite knx:3/4/1.
*/
class InterfaceObject: public SaveRestore
{
public:
/**
* @brief Destructor
* Destructor
*/
virtual ~InterfaceObject() {}
/**
* @brief Read a property of the interface object. See section 4.8.4.2 of @cite knx:3/4/1.
* Read a property of the interface object. See section 4.8.4.2 of @cite knx:3/4/1.
*
* @param id id of the property to read
*
@ -74,7 +74,7 @@ public:
*/
virtual void readProperty(PropertyID id, uint32_t start, uint32_t& count, uint8_t* data);
/**
* @brief Write property of the interface object. If the interface object does not have the property this
* Write property of the interface object. If the interface object does not have the property this
* method does nothing. See section 4.8.4.4 of @cite knx:3/4/1.
*
* @param id id of the property to write
@ -87,7 +87,7 @@ public:
*/
virtual void writeProperty(PropertyID id, uint8_t start, uint8_t* data, uint8_t count);
/**
* @brief Gets the size of of property in bytes.
* Gets the size of of property in bytes.
*
* @param id of the property to get the size of
*
@ -95,7 +95,7 @@ public:
*/
virtual uint8_t propertySize(PropertyID id);
/**
* @brief Read the Description of a property of the interface object. The output parameters are only valid if nuberOfElements is not zero.
* Read the Description of a property of the interface object. The output parameters are only valid if nuberOfElements is not zero.
*
* @param[in,out] propertyId The id of the property of which to read the description of. If this parameter is not zero
* propertyIndex paramter is ignored as input and the corrrect index of the property is written to it. If this
@ -116,11 +116,11 @@ public:
void readPropertyDescription(uint8_t& propertyId, uint8_t& propertyIndex, bool& writeEnable, uint8_t& type, uint16_t& numberOfElements, uint8_t& access);
protected:
/**
* @brief Returns the number of properties the interface object has.
* Returns the number of properties the interface object has.
*/
virtual uint8_t propertyCount();
/**
* @brief Returns a pointer to the first PropertyDescription of the interface object.
* Returns a pointer to the first PropertyDescription of the interface object.
* This is used by readPropertyDescription() together with propertyCount().
*/
virtual PropertyDescription* propertyDescriptions();

6
src/knx/save_restore.h
View File

@ -2,13 +2,13 @@
#include <stdint.h>
/**
* @brief Interface for classes that can save and restore data from a buffer.
* Interface for classes that can save and restore data from a buffer.
*/
class SaveRestore
{
public:
/**
* @brief This method is called when the object should save its state to the buffer.
* This method is called when the object should save its state to the buffer.
*
* @param buffer The buffer the object should save its state to.
*
@ -17,7 +17,7 @@ public:
*/
virtual uint8_t* save(uint8_t* buffer) = 0;
/**
* @brief This method is called when the object should restore its state from the buffer.
* This method is called when the object should restore its state from the buffer.
*
* @param buffer The buffer the object should restore its state from.
*

18
src/knx/table_object.h
View File

@ -4,13 +4,13 @@
#include "platform.h"
/**
* @brief This class provides common functionality for interface objects that are configured by ETS with MemorWrite.
* This class provides common functionality for interface objects that are configured by ETS with MemorWrite.
*/
class TableObject: public InterfaceObject
{
public:
/**
* @brief The constuctor.
* The constuctor.
* @param platform the Platform on which the software runs. The class uses the memory management features of Platform.
*/
TableObject(Platform& platform);
@ -18,34 +18,34 @@ public:
virtual void writeProperty(PropertyID id, uint8_t start, uint8_t* data, uint8_t count);
virtual uint8_t propertySize(PropertyID id);
/**
* @brief The destructor.
* The destructor.
*/
virtual ~TableObject();
/**
* @brief This method returns the ::LoadState of the interface object.
* This method returns the ::LoadState of the interface object.
*/
LoadState loadState();
virtual uint8_t* save(uint8_t* buffer);
virtual uint8_t* restore(uint8_t* buffer);
protected:
/**
* @brief This method is called before the interface object enters a new ::Loadstate.
* This method is called before the interface object enters a new ::Loadstate.
* If there is a error changing the state newState should be set to ::LS_ERROR and errorCode()
* to a reason for the failure.
*/
virtual void beforeStateChange(LoadState& newState) {}
/**
* @brief returns the internal data of the interface object. This pointer belongs to the TableObject class and
* returns the internal data of the interface object. This pointer belongs to the TableObject class and
* must not be freed.
*/
uint8_t* data();
/**
* @brief returns the size of the internal data of the interface object int byte.
* returns the size of the internal data of the interface object int byte.
*/
uint32_t size();
/**
* @brief Set the reason for a state change failure.
* Set the reason for a state change failure.
*/
void errorCode(ErrorCode errorCode);
@ -59,7 +59,7 @@ protected:
void loadEventError(uint8_t* data);
void additionalLoadControls(uint8_t* data);
/**
* @brief set the ::LoadState of the interface object.
* set the ::LoadState of the interface object.
*
* Calls beforeStateChange().
*