X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/d54cf7ff131b62cc83116d5bfb8d2b5c49de9574..2e18fe7139558b3cb592a04a4e4668319a966ebf:/docs/doxygen/overviews/config.h diff --git a/docs/doxygen/overviews/config.h b/docs/doxygen/overviews/config.h index 656e538796..d7f1d34cd6 100644 --- a/docs/doxygen/overviews/config.h +++ b/docs/doxygen/overviews/config.h @@ -3,60 +3,60 @@ // Purpose: topic overview // Author: wxWidgets team // RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// -/*! +/** - @page overview_config wxConfig classes overview +@page overview_config wxConfig Overview - Classes: #wxConfig +Classes: wxConfigBase - This overview briefly describes what the config classes are and what they are - for. All the details about how to use them may be found in the description of - the #wxConfigBase class and the documentation of the - file, registry and INI file based implementations mentions all the - features/limitations specific to each one of these versions. +This overview briefly describes what the config classes are and what they are +for. All the details about how to use them may be found in the description of +the wxConfigBase class and the documentation of the file, registry and INI file +based implementations mentions all the features/limitations specific to each +one of these versions. - The config classes provide a way to store some application configuration - information. They were especially designed for this usage and, although may - probably be used for many other things as well, should be limited to it. It - means that this information should be: +The config classes provide a way to store some application configuration +information. They were especially designed for this usage and, although may +probably be used for many other things as well, should be limited to it. It +means that this information should be: - @li Typed, i.e. strings or numbers for the moment. - You can not store binary data, for example. - @li Small. For instance, it is not recommended to use the Windows - registry for amounts of data more than a couple of kilobytes. - @li Not performance critical, neither from speed nor from a memory - consumption point of view. +@li Typed, i.e. strings or numbers for the moment. You cannot store binary + data, for example. +@li Small. For instance, it is not recommended to use the Windows registry for + amounts of data more than a couple of kilobytes. +@li Not performance critical, neither from speed nor from a memory consumption + point of view. - On the other hand, the features provided make them very useful for storing all - kinds of small to medium volumes of hierarchically-organized, heterogeneous - data. In short, this is a place where you can conveniently stuff all your data - (numbers and strings) organizing it in a tree where you use the - filesystem-like paths to specify the location of a piece of data. In - particular, these classes were designed to be as easy to use as possible. +On the other hand, the features provided make them very useful for storing all +kinds of small to medium volumes of hierarchically-organized, heterogeneous +data. In short, this is a place where you can conveniently stuff all your data +(numbers and strings) organizing it in a tree where you use the filesystem-like +paths to specify the location of a piece of data. In particular, these classes +were designed to be as easy to use as possible. - From another point of view, they provide an interface which hides the - differences between the Windows registry and the standard Unix text format - configuration files. Other (future) implementations of wxConfigBase might also - understand GTK resource files or their analogues on the KDE side. +From another point of view, they provide an interface which hides the +differences between the Windows registry and the standard Unix text format +configuration files. Other (future) implementations of wxConfigBase might also +understand GTK resource files or their analogues on the KDE side. - In any case, each implementation of wxConfigBase does its best to - make the data look the same way everywhere. Due to limitations of the underlying - physical storage, it may not implement 100% of the base class functionality. +In any case, each implementation of wxConfigBase does its best to make the data +look the same way everywhere. Due to limitations of the underlying physical +storage, it may not implement 100% of the base class functionality. - There are groups of entries and the entries themselves. Each entry contains either - a string or a number (or a boolean value; support for other types of data such as - dates or timestamps is planned) and is identified by the full path to it: something - like /MyApp/UserPreferences/Colors/Foreground. +There are groups of entries and the entries themselves. Each entry contains +either a string or a number (or a boolean value; support for other types of +data such as dates or timestamps is planned) and is identified by the full path +to it: something like @c /MyApp/UserPreferences/Colors/Foreground. - The previous elements in the path are the group names, and each name may - contain an arbitrary number of entries and subgroups. +The previous elements in the path are the group names, and each name may +contain an arbitrary number of entries and subgroups. - The path components are @b always separated with a slash, - even though some implementations use the backslash internally. Further - details (including how to read/write these entries) may be found in - the documentation for #wxConfigBase. +The path components are @e always separated with a slash, even though some +implementations use the backslash internally. Further details (including how to +read/write these entries) may be found in the documentation for wxConfigBase. */ +