Changeset 31c91db0 for x

Timestamp:

09/14/2024 09:01:29 AM (6 days ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

trunk

Children:

d4a3f02

Parents:

f73357b4

git-author:

Xi Ruoyao <xry111@…> (09/14/2024 09:01:00 AM)

git-committer:

Xi Ruoyao <xry111@…> (09/14/2024 09:01:29 AM)

Message:

gtk4: Attempt to get a cleaner test result

File:

• x/lib/gtk4.xml (modified) (5 diffs)

x/lib/gtk4.xml

@@ -101 +101 @@
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
+      <xref linkend="avahi"/> (for some tests),
       <xref linkend="colord"/>,
       <xref linkend="cups"/>,
@@ -111 +112 @@
       <xref linkend="sassc"/>,
       <xref linkend="tracker3"/>,
-      <ulink url="https://github.com/OpenPrinting/cpdb-libs">cpdb</ulink>, and
+      <ulink url="https://github.com/OpenPrinting/cpdb-libs">cpdb</ulink>
+      <ulink url="https://pypi.org/project/pydbus/">pydbus</ulink>
+      (for some tests), and
       <ulink url="&sysprof-url;">sysprof</ulink>
     </para>
@@ -146 +149 @@
 
     <para>
-      To run the tests, issue: <command>dbus-run-session meson test --setup
-      x11</command>. If you are in a Wayland session, replace x11 with wayland.
+      To run the tests, issue:
+    </para>
+
+    <screen remap='test'><userinput>LIBGL_ALWAYS_SOFTWARE=1 \
+dbus-run-session meson test --setup x11 --no-suite needs-dmabuf
+9</userinput></screen>
+
+    <para>
+      If you are in a Wayland session, replace the two occurences of
+      <literal>x11</literal> with <literal>wayland</literal>.
       
-      Nine tests are known to fail if
+      One test is known to fail if
       <ulink url="https://gitlab.gnome.org/GNOME/cantarell-fonts">Cantrell fonts</ulink>
-      are not installed. 
+      are not installed.
+
+      About a dozen of tests are known to fail with minor (mostly invisible)
+      differences between the render output and the shipped reference image.
+      Issue
+      <command>grep 'not ok' meson-logs/testlog-x11.txt -B3</command>
+      (use <filename>testlog-wayland.txt</filename> if testing in a Wayland
+      session) to list them and the image files showing the render output,
+      the reference output, and the differences.  You may take a look at
+      those images to ensure the differences are insignificant.
+
+      Two <literal>headless</literal> tests are known to fail without the
+      external dependency pydbus installed.
       
       Many tests will fail if <filename>~/.config/gtk-4.0/settings.ini</filename> 
       exists and the gtk-modules line is not commented out.
+
+      Several other tests may fail for unknown reason.
       
       On systems with NVIDIA graphics cards, the tests may take significantly
       longer than the above test time.
-
+      <!--
       On some systems as many as 212 tests may fail (out of over 6100) for 
       unknown reasons.
+
+      I hope this is gone with LIBGL_ALWAYS_SOFTWARE and -\-no-suite dmabuf.
+      If not please restore them.  - xry111
+      -->
     </para>
 <!-- [pierre]: 4.6.0, wayland:   727 OK; 2 Expected Fail;   1 Fail; 1  Skipped
@@ -190 +219 @@
      [bdubbs]: 4.16.0, x11,     5896 OK, 0 Expected Fail, 212 Fail, 16 Skipped, 0 Timeout
                above on X11 in XFCE.  Over ssh there were 24 Timeouts
+     [xry111]: 4.16.1, x11,     6121 OK, 0 Expected Fail, 14 Fail, 16 Skipped, 0 Timeout
+               above on X11 (Xwayland) in GNOME
+     [xry111]: 4.16.1, wayland, 6120 OK, 0 Expected Fail, 15 Fail, 16 Skipped, 0 Timeout
+               above on wayland in GNOME
+     [xry111]: 4.16.1, x11,     6119 OK, 0 Expected Fail, 16 Fail, 16 Skipped, 0 Timeout
+               above on X11 (Xwayland) in Weston
+     [xry111]: 4.16.1, x11,     6106 OK, 0 Expected Fail, 18 Fail, 25 Skipped, 2 Timeout
+               above on wayland in Weston
 -->
 
@@ -254 +291 @@
     </para>
 
+    <para>
+      <envar>LIBGL_ALWAYS_SOFTWARE=1</envar>: Force the test suite to use
+      the softpipe or llvmpipe driver from Mesa.  The test suite is so
+      sensitive that the minor differences caused by a different Mesa
+      driver can trigger test failures.
+    </para>
+
+    <para>
+      <parameter>--no-suite dmabuf</parameter>: Disable the tests requiring
+      <filename class='devicefile'>/dev/udmabuf</filename>.  This file does
+      not exist if the feature is not enabled in the kernel configuration,
+      and even if it exists it cannot be accessed as unprivileged users.
+    </para>
   </sect2>