Configuration Metadata¶
Each configuration schema has its own set of metadata, in addition to the
metadata associated with each configuration option. There are three kinds of
schema metadata: Common, backend-specific, and custom metadata. Common metadata
is comprised of pre-defined keys not specific to a backend, and do not have a
common prefix. Backend-specific metadata is comprised of pre-defined keys with
a common prefix: the name property of the backend. Custom metadata follows the
convention of message headers [1] and desktop file keys [2], in that they MUST
begin with the prefix X-
.
Here is the list of common metadata keys:
single_instance
- Asserts that there can only be one instance of the configuration (defaults to true). If this value is false, then multiple instances of configuration options can be governed by the schema.
Here is the list of backend-specific metadata keys:
GConf.base_path
- The base path for the configuration options. The configuration options will
reside in
${base_path}/${app_name}
. This defaults to/apps
. GConf.base_instance_path
- The base path for the configuration data for multiple instances that are
governed by the schema. Defaults to
${base_path}/instances
. The configuration options will reside in${base_instance_path}/${app_name}/${instance_id}
. If this key exists whensingle_instance
is true, a warning will be issued. The placeholder${base_path}
and will be replaced with the proper variable value.
All of this metadata is stored in the group DEFAULT
. Here is an example of
what that section might look like:
[DEFAULT]
single_instance = false
GConf.base_path = /non/standard-prefix
[1] | RFC 822, Section 4.7.5 |
[2] | Desktop Entry Specification: Extending the format |