source: gnome/platform/dconf.xml@ 7b2fed0f

11.0 11.1 11.2 11.3 12.0 12.1 12.2 gimp3 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/for-12.3 xry111/intltool xry111/llvm18 xry111/soup3 xry111/spidermonkey128 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 7b2fed0f was 7b2fed0f, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Tags
  • Property mode set to 100644
File size: 9.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7<!-- DConf -->
8 <!ENTITY dconf-download-http "&gnome-download-http;/dconf/0.40/dconf-&dconf-version;.tar.xz">
9 <!ENTITY dconf-download-ftp "&gnome-download-ftp;/dconf/0.40/dconf-&dconf-version;.tar.xz">
10 <!ENTITY dconf-md5sum "ac8db20b0d6b996d4bbbeb96463d01f0">
11 <!ENTITY dconf-size "115 KB">
12 <!ENTITY dconf-buildsize "7.0 MB (with tests)">
13 <!ENTITY dconf-time "0.1 SBU (with tests)">
14
15<!-- DConf-Editor -->
16 <!ENTITY dconf-editor-download-http "&gnome-download-http;/dconf-editor/&gnome-minor-38;/dconf-editor-&dconf-editor-version;.tar.xz">
17 <!ENTITY dconf-editor-download-ftp "&gnome-download-ftp;/dconf-editor/&gnome-minor-38;/dconf-editor-&dconf-editor-version;.tar.xz">
18 <!ENTITY dconf-editor-md5sum "06d64abca0673761cf320145e9977b9c">
19 <!ENTITY dconf-editor-size "584 KB">
20 <!ENTITY dconf-editor-buildsize "37 MB">
21 <!ENTITY dconf-editor-time "0.2 SBU">
22]>
23
24<sect1 id="dconf" xreflabel="DConf-&dconf-version;">
25 <?dbhtml filename="dconf.html"?>
26
27 <sect1info>
28 <date>$Date$</date>
29 </sect1info>
30
31 <title>DConf-&dconf-version; / DConf-Editor-&dconf-editor-version;</title>
32
33 <indexterm zone="dconf">
34 <primary sortas="a-DConf">DConf</primary>
35 </indexterm>
36
37<!-- DConf -->
38
39 <sect2 role="package">
40 <title>Introduction to DConf</title>
41
42 <para>
43 The <application>DConf</application> package contains a low-level
44 configuration system. Its main purpose is to provide a backend to
45 GSettings on platforms that don't already have configuration storage
46 systems.
47 </para>
48
49 <para>
50 The <application>DConf-Editor</application>, as the name suggests, is a
51 graphical editor for the <application>DConf</application> database.
52 Installation is optional, because <command>gsettings</command> from <xref
53 linkend="glib2"/> provides similar functionality on the commandline.
54 </para>
55
56 &lfs110a_checked;
57
58 <bridgehead renderas="sect3">Package Information</bridgehead>
59 <itemizedlist spacing="compact">
60 <listitem>
61 <para>
62 Download (HTTP): <ulink url="&dconf-download-http;"/>
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Download (FTP): <ulink url="&dconf-download-ftp;"/>
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Download MD5 sum: &dconf-md5sum;
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Download size: &dconf-size;
78 </para>
79 </listitem>
80 <listitem>
81 <para>
82 Estimated disk space required: &dconf-buildsize;
83 </para>
84 </listitem>
85 <listitem>
86 <para>
87 Estimated build time: &dconf-time;
88 </para>
89 </listitem>
90 </itemizedlist>
91
92 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
93 <itemizedlist spacing="compact">
94 <listitem>
95 <para>
96 Download (HTTP): <ulink url="&dconf-editor-download-http;"/>
97 </para>
98 </listitem>
99 <listitem>
100 <para>
101 Download (FTP): <ulink url="&dconf-editor-download-ftp;"/>
102 </para>
103 </listitem>
104 <listitem>
105 <para>
106 Download MD5 sum: &dconf-editor-md5sum;
107 </para>
108 </listitem>
109 <listitem>
110 <para>
111 Download size: &dconf-editor-size;
112 </para>
113 </listitem>
114 <listitem>
115 <para>
116 Estimated disk space required: &dconf-editor-buildsize;
117 </para>
118 </listitem>
119 <listitem>
120 <para>
121 Estimated build time: &dconf-editor-time;
122 </para>
123 </listitem>
124 </itemizedlist>
125
126 <!-- Applied in 3.38.3
127 <itemizedlist spacing="compact">
128 <listitem>
129 <para>
130 Required patch for dconf-editor:
131 <ulink url="&patch-root;/dconf-editor-&dconf-editor-version;-vala_fix-1.patch"/>
132 </para>
133 </listitem>
134 </itemizedlist>
135 -->
136
137 <bridgehead renderas="sect3">DConf Dependencies</bridgehead>
138
139 <bridgehead renderas="sect4">Required</bridgehead>
140 <para role="required">
141 <xref linkend="dbus"/>,
142 <xref linkend="glib2"/>,
143 <xref linkend="gtk3"/> (for the editor), and
144 <xref linkend="libxml2"/> (for the editor)
145 </para>
146
147 <bridgehead renderas="sect4">Recommended</bridgehead>
148 <para role="recommended">
149 <xref linkend="libxslt"/> and
150 <xref linkend="vala"/>
151 </para>
152
153 <bridgehead renderas="sect4">Optional</bridgehead>
154 <para role="optional">
155 <xref linkend="gtk-doc"/> and
156 <ulink url="https://github.com/scop/bash-completion">bash-completion</ulink>
157 </para>
158
159 <para condition="html" role="usernotes">User Notes:
160 <ulink url="&blfs-wiki;/dconf"/>
161 </para>
162 </sect2>
163
164 <sect2 role="installation">
165 <title>Installation of DConf</title>
166 <!-- No longer applicable with 0.36, but keep around in case of a revert.
167 <para>
168 First, fix a bug introduced by meson-0.52.0 and a test suite problem:
169 </para>
170
171<screen><userinput remap="pre">sed -i 's|link_whole|link_with|' client/meson.build &amp;&amp;
172sed -i 's/module/&amp; | grep -v mangle_path/' gsettings/abicheck.sh</userinput></screen>
173 -->
174
175 <para revision="sysv">
176 First, prevent unnecessary systemd units from being installed:
177 </para>
178
179<screen revision="sysv"><userinput remap="pre">sed -i 's/install_dir: systemd_userunitdir,//' service/meson.build</userinput></screen>
180
181 <para>
182 Install <application>DConf</application> by running the following
183 commands:
184 </para>
185
186<screen><userinput>mkdir build &amp;&amp;
187cd build &amp;&amp;
188
189meson --prefix=/usr --buildtype=release -Dbash_completion=false .. &amp;&amp;
190ninja</userinput></screen>
191
192 <para>
193 To test the results, issue: <command>ninja test</command>
194 </para>
195
196 <para>
197 As the <systemitem class="username">root</systemitem> user:
198 </para>
199
200<screen role="root"><userinput>ninja install</userinput></screen>
201
202 <para>
203 Now, optionally install the editor:
204 </para>
205
206<screen><userinput>cd .. &amp;&amp;
207tar -xf ../dconf-editor-&dconf-editor-version;.tar.xz &amp;&amp;
208cd dconf-editor-&dconf-editor-version; &amp;&amp;
209
210mkdir build &amp;&amp;
211cd build &amp;&amp;
212
213meson --prefix=/usr --buildtype=release .. &amp;&amp;
214ninja</userinput></screen>
215
216 <para>
217 As the <systemitem class="username">root</systemitem> user:
218 </para>
219
220<screen role="root"><userinput>ninja install</userinput></screen>
221
222 </sect2>
223
224 <sect2 role="commands">
225 <title>Command Explanations</title>
226
227 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
228 href="../../xincludes/meson-buildtype-release.xml"/>
229
230 <para>
231 <option>-Dgtk_doc=true</option>: Use this parameter if
232 <application>GTK-Doc</application> is installed and you wish to rebuild
233 and install the API documentation.
234 </para>
235
236 </sect2>
237
238 <sect2 role="content">
239 <title>Contents</title>
240
241 <segmentedlist>
242 <segtitle>Installed Programs</segtitle>
243 <segtitle>Installed Libraries</segtitle>
244 <segtitle>Installed Directories</segtitle>
245
246 <seglistitem>
247 <seg>
248 dconf and dconf-editor
249 </seg>
250 <seg>
251 <!--libdconf-dbus-1.so, -->
252 libdconf.so,
253 and libdconfsettings.so (GIO Module installed in
254 <filename class="directory">/usr/lib/gio/modules</filename>)
255 </seg>
256 <seg>
257 /usr/{include,share/gtk-doc/html}/dconf
258 <!-- and /usr/include/dconf-dbus-1 -->
259 </seg>
260 </seglistitem>
261 </segmentedlist>
262
263 <variablelist>
264 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
265 <?dbfo list-presentation="list"?>
266 <?dbhtml list-presentation="table"?>
267
268 <varlistentry id="dconf-prog">
269 <term><command>dconf</command></term>
270 <listitem>
271 <para>
272 is a simple tool for manipulating the
273 <application>DConf</application> database
274 </para>
275 <indexterm zone="dconf dconf-prog">
276 <primary sortas="b-dconf">dconf</primary>
277 </indexterm>
278 </listitem>
279 </varlistentry>
280
281 <varlistentry id="dconf-editor">
282 <term><command>dconf-editor</command></term>
283 <listitem>
284 <para>
285 is a graphical program for editing the
286 <application>DConf</application> database
287 </para>
288 <indexterm zone="dconf dconf-editor">
289 <primary sortas="b-dconf-editor">dconf-editor</primary>
290 </indexterm>
291 </listitem>
292 </varlistentry>
293
294 <varlistentry id="libdconf">
295 <term><filename class="libraryfile">libdconf.so</filename></term>
296 <listitem>
297 <para>
298 contains the <application>DConf</application> client API functions
299 </para>
300 <indexterm zone="dconf libdconf">
301 <primary sortas="c-libdconf">libdconf.so</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305 <!--
306 <varlistentry id="libdconf-dbus-1">
307 <term><filename class="libraryfile">libdconf-dbus-1.so</filename></term>
308 <listitem>
309 <para>
310 contains the <application>DConf</application> client API functions
311 for <application>D-Bus</application>.
312 </para>
313 <indexterm zone="dconf libdconf-dbus-1">
314 <primary sortas="c-libdconf-dbus-1">libdconf-dbus-1.so</primary>
315 </indexterm>
316 </listitem>
317 </varlistentry>
318 -->
319 </variablelist>
320
321 </sect2>
322
323</sect1>
Note: See TracBrowser for help on using the repository browser.