annotate mcabber/mcabber/settings.h @ 1768:d80a9e32ab1a

Refuse to replace existing guards * Settings_set_guard returns success status * API v3 * Min API v3
author Myhailo Danylenko <isbear@ukrpost.net>
date Sat, 13 Mar 2010 20:09:14 +0200
parents 552da310b83e
children e6d355e50d7a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1668
41c26b7d2890 Install mcabber headers
Myhailo Danylenko <isbear@ukrpost.net>
parents: 1598
diff changeset
1 #ifndef __MCABBER_SETTINGS_H__
41c26b7d2890 Install mcabber headers
Myhailo Danylenko <isbear@ukrpost.net>
parents: 1598
diff changeset
2 #define __MCABBER_SETTINGS_H__ 1
279
f5dd437c057b Rewrite the settings system
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
3
498
879ffddc13b0 Suppress a compilation warning
Mikael Berthe <mikael@lilotux.net>
parents: 364
diff changeset
4 #include <ctype.h>
279
f5dd437c057b Rewrite the settings system
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
5 #include <glib.h>
f5dd437c057b Rewrite the settings system
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
6
1668
41c26b7d2890 Install mcabber headers
Myhailo Danylenko <isbear@ukrpost.net>
parents: 1598
diff changeset
7 #include <mcabber/roster.h>
41c26b7d2890 Install mcabber headers
Myhailo Danylenko <isbear@ukrpost.net>
parents: 1598
diff changeset
8 #include <mcabber/config.h>
294
871e53769084 Allow one status message per Jabber status
Mikael Berthe <mikael@lilotux.net>
parents: 292
diff changeset
9
498
879ffddc13b0 Suppress a compilation warning
Mikael Berthe <mikael@lilotux.net>
parents: 364
diff changeset
10 #ifndef isblank
292
96917f04c841 Define isblank() when C99 is not used
Mikael Berthe <mikael@lilotux.net>
parents: 288
diff changeset
11 # define isblank(c) ((c) == 0x20 || (c) == 0x09)
96917f04c841 Define isblank() when C99 is not used
Mikael Berthe <mikael@lilotux.net>
parents: 288
diff changeset
12 #endif
96917f04c841 Define isblank() when C99 is not used
Mikael Berthe <mikael@lilotux.net>
parents: 288
diff changeset
13
294
871e53769084 Allow one status message per Jabber status
Mikael Berthe <mikael@lilotux.net>
parents: 292
diff changeset
14
279
f5dd437c057b Rewrite the settings system
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
15 #define SETTINGS_TYPE_OPTION 1
f5dd437c057b Rewrite the settings system
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
16 #define SETTINGS_TYPE_ALIAS 2
f5dd437c057b Rewrite the settings system
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
17 #define SETTINGS_TYPE_BINDING 3
1299
3b338a5c01fc OTR support
Frank Zschockelt <mcabber_otr[at]freakysoft.de>
parents: 1197
diff changeset
18 #ifdef HAVE_LIBOTR
3b338a5c01fc OTR support
Frank Zschockelt <mcabber_otr[at]freakysoft.de>
parents: 1197
diff changeset
19 #define SETTINGS_TYPE_OTR 4
3b338a5c01fc OTR support
Frank Zschockelt <mcabber_otr[at]freakysoft.de>
parents: 1197
diff changeset
20 #endif
279
f5dd437c057b Rewrite the settings system
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
21
967
303408ef5e5d Configurable command character
Alexis Hildebrandt
parents: 867
diff changeset
22 #define COMMAND_CHAR '/'
303408ef5e5d Configurable command character
Alexis Hildebrandt
parents: 867
diff changeset
23 #define COMMAND_CHARSTR "/"
303408ef5e5d Configurable command character
Alexis Hildebrandt
parents: 867
diff changeset
24
279
f5dd437c057b Rewrite the settings system
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
25 #define settings_opt_get(k) settings_get(SETTINGS_TYPE_OPTION, k)
f5dd437c057b Rewrite the settings system
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
26 #define settings_opt_get_int(k) settings_get_int(SETTINGS_TYPE_OPTION, k)
f5dd437c057b Rewrite the settings system
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
27
967
303408ef5e5d Configurable command character
Alexis Hildebrandt
parents: 867
diff changeset
28 #define mkcmdstr(cmd) COMMAND_CHARSTR cmd
303408ef5e5d Configurable command character
Alexis Hildebrandt
parents: 867
diff changeset
29
1673
552da310b83e Add option guards
Myhailo Danylenko <isbear@ukrpost.net>
parents: 1668
diff changeset
30 typedef gchar *(*settings_guard_t)(const gchar *key, const gchar *new_value);
552da310b83e Add option guards
Myhailo Danylenko <isbear@ukrpost.net>
parents: 1668
diff changeset
31
1065
230dca34dbea Extand pgp_data structure
Mikael Berthe <mikael@lilotux.net>
parents: 1004
diff changeset
32 void settings_init(void);
1192
7b8765c10abb New command: /source
Mikael Berthe <mikael@lilotux.net>
parents: 1141
diff changeset
33 int cfg_read_file(char *filename, guint mainfile);
1074
b2fc694a8228 Fix a few memory leaks after calls to parse_assigment()
Mikael Berthe <mikael@lilotux.net>
parents: 1070
diff changeset
34 guint parse_assigment(gchar *assignment, gchar **pkey, gchar **pval);
1768
d80a9e32ab1a Refuse to replace existing guards
Myhailo Danylenko <isbear@ukrpost.net>
parents: 1673
diff changeset
35 gboolean settings_set_guard(const gchar *key, settings_guard_t guard);
1673
552da310b83e Add option guards
Myhailo Danylenko <isbear@ukrpost.net>
parents: 1668
diff changeset
36 void settings_del_guard(const gchar *key);
552da310b83e Add option guards
Myhailo Danylenko <isbear@ukrpost.net>
parents: 1668
diff changeset
37 void settings_opt_set_raw(const gchar *key, const gchar *value);
281
f562b9af2de7 Add "const" specifier in prototypes
Mikael Berthe <mikael@lilotux.net>
parents: 280
diff changeset
38 void settings_set(guint type, const gchar *key, const gchar *value);
f562b9af2de7 Add "const" specifier in prototypes
Mikael Berthe <mikael@lilotux.net>
parents: 280
diff changeset
39 void settings_del(guint type, const gchar *key);
f562b9af2de7 Add "const" specifier in prototypes
Mikael Berthe <mikael@lilotux.net>
parents: 280
diff changeset
40 const gchar *settings_get(guint type, const gchar *key);
f562b9af2de7 Add "const" specifier in prototypes
Mikael Berthe <mikael@lilotux.net>
parents: 280
diff changeset
41 int settings_get_int(guint type, const gchar *key);
294
871e53769084 Allow one status message per Jabber status
Mikael Berthe <mikael@lilotux.net>
parents: 292
diff changeset
42 const gchar *settings_get_status_msg(enum imstatus status);
867
7f056c566569 Commands /alias & /bind list the key bindings and aliases
Mikael Berthe <mikael@lilotux.net>
parents: 580
diff changeset
43 void settings_foreach(guint type,
1070
9eaacc0ad3a2 Use a hash for settings
Mikael Berthe <mikael@lilotux.net>
parents: 1065
diff changeset
44 void (*pfunc)(char *k, char *v, void *param),
867
7f056c566569 Commands /alias & /bind list the key bindings and aliases
Mikael Berthe <mikael@lilotux.net>
parents: 580
diff changeset
45 void *param);
279
f5dd437c057b Rewrite the settings system
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
46
1065
230dca34dbea Extand pgp_data structure
Mikael Berthe <mikael@lilotux.net>
parents: 1004
diff changeset
47 void settings_pgp_setdisabled(const char *bjid, guint value);
230dca34dbea Extand pgp_data structure
Mikael Berthe <mikael@lilotux.net>
parents: 1004
diff changeset
48 guint settings_pgp_getdisabled(const char *bjid);
1197
6f602d3270a4 Add /pgp [-]force
Mikael Berthe <mikael@lilotux.net>
parents: 1192
diff changeset
49 void settings_pgp_setforce(const char *bjid, guint value);
6f602d3270a4 Add /pgp [-]force
Mikael Berthe <mikael@lilotux.net>
parents: 1192
diff changeset
50 guint settings_pgp_getforce(const char *bjid);
1065
230dca34dbea Extand pgp_data structure
Mikael Berthe <mikael@lilotux.net>
parents: 1004
diff changeset
51 void settings_pgp_setkeyid(const char *bjid, const char *keyid);
230dca34dbea Extand pgp_data structure
Mikael Berthe <mikael@lilotux.net>
parents: 1004
diff changeset
52 const char *settings_pgp_getkeyid(const char *bjid);
230dca34dbea Extand pgp_data structure
Mikael Berthe <mikael@lilotux.net>
parents: 1004
diff changeset
53
1301
37b41ed9ed35 Fixed compiler warnings
Frank Zschockelt <mcabber_otr[at]freakysoft.de>
parents: 1299
diff changeset
54 #ifdef HAVE_LIBOTR
37b41ed9ed35 Fixed compiler warnings
Frank Zschockelt <mcabber_otr[at]freakysoft.de>
parents: 1299
diff changeset
55 guint settings_otr_getpolicy(const char *bjid);
37b41ed9ed35 Fixed compiler warnings
Frank Zschockelt <mcabber_otr[at]freakysoft.de>
parents: 1299
diff changeset
56 void settings_otr_setpolicy(const char *bjid, guint value);
37b41ed9ed35 Fixed compiler warnings
Frank Zschockelt <mcabber_otr[at]freakysoft.de>
parents: 1299
diff changeset
57 #endif
37b41ed9ed35 Fixed compiler warnings
Frank Zschockelt <mcabber_otr[at]freakysoft.de>
parents: 1299
diff changeset
58
1141
5be2408a6534 Add option "max_history_blocks"
Mikael Berthe <mikael@lilotux.net>
parents: 1074
diff changeset
59 guint get_max_history_blocks(void);
5be2408a6534 Add option "max_history_blocks"
Mikael Berthe <mikael@lilotux.net>
parents: 1074
diff changeset
60
1395
d431cd75eb53 Use bookmarked nickname when manually joining a room
Mikael Berthe <mikael@lilotux.net>
parents: 1301
diff changeset
61 char *default_muc_nickname(const char *roomid);
1004
b57a01ffeed6 Use existing conference bookmarks
Mikael Berthe <mikael@lilotux.net>
parents: 967
diff changeset
62
288
1eea0fa0955e Add /bind command
Mikael Berthe <mikael@lilotux.net>
parents: 281
diff changeset
63 const gchar *isbound(int key);
1eea0fa0955e Add /bind command
Mikael Berthe <mikael@lilotux.net>
parents: 281
diff changeset
64
1668
41c26b7d2890 Install mcabber headers
Myhailo Danylenko <isbear@ukrpost.net>
parents: 1598
diff changeset
65 #endif /* __MCABBER_SETTINGS_H__ */
279
f5dd437c057b Rewrite the settings system
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
66
580
fed6d1e4d7a9 Fix modelines
Mikael Berthe <mikael@lilotux.net>
parents: 576
diff changeset
67 /* vim: set expandtab cindent cinoptions=>2\:2(0: For Vim users... */