Changes in gnome/platform/mutter.xml [88e7954:e1d37d8]
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
gnome/platform/mutter.xml
r88e7954 re1d37d8 5 5 %general-entities; 6 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 "bbfb54fba942b4f388e5b89759f2e9a6"> 10 <!ENTITY mutter-size "2.6 MB"> 11 <!ENTITY mutter-buildsize "296 MB"> 12 <!ENTITY mutter-time "2.1 SBU (Using parallelism=4)"> 7 <!ENTITY mutter-download-http "&gnome-download-http;/mutter/&gnome-43;/mutter-&mutter-version;.tar.xz"> 8 <!ENTITY mutter-download-ftp "&gnome-download-ftp;/mutter/&gnome-43;/mutter-&mutter-version;.tar.xz"> 9 <!ENTITY mutter-md5sum "2aa9fae86f51490b419e747885069e96"> 10 <!ENTITY mutter-size "2.7 MB"> 11 <!ENTITY mutter-buildsize "150 MB (without tests)"> 12 <!ENTITY mutter-time "0.6 SBU (Using parallelism=4)"> 13 <!ENTITY mutter-time-systemd "0.6 SBU (Using parallelism=4, add 1.0 SBU for tests)"> 13 14 ]> 14 15 … … 16 17 <?dbhtml filename="mutter.html"?> 17 18 18 <sect1info>19 <date>$Date$</date>20 </sect1info>21 19 22 20 <title>Mutter-&mutter-version;</title> … … 36 34 </para> 37 35 38 &lfs11 0a_checked;36 &lfs112_checked; 39 37 40 38 <bridgehead renderas="sect3">Package Information</bridgehead> … … 65 63 </para> 66 64 </listitem> 67 <listitem >65 <listitem revision='sysv'> 68 66 <para> 69 67 Estimated build time: &mutter-time; 70 68 </para> 71 69 </listitem> 70 <listitem revision='systemd'> 71 <para> 72 Estimated build time: &mutter-time-systemd; 73 </para> 74 </listitem> 72 75 </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 --> 76 84 77 <bridgehead renderas="sect3">Mutter Dependencies</bridgehead> 85 78 86 79 <bridgehead renderas="sect4">Required</bridgehead> 87 80 <para role="required"> 88 <!-- now using internal shipped clutter and cogl copies -->89 <!-- <xref linkend="clutter"/>, -->90 81 <xref linkend="gnome-settings-daemon"/>, 91 82 <xref linkend="graphene"/>, 92 83 <xref linkend="libxcvt"/>, 93 <xref linkend="libxkbcommon"/>, 94 <xref linkend="pipewire"/>, and 95 <xref linkend="zenity"/> 84 <xref linkend="libxkbcommon"/>, and 85 <xref linkend="pipewire"/> 96 86 </para> 97 87 … … 123 113 <bridgehead renderas="sect4">Optional</bridgehead> 124 114 <para role="optional"> 115 <xref linkend="python-dbusmock"/> (required for tests) and 125 116 <xref linkend="xorg-server"/> (for X11 sessions) 126 117 </para> … … 139 130 <title>Installation of Mutter</title> 140 131 141 <!--142 <para>143 First, fix a problem with the build system and bugs with wayland sessions:144 </para>145 146 <screen><userinput remap="pre">patch -Np1 -i ../mutter-&mutter-version;-upstream_fixes-1.patch</userinput></screen>147 -->148 149 <para>150 First, fix a race condition that sometimes occurs due to meson dependency151 ordering:152 </para>153 154 <screen><userinput remap="pre">sed -i '/libmutter_dep = declare_dependency(/a sources: mutter_built_sources,' src/meson.build</userinput></screen>155 156 132 <para> 157 133 Install <application>Mutter</application> by running the following … … 162 138 cd build && 163 139 164 meson --prefix=/usr --buildtype=debugoptimized .. &&140 meson --prefix=/usr --buildtype=debugoptimized -Dtests=false .. && 165 141 ninja</userinput></screen> 166 142 143 <!-- 167 144 <para> 168 145 To test the results, issue: … … 173 150 <filename>native-headless</filename>, is known to fail. 174 151 </para> 152 --> 153 <!-- there are no added problems in sysv, AFAICT. Running the tests is 154 not easy whatever the init system. But using the instructions below in 155 a gnome session on sysv works (no test failure)... 156 <para revision='sysv'> 157 This package does not come with a test suite that runs properly in the 158 SystemV environment. 159 </para> 160 --> 161 162 <para> 163 The test suite requires debug functions to be enabled in the build, and an 164 external program called <command>xvfb-run</command>. If you wish to run 165 the tests, you should download and install it before running 166 <command>meson</command>. 167 168 You can obtain it from <ulink 169 url="&sources-anduin-http;/mutter/xvfb-run">xvfb-run</ulink>, and install 170 it with executable permissions in <filename 171 class="directory">/usr/bin</filename>. <command>xvfb-run</command> needs 172 <command>Xvfb</command> at runtime, and <command>Xvfb</command> can be 173 installed from either <xref linkend='xorg-server'/> or <xref 174 linkend='xwayland'/>. 175 176 You should also replace <parameter>-Dtests=false</parameter> in the 177 <command>meson</command> command, with 178 <parameter>-Dtests=true</parameter>. The test 179 suite requires the mutter schema to be installed on the system, so it is 180 better to run the tests after installing the package. 181 </para> 182 183 <para> 184 You can also test basic functions of <application>Mutter</application> 185 following <xref linkend='mutter-starting'/>, after installing it. 186 </para> 175 187 176 188 <para> … … 180 192 <screen role="root"><userinput>ninja install</userinput></screen> 181 193 194 <para> 195 The tests can now be run: issue 196 <command>ninja test</command>. The tests 197 require an active X or wayland session. 198 The <filename>native-unit</filename> test is known to fail. 199 A lot of tests will fail if the opengl rendering is not done in hardware. 200 </para> 182 201 </sect2> 183 202 … … 185 204 <title>Command Explanations</title> 186 205 206 <!-- https://gitlab.gnome.org/GNOME/gnome-shell/-/issues/5512 207 If debug is disabled, the "assertion 'CLUTTER_IS_ACTOR (self)' 208 failed" message will turn into a crash. Enabling debug is just a 209 work around, it's not a proper fix. --> 187 210 <para> 188 211 <parameter>--buildtype=debugoptimized</parameter>: Override the 189 212 default buildtype (<quote>debug</quote>), which would produce 190 unoptimized binaries. The test suite of this package needs debug 191 to be enabled. 213 unoptimized binaries. It's used instead of 214 <option>--buildtype=release</option> to work around an issue 215 causing gnome-shell to crash. 216 </para> 217 <!-- 218 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 219 href="../../xincludes/meson-buildtype-release.xml"/> 220 --> 221 <para> 222 <parameter>-Dtests=false</parameter>: Prevents building the tests, 223 and removes a hard requirement on <command>xvfb-run</command>. 192 224 </para> 193 225 … … 197 229 want meson to download <application>Sysprof</application> source 198 230 code. 231 </para> 232 233 </sect2> 234 235 <sect2 role="starting" id="mutter-starting"> 236 <title>Starting Mutter</title> 237 238 <!-- Mutter as a Wayland compositor Works with mutter-42.4 and 43.0. 239 IIRC mutter can also be used as a X window manager: just replace 240 "twm" with "mutter ‐‐x11" in xinitrc. But I've not tested 241 such a configuration recently (I don't build Xorg Server or xinit 242 these days. --> 243 244 <para> 245 <application>Mutter</application> is normally used as a component of 246 <application>gnome-shell</application>, but it can be used as a 247 standalone Wayland compositor too. To run 248 <application>Mutter</application> as a Wayland compositor, in a 249 virtual console, issue: 250 </para> 251 252 <screen role='nodump'><userinput>mutter --wayland -- vte-2.91</userinput></screen> 253 254 <para> 255 Replace <command>vte-2.91</command> with the command line for the 256 first application you want in the Wayland session. Note that once this 257 application exits, the Wayland session will be terminated. 258 </para> 259 260 <para> 261 <application>Mutter</application> can also function as a nested 262 compositor in another Wayland session. In a terminal emulator, issue: 263 </para> 264 265 <screen role='nodump'><userinput>MUTTER_DEBUG_DUMMY_MODE_SPECS=1920x1080 mutter --wayland --nested -- vte-2.91</userinput></screen> 266 267 <para> 268 Replace <replaceable>1920x1080</replaceable> with the size you want 269 for the nested Wayland session. 199 270 </para> 200 271 </sect2> … … 213 284 </seg> 214 285 <seg> 215 libmutter- 8.so286 libmutter-11.so 216 287 </seg> 217 288 <seg> 218 /usr/{lib,include,libexec/installed-tests,share/{ installed-tests}}/mutter-8289 /usr/{lib,include,libexec/installed-tests,share/{,installed-tests}}/mutter-11 219 290 </seg> 220 291 </seglistitem> … … 240 311 241 312 <varlistentry id="libmutter"> 242 <term><filename class="libraryfile">libmutter- 8.so</filename></term>313 <term><filename class="libraryfile">libmutter-11.so</filename></term> 243 314 <listitem> 244 315 <para> … … 246 317 </para> 247 318 <indexterm zone="mutter libmutter"> 248 <primary sortas="c-libmutter">libmutter- 8.so</primary>319 <primary sortas="c-libmutter">libmutter-11.so</primary> 249 320 </indexterm> 250 321 </listitem>
Note:
See TracChangeset
for help on using the changeset viewer.