/*

 * Copyright (C) 2002-2006 Sergey V. Udaltsov <svu@gnome.org>

 *

 * This library is free software; you can redistribute it and/or

 * modify it under the terms of the GNU Lesser General Public

 * License as published by the Free Software Foundation; either

 * version 2 of the License, or (at your option) any later version.

 *

 * This library 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

 * Lesser General Public License for more details.

 *

 * You should have received a copy of the GNU Lesser General Public

 * License along with this library; if not, write to the

 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,

 * Boston, MA 02111-1307, USA.

 */

#ifndef __XKLAVIER_H__

#define __XKLAVIER_H__

#include <stdarg.h>

#include <X11/Xlib.h>

#include <glib-object.h>

#include <libxklavier/xkl_engine.h>

#include <libxklavier/xkl_config_rec.h>

#include <libxklavier/xkl_config_item.h>

#include <libxklavier/xkl_config_registry.h>

#include <libxklavier/xkl-enum-types.h>

#ifdef __cplusplus

extern "C" {

#endif

/**

 * xkl_get_last_error:

 *

 * Returns: the text message (statically allocated) of the last error

 */

	extern const gchar *xkl_get_last_error(void);

/**

 * _xkl_debug:

 * @file: the name of the source file. 

 * Preprocessor symbol__FILE__ should be used here

 * @function: name of the function

 * Preprocessor symbol__func__ should be used here

 * @level: level of the message

 * @format: is a format (like in printf)

 *

 * Output (optionally) some debug info

 */

	extern void _xkl_debug(const gchar file[], const gchar function[],

			       gint level, const gchar format[], ...);

/**

 * XklLogAppender:

 * @file: name of the source file. 

 * Preprocessor symbol__FILE__ should be used here

 * @function: name of the function

 * Preprocessor symbol__func__ should be used here

 * @level: level of the message

 * @format: format (like in printf)

 * @args: list of parameters

 *

 * Custom log output method for _xkl_debug. This appender is NOT called if the

 * level of the message is greater than currently set debug level.

 */

	typedef void (*XklLogAppender) (const gchar file[],

					const gchar function[],

					gint level,

					const gchar format[],

					va_list args);

/**

 * xkl_default_log_appender:

 * @file: name of the source file. 

 * Preprocessor symbol__FILE__ should be used here

 * @function: name of the function

 * Preprocessor symbol__func__ should be used here

 * @level: level of the message

 * @format: format (like in printf)

 * @args: list of parameters

 *

 * Default log output method. Sends everything to stdout.

 */

	extern void xkl_default_log_appender(const gchar file[],

					     const gchar function[],

					     gint level,

					     const gchar format[],

					     va_list args);

/**

 * xkl_set_log_appender:

 * @fun: new log appender

 *

 * Installs the custom log appender.function

 */

	extern void xkl_set_log_appender(XklLogAppender fun);

/**

 * xkl_set_debug_level:

 * @level: new debug level

 *

 * Sets maximum debug level. 

 * Message of the level more than the one set here - will be ignored

 */

	extern void xkl_set_debug_level(gint level);

#ifdef G_HAVE_ISO_VARARGS

/**

 * xkl_debug:

 * @level: level of the message

 *

 * Output (optionally) some debug info

 */

#define xkl_debug( level, ... ) \

  _xkl_debug( __FILE__, __func__, level, __VA_ARGS__ )

#elif defined(G_HAVE_GNUC_VARARGS)

/**

 * xkl_debug:

 * @level: level of the message

 * @format: format (like in printf)

 *

 * Output (optionally) some debug info

 */

#define xkl_debug( level, format, args... ) \

   _xkl_debug( __FILE__, __func__, level, format, ## args )

#else

#define xkl_debug( level, ... ) \

  _xkl_debug( __FILE__, __func__, level, __VA_ARGS__ )

#endif

#ifdef __cplusplus

}

#endif				/* __cplusplus */

#endif