pidgin/pidgin

pidgin.h phase3: create pidgin.h and force its usage

2020-08-06, Gary Kramlich
875489636847
pidgin.h phase3: create pidgin.h and force its usage

fix the section id of pidgincore.h

Generate our pidgin.h file

Add include guard to all pidgin/*.h files and deal with the fallout from that.

Also had to namespace PIDGIN_BLIST_COLUMN_NAME, will come back and get the rest at a later time.

Testing Done:
Compile test, including some plugins that don't build by default. Also ran everything seems fine.

Reviewed at https://reviews.imfreedom.org/r/50/
/* purple
*
* Purple is the legal property of its developers, whose names are too numerous
* to list here. Please refer to the COPYRIGHT file distributed with this
* source distribution.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
*/
#if !defined(PURPLE_GLOBAL_HEADER_INSIDE) && !defined(PURPLE_COMPILATION)
# error "only <purple.h> may be included directly"
#endif
#ifndef PURPLE_IDLE_H
#define PURPLE_IDLE_H
/**
* SECTION:idle
* @section_id: libpurple-idle
* @short_description: <filename>idle.h</filename>
* @title: Idle API
*/
#include <time.h>
#include <glib-object.h>
#define PURPLE_TYPE_IDLE_UI_OPS (purple_idle_ui_ops_get_type())
typedef struct _PurpleIdleUiOps PurpleIdleUiOps;
/**
* PurpleIdleUiOps:
*
* Idle UI operations.
*/
struct _PurpleIdleUiOps
{
time_t (*get_time_idle)(void);
/*< private >*/
void (*_purple_reserved1)(void);
void (*_purple_reserved2)(void);
void (*_purple_reserved3)(void);
void (*_purple_reserved4)(void);
};
G_BEGIN_DECLS
/**************************************************************************/
/* Idle API */
/**************************************************************************/
/**
* purple_idle_touch:
*
* Touch our idle tracker. This signifies that the user is
* 'active'. The conversation code calls this when the
* user sends an IM, for example.
*/
void purple_idle_touch(void);
/**
* purple_idle_set:
*
* Fake our idle time by setting the time at which our
* accounts purportedly became idle. This is used by
* the I'dle Mak'er plugin.
*/
void purple_idle_set(time_t time);
/**************************************************************************/
/* Idle Subsystem */
/**************************************************************************/
/**
* purple_idle_ui_ops_get_type:
*
* Returns: The #GType for the #PurpleIdleUiOps boxed structure.
*/
GType purple_idle_ui_ops_get_type(void);
/**
* purple_idle_set_ui_ops:
* @ops: The UI operations structure.
*
* Sets the UI operations structure to be used for idle reporting.
*/
void purple_idle_set_ui_ops(PurpleIdleUiOps *ops);
/**
* purple_idle_get_ui_ops:
*
* Returns the UI operations structure used for idle reporting.
*
* Returns: The UI operations structure in use.
*/
PurpleIdleUiOps *purple_idle_get_ui_ops(void);
/**
* purple_idle_init:
*
* Initializes the idle system.
*/
void purple_idle_init(void);
/**
* purple_idle_uninit:
*
* Uninitializes the idle system.
*/
void purple_idle_uninit(void);
G_END_DECLS
#endif /* PURPLE_IDLE_H */