4 * Handling message files
6 * © 1994-1998 Straylight
9 /*----- Licensing note ----------------------------------------------------*
11 * This file is part of Straylight's Steel library.
13 * Steel is free software; you can redistribute it and/or modify
14 * it under the terms of the GNU General Public License as published by
15 * the Free Software Foundation; either version 2, or (at your option)
18 * Steel is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU General Public License for more details.
23 * You should have received a copy of the GNU General Public License
24 * along with Steel. If not, write to the Free Software Foundation,
25 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
31 /*----- Implementation limits ---------------------------------------------*
33 * These limits are not enforced. Woe betides anyone who oversteps them.
36 #define msgs_TAG_MAX 20
37 #define msgs_MSG_MAX 1024
38 #define msgs_VARIANT_MAX 10
40 /*----- Functions ---------------------------------------------------------*/
43 * void msgs_init(void)
46 * Loads the messages file `Messages' using msgs_readfile.
52 * void msgs_readfile(char *name)
55 * Merges the file named into the current messages. Duplicates are likely
56 * to cause problems, so try to avoid them. The file is found using the
57 * res_findname mechanism.
60 * char *name == pointer to the name of the messages file
63 void msgs_readfile(char *name);
66 * char *msgs_lookup(char *tag)
69 * Looks up a message given its tag. The tag may optionally be followed by
70 * a default string, which is returned if the message is not found. If no
71 * default is supplied, and the message tag is not found, the tag is
75 * char *tag == pointer to tag string to find
78 char *msgs_lookup(char *tag);
81 * void msgs_delete(void)
84 * Removes all messages from memory.
87 void msgs_delete(void);