source: gnome/platform/mutter.xml@ 45ab6c7

trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 7.1 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 "64ec45c43427fa9794fc3a6e287689bd">
10 <!ENTITY mutter-size "2.6 MB">
11 <!ENTITY mutter-buildsize "240 MB">
12 <!ENTITY mutter-time "1.6 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-desktop"/>,
91 <xref linkend="gnome-settings-daemon"/>,
92 <xref linkend="graphene"/>,
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"/>,
105 <xref linkend="startup-notification"/>, and
106 <xref linkend="sysprof"/>
107 </para>
108
109 <bridgehead renderas="sect4">Recommended (Required to
110 build the Wayland compositor)</bridgehead>
111 <para role="recommended">
112 <xref linkend="libinput"/>,
113 <xref linkend="wayland"/>,
114 <xref linkend="wayland-protocols"/>, and
115 <xref linkend="xorg-server"/> (with <command>Xwayland</command>).
116 Additionally, <xref linkend="gtk3"/> needs to be built with
117 <application>Wayland</application> support.
118 </para>
119
120 <bridgehead renderas="sect4"
121 revision="sysv">Recommended (Runtime)</bridgehead>
122 <para role="recommended" revision="sysv">
123 <xref linkend="blocaled" role="runtime"/>
124 </para>
125
126 <!-- NOTE: Mutter compiles git versions of COGL and Clutter for it's own
127 internal use. This is because the wayland support upstream isn't advanced
128 enough for the graphics stack used in Mutter. -->
129
130 <para condition="html" role="usernotes">User Notes:
131 <ulink url="&blfs-wiki;/mutter"/>
132 </para>
133
134 </sect2>
135
136 <sect2 role="installation">
137 <title>Installation of Mutter</title>
138
139<!--
140 <para>
141 First, fix a problem with the build system and bugs with wayland sessions:
142 </para>
143
144<screen><userinput remap="pre">patch -Np1 -i ../mutter-&mutter-version;-upstream_fixes-1.patch</userinput></screen>
145-->
146
147 <para>
148 First, fix a race condition that sometimes occurs due to meson dependency
149 ordering:
150 </para>
151
152<screen><userinput remap="pre">sed -i '/libmutter_dep = declare_dependency(/a sources: mutter_built_sources,' src/meson.build</userinput></screen>
153
154 <para>
155 Install <application>Mutter</application> by running the following
156 commands:
157 </para>
158
159<screen><userinput>mkdir build &amp;&amp;
160cd build &amp;&amp;
161
162meson --prefix=/usr .. &amp;&amp;
163ninja</userinput></screen>
164
165 <para>
166 To test the results, issue:
167 <command>dbus-run-session ninja test</command>. The tests
168 require an active X session to run correctly. It is not necessary to
169 run a separate D-bus session if not in a GNOME session, but it
170 provides a clean environment in any case. One test,
171 <filename>native-headless</filename>, is known to fail.
172 </para>
173
174 <para>
175 Now, as the <systemitem class="username">root</systemitem> user:
176 </para>
177
178<screen role="root"><userinput>ninja install</userinput></screen>
179
180 </sect2>
181
182 <sect2 role="content">
183 <title>Contents</title>
184
185 <segmentedlist>
186 <segtitle>Installed Programs</segtitle>
187 <segtitle>Installed Libraries</segtitle>
188 <segtitle>Installed Directories</segtitle>
189
190 <seglistitem>
191 <seg>
192 mutter
193 </seg>
194 <seg>
195 libmutter-8.so
196 </seg>
197 <seg>
198 /usr/{lib,include,libexec/installed-tests,share/{installed-tests}}/mutter-8
199 </seg>
200 </seglistitem>
201 </segmentedlist>
202
203 <variablelist>
204 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
205 <?dbfo list-presentation="list"?>
206 <?dbhtml list-presentation="table"?>
207
208 <varlistentry id="mutter-prog">
209 <term><command>mutter</command></term>
210 <listitem>
211 <para>
212 is a <application>Clutter</application> based compositing
213 <application>GTK+</application> Window Manager
214 </para>
215 <indexterm zone="mutter mutter-prog">
216 <primary sortas="b-mutter">mutter</primary>
217 </indexterm>
218 </listitem>
219 </varlistentry>
220
221 <varlistentry id="libmutter">
222 <term><filename class="libraryfile">libmutter-8.so</filename></term>
223 <listitem>
224 <para>
225 contains the <application>Mutter</application> API functions
226 </para>
227 <indexterm zone="mutter libmutter">
228 <primary sortas="c-libmutter">libmutter-8.so</primary>
229 </indexterm>
230 </listitem>
231 </varlistentry>
232
233 </variablelist>
234
235 </sect2>
236
237</sect1>
Note: See TracBrowser for help on using the repository browser.