source: gnome/platform/mutter.xml@ 4cf64fb

11.0 qt5new trunk
Last change on this file since 4cf64fb was 4cf64fb, checked in by Xi Ruoyao <xry111@…>, 4 months ago

mutter: clean up dependencies

Remove gnome-desktop, libcanberra, libwacom, and upower, as they are
needed by gnome-settings-daemon anyway.

  • Property mode set to 100644
File size: 7.0 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 mutter-download-http "&gnome-download-http;/mutter/&gnome-40;/mutter-&mutter-version;.tar.xz">
8 <!ENTITY mutter-download-ftp "&gnome-download-ftp;/mutter/&gnome-40;/mutter-&mutter-version;.tar.xz">
9 <!ENTITY mutter-md5sum "84beb760caa91baad7838260593e488a">
10 <!ENTITY mutter-size "2.6 MB">
11 <!ENTITY mutter-buildsize "198 MB">
12 <!ENTITY mutter-time "1.0 SBU (Using parallelism=4)">
13]>
14
15<sect1 id="mutter" xreflabel="Mutter-&mutter-version;">
16 <?dbhtml filename="mutter.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>Mutter-&mutter-version;</title>
23
24 <indexterm zone="mutter">
25 <primary sortas="a-Mutter">Mutter</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to Mutter</title>
30
31 <para>
32 <application>Mutter</application> is the window manager for
33 <application>GNOME</application>. It is not invoked directly,
34 but from <application>GNOME Session</application> (on a
35 machine with a hardware accelerated video driver).
36 </para>
37
38 &lfs101_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&mutter-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&mutter-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &mutter-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &mutter-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &mutter-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &mutter-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73<!--
74 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
75 <itemizedlist spacing="compact">
76 <listitem>
77 <para>
78 Required patch:
79 <ulink url="&patch-root;/mutter-&mutter-version;-upstream_fixes-1.patch"/>
80 </para>
81 </listitem>
82 </itemizedlist>
83-->
84 <bridgehead renderas="sect3">Mutter Dependencies</bridgehead>
85
86 <bridgehead renderas="sect4">Required</bridgehead>
87 <para role="required">
88 <!-- now using internal shipped clutter and cogl copies -->
89 <!-- <xref linkend="clutter"/>, -->
90 <xref linkend="gnome-settings-daemon"/>,
91 <xref linkend="graphene"/>,
92 <xref linkend="libxkbcommon"/>,
93 <xref linkend="pipewire"/>, and
94 <xref linkend="zenity"/>
95 </para>
96
97 <bridgehead renderas="sect4">Recommended</bridgehead>
98 <para role="recommended">
99 <xref linkend="desktop-file-utils"/>,
100 <xref linkend="gobject-introspection"/>,
101 <xref linkend="startup-notification"/>, and
102 <xref linkend="sysprof"/>
103 </para>
104
105 <bridgehead renderas="sect4">Recommended (Required to
106 build the Wayland compositor)</bridgehead>
107 <para role="recommended">
108 <xref linkend="libinput"/>,
109 <xref linkend="wayland"/>,
110 <xref linkend="wayland-protocols"/>, and
111 <xref linkend="xorg-server"/> (with <command>Xwayland</command>).
112 Additionally, <xref linkend="gtk3"/> needs to be built with
113 <application>Wayland</application> support.
114 </para>
115
116 <bridgehead renderas="sect4"
117 revision="sysv">Recommended (Runtime)</bridgehead>
118 <para role="recommended" revision="sysv">
119 <xref linkend="blocaled" role="runtime"/>
120 </para>
121
122 <!-- NOTE: Mutter compiles git versions of COGL and Clutter for it's own
123 internal use. This is because the wayland support upstream isn't advanced
124 enough for the graphics stack used in Mutter. -->
125
126 <para condition="html" role="usernotes">User Notes:
127 <ulink url="&blfs-wiki;/mutter"/>
128 </para>
129
130 </sect2>
131
132 <sect2 role="installation">
133 <title>Installation of Mutter</title>
134
135<!--
136 <para>
137 First, fix a problem with the build system and bugs with wayland sessions:
138 </para>
139
140<screen><userinput remap="pre">patch -Np1 -i ../mutter-&mutter-version;-upstream_fixes-1.patch</userinput></screen>
141-->
142
143 <para>
144 First, fix a race condition that sometimes occurs due to meson dependency
145 ordering:
146 </para>
147
148<screen><userinput remap="pre">sed -i '/libmutter_dep = declare_dependency(/a sources: mutter_built_sources,' src/meson.build</userinput></screen>
149
150 <para>
151 Install <application>Mutter</application> by running the following
152 commands:
153 </para>
154
155<screen><userinput>mkdir build &amp;&amp;
156cd build &amp;&amp;
157
158meson --prefix=/usr .. &amp;&amp;
159ninja</userinput></screen>
160
161 <para>
162 To test the results, issue:
163 <command>dbus-run-session ninja test</command>. The tests
164 require an active X session to run correctly. It is not necessary to
165 run a separate D-bus session if not in a GNOME session, but it
166 provides a clean environment in any case. One test,
167 <filename>native-headless</filename>, is known to fail.
168 </para>
169
170 <para>
171 Now, as the <systemitem class="username">root</systemitem> user:
172 </para>
173
174<screen role="root"><userinput>ninja install</userinput></screen>
175
176 </sect2>
177
178 <sect2 role="content">
179 <title>Contents</title>
180
181 <segmentedlist>
182 <segtitle>Installed Programs</segtitle>
183 <segtitle>Installed Libraries</segtitle>
184 <segtitle>Installed Directories</segtitle>
185
186 <seglistitem>
187 <seg>
188 mutter
189 </seg>
190 <seg>
191 libmutter-8.so
192 </seg>
193 <seg>
194 /usr/{lib,include,libexec/installed-tests,share/{installed-tests}}/mutter-8
195 </seg>
196 </seglistitem>
197 </segmentedlist>
198
199 <variablelist>
200 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
201 <?dbfo list-presentation="list"?>
202 <?dbhtml list-presentation="table"?>
203
204 <varlistentry id="mutter-prog">
205 <term><command>mutter</command></term>
206 <listitem>
207 <para>
208 is a <application>Clutter</application> based compositing
209 <application>GTK+</application> Window Manager
210 </para>
211 <indexterm zone="mutter mutter-prog">
212 <primary sortas="b-mutter">mutter</primary>
213 </indexterm>
214 </listitem>
215 </varlistentry>
216
217 <varlistentry id="libmutter">
218 <term><filename class="libraryfile">libmutter-8.so</filename></term>
219 <listitem>
220 <para>
221 contains the <application>Mutter</application> API functions
222 </para>
223 <indexterm zone="mutter libmutter">
224 <primary sortas="c-libmutter">libmutter-8.so</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 </variablelist>
230
231 </sect2>
232
233</sect1>
Note: See TracBrowser for help on using the repository browser.