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

trunk
Last change on this file was 2f2bfbd, checked in by Pierre Labastie <pierre.labastie@…>, 7 days ago

Fixes for building with meson 0.61+

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