comparison src/log.h @ 11292:ef9280fdc511

[gaim-migrate @ 13492] Apparently, users like to know when logging is failing. Who knew? committer: Tailor Script <[e-mail]>

11291:57fccea36e36

struct _GaimLog {
	GaimLogType type;                     /**< The type of log this is */
	char *name;                           /**< The name of this log */
	GaimAccount *account;                 /**< The account this log is taking
											   place on */
	time_t time;                          /**< The time this conversation
											   started */
	GaimLogLogger *logger;                /**< The logging mechanism this log
											   is to use */
	void *logger_data;                    /**< Data used by the log logger */

 *
 * @param type        The type of log this is.
 * @param name        The name of this conversation (screenname, chat name,
 *                    etc.)
 * @param account     The account the conversation is occurring on
 * @param time        The time this conversation started
 * @return            The new log
 */
GaimLog *gaim_log_new(GaimLogType type, const char *name,
		GaimAccount *account, time_t time);

/**
 * Frees a log
 *
 * @param log         The log to destroy

 * file handle is retained.  The log's logger_data value is
 * set to a GaimLogCommonLoggerData struct containing the log
 * file handle and log path.
 *
 * @param log   The log to write to.
 * @param time  The time of the item being logged.
 * @param ext   The file extension to give to this log file.
 */
void gaim_log_common_writer(GaimLog *log, time_t time, const char *ext);

/**
 * Returns a sorted GList of GaimLogs of the requested type.
 * This function should only be used with logs that are written
 * with gaim_log_common_writer().

11292:ef9280fdc511

struct _GaimLog {
	GaimLogType type;                     /**< The type of log this is */
	char *name;                           /**< The name of this log */
	GaimAccount *account;                 /**< The account this log is taking
											   place on */
	GaimConversation *conv;               /**< The conversation being logged */
	time_t time;                          /**< The time this conversation
											   started */
	GaimLogLogger *logger;                /**< The logging mechanism this log
											   is to use */
	void *logger_data;                    /**< Data used by the log logger */

 *
 * @param type        The type of log this is.
 * @param name        The name of this conversation (screenname, chat name,
 *                    etc.)
 * @param account     The account the conversation is occurring on
 * @param conv        The conversation being logged
 * @param time        The time this conversation started
 * @return            The new log
 */
GaimLog *gaim_log_new(GaimLogType type, const char *name, GaimAccount *account,
					  GaimConversation *conv, time_t time);

/**
 * Frees a log
 *
 * @param log         The log to destroy

 * file handle is retained.  The log's logger_data value is
 * set to a GaimLogCommonLoggerData struct containing the log
 * file handle and log path.
 *
 * @param log   The log to write to.
 * @param ext   The file extension to give to this log file.
 */
void gaim_log_common_writer(GaimLog *log, const char *ext);

/**
 * Returns a sorted GList of GaimLogs of the requested type.
 * This function should only be used with logs that are written
 * with gaim_log_common_writer().