Changeset 3592a6e

Timestamp:

01/13/2022 09:02:10 PM (2 years ago)

Author:

Pierre Labastie <pierre.labastie@…>

Branches:

11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

83948964

Parents:

e14df3bd

git-author:

Pierre Labastie <pierre.labastie@…> (01/13/2022 08:59:54 PM)

git-committer:

Pierre Labastie <pierre.labastie@…> (01/13/2022 09:02:10 PM)

Message:

mutter: change command explanations

We need to have <parameter> for what is used in the meson command.
Also change the test instructions so that it is clear that xvfb-run
needs to be installed before running meson.

File:

• gnome/platform/mutter.xml (modified) (2 diffs)

gnome/platform/mutter.xml

@@ -173 +173 @@
 
     <para>
-      The test suite requires an external program called xvfb-run.
-      If you wish to run the tests, install xvfb-run from
-      <ulink url="&sources-anduin-http;/mutter/xvfb-run">xvfb-run</ulink>
-      and remove -Dtests=false. The script must be placed in /usr/bin to work
-      properly. To run the tests if all of these conditions are met, issue:
+      The test suite requires an external program called
+      <command>xvfb-run</command>. If you wish to run the tests, you should
+      download and install it before running <command>meson</command>.
+      You can obtain it from
+      <ulink url="&sources-anduin-http;/mutter/xvfb-run">xvfb-run</ulink>, and
+      install it in <filename class="directory">/usr/bin</filename>.
+      You should also remove the <parameter>-Dtests=false</parameter> from
+      the <command>meson</command> command. To run the tests, issue:
       <command>dbus-run-session ninja test</command>. Note that the tests
       require an active X session to run correctly, and that
@@ -202 +205 @@
 
     <para>
+      <parameter>-Dtests=false</parameter>: Prevents building the tests,
+      and removes a hard requirement on <command>xvfb-run</command>.
+      If you wish to run the tests, read the test suite instructions above.
+      Note that you will need
+      <ulink url="&sources-anduin-http;/mutter/xvfb-run">xvfb-run</ulink>
+      installed in <filename class="directory">/usr/bin</filename>.
+    </para>
+
+    <para>
       <option>-Dprofiler=false</option>: Use this option if
       <application>Sysprof</application> is not installed, and you don't
       want meson to download <application>Sysprof</application> source
       code.
-    </para>
-
-    <para>
-      <option>-Dtests=true</option>: Mutter-41.0 implemented xvfb-run as a
-      requirement to run the tests. -Dtests=false bypasses this requirement.
-      If you wish to run the tests, read the test suite instructions above.
-      Note that you will need
-      <ulink url="&sources-anduin-http;/mutter/xvfb-run">xvfb-run</ulink>
-      installed in /usr/bin.
     </para>