'\" t
.\"     Title: gsettings-data-convert
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/>
.\"      Date: 01/21/2013
.\"    Manual: User Commands
.\"    Source: User Commands
.\"  Language: English
.\"
.TH "GSETTINGS\-DATA\-CON" "1" "01/21/2013" "User Commands" "User Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
gsettings-data-convert \- GConf to GSettings data migration
.SH "SYNOPSIS"
.HP \w'\fBgsettings\-data\-convert\fR\ 'u
\fBgsettings\-data\-convert\fR [option...]
.SH "DESCRIPTION"
.PP

\fBgsettings\-data\-convert\fR
reads values out of the users GConf database and stores them in GSettings\&.
.PP
The information about the mapping from GConf keys to GSettings keys is taken from files in
/usr/share/GConf/gsettings\&. Each file in that directory is read as a key file, with sections for each GSettings schema that is being converted\&. The entries in each section map GSettings keys to paths in the GConf database\&. Currently,
\fBgsettings\-data\-convert\fR
supports all basic GConf types as well as lists of strings and lists of integers\&.
.PP
A simple example might look like this:
.sp
.if n \{\
.RS 4
.\}
.nf
[org\&.gnome\&.fonts]
antialiasing = /desktop/gnome/font_rendering/antialiasing
dpi = /desktop/gnome/font_rendering/dpi
hinting = /desktop/gnome/font_rendering/hinting
rgba_order = /desktop/gnome/font_rendering/rgba_order
.fi
.if n \{\
.RE
.\}
.PP
If the GSettings schema does not have a fixed path, you must specify the path in the group name, separated by a colon character:
.sp
.if n \{\
.RS 4
.\}
.nf
[org\&.gnome\&.fonts:/desktop/gnome/font\-rendering/]
.fi
.if n \{\
.RE
.\}
.PP

\fBgsettings\-data\-convert\fR
keeps a list of the key files it has already converted, so it is safe to run it repeatedly to handle newly appeared key files\&. The expected use of this utility is to make each application install a key file for the GConf keys that it wants to be migrated, and run
\fBgsettings\-data\-convert\fR
every time a user logs in\&.
.SS "Options"
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Print help and exit
.RE
.PP
\fB\-\-dry\-run\fR
.RS 4
Do not make any changes, just report what would be done
.RE
.PP
\fB\-\-verbose\fR
.RS 4
Show verbose messages
.RE
.SH "SEE ALSO"
.PP

\fBgsettings-schema-convert\fR(1)
is a related command that helps with the conversion of schemas from GConf to GSettings\&.