annotate libpurple/protocols/zephyr/com_err.h @ 18035:c168d1ae2012

A patch from Norbert Buchmuller: "There's a 'setstatus' command implemented in 'gaim-remote', but there's no 'getstatus'. For some tasks (eg. setting status to 'offline' on hibernation and restoring it on resume) it would be useful if such command existed." I'm not sure if we're considering this API or not. committer: Richard Laager <[e-mail]>

/*
 * Header file for common error description library.
 *
 * Copyright 1988, Student Information Processing Board of the
 * Massachusetts Institute of Technology.
 *
 * For copyright and distribution info, see the documentation supplied
 * with this package.
 */

#ifndef __COM_ERR_H
#define __COM_ERR_H

#define COM_ERR_BUF_LEN 25

/* Use __STDC__ to guess whether we can use stdarg, prototypes, and const.
 * This is a public header file, so autoconf can't help us here. */
#ifdef __STDC__
# include <stdarg.h>
# define ETP(x) x
# define ETCONST const
#else
# define ETP(x) ()
# define ETCONST
#endif

typedef void (*error_handler_t) ETP((ETCONST char *, long, ETCONST char *,
				     va_list));
extern error_handler_t com_err_hook;
void com_err ETP((ETCONST char *, long, ETCONST char *, ...));
ETCONST char *error_message ETP((long));
ETCONST char *error_message_r ETP((long, char *));
error_handler_t set_com_err_hook ETP((error_handler_t));
error_handler_t reset_com_err_hook ETP((void));

#undef ETP

#endif /* ! defined(__COM_ERR_H) */