source: gnome/platform/dconf.xml@ 5c9d6e2c

11.3 12.0 12.1 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 xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 5c9d6e2c was 3f2db3a6, checked in by Pierre Labastie <pierre.labastie@…>, 19 months ago

Remove sect1info tags

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