]>
jfr.im git - irc/evilnet/x3.git/blob - src/helpfile.c
1 /* helpfile.c - Help file loading and display
2 * Copyright 2000-2004 srvx Development Team
4 * This file is part of x3.
6 * x3 is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with srvx; if not, write to the Free Software Foundation,
18 * Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
28 #if defined(HAVE_DIRENT_H)
32 #if defined(HAVE_SYS_STAT_H)
36 static const struct message_entry msgtab
[] = {
37 { "HFMSG_MISSING_HELPFILE", "The help file could not be found. Sorry!" },
38 { "HFMSG_HELP_NOT_STRING", "Help file error (help data was not a string)." },
42 #define DEFAULT_LINE_SIZE MAX_LINE_SIZE
43 #define DEFAULT_TABLE_SIZE 80
45 extern struct userNode
*global
, *chanserv
, *opserv
, *nickserv
, *spamserv
;
46 struct userNode
*message_dest
;
47 struct userNode
*message_source
;
48 struct language
*lang_C
;
49 struct dict
*languages
;
51 static void language_cleanup(void)
53 dict_delete(languages
);
56 static void language_free_helpfile(void *data
)
58 struct helpfile
*hf
= data
;
62 static void language_free(void *data
)
64 struct language
*lang
= data
;
65 dict_delete(lang
->messages
);
66 dict_delete(lang
->helpfiles
);
71 static struct language
*language_alloc(const char *name
)
73 struct language
*lang
= calloc(1, sizeof(*lang
));
74 lang
->name
= strdup(name
);
75 lang
->parent
= lang_C
;
77 languages
= dict_new();
78 dict_set_free_data(languages
, language_free
);
80 dict_insert(languages
, lang
->name
, lang
);
84 /* Language names should use a lang or lang_COUNTRY type system, where
85 * lang is a two-letter code according to ISO-639-1 (or three-letter
86 * code according to ISO-639-2 for languages not in ISO-639-1), and
87 * COUNTRY is the ISO 3166 country code in all upper case.
90 * http://www.loc.gov/standards/iso639-2/
91 * http://www.loc.gov/standards/iso639-2/langhome.html
92 * http://www.iso.ch/iso/en/prods-services/iso3166ma/index.html
94 struct language
*language_find(const char *name
)
96 struct language
*lang
;
97 char alt_name
[MAXLEN
];
100 if ((lang
= dict_find(languages
, name
, NULL
)))
102 if ((uscore
= strchr(name
, '_'))) {
103 strncpy(alt_name
, name
, uscore
-name
);
104 alt_name
[uscore
-name
] = 0;
105 if ((lang
= dict_find(languages
, alt_name
, NULL
)))
109 lang_C
= language_alloc("C");
110 lang_C
->messages
= dict_new();
111 lang_C
->helpfiles
= dict_new();
116 static void language_set_messages(struct language
*lang
, dict_t dict
)
118 dict_iterator_t it
, it2
;
119 struct record_data
*rd
;
124 for (it
= dict_first(dict
), it2
= dict_first(lang_C
->messages
); it
; ) {
125 const char *msgid
= iter_key(it
);
126 int diff
= it2
? irccasecmp(msgid
, iter_key(it2
)) : -1;
131 } else if (diff
> 0) {
133 it2
= iter_next(it2
);
139 msg
= strdup(rd
->d
.qstring
);
141 case RECDB_STRING_LIST
:
142 /* XXX: maybe do an unlistify_help() type thing */
144 log_module(MAIN_LOG
, LOG_WARNING
, "Unsupported record type for message %s in language %s", msgid
, lang
->name
);
147 dict_insert(lang
->messages
, strdup(msgid
), msg
);
149 it2
= iter_next(it2
);
153 it2
= iter_next(it2
);
155 if (extra
|| missing
)
156 log_module(MAIN_LOG
, LOG_WARNING
, "In language %s, %d extra and %d missing messages.", lang
->name
, extra
, missing
);
159 static struct language
*language_read(const char *name
)
162 struct dirent
*dirent
;
163 struct language
*lang
;
165 char filename
[MAXLEN
], *uscore
;
169 /* Never try to read the C language from disk. */
170 if (!irccasecmp(name
, "C"))
173 /* Open the directory stream; if we can't, fail. */
174 snprintf(filename
, sizeof(filename
), "languages/%s", name
);
175 if (!(dir
= opendir(filename
))) {
176 log_module(MAIN_LOG
, LOG_ERROR
, "Unable to open language directory languages/%s: %s", name
, strerror(errno
));
179 if (!(lang
= dict_find(languages
, name
, NULL
)))
180 lang
= language_alloc(name
);
182 /* Find the parent language. */
183 snprintf(filename
, sizeof(filename
), "languages/%s/parent", name
);
184 if (!(file
= fopen(filename
, "r"))
185 || !fgets(filename
, sizeof(filename
), file
)) {
186 strcpy(filename
, "C");
188 if (!(lang
->parent
= language_find(filename
))) {
189 uscore
= strchr(filename
, '_');
192 lang
->parent
= language_find(filename
);
195 lang
->parent
= lang_C
;
198 /* (Re-)initialize the language's dicts. */
199 dict_delete(lang
->messages
);
200 lang
->messages
= dict_new();
201 dict_set_free_keys(lang
->messages
, free
);
202 dict_set_free_data(lang
->messages
, free
);
203 lang
->helpfiles
= dict_new();
204 dict_set_free_data(lang
->helpfiles
, language_free_helpfile
);
206 /* Read all the translations from the directory. */
207 while ((dirent
= readdir(dir
))) {
208 snprintf(filename
, sizeof(filename
), "languages/%s/%s", name
, dirent
->d_name
);
209 if (!strcmp(dirent
->d_name
,"parent")) {
211 } else if (!strcmp(dirent
->d_name
, "strings.db")) {
212 dict
= parse_database(filename
);
213 language_set_messages(lang
, dict
);
215 } else if ((hf
= dict_find(lang_C
->helpfiles
, dirent
->d_name
, NULL
))) {
216 hf
= open_helpfile(filename
, hf
->expand
);
217 dict_insert(lang
->helpfiles
, hf
->name
, hf
);
226 static void language_read_list(void)
229 struct dirent
*dirent
;
231 char namebuf
[MAXLEN
];
233 if (!(dir
= opendir("languages")))
235 while ((dirent
= readdir(dir
))) {
236 if (dirent
->d_name
[0] == '.')
238 snprintf(namebuf
, sizeof(namebuf
), "languages/%s", dirent
->d_name
);
239 if (stat(namebuf
, &sbuf
) < 0) {
240 log_module(MAIN_LOG
, LOG_INFO
, "Skipping language entry '%s' (unable to stat).", dirent
->d_name
);
243 if (!S_ISDIR(sbuf
.st_mode
)) {
244 log_module(MAIN_LOG
, LOG_INFO
, "Skipping language entry '%s' (not directory).", dirent
->d_name
);
247 language_alloc(dirent
->d_name
);
252 const char *language_find_message(struct language
*lang
, const char *msgid
) {
253 struct language
*curr
;
257 for (curr
= lang
; curr
; curr
= curr
->parent
)
258 if ((msg
= dict_find(curr
->messages
, msgid
, NULL
)))
260 log_module(MAIN_LOG
, LOG_ERROR
, "Tried to find unregistered message \"%s\" (original language %s)", msgid
, lang
->name
);
264 int strlen_vis(char *str
)
267 for(count
=0;*str
;str
++)
274 table_send(struct userNode
*from
, const char *to
, unsigned int size
, irc_send_func irc_send
, struct helpfile_table table
) {
275 unsigned int ii
, jj
, len
, nreps
, reps
, tot_width
, pos
, spaces
, *max_width
;
276 char line
[MAX_LINE_SIZE
+1];
277 struct handle_info
*hi
;
281 if (IsChannelName(to
) || *to
== '$') {
285 message_dest
= GetUserH(to
);
287 log_module(MAIN_LOG
, LOG_ERROR
, "Unable to find user with nickname %s (in table_send from %s).", to
, from
->nick
);
290 hi
= message_dest
->handle_info
;
291 #ifdef WITH_PROTOCOL_P10
292 to
= message_dest
->numeric
;
295 message_source
= from
;
297 /* If size or irc_send are 0, we should try to use a default. */
301 size
= DEFAULT_TABLE_SIZE
;
302 else if (hi
->table_width
)
303 size
= hi
->table_width
;
304 else if (hi
->screen_width
)
305 size
= hi
->screen_width
;
307 size
= DEFAULT_TABLE_SIZE
;
310 {} /* use that function */
312 irc_send
= HANDLE_FLAGGED(hi
, USE_PRIVMSG
) ? irc_privmsg
: irc_notice
;
314 irc_send
= IsChannelName(to
) ? irc_privmsg
: irc_notice
;
316 /* Limit size to how much we can show at once */
317 if (size
> sizeof(line
))
320 /* Figure out how wide columns should be */
321 max_width
= alloca(table
.width
* sizeof(int));
322 for (jj
=tot_width
=0; jj
<table
.width
; jj
++) {
323 /* Find the widest width for this column */
325 for (ii
=0; ii
<table
.length
; ii
++) {
326 len
= strlen(table
.contents
[ii
][jj
]);
327 if (len
> max_width
[jj
])
330 /* Separate columns with spaces */
331 tot_width
+= max_width
[jj
] + 1;
333 /* How many rows to put in a line? */
334 if ((table
.flags
& TABLE_REPEAT_ROWS
) && (size
> tot_width
))
335 nreps
= size
/ tot_width
;
338 /* Send headers line.. */
339 if (table
.flags
& TABLE_NO_HEADERS
) {
342 /* Sending headers needs special treatment: either show them
343 * once, or repeat them as many times as we repeat the columns
345 for (pos
=ii
=0; ii
<((table
.flags
& TABLE_REPEAT_HEADERS
)?nreps
:1); ii
++) {
347 len
= strlen(table
.contents
[0][jj
]);
348 //line[pos++] = '\02'; /* bold header */
349 spaces
= max_width
[jj
] - len
;
350 if (table
.flags
& TABLE_PAD_LEFT
)
353 memcpy(line
+pos
, table
.contents
[0][jj
], len
);
355 //line[pos++] = '\02'; /* end bold header */
356 if (++jj
== table
.width
)
358 if (!(table
.flags
& TABLE_PAD_LEFT
))
366 sepsize
= strlen_vis(line
);
367 sepstr
= malloc(sepsize
+ 1);
368 memset(sepstr
, '-', sepsize
);
370 if(hi
&& hi
->userlist_style
!= HI_STYLE_CLEAN
)
371 irc_send(from
, to
, sepstr
); /* ----------------- */
372 irc_send(from
, to
, line
); /* alpha beta roe */
373 if(hi
&& hi
->userlist_style
!= HI_STYLE_CLEAN
)
374 irc_send(from
, to
, sepstr
); /* ----------------- */
377 /* Send the table. */
378 for (jj
=0, pos
=0, reps
=0; ii
<table
.length
; ) {
380 len
= strlen(table
.contents
[ii
][jj
]);
381 spaces
= max_width
[jj
] - len
;
382 if (table
.flags
& TABLE_PAD_LEFT
)
383 while (spaces
--) line
[pos
++] = ' ';
384 memcpy(line
+pos
, table
.contents
[ii
][jj
], len
);
386 if (++jj
== table
.width
) {
387 jj
= 0, ++ii
, ++reps
;
388 if ((reps
== nreps
) || (ii
== table
.length
)) {
390 irc_send(from
, to
, line
);
395 if (!(table
.flags
& TABLE_PAD_LEFT
))
401 if (!(table
.flags
& TABLE_NO_HEADERS
)) {
402 /* Send end bar & free its memory */
405 sepstr
[sepsize
/2-1] = 'E';
406 sepstr
[sepsize
/2] = 'n';
407 sepstr
[sepsize
/2+1]= 'd';
410 if(hi
&& hi
->userlist_style
!= HI_STYLE_CLEAN
)
411 irc_send(from
, to
, sepstr
);
415 if (!(table
.flags
& TABLE_NO_FREE
)) {
416 /* Deallocate table memory (but not the string memory). */
417 for (ii
=0; ii
<table
.length
; ii
++)
418 free(table
.contents
[ii
]);
419 free(table
.contents
);
424 vsend_message(const char *dest
, struct userNode
*src
, struct handle_info
*handle
, int msg_type
, expand_func_t expand_f
, const char *format
, va_list al
)
426 void (*irc_send
)(struct userNode
*from
, const char *to
, const char *msg
);
427 static struct string_buffer input
;
428 unsigned int size
, ipos
, pos
, length
, chars_sent
, use_color
;
429 unsigned int expand_pos
, expand_ipos
, newline_ipos
;
430 char line
[MAX_LINE_SIZE
];
432 if (IsChannelName(dest
) || *dest
== '$') {
434 } else if (!(message_dest
= GetUserH(dest
))) {
435 log_module(MAIN_LOG
, LOG_ERROR
, "Unable to find user with nickname %s (in vsend_message from %s).", dest
, src
->nick
);
437 } else if (message_dest
->dead
) {
438 /* No point in sending to a user who is leaving. */
441 #ifdef WITH_PROTOCOL_P10
442 dest
= message_dest
->numeric
;
445 message_source
= src
;
446 if (!(msg_type
& MSG_TYPE_NOXLATE
)
447 && !(format
= handle_find_message(handle
, format
)))
449 /* fill in a buffer with the string */
451 string_buffer_append_vprintf(&input
, format
, al
);
453 /* figure out how to send the messages */
455 msg_type
|= (HANDLE_FLAGGED(handle
, USE_PRIVMSG
) ? 1 : 0);
456 use_color
= HANDLE_FLAGGED(handle
, MIRC_COLOR
);
457 size
= handle
->screen_width
;
458 if (size
> sizeof(line
))
464 if (!size
|| !(msg_type
& MSG_TYPE_MULTILINE
))
465 size
= DEFAULT_LINE_SIZE
;
466 switch (msg_type
& 3) {
468 irc_send
= irc_notice
;
471 irc_send
= irc_wallchops
;
475 irc_send
= irc_privmsg
;
478 /* This used to be two passes, but if you do that and allow
479 * arbitrary sizes for ${}-expansions (as with help indexes),
480 * that requires a very big intermediate buffer.
482 expand_ipos
= newline_ipos
= ipos
= 0;
483 expand_pos
= pos
= 0;
485 while (input
.list
[ipos
]) {
486 char ch
, *value
, *free_value
;
488 while ((ch
= input
.list
[ipos
]) && (ch
!= '$') && (ch
!= '\n') && (pos
< size
)) {
493 if (!input
.list
[ipos
])
495 if (input
.list
[ipos
] == '\n') {
500 unsigned int new_ipos
;
501 /* Scan backwards for a space in the input, until we hit
502 * either the last newline or the last variable expansion.
503 * Print the line up to that point, and start from there.
505 for (new_ipos
= ipos
;
506 (new_ipos
> expand_ipos
) && (new_ipos
> newline_ipos
);
508 if (input
.list
[new_ipos
] == ' ')
510 pos
-= ipos
- new_ipos
;
511 if (new_ipos
== newline_ipos
) {
512 /* Single word was too big to fit on one line; skip
513 * forward to its end and print it as a whole.
515 while (input
.list
[new_ipos
]
516 && (input
.list
[new_ipos
] != ' ')
517 && (input
.list
[new_ipos
] != '\n')
518 && (input
.list
[new_ipos
] != '$'))
519 line
[pos
++] = input
.list
[new_ipos
++];
522 while (input
.list
[ipos
] == ' ')
528 switch (input
.list
[++ipos
]) {
529 /* Literal '$' or end of string. */
535 /* The following two expand to mIRC color codes if enabled
538 value
= use_color
? "\002" : "";
541 value
= use_color
? "\017" : "";
544 value
= use_color
? "\026" : "";
547 value
= use_color
? "\037" : "";
554 value
= global
? global
->nick
: "Global";
557 value
= chanserv
? chanserv
->nick
: "ChanServ";
560 value
= opserv
? opserv
->nick
: "OpServ";
563 value
= nickserv
? nickserv
->nick
: "NickServ";
566 value
= spamserv
? spamserv
->nick
: "SpamServ";
572 value
= handle
? handle
->handle
: "Account";
574 #define SEND_LINE(TRUNCED) do { \
577 if (!(msg_type & MSG_TYPE_MULTILINE) && (pos > 1) && TRUNCED) \
578 line[pos-2] = line[pos-1] = '.'; \
579 irc_send(src, dest, line); \
583 newline_ipos = ipos; \
584 if (!(msg_type & MSG_TYPE_MULTILINE)) return chars_sent; \
586 /* Custom expansion handled by helpfile-specific function. */
589 struct helpfile_expansion exp
;
590 char *name_end
= input
.list
+ ipos
+ 1, *colon
= NULL
;
592 while (*name_end
!= '}' && *name_end
!= ')' && *name_end
) {
593 if (*name_end
== ':') {
603 struct module *module = module_find(input
.list
+ ipos
+ 1);
604 if (module && module->expand_help
)
605 exp
= module->expand_help(colon
+ 1);
611 exp
= expand_f(input
.list
+ ipos
+ 1);
616 free_value
= value
= exp
.value
.str
;
621 /* Must send current line, then emit table. */
623 table_send(src
, (message_dest
? message_dest
->nick
: dest
), 0, irc_send
, exp
.value
.table
);
628 log_module(MAIN_LOG
, LOG_ERROR
, "Invalid exp.type %d from expansion function %p.", exp
.type
, expand_f
);
631 ipos
= name_end
- input
.list
;
638 value
[1] = input
.list
[ipos
];
642 while ((pos
+ strlen(value
) > size
) || strchr(value
, '\n')) {
644 avail
= size
- pos
- 1;
645 length
= strcspn(value
, "\n ");
646 if (length
<= avail
) {
647 strncpy(line
+pos
, value
, length
);
650 /* copy over spaces, until (possible) end of line */
651 while (*value
== ' ') {
653 line
[pos
++] = *value
;
657 /* word to send is too big to send now.. what to do? */
659 /* try to put it on a separate line */
662 /* already at start of line; only send part of it */
663 strncpy(line
, value
, avail
);
666 /* skip any trailing spaces */
667 while (*value
== ' ')
671 /* if we're looking at a newline, send the accumulated text */
672 if (*value
== '\n') {
677 length
= strlen(value
);
678 memcpy(line
+ pos
, value
, length
);
682 if ((pos
< size
-1) && input
.list
[ipos
]) {
697 send_message(struct userNode
*dest
, struct userNode
*src
, const char *format
, ...)
702 if (IsLocal(dest
)) return 0;
703 va_start(ap
, format
);
704 res
= vsend_message(dest
->nick
, src
, dest
->handle_info
, 0, NULL
, format
, ap
);
710 send_message_type(int msg_type
, struct userNode
*dest
, struct userNode
*src
, const char *format
, ...) {
714 if (IsLocal(dest
)) return 0;
715 va_start(ap
, format
);
716 res
= vsend_message(dest
->nick
, src
, dest
->handle_info
, msg_type
, NULL
, format
, ap
);
722 send_target_message(int msg_type
, const char *dest
, struct userNode
*src
, const char *format
, ...)
727 va_start(ap
, format
);
728 res
= vsend_message(dest
, src
, NULL
, msg_type
, NULL
, format
, ap
);
734 _send_help(struct userNode
*dest
, struct userNode
*src
, expand_func_t expand
, const char *format
, ...)
739 va_start(ap
, format
);
740 res
= vsend_message(dest
->nick
, src
, dest
->handle_info
, 12, expand
, format
, ap
);
746 send_help(struct userNode
*dest
, struct userNode
*src
, struct helpfile
*hf
, const char *topic
)
748 struct helpfile
*lang_hf
;
749 struct record_data
*rec
;
750 struct language
*curr
;
755 _send_help(dest
, src
, NULL
, "HFMSG_MISSING_HELPFILE");
758 for (curr
= (dest
->handle_info
? dest
->handle_info
->language
: lang_C
);
760 curr
= curr
->parent
) {
761 lang_hf
= dict_find(curr
->helpfiles
, hf
->name
, NULL
);
764 rec
= dict_find(lang_hf
->db
, topic
, NULL
);
765 if (rec
&& rec
->type
== RECDB_QSTRING
) {
766 _send_help(dest
, src
, hf
->expand
, rec
->d
.qstring
);
770 rec
= dict_find(hf
->db
, "<missing>", NULL
);
773 if (rec
->type
!= RECDB_QSTRING
) {
774 send_message(dest
, src
, "HFMSG_HELP_NOT_STRING");
777 _send_help(dest
, src
, hf
->expand
, rec
->d
.qstring
);
782 send_help_brief(struct userNode
*dest
, struct userNode
*src
, struct helpfile
*hf
, const char *topic
)
784 struct helpfile
*lang_hf
;
785 struct record_data
*rec
;
786 struct language
*curr
;
791 _send_help(dest
, src
, NULL
, "HFMSG_MISSING_HELPFILE");
794 for (curr
= (dest
->handle_info
? dest
->handle_info
->language
: lang_C
);
796 curr
= curr
->parent
) {
797 lang_hf
= dict_find(curr
->helpfiles
, hf
->name
, NULL
);
800 rec
= dict_find(lang_hf
->db
, topic
, NULL
);
801 if (rec
&& rec
->type
== RECDB_QSTRING
)
806 buf
= malloc(strlen(rec
->d
.qstring
) + 1);
807 strcpy(buf
, rec
->d
.qstring
);
808 *strchr(buf
, '\n') = 0;
810 res
= _send_help(dest
, src
, hf
->expand
, buf
);
815 rec
= dict_find(hf
->db
, "<missing>", NULL
);
817 return 0; /* send_message(dest, src, "MSG_TOPIC_UNKNOWN"); */
818 if (rec
->type
!= RECDB_QSTRING
)
819 return 0; /* send_message(dest, src, "HFMSG_HELP_NOT_STRING"); */
820 return _send_help(dest
, src
, hf
->expand
, rec
->d
.qstring
);
823 /* Grammar supported by this parser:
824 * condition = expr | prefix expr
825 * expr = atomicexpr | atomicexpr op atomicexpr
826 * op = '&&' | '||' | 'and' | 'or'
827 * atomicexpr = '(' expr ')' | identifier
828 * identifier = ( '0'-'9' 'A'-'Z' 'a'-'z' '-' '_' '/' )+ | ! identifier
830 * Whitespace is ignored. The parser is implemented as a recursive
831 * descent parser by functions like:
832 * static int helpfile_eval_<element>(const char *start, const char **end);
841 static const struct {
844 } helpfile_operators
[] = {
845 { "&&", OP_BOOL_AND
},
846 { "and", OP_BOOL_AND
},
847 { "||", OP_BOOL_OR
},
848 { "or", OP_BOOL_OR
},
852 static const char *identifier_chars
= "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-_/";
854 static int helpfile_eval_expr(const char *start
, const char **end
);
855 static int helpfile_eval_atomicexpr(const char *start
, const char **end
);
856 static int helpfile_eval_identifier(const char *start
, const char **end
);
859 helpfile_eval_identifier(const char *start
, const char **end
)
861 /* Skip leading whitespace. */
862 while (isspace(*start
) && (start
< *end
))
865 log_module(MAIN_LOG
, LOG_FATAL
, "Expected identifier in helpfile condition.");
869 if (start
[0] == '!') {
870 int res
= helpfile_eval_identifier(start
+1, end
);
874 } else if (start
[0] == '/') {
876 char *id_str
, *value
;
879 strchr(identifier_chars
, sep
[0]) && (sep
< *end
);
881 memcpy(id_str
= alloca(sep
+1-start
), start
, sep
-start
);
882 id_str
[sep
-start
] = '\0';
883 value
= conf_get_data(id_str
+1, RECDB_QSTRING
);
887 return enabled_string(value
) || true_string(value
);
888 } else if ((*end
- start
>= 4) && !ircncasecmp(start
, "true", 4)) {
891 } else if ((*end
- start
>= 5) && !ircncasecmp(start
, "false", 5)) {
895 log_module(MAIN_LOG
, LOG_FATAL
, "Unexpected helpfile identifier '%.*s'.", (int)(*end
-start
), start
);
901 helpfile_eval_atomicexpr(const char *start
, const char **end
)
906 /* Skip leading whitespace. */
907 while (isspace(*start
) && (start
< *end
))
910 log_module(MAIN_LOG
, LOG_FATAL
, "Expected atomic expression in helpfile condition.");
914 /* If it's not parenthesized, it better be a valid identifier. */
916 return helpfile_eval_identifier(start
, end
);
918 /* Parse the internal expression. */
921 res
= helpfile_eval_expr(start
, &sep
);
923 /* Check for the closing parenthesis. */
924 while (isspace(*sep
) && (sep
< *end
))
926 if ((sep
== *end
) || (sep
[0] != ')')) {
927 log_module(MAIN_LOG
, LOG_FATAL
, "Expected close parenthesis at '%.*s'.", (int)(*end
-sep
), sep
);
931 /* Report the end location and result. */
937 helpfile_eval_expr(const char *start
, const char **end
)
939 const char *sep
, *sep2
;
940 unsigned int ii
, len
;
944 /* Parse the first atomicexpr. */
946 res_a
= helpfile_eval_atomicexpr(start
, &sep
);
950 /* Figure out what follows that. */
951 while (isspace(*sep
) && (sep
< *end
))
956 for (ii
= 0; helpfile_operators
[ii
].str
; ++ii
) {
957 len
= strlen(helpfile_operators
[ii
].str
);
958 if (ircncasecmp(sep
, helpfile_operators
[ii
].str
, len
))
960 op
= helpfile_operators
[ii
].op
;
963 if (op
== OP_INVALID
) {
964 log_module(MAIN_LOG
, LOG_FATAL
, "Unrecognized helpfile operator at '%.*s'.", (int)(*end
-sep
), sep
);
968 /* Parse the next atomicexpr. */
970 res_b
= helpfile_eval_atomicexpr(sep
, &sep2
);
974 /* Make sure there's no trailing garbage */
975 while (isspace(*sep2
) && (sep2
< *end
))
978 log_module(MAIN_LOG
, LOG_FATAL
, "Trailing garbage in helpfile expression: '%.*s'.", (int)(*end
-sep2
), sep2
);
982 /* Record where we stopped parsing. */
985 /* Do the logic on the subexpressions. */
988 return res_a
&& res_b
;
990 return res_a
|| res_b
;
997 helpfile_eval_condition(const char *start
, const char **end
)
1001 /* Skip the prefix if there is one. */
1002 for (term
= start
; isalnum(*term
) && (term
< *end
); ++term
) ;
1003 if (term
!= start
) {
1004 if ((term
+ 2 >= *end
) || (term
[0] != ':') || (term
[1] != ' ')) {
1005 log_module(MAIN_LOG
, LOG_FATAL
, "In helpfile condition '%.*s' expected prefix to end with ': '.",(int)(*end
-start
), start
);
1011 /* Evaluate the remaining string as an expression. */
1012 return helpfile_eval_expr(start
, end
);
1016 unlistify_help(const char *key
, void *data
, void *extra
)
1018 struct record_data
*rd
= data
;
1019 dict_t newdb
= extra
;
1023 dict_insert(newdb
, strdup(key
), alloc_record_data_qstring(GET_RECORD_QSTRING(rd
)));
1025 case RECDB_STRING_LIST
: {
1026 struct string_list
*slist
= GET_RECORD_STRING_LIST(rd
);
1028 unsigned int totlen
, len
, i
;
1030 for (i
=totlen
=0; i
<slist
->used
; i
++)
1031 totlen
= totlen
+ strlen(slist
->list
[i
]) + 1;
1032 dest
= alloca(totlen
+1);
1033 for (i
=totlen
=0; i
<slist
->used
; i
++) {
1034 len
= strlen(slist
->list
[i
]);
1035 memcpy(dest
+totlen
, slist
->list
[i
], len
);
1036 dest
[totlen
+len
] = '\n';
1037 totlen
= totlen
+ len
+ 1;
1040 dict_insert(newdb
, strdup(key
), alloc_record_data_qstring(dest
));
1043 case RECDB_OBJECT
: {
1046 for (it
= dict_first(GET_RECORD_OBJECT(rd
)); it
; it
= iter_next(it
)) {
1047 const char *k2
, *end
;
1050 /* Evaluate the expression for this subentry. */
1052 end
= k2
+ strlen(k2
);
1053 res
= helpfile_eval_condition(k2
, &end
);
1054 /* If the evaluation failed, bail. */
1056 log_module(MAIN_LOG
, LOG_FATAL
, " .. while processing entry '%s' condition '%s'.", key
, k2
);
1059 /* If the condition was false, try another. */
1062 /* If we cannot unlistify the contents, bail. */
1063 if (unlistify_help(key
, iter_data(it
), extra
))
1067 /* If none of the conditions apply, just omit the entry. */
1076 open_helpfile(const char *fname
, expand_func_t expand
)
1078 struct helpfile
*hf
;
1080 dict_t db
= parse_database(fname
);
1081 hf
= calloc(1, sizeof(*hf
));
1082 hf
->expand
= expand
;
1083 hf
->db
= alloc_database();
1084 dict_set_free_keys(hf
->db
, free
);
1085 if ((slash
= strrchr(fname
, '/'))) {
1086 hf
->name
= strdup(slash
+ 1);
1088 hf
->name
= strdup(fname
);
1089 dict_insert(language_find("C")->helpfiles
, hf
->name
, hf
);
1092 dict_foreach(db
, unlistify_help
, hf
->db
);
1098 void close_helpfile(struct helpfile
*hf
)
1102 free((char*)hf
->name
);
1103 free_database(hf
->db
);
1107 void message_register_table(const struct message_entry
*table
)
1111 while (table
->msgid
) {
1112 dict_insert(lang_C
->messages
, table
->msgid
, (char*)table
->format
);
1117 void helpfile_init(void)
1119 message_register_table(msgtab
);
1120 language_read_list();
1123 void helpfile_finalize(void)
1126 for (it
= dict_first(languages
); it
; it
= iter_next(it
))
1127 language_read(iter_key(it
));
1128 reg_exit_func(language_cleanup
);