Changeset 2beaab8 for general/prog/mercurial.xml

Timestamp:

02/03/2016 05:22:58 PM (8 years ago)

Author:

Fernando de Oliveira <fernando@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

2b64864b

Parents:

28320bf4

Message:

• mercurial-3.7: try to improve the text and minor reformats.
• Update to nss-3.22.
• Update to iso-codes-3.65.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@16900 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• general/prog/mercurial.xml (modified) (5 diffs)

general/prog/mercurial.xml

@@ -99 +99 @@
 <screen><userinput>make doc</userinput></screen>
 
-    <para>Running the test suite is optional. If some thest fails, it can be
-    disabled. To test the results in the subdiretory <filename
-    class="directory">tests/tmp</filename>, skipping failing tests,
+    <para>Running the test suite is optional. Tests which fail may be disabled,
+    adding each one to <filename>tests/blacklists/failed-tests</filename>. In
+    order to execute the test suite using the temporary directory <filename
+    class="directory">tests/tmp</filename> and skipping the failing tests,
     issue:</para>
 
@@ -110 +111 @@
   test-gpg.t</literal>
 EOF
+
 rm -rf tests/tmp &amp;&amp;
+
 TESTFLAGS="-j<replaceable>&lt;N&gt;</replaceable> --tmpdir tmp --blacklist blacklists/failed-tests" \
 make check</userinput></screen>
@@ -122 +125 @@
     before:</para>
 
-<screen><userinput>pushd tests &amp;&amp;
-rm -rf tmp  &amp;&amp;
-./run-tests.py --debug --tmpdir tmp      \
-               test-convert-svn-source.t \
-               test-convert-hg-svn.t     \
-               test-gpg.t &amp;&amp;
+<screen><userinput>pushd tests  &amp;&amp;
+  rm -rf tmp &amp;&amp;
+
+  ./run-tests.py --debug --tmpdir tmp      \
+                 test-convert-svn-source.t \
+                 test-convert-hg-svn.t     \
+                 test-gpg.t                &amp;&amp;
 popd</userinput></screen>
 
-    <para>Normally, failures will be repeated. However, if you add the switch
-    "--debug" before "--tmpdir", and run again, the failures are gone. Normally,
-    from now on, there will be no more failure whether you use the debug switch
-    or not. An interesting switch is "--time", which will generated at the end
-    of the test suite execution, a table with all executed tests and respective
-    start, end, user, system and real times.  Notice that the switches may be
-    used with <command>make check</command>, in the
+    <para>Normally, the previous failures will be confirmed. However, if you add
+    the switch "--debug" before "--tmpdir", and run again, some failures are
+    gone, which seems to be a problem with the test suite. If this happens,
+    normally, from now on, there will be no more such failures whether you use
+    the debug switch or not.</para>
+
+    <para>An interesting switch is "--time", which will generated at the end of
+    the test suite execution, a table with all executed tests and respective
+    start, end, user, system and real times. Notice that the switches may be
+    used with <command>make check</command>, including them in the
     <envar>TESTFLAGS</envar> environment variable.</para>
 
@@ -154 +161 @@
 <screen><userinput>cat &gt;&gt; ~/.hgrc &lt;&lt; "EOF"
 <literal>[ui]
-username = &lt;user_name&gt; &lt;your@mail&gt;</literal>
+username = <replaceable>&lt;user_name&gt; &lt;user@mail&gt;</replaceable></literal>
 EOF</userinput></screen>
 
@@ -185 +192 @@
       </indexterm>
 
-      <para>
-        A great majority of extensions are disabled by default. Run <command>hg
-        help extensions</command> if you need to enable any, e.g. when
-        investigating test failures, and use one of the configuration files to
-        enable it.
-      </para>
-
-      <para>
-        If you have installed the <xref linkend="cacerts"/> and you want
-        <application>Mercurial</application> to use them, as the
-        <systemitem class="username">root</systemitem> user:
-      </para>
+      <para>The great majority of extensions are disabled by default. Run
+      <command>hg help extensions</command> if you need to enable any, e.g.
+      when investigating test failures. You will obtain the lists of enabled and
+      disabled extensions, and more information, such as how to enable or
+      disable them using configuration files.</para>
+
+      <para>If you have installed the <xref linkend="cacerts"/> and want
+      <application>Mercurial</application> to use them, as the <systemitem
+      class="username">root</systemitem> user, issue:</para>
 
 <screen role="root"><userinput>install -v -d -m755 /etc/mercurial &amp;&amp;
-cat &gt; /etc/mercurial/hgrc &lt;&lt; "EOF"
+cat &gt;&gt; /etc/mercurial/hgrc &lt;&lt; "EOF"
 <literal>[web]
 cacerts = /etc/ssl/ca-bundle.crt</literal>