[documentation] fix a few doxygen warnings

This commit is contained in:
akallabeth
2026-01-25 09:38:33 +01:00
parent eb83f339b4
commit 7d943a9c21
5 changed files with 22 additions and 18 deletions

View File

@@ -28,7 +28,8 @@ extern "C"
{
#endif
/** @enum Hotplug event types.
/** @enum RdpdrHotplugEventType
* @brief Hotplug event types.
*
* @since version 3.16.0
*/
@@ -75,7 +76,8 @@ extern "C"
*/
typedef UINT (*pcRdpdrHotplugDevice)(RdpdrClientContext* context, RdpdrHotplugEventType type);
/** @struct rdpdr channel client context
/** @struct s_rdpdr_client_context
* @brief rdpdr channel client context
*
* @since version 3.16.0
*/

View File

@@ -738,9 +738,12 @@ extern "C"
FREERDP_API const char* freerdp_encryption_methods_string(UINT32 EncryptionLevel, char* buffer,
size_t size);
/** \brief returns a string representation of \b RNS_UD_XXBPP_SUPPORT values
/** @brief returns a string representation of \b RNS_UD_XXBPP_SUPPORT values
* @param mask A bitmask of supported color dephts \b RNS_UD_*
* @param buffer A pointer to a buffer of \b size bytes
* @param size The size of the buffer in bytes
*
* return A string reprenentation of the bitmask.
* @return A string reprenentation of the bitmask.
*/
FREERDP_API const char* freerdp_supported_color_depths_string(UINT16 mask, char* buffer,
size_t size);
@@ -748,7 +751,7 @@ extern "C"
/** \brief return the configuration directory for the library
* @return The current configuration path or \b NULL
* @since version 3.6.0
* @note Since 3.17.1 this is a wrapper for \ref freerdp_GetConfigFilePath(FALSE, "")
* @note Since 3.17.1 this is a wrapper for \b freerdp_GetConfigFilePath(FALSE, "")
*/
WINPR_ATTR_MALLOC(free, 1)
FREERDP_API char* freerdp_settings_get_config_path(void);

View File

@@ -36,7 +36,8 @@ extern "C"
{
#endif
/** @enum Expected wellknown fields to be supported
/** @enum AAD_WELLKNOWN_VALUES
* @brief Expected wellknown fields to be supported
* @since version 3.10.0
*/
typedef enum

View File

@@ -47,19 +47,16 @@ extern "C"
/** @struct wObject
* @brief This struct contains function pointer to initialize/free objects
*
* @var fnObjectNew A new function that creates a clone of the input
* @var fnObjectInit A function initializing an object, but not allocating it
* @var fnObjectUninit A function to deinitialize an object, but not free it
* @var fnObjectFree A function freeing an object
* @var fnObjectEquals A function to compare two objects
*/
typedef struct
{
OBJECT_NEW_FN fnObjectNew;
OBJECT_INIT_FN fnObjectInit;
OBJECT_UNINIT_FN fnObjectUninit;
OBJECT_FREE_FN fnObjectFree;
OBJECT_EQUALS_FN fnObjectEquals;
OBJECT_NEW_FN fnObjectNew; /**< A new function that creates a clone of the input */
OBJECT_INIT_FN
fnObjectInit; /**< A function initializing an object, but not allocating it */
OBJECT_UNINIT_FN
fnObjectUninit; /**< A function to deinitialize an object, but not free it */
OBJECT_FREE_FN fnObjectFree; /**< A function freeing an object */
OBJECT_EQUALS_FN fnObjectEquals; /**< A function to compare two objects */
} wObject;
/* utility function with compatible arguments for string data */

View File

@@ -120,7 +120,8 @@ extern "C"
* @brief Return a pointer to an JSON object item
* @param object the JSON object
* @param string the name of the object (case is ignored)
* @return A pointer to the object identified by @ref string or \b NULL
*
* @return A pointer to the object identified by \b string or \b NULL
* @since version 3.6.0
*/
WINPR_API WINPR_JSON* WINPR_JSON_GetObjectItem(const WINPR_JSON* object, const char* string);
@@ -130,7 +131,7 @@ extern "C"
*
* @param object the JSON instance to query
* @param string the name of the object
* @return A pointer to the object identified by @ref string or \b NULL
* @return A pointer to the object identified by \b string or \b NULL
* @since version 3.6.0
*/
WINPR_API WINPR_JSON* WINPR_JSON_GetObjectItemCaseSensitive(const WINPR_JSON* object,