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

11.0 qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 7e16b7ab was 7e16b7ab, checked in by Pierre Labastie <pieere@…>, 6 months ago

Patch dconf-editor so that it builds with vala-0.50.4

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24380 af4574ff-66df-0310-9fd7-8a98e5e911e0

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