glfs/gnome/platform/gnome-settings-daemon.xml
Xi Ruoyao 45ab6c70c2
more SVN prop clean up
Remove "$LastChanged$" everywhere, and also some unused $Date$
2021-04-20 19:12:02 +08:00

247 lines
7.9 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY gnome-settings-daemon-download-http
"&gnome-download-http;/gnome-settings-daemon/&gnome-40;/gnome-settings-daemon-&gnome-settings-daemon-version;.tar.xz">
<!ENTITY gnome-settings-daemon-download-ftp
"&gnome-download-ftp;/gnome-settings-daemon/&gnome-40;/gnome-settings-daemon-&gnome-settings-daemon-version;.tar.xz">
<!ENTITY gnome-settings-daemon-md5sum "9866c0995b0d74ed168198e5af421e7b">
<!ENTITY gnome-settings-daemon-size "1.4 MB">
<!ENTITY gnome-settings-daemon-buildsize "48 MB">
<!ENTITY gnome-settings-daemon-time "1.0 SBU (Using parallelism=4)">
]>
<sect1 id="gnome-settings-daemon" xreflabel="gnome-settings-daemon-&gnome-settings-daemon-version;">
<?dbhtml filename="gnome-settings-daemon.html"?>
<sect1info>
<date>$Date$</date>
</sect1info>
<title>gnome-settings-daemon-&gnome-settings-daemon-version;</title>
<indexterm zone="gnome-settings-daemon">
<primary sortas="a-gnome-settings-daemon">gnome-settings-daemon</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to GNOME Settings Daemon</title>
<para>
The <application>GNOME Settings Daemon</application> is responsible
for setting various parameters of a <application>GNOME Session</application>
and the applications that run under it.
</para>
&lfs101_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&gnome-settings-daemon-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&gnome-settings-daemon-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &gnome-settings-daemon-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &gnome-settings-daemon-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &gnome-settings-daemon-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &gnome-settings-daemon-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">GNOME Settings Daemon Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="colord"/>,
<xref linkend="fontconfig"/>,
<xref linkend="gcr"/>,
<xref linkend="geoclue2"/>,
<xref linkend="geocode-glib"/>,
<xref linkend="gnome-desktop"/>,
<xref linkend="lcms2"/>,
<xref linkend="libcanberra"/>,
<xref linkend="libgweather"/>,
<xref linkend="libnotify"/>,
<xref linkend="librsvg"/>,
<xref linkend="libwacom"/>,
<xref linkend="pulseaudio"/>,
<phrase revision="sysv"><xref linkend="elogind"/>,</phrase>
<phrase revision="systemd"><xref linkend="systemd"/>,</phrase>
<xref linkend="upower"/>, and
<xref linkend="xorg-wacom-driver"/>
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="alsa"/>,
<xref linkend="cups"/>,
<xref linkend="NetworkManager"/>,
<xref linkend="nss"/>, and
<xref linkend="wayland"/>
</para>
<note>
<para>
Recommended dependencies are not strictly required for
this package to build and function, but you may not get
expected results at runtime if you don't install them.
</para>
</note>
<bridgehead renderas="sect4"
revision="sysv">Recommended (Runtime)</bridgehead>
<para role="recommended" revision="sysv">
<xref linkend="blocaled" role="runtime"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="mutter"/>,
<xref linkend="python-dbusmock"/>, and
<xref linkend="umockdev"/>
</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gnome-settings-daemon"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of GNOME Settings Daemon</title>
<para revision="sysv">
First, fix libelogind detection for tests:
</para>
<screen revision="sysv"><userinput>sed -e 's/libsystemd/libelogind/' \
-i plugins/power/test.py</userinput></screen>
<para revision="sysv">
Next, fix backlight functionality in gnome-control-center:
</para>
<screen revision="sysv"><userinput>sed -e 's/(backlight->logind_proxy)/(0)/' \
-i plugins/power/gsd-backlight.c</userinput></screen>
<para revision="systemd">
First, remove older versions of the systemd units:
</para>
<screen revision="systemd" role="root"><userinput remap="pre">rm -v /usr/lib/systemd/user/gsd-*</userinput></screen>
<para>
Install <application>GNOME Settings Daemon</application> by running the
following commands:
</para>
<screen revision='sysv'><userinput>mkdir build &amp;&amp;
cd build &amp;&amp;
meson --prefix=/usr -Dsystemd=false .. &amp;&amp;
ninja</userinput></screen>
<screen revision='systemd'><userinput>mkdir build &amp;&amp;
cd build &amp;&amp;
meson --prefix=/usr .. &amp;&amp;
ninja</userinput></screen>
<!-- [renodr, June 29th, 2019]: for some reason, on elogind, all tests
passed. 8 failed on systemd. It could be kernel configuration, or
any other package change. umockdev might be needed, but it works
fine without it on elogind.
[pierre, July 31st, 2020]: only one test passed on elogind. I
have umockdev, but it does not look like it is used. Adding the
sed allows 9 tests out of 10 to pass. -->
<para>
To check the results, execute: <command>ninja test</command>. Note that
you must have <application>python-dbusmock</application> installed in
order for the tests to complete successfully. Some tests
may fail depending on the init system in use.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>ninja install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
None
</seg>
<seg>
libgsd.so
</seg>
<seg>
/etc/xdg/Xwayland-session.d,
/usr/include/gnome-settings-daemon-40,
/usr/lib/gnome-settings-daemon-40, and
/usr/share/gnome-settings-daemon
</seg>
</seglistitem>
</segmentedlist>
<!-- For version 3.34, there is nothing in /usr/bin but there are a lot
of support programs in /usr/libexec. In NEWS:
Removed daemon, everything is now implemented in mutter
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="gnome-settings-daemon-prog">
<term><command>gnome-settings-daemon</command></term>
<listitem>
<para>
is responsible for setting the various preference parameters of
a <application>GNOME</application> session and the applications
that run under it.
</para>
<indexterm zone="gnome-settings-daemon gnome-settings-daemon-prog">
<primary sortas="b-gnome-settings-daemon">gnome-settings-daemon</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
-->
</sect2>
</sect1>