diff options
author | Brian Tarricone <brian@tarricone.org> | 2008-01-14 06:42:36 +0000 |
---|---|---|
committer | Brian Tarricone <brian@tarricone.org> | 2008-01-14 06:42:36 +0000 |
commit | 3b001926937bbe0a82644540bd1d3793e24a56f2 (patch) | |
tree | 66948b8511d78212702785e28dd34124dac6146a /docs | |
parent | 12e247bf8f5bbbfbe1d27748957c3d255b990f63 (diff) | |
download | xfconf-3b001926937bbe0a82644540bd1d3793e24a56f2.tar.gz |
update spec and docs
(Old svn revision: 26775)
Diffstat (limited to 'docs')
-rw-r--r-- | docs/spec/backend.txt | 17 | ||||
-rw-r--r-- | docs/spec/perchannel-xml.txt | 4 |
2 files changed, 8 insertions, 13 deletions
diff --git a/docs/spec/backend.txt b/docs/spec/backend.txt index 421d737..43353c1 100644 --- a/docs/spec/backend.txt +++ b/docs/spec/backend.txt @@ -17,7 +17,6 @@ semi-arbitrary types, as well as array types. So, the backend must, at minimum, be able to understand the following GTypes: G_TYPE_STRING -G_TYPE_STRV (special GType for a C array of G_TYPE_STRING) G_TYPE_UCHAR G_TYPE_CHAR XFCONF_TYPE_UINT16 @@ -31,13 +30,9 @@ G_TYPE_DOUBLE G_TYPE_BOOLEAN In addition, the backend must be able to handle arrays of arbitrary -types from the above list (with the exception of G_TYPE_STRV). A single -array may hold multiple values of the same type, or of different types. -Because of this, array types are received by the backend as GValueArrays. -The GType of each value in the array must be checked, of course, as the -array elements may be of different types. - -If the backend receives a G_TYPE_STRV value, it may treat it specially -in storage, or may simply store it as an array of G_TYPE_STRING values. -However, the backend should always return it to clients as G_TYPE_STRV, -not as a G_TYPE_VALUE_ARRAY of G_TYPE_STRING. +types from the above list. A single array may hold multiple values +of the same type, or of different types. Because of this, an array is +sent over the bus as a GValue which holds a GPtrArray which holds an +array of GValues (which of course hold the actual values). The GType +of each value in the array must be checked, of course, as the array +elements may be of different types. diff --git a/docs/spec/perchannel-xml.txt b/docs/spec/perchannel-xml.txt index 0374feb..1276a79 100644 --- a/docs/spec/perchannel-xml.txt +++ b/docs/spec/perchannel-xml.txt @@ -89,8 +89,8 @@ XfconfBackendPerchannelXml file format, version 1.0 /HappyApp/main/last-document /HappyApp/history - (These strings are what you'd look up if using libxfconf to retrieve - property values.) + (These strings, minus the channel name part at the beginning, are what + you'd look up if using libxfconf to retrieve property values.) -> Locking/Kiosk mode: |