Bug#519096: gconf2: missing documentation about NN_package vs NN_package.entries (xml)

[sean finney]

Package: gconf2
Version: 2.24.0-7
Severity: minor
Tags: patch

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

hi,

i'm packaging a custom config package for standard-client type environment,
and ran into a bit of confusion here.  the attached patch might help clarify
for the next person who comes along :)

note also i found a seperate error further up in the documentation that
referred to NNpackage instead of NN_package, which is also fixed in this
patch.


	sean

- -- System Information:
Debian Release: squeeze/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'stable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.26-1-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_US.utf8, LC_CTYPE=en_US.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash

Versions of packages gconf2 depends on:
ii  dbus-x11                    1.2.12-1     simple interprocess messaging syst
ii  gconf2-common               2.24.0-7     GNOME configuration database syste
ii  libc6                       2.9-4        GNU C Library: Shared libraries
ii  libgconf2-4                 2.24.0-7     GNOME configuration database syste
ii  libglib2.0-0                2.18.4-2     The GLib library of C routines
ii  libxml2                     2.7.3.dfsg-1 GNOME XML library
ii  psmisc                      22.6-1       Utilities that use the proc filesy
ii  python                      2.5.4-2      An interactive high-level object-o

Versions of packages gconf2 recommends:
ii  libgtk2.0-0                   2.14.7-4   The GTK+ graphical user interface 

Versions of packages gconf2 suggests:
pn  gconf-defaults-service        <none>     (no description available)

- -- no debconf information

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)

iD8DBQFJtlpDynjLPm522B0RAqEzAJ0TXSsz0Q2lNPqEH28dg8/OxkFSGQCfclIk
FhEGT7GXpM+eGYMK3PCWMlY=
=lqrY
-----END PGP SIGNATURE-----
-------------- next part --------------
--- README.Debian.orig	2009-03-10 13:06:48.000000000 +0100
+++ README.Debian	2009-03-10 13:14:12.000000000 +0100
@@ -22,7 +22,7 @@
 
 * /var/lib/gconf/debian.defaults/
   This directory contains some defaults provided by Debian, CDD or local
-  packages. Packages can ship files of the form NNpackage, larger NN
+  packages. Packages can ship files of the form NN_package, larger NN
   values meaning larger priorities, in /usr/share/gconf/defaults/,
   before launching update-gconf-defaults. Debian packages themselves use
   01, CDD distributions are encouraged to use values larger than 10, and
@@ -35,6 +35,14 @@
   schemas that lie in /usr/share/gconf/schemas. This is done by the
   gconf-schemas script in the package's post-installation script.
 
+* /usr/share/gconf/defaults and /usr/share/gconf/mandatory
+  This directory contains respectively default and mandatory settings
+  as shipped by locally installed packages, which are updated via
+  update-gconf-defaults.  The file format can follow one of two formats,
+  which is determined based on the naming pattern:
+  * NN_package: simple key/value pairings
+  * NN_package.entries: standard gconftool -R format xml dump
+
 All system directories use a %gconf-tree.xml file containing the whole
 structure, for performance reasons. The upgrade from the previous
 situation (tree of %gconf.xml files) is done in gconf2 2.12.1-5.