Add g_settings_schema_key_get_summary/description
authorRyan Lortie <desrt@desrt.ca>
Sat, 26 Oct 2013 22:57:55 +0000 (18:57 -0400)
committerRyan Lortie <desrt@desrt.ca>
Sun, 27 Oct 2013 17:42:55 +0000 (10:42 -0700)
commit96a053e025f4b5a7286844df3d691ebb508953ab
treea9e387770f6ee221c98dcd5ddd232f1399a3f2d5
parent84fa07aeb1e3e41deac3508231712967366abfbd
Add g_settings_schema_key_get_summary/description

Add an API to read the summary and description from the .xml schema
files.

This will be used by dconf-editor and gnome-tweak-tool.

This API is a bit heavy -- it parses the XML and builds a table.  It
also loads gettext domains for translation.  It only does these things
if it is used, however, so it will not impact normal applications.

We store the summary/description in a pair of hash tables on the schema
source (which we have a backref to as of a few commits ago).  We can't
use a global table because people might want to request summary and
description from non-default sources.  We don't want to use per-schema
tables because we'd have to reparse the directory every time (since we
cannot guess which file a schema may have been in).

https://bugzilla.gnome.org/show_bug.cgi?id=668232
docs/reference/gio/gio-sections.txt
gio/gsettingsschema.c
gio/gsettingsschema.h