source: gnome/platform/gnome-settings-daemon.xml

trunk
Last change on this file was 7ef053d, checked in by Douglas R. Reno <renodr@…>, 5 weeks ago

Update to gnome-settings-daemon-43.0.

  • Property mode set to 100644
File size: 8.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 <!ENTITY gnome-settings-daemon-download-http
8 "&gnome-download-http;/gnome-settings-daemon/&gnome-43;/gnome-settings-daemon-&gnome-settings-daemon-version;.tar.xz">
9 <!ENTITY gnome-settings-daemon-download-ftp
10 "&gnome-download-ftp;/gnome-settings-daemon/&gnome-43;/gnome-settings-daemon-&gnome-settings-daemon-version;.tar.xz">
11 <!ENTITY gnome-settings-daemon-md5sum "eea402f0a87aea7f4d8428af3917fb0c">
12 <!ENTITY gnome-settings-daemon-size "1.4 MB">
13 <!ENTITY gnome-settings-daemon-buildsize "45 MB">
14 <!ENTITY gnome-settings-daemon-time "0.1 SBU (Using parallelism=4)">
15]>
16
17<sect1 id="gnome-settings-daemon" xreflabel="gnome-settings-daemon-&gnome-settings-daemon-version;">
18 <?dbhtml filename="gnome-settings-daemon.html"?>
19
20
21 <title>gnome-settings-daemon-&gnome-settings-daemon-version;</title>
22
23 <indexterm zone="gnome-settings-daemon">
24 <primary sortas="a-gnome-settings-daemon">gnome-settings-daemon</primary>
25 </indexterm>
26
27 <sect2 role="package">
28 <title>Introduction to GNOME Settings Daemon</title>
29
30 <para>
31 The <application>GNOME Settings Daemon</application> is responsible
32 for setting various parameters of a <application>GNOME Session</application>
33 and the applications that run under it.
34 </para>
35
36 &lfs112_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>
42 Download (HTTP): <ulink url="&gnome-settings-daemon-download-http;"/>
43 </para>
44 </listitem>
45 <listitem>
46 <para>
47 Download (FTP): <ulink url="&gnome-settings-daemon-download-ftp;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download MD5 sum: &gnome-settings-daemon-md5sum;
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download size: &gnome-settings-daemon-size;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Estimated disk space required: &gnome-settings-daemon-buildsize;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated build time: &gnome-settings-daemon-time;
68 </para>
69 </listitem>
70 </itemizedlist>
71
72 <bridgehead renderas="sect3">GNOME Settings Daemon Dependencies</bridgehead>
73
74 <bridgehead renderas="sect4">Required</bridgehead>
75 <para role="required">
76 <xref linkend="alsa-lib"/>,
77 <xref linkend="colord"/>,
78 <xref linkend="fontconfig"/>,
79 <xref linkend="gcr4"/>,
80 <xref linkend="geoclue2"/>,
81 <xref linkend="geocode-glib"/>,
82 <xref linkend="gnome-desktop"/>,
83 <xref linkend="lcms2"/>,
84 <xref linkend="libcanberra"/>,
85 <xref linkend="libgweather"/>,
86 <xref linkend="libnotify"/>,
87 <xref linkend="libwacom"/>,
88 <xref linkend="pulseaudio"/>,
89 <phrase revision="sysv"><xref linkend="elogind"/>,</phrase>
90 <phrase revision="systemd"><xref linkend="systemd"/>,</phrase>
91 and <xref linkend="upower"/>
92 </para>
93
94 <bridgehead renderas="sect4">Recommended</bridgehead>
95 <para role="recommended">
96 <xref linkend="alsa"/>,
97 <xref linkend="cups"/>,
98 <xref linkend="NetworkManager"/>,
99 <xref linkend="nss"/>, and
100 <xref linkend="wayland"/>
101 </para>
102
103 <note>
104 <para>
105 Recommended dependencies are not strictly required for
106 this package to build and function, but you may not get
107 expected results at runtime if you don't install them.
108 </para>
109 </note>
110
111 <bridgehead renderas="sect4"
112 revision="sysv">Recommended (Runtime)</bridgehead>
113 <para role="recommended" revision="sysv">
114 <xref linkend="blocaled" role="runtime"/>
115 </para>
116
117 <bridgehead renderas="sect4">Optional</bridgehead>
118 <para role="optional">
119 <xref linkend="gnome-session"/>,
120 <xref linkend="mutter"/>,
121 <xref linkend="python-dbusmock"/>,
122 <xref linkend="umockdev"/>, and
123 <command>Xvfb</command> (for tests, from
124 <xref linkend="xorg-server"/> or
125 <xref role="nodep" linkend="xwayland"/>)
126 </para>
127
128 <para condition="html" role="usernotes">User Notes:
129 <ulink url="&blfs-wiki;/gnome-settings-daemon"/>
130 </para>
131 </sect2>
132
133 <sect2 role="installation">
134 <title>Installation of GNOME Settings Daemon</title>
135
136<!--
137 <para>
138 First, fix building with recent versions of
139 <application>meson</application>:
140 </para>
141
142<screen><userinput>sed "/ policy,/d" -i plugins/{power,wacom}/meson.build</userinput></screen>
143-->
144
145 <para revision="sysv">
146 Next, fix libelogind detection for tests:
147 </para>
148
149<screen revision="sysv"><userinput>sed -e 's/libsystemd/libelogind/' \
150 -i plugins/power/test.py</userinput></screen>
151
152 <para revision="sysv">
153 Next, fix backlight functionality in gnome-control-center:
154 </para>
155
156<screen revision="sysv"><userinput>sed -e 's/(backlight->logind_proxy)/(0)/' \
157 -i plugins/power/gsd-backlight.c</userinput></screen>
158
159 <para>
160 Install <application>GNOME Settings Daemon</application> by running the
161 following commands:
162 </para>
163
164<screen revision='sysv'><userinput>mkdir build &amp;&amp;
165cd build &amp;&amp;
166
167meson --prefix=/usr --buildtype=release -Dsystemd=false .. &amp;&amp;
168ninja</userinput></screen>
169
170<screen revision='systemd'><userinput>mkdir build &amp;&amp;
171cd build &amp;&amp;
172
173meson --prefix=/usr --buildtype=release .. &amp;&amp;
174ninja</userinput></screen>
175
176 <!-- [renodr, June 29th, 2019]: for some reason, on elogind, all tests
177 passed. 8 failed on systemd. It could be kernel configuration, or
178 any other package change. umockdev might be needed, but it works
179 fine without it on elogind.
180 [pierre, July 31st, 2020]: only one test passed on elogind. I
181 have umockdev, but it does not look like it is used. Adding the
182 sed allows 9 tests out of 10 to pass. -->
183 <para>
184 To check the results, execute: <command>ninja test</command>. Note that
185 you must have <application>python-dbusmock</application> installed in
186 order for the tests to complete successfully. Some tests
187 may fail depending on the init system in use.
188 </para>
189
190 <para>
191 Now, as the <systemitem class="username">root</systemitem> user:
192 </para>
193
194<screen role="root"><userinput>ninja install</userinput></screen>
195
196 </sect2>
197
198 <sect2 role="commands">
199 <title>Command Explanations</title>
200
201 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
202 href="../../xincludes/meson-buildtype-release.xml"/>
203
204 </sect2>
205
206 <sect2 role="content">
207 <title>Contents</title>
208
209 <segmentedlist>
210 <segtitle>Installed Programs</segtitle>
211 <segtitle>Installed Libraries</segtitle>
212 <segtitle>Installed Directories</segtitle>
213
214 <seglistitem>
215 <seg>
216 None
217 </seg>
218 <seg>
219 libgsd.so
220 </seg>
221 <seg>
222 /etc/xdg/Xwayland-session.d,
223 /usr/include/gnome-settings-daemon-43,
224 /usr/lib/gnome-settings-daemon-43, and
225 /usr/share/gnome-settings-daemon
226 </seg>
227 </seglistitem>
228 </segmentedlist>
229<!-- For version 3.34, there is nothing in /usr/bin but there are a lot
230 of support programs in /usr/libexec. In NEWS:
231
232 Removed daemon, everything is now implemented in mutter
233
234 <variablelist>
235 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
236 <?dbfo list-presentation="list"?>
237 <?dbhtml list-presentation="table"?>
238
239 <varlistentry id="gnome-settings-daemon-prog">
240 <term><command>gnome-settings-daemon</command></term>
241 <listitem>
242 <para>
243 is responsible for setting the various preference parameters of
244 a <application>GNOME</application> session and the applications
245 that run under it.
246 </para>
247 <indexterm zone="gnome-settings-daemon gnome-settings-daemon-prog">
248 <primary sortas="b-gnome-settings-daemon">gnome-settings-daemon</primary>
249 </indexterm>
250 </listitem>
251 </varlistentry>
252
253 </variablelist>
254-->
255 </sect2>
256
257</sect1>
Note: See TracBrowser for help on using the repository browser.