source: gnome/platform/mutter.xml@ ffe2b45

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since ffe2b45 was ffe2b45, checked in by Pierre Labastie <pieere@…>, 21 months ago

Patch mutter for mesa-20.x+

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

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