man pages: document the order of schema overrides
authorRyan Lortie <desrt@desrt.ca>
Sat, 17 Mar 2012 16:39:23 +0000 (12:39 -0400)
committerRyan Lortie <desrt@desrt.ca>
Sat, 17 Mar 2012 16:41:36 +0000 (12:41 -0400)
GSettings overrides are processed in such a way that
alphabetically-later files have precedence over earlier files (eg: 20_
will beat 10_).  Document that fact.

docs/reference/gio/glib-compile-schemas.xml

index 9055355..65236d4 100644 (file)
@@ -43,6 +43,13 @@ values are written in serialized GVariant form.
 Vendor ovrride files must have the filename extension
 <filename>.gschema.override</filename>.
 </para>
+<para>
+By convention, vendor override files begin with <filename>nn_</filename>
+where <filename>nn</filename> is a number from 00 to 99.  Higher
+numbered files have higher priority (eg: if the same override is made in
+a file numbered 10 and then again in a file numbered 20, the override
+from 20 will take precedence).
+</para>
 
 <refsect2><title>Options</title>
 <variablelist>