michaelh/zephyr
1
0
Fork 0
Code Releases Activity

Bluetooth: host: Fix doxygen in addr header

Browse source 
Fix doxygen in addr.h file, missing /** needed for doxygen,
and placing the brief on the first line of the comment consistenly.

Signed-off-by: Joakim Andersson <joakim.andersson@nordicsemi.no>
This commit is contained in:
Joakim Andersson 2021-01-19 15:38:52 +01:00 • committed by Anas Nashif
commit 27bc7ad3a7
1 changed files with 37 additions and 43 deletions
Download patch file Download diff file Expand all files Collapse all files

26
include/bluetooth/addr.h
View file

@ -41,14 +41,14 @@ typedef struct {
bt_addr_t a;
} bt_addr_le_t;
/* Bluetooth device "any" address, not a valid address */
/** Bluetooth device "any" address, not a valid address */
#define BT_ADDR_ANY ((bt_addr_t[]) { { { 0, 0, 0, 0, 0, 0 } } })
/* Bluetooth device "none" address, not a valid address */
/** Bluetooth device "none" address, not a valid address */
#define BT_ADDR_NONE ((bt_addr_t[]) { { \
{ 0xff, 0xff, 0xff, 0xff, 0xff, 0xff } } })
/* Bluetooth LE device "any" address, not a valid address */
/** Bluetooth LE device "any" address, not a valid address */
#define BT_ADDR_LE_ANY ((bt_addr_le_t[]) { { 0, { { 0, 0, 0, 0, 0, 0 } } } })
/* Bluetooth LE device "none" address, not a valid address */
/** Bluetooth LE device "none" address, not a valid address */
#define BT_ADDR_LE_NONE ((bt_addr_le_t[]) { { 0, \
{ { 0xff, 0xff, 0xff, 0xff, 0xff, 0xff } } } })
@ -151,8 +151,7 @@ static inline bool bt_addr_le_is_identity(const bt_addr_le_t *addr)
return BT_ADDR_IS_STATIC(&addr->a);
}
/**
* @def BT_ADDR_STR_LEN
/** @def BT_ADDR_STR_LEN
*
* @brief Recommended length of user string buffer for Bluetooth address
*
@ -162,8 +161,7 @@ static inline bool bt_addr_le_is_identity(const bt_addr_le_t *addr)
*/
#define BT_ADDR_STR_LEN 18
/**
* @def BT_ADDR_LE_STR_LEN
/** @def BT_ADDR_LE_STR_LEN
*
* @brief Recommended length of user string buffer for Bluetooth LE address
*
@ -173,8 +171,7 @@ static inline bool bt_addr_le_is_identity(const bt_addr_le_t *addr)
*/
#define BT_ADDR_LE_STR_LEN 30
/**
* @brief Converts binary Bluetooth address to string.
/** @brief Converts binary Bluetooth address to string.
*
* @param addr Address of buffer containing binary Bluetooth address.
* @param str Address of user buffer with enough room to store formatted
@ -191,8 +188,7 @@ static inline int bt_addr_to_str(const bt_addr_t *addr, char *str, size_t len)
addr->val[2], addr->val[1], addr->val[0]);
}
/**
* @brief Converts binary LE Bluetooth address to string.
/** @brief Converts binary LE Bluetooth address to string.
*
* @param addr Address of buffer containing binary LE Bluetooth address.
* @param str Address of user buffer with enough room to store
@ -230,8 +226,7 @@ static inline int bt_addr_le_to_str(const bt_addr_le_t *addr, char *str,
addr->a.val[2], addr->a.val[1], addr->a.val[0], type);
}
/**
* @brief Convert Bluetooth address from string to binary.
/** @brief Convert Bluetooth address from string to binary.
*
* @param[in] str The string representation of a Bluetooth address.
* @param[out] addr Address of buffer to store the Bluetooth address
@ -240,8 +235,7 @@ static inline int bt_addr_le_to_str(const bt_addr_le_t *addr, char *str,
*/
int bt_addr_from_str(const char *str, bt_addr_t *addr);
/**
* @brief Convert LE Bluetooth address from string to binary.
/** @brief Convert LE Bluetooth address from string to binary.
*
* @param[in] str The string representation of an LE Bluetooth address.
* @param[in] type The string representation of the LE Bluetooth address