$client->set_schema($key, { owner => 'some_program', short_desc => 'Some key.', long_desc => 'A key that does something to some_program.', locale => 'C', type => 'int', default_value => { type => 'int', value => 42 } }); $description{'short'} = $client->get_schema($key)->{short_desc};
In C, GConfSchema is an opaque type for a "schema", that is a collection of useful informations about a key/value pair. It may contain a description of the key, a default value, the program which owns the key, etc.
GConfSchema
In perl, it is represented using an hashref containing any of these keys:
The type of the value the key points to. It's similar to the corresponding 'type' key of GConfValue, but it explicitly tags lists and pairs using the 'list' and 'pair' types (the 'type' key is just an indication of what should be expected inside the default_value field).
GConfValue
default_value
The default value of the key. In C, this should be a GConfValue, so, in perl, it becomes an hashref (see Gnome2::GConf::Value)
A string containing a short description (a phrase, no more) of the key.
A string containing a longer description (a paragraph or more) of the key.
A string containing the name of the program which uses ('owns') the key to which the schema is bound.
The locale for the three strings above (above strings are UTF-8, and the locale is needed for translations purposes).
Gnome2::GConf(3pm), Gnome2::GConf::Value(3pm).
To install Gnome2::GConf, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Gnome2::GConf
CPAN shell
perl -MCPAN -e shell install Gnome2::GConf
For more information on module installation, please visit the detailed CPAN module installation guide.