diff -r f3fd62f8c831 -r ea25e596b1d4 libpurple/log.h
--- a/libpurple/log.h Fri Mar 26 01:31:55 2021 -0500
+++ b/libpurple/log.h Fri Mar 26 01:33:03 2021 -0500
@@ -46,12 +46,26 @@
typedef struct _PurpleLogCommonLoggerData PurpleLogCommonLoggerData;
typedef struct _PurpleLogSet PurpleLogSet;
+/**
+ * PurpleLogType:
+ * @PURPLE_LOG_IM: Indicates an IM conversation.
+ * @PURPLE_LOG_CHAT: Indicates a chat.
+ * @PURPLE_LOG_SYSTEM: Indicates a server log.
+ *
+ * The individual types of logs.
+ */
typedef enum {
PURPLE_LOG_IM,
PURPLE_LOG_CHAT,
PURPLE_LOG_SYSTEM
} PurpleLogType;
+/**
+ * PurpleLogReadFlags:
+ * @PURPLE_LOG_READ_NO_NEWLINE: Defines that newlines should be ignored.
+ *
+ * Flags that should be used when reading a log.
+ */
typedef enum {
PURPLE_LOG_READ_NO_NEWLINE = 1
} PurpleLogReadFlags;
@@ -162,6 +176,9 @@
/**
* PurpleLogCommonLoggerData:
+ * @path: The path to the file.
+ * @file: The pointer to the open file handle.
+ * @extra_data: User supplied data.
*
* A common logger_data struct containing a file handle and path, as well
* as a pointer to something else for additional data.
@@ -556,6 +573,7 @@
* create, %NULL (a placeholder for
* write), and finalize
* (for a total of 3 functions).
+ * @...: The functions used to log.
*
* Creates a new logger
*