Changeset 0c1c573

Timestamp:

06/12/2023 11:08:35 AM (12 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

12.0, 12.1, kea, ken/TL2024, ken/tuningfonts, lazarus, lxqt, plabs/newcss, python3.11, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18, xry111/xf86-video-removal

Children:

e8314fa

Parents:

196cbf4

Message:

rust: Document test failures, and correct some XML elements in explanations

File:

• general/prog/rust.xml (modified) (7 diffs)

general/prog/rust.xml

@@ -352 +352 @@
     </para>
 
-<screen remap="test"><userinput>python3 ./x.py test --verbose --no-fail-fast | tee rustc-testlog</userinput></screen>
+<screen remap="test"><userinput>SSL_CERT_DIR=/etc/ssl/certs \
+python3 ./x.py test --verbose --no-fail-fast | tee rustc-testlog</userinput></screen>
+
+    <!-- https://github.com/rust-lang/rust/issues/112209 -->
+    <para>
+      Three <literal>ui</literal> tests may fail (depending on the length
+      of absolute path of the
+      <filename class='directory'>rustc-&rust-version;-src</filename>
+      directory).
+    </para>
 
     <para>
@@ -439 +448 @@
 
     <para>
-      <command>targets = "X86"</command>: this avoids building all the available
+      <literal>targets = "X86"</literal>: this avoids building all the available
       linux cross-compilers (AArch64, MIPS, PowerPC, SystemZ, etc). Unfortunately,
       rust insists on installing source files for these below
@@ -446 +455 @@
 
     <para>
-      <command>extended = true</command>: this installs several tools
+      <literal>extended = true</literal>: this installs several tools
       (specified by the <literal>tools</literal> entry) alongside
       <command>rustc</command>.
@@ -452 +461 @@
 
     <para>
-      <command>tools = ["cargo", "clippy", "rustdoc", "rustfmt"]</command>:
+      <literal>tools = ["cargo", "clippy", "rustdoc", "rustfmt"]</literal>:
       only build the tools from the 'default' profile in binary command
       <command>rustup</command> which are recommended for most users.
@@ -460 +469 @@
 
     <para>
-      <command>channel = "stable"</command>: this ensures only stable features
+      <literal>channel = "stable"</literal>: this ensures only stable features
       can be used, the default in <filename>config.toml</filename> is to use
       development features, which is not appropriate for a released version.
@@ -467 +476 @@
     <!-- comment while using shipped LLVM -->
     <para>
-      <command>[target.x86_64-unknown-linux-gnu]</command>: the syntax of
+      <literal>[target.x86_64-unknown-linux-gnu]</literal>: the syntax of
       <filename>config.toml</filename> requires an <literal>llvm-config</literal>
       entry for each target for which system-llvm is to be used. Change the target
@@ -499 +508 @@
     </para>-->
 
-    <para>
-      <command>--verbose</command>: this switch can sometimes provide more
+    <!-- https://github.com/alexcrichton/openssl-probe/issues/25 -->
+    <para>
+      <envar>SSL_CERT_DIR=/etc/ssl/certs</envar>: Work around an issue
+      causing test failures with the CA certificate store layout used by
+      <xref linkend='make-ca'/>.
+    </para>
+
+    <para>
+      <parameter>--verbose</parameter>: this switch can sometimes provide more
       information about a test which fails.
     </para>
 
     <para>
-      <command>--no-fail-fast</command>: this switch ensures that the test suite
+      <parameter>--no-fail-fast</parameter>: this switch ensures that the test suite
       will not stop at the first error.
     </para>