source: gnome/platform/mutter.xml@ 078db5b

10.0 10.1 11.0 9.1 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 078db5b was 078db5b, checked in by Pierre Labastie <pieere@…>, 2 years ago

Add dependency on desktop-file-utils for packages which have a custom
meson command calling update-desktop-database at install time

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

  • Property mode set to 100644
File size: 6.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 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 "4d7b67471fa4177e5ff0357e1f1736fb">
10 <!ENTITY mutter-size "2.7 MB">
11 <!ENTITY mutter-buildsize "487 MB">
12 <!ENTITY mutter-time "0.7 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 &lfs90_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;-upstream_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 <xref linkend="clutter"/>,
90 <xref linkend="gnome-desktop"/>,
91 <xref linkend="libcanberra"/>,
92 <xref linkend="libwacom"/>,
93 <xref linkend="libxkbcommon"/>,
94 <xref linkend="pipewire"/>,
95 <xref linkend="upower"/>, and
96 <xref linkend="zenity"/>
97 </para>
98
99 <bridgehead renderas="sect4">Recommended</bridgehead>
100 <para role="recommended">
101 <xref linkend="desktop-file-utils"/>,
102 <xref linkend="gobject-introspection"/>, and
103 <xref linkend="startup-notification"/>
104 </para>
105
106 <bridgehead renderas="sect4">Recommended (Required to
107 build the Wayland compositor)</bridgehead>
108 <para role="recommended">
109 <xref linkend="libinput"/>,
110 <xref linkend="wayland"/>,
111 <xref linkend="wayland-protocols"/>, and
112 <xref linkend="xorg-server"/> (with <command>Xwayland</command>).
113 Additionally, <xref linkend="gtk3"/> needs to be built with
114 <application>Wayland</application> support.
115 </para>
116
117 <!-- NOTE: Mutter compiles git versions of COGL and Clutter for it's own
118 internal use. This is because the wayland support upstream isn't advanced
119 enough for the graphics stack used in Mutter. -->
120
121 <para condition="html" role="usernotes">User Notes:
122 <ulink url="&blfs-wiki;/mutter"/>
123 </para>
124
125 </sect2>
126
127 <sect2 role="installation">
128 <title>Installation of Mutter</title>
129
130 <para>
131 First, apply a patch to Mutter to fix some upstream bugs:
132 </para>
133
134<screen><userinput remap="pre">patch -Np1 -i ../mutter-&mutter-version;-upstream_fixes-1.patch</userinput></screen>
135
136 <para>
137 Install <application>Mutter</application> by running the following
138 commands:
139 </para>
140
141<screen><userinput>mkdir build &amp;&amp;
142cd build &amp;&amp;
143
144meson --prefix=/usr -Dprofiler=false .. &amp;&amp;
145ninja</userinput></screen>
146
147 <para>
148 To test the results, issue: <command>ninja test</command>. The tests
149 require an active X session to run correctly. Some (18 of 92) tests require
150 a wayland based session.
151 </para>
152
153 <para>
154 Now, as the <systemitem class="username">root</systemitem> user:
155 </para>
156
157<screen role="root"><userinput>ninja install</userinput></screen>
158
159 </sect2>
160
161 <sect2 role="content">
162 <title>Contents</title>
163
164 <segmentedlist>
165 <segtitle>Installed Programs</segtitle>
166 <segtitle>Installed Libraries</segtitle>
167 <segtitle>Installed Directories</segtitle>
168
169 <seglistitem>
170 <seg>
171 mutter
172 </seg>
173 <seg>
174 libmutter-5.so
175 </seg>
176 <seg>
177 /usr/{lib,include,libexec/installed-tests,share/{installed-tests}}/mutter-5
178 </seg>
179 </seglistitem>
180 </segmentedlist>
181
182 <variablelist>
183 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
184 <?dbfo list-presentation="list"?>
185 <?dbhtml list-presentation="table"?>
186
187 <varlistentry id="mutter-prog">
188 <term><command>mutter</command></term>
189 <listitem>
190 <para>
191 is a <application>Clutter</application> based compositing
192 <application>GTK+</application> Window Manager.
193 </para>
194 <indexterm zone="mutter mutter-prog">
195 <primary sortas="b-mutter">mutter</primary>
196 </indexterm>
197 </listitem>
198 </varlistentry>
199
200 <varlistentry id="libmutter">
201 <term><filename class="libraryfile">libmutter-5.so</filename></term>
202 <listitem>
203 <para>
204 contains the <application>Mutter</application> API functions.
205 </para>
206 <indexterm zone="mutter libmutter">
207 <primary sortas="c-libmutter">libmutter-5.so</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 </variablelist>
213
214 </sect2>
215
216</sect1>
Note: See TracBrowser for help on using the repository browser.