Copyright
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library 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 Library General Public License for more details.

You should have received a copy of the GNU Library General Public License along with this library; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

These classes support easy to use management of configuration settings. On Unix systems these settings get written to configuration files, of the type used by Windows (.INI) and KDE (.lnk). On Win32 systems (Windows NT or 95), the settings get written to the registry database.
Therefor AppConfig provides a consistent API for configuration management across both platforms. The API is defined by the BaseConfig virtual base class and two implemenations, FileConfig and RegistryConfig are derived from this. Nevertheless, you can also use FileConfig under Windows if you need it for some special purpose.

The class AppConfig is defined which is the 'native' implementation on each platform.

Also, if the gettext() library function is available (use -lintl on Unix systems), AppConfig can be compiled with -DAPPCONF_USE_GETTEXT=1 to support multiple languages in its error messages. Precompiled message catalogues for German and French are included, copy them to the appropriate directories under Unix (e.g. /usr/share/locale/fr/LC_MESSAGES/appconf.mo or /usr/share/locale/de/LC_MESSAGES/appconf.mo).

Two simple programs demonstrating the use of AppConfig are included.

Full documentation of the classes is included in HTML format in the doc directory. Please use your web browser to view it.
The LaTeX documentation appconf.tex in the same directory contains a few errors (because it was auto-generated with doc++), but is usable. Just keep pressing Enter when LaTeX complains. An A4 PostScript version is also included.

Feel free to contact us with any questions or suggestions. If you use it in your programs, we would be pleased to hear about it.

Author:

Karsten Ballüder and Vadim Zeitlin