Ignore:
Timestamp:
01/04/2023 06:05:12 PM (16 months ago)
Author:
Pierre Labastie <pierre.labastie@…>
Branches:
qt5new
Children:
c0ef2f9
Parents:
1daaab6d (diff), 811d39b (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.
Message:

Merge branch 'trunk' into qt5new

File:
1 edited

Legend:

Unmodified
Added
Removed
  • general/prog/mercurial.xml

    r1daaab6d r104ff4e  
    77  <!ENTITY mercurial-download-http "https://www.mercurial-scm.org/release/mercurial-&mercurial-version;.tar.gz">
    88  <!ENTITY mercurial-download-ftp  " ">
    9   <!ENTITY mercurial-md5sum        "5d9b9515ba10c60de2a5ec10bee45807">
    10   <!ENTITY mercurial-size          "7.8 MB">
    11   <!ENTITY mercurial-buildsize     "77 MB (with docs, add 1.6 GB for tests)">
    12   <!ENTITY mercurial-time          "0.3 SBU (with docs, add 18 SBU for tests using -j4)">
     9  <!ENTITY mercurial-md5sum        "3d16503218c720fb017a19c9bad4f97d">
     10  <!ENTITY mercurial-size          "7.7 MB">
     11  <!ENTITY mercurial-buildsize     "79 MB (with docs, add 1.9 GB for tests)">
     12  <!ENTITY mercurial-time          "0.3 SBU (with docs, add 23 SBU for tests using -j4)">
    1313]>
    1414
     
    1616  <?dbhtml filename="mercurial.html"?>
    1717
    18   <sect1info>
    19     <date>$Date$</date>
    20   </sect1info>
    2118
    2219  <title>Mercurial-&mercurial-version;</title>
     
    3734    </para>
    3835
    39     &lfs110a_checked;
     36    &lfs112_checked;
    4037
    4138    <bridgehead renderas="sect3">Package Information</bridgehead>
     
    7471
    7572    <bridgehead renderas="sect3">Mercurial Dependencies</bridgehead>
    76 
    77     <!--
    78     <bridgehead renderas="sect4">Required</bridgehead>
    79     <para role="required">
    80       <xref linkend="python2"/>
    81     </para>
    82     -->
    8373
    8474    <bridgehead renderas="sect4">Optional</bridgehead>
     
    9181      (runtime, to access ssh://... repositories),
    9282    <xref linkend="pygments"/>,
    93     <xref linkend="rust"/>,
     83    <xref linkend="rust"/> (see <filename>rust/README.rst</filename> and <filename>rust/rhg/README.md</filename>),
    9484    <xref linkend="subversion"/> (with Python bindings),
    9585    <ulink url="https://launchpad.net/bzr">Bazaar</ulink>,
    96     <ulink url="http://www.nongnu.org/cvs/">CVS</ulink>,
     86    <ulink url="https://www.nongnu.org/cvs/">CVS</ulink>,
    9787    <ulink url="https://pypi.python.org/pypi/pyflakes">pyflakes</ulink>,
    9888    <ulink url="https://www.pyopenssl.org/en/stable/">pyOpenSSL</ulink>, and
     
    111101
    112102    <para>
    113       First, force the build system to use Python 3:
    114     </para>
    115 
    116 <screen><userinput remap="pre">export PYTHON=python3</userinput></screen>
    117 
    118     <para>
    119103      Build <application>Mercurial</application> by issuing the following
    120104      command:
     
    130114
    131115    <para>
    132       To run the test suite, issue (15 tests are known to fail):
     116      To run the test suite, issue:
    133117    </para>
    134118<screen remap="test"><userinput>TESTFLAGS="-j<replaceable>&lt;N&gt;</replaceable> --tmpdir tmp --blacklist blacklists/fsmonitor --blacklist blacklists/linux-vfat" make check</userinput></screen>
     
    138122    <para>
    139123      where <replaceable>&lt;N&gt;</replaceable> is an integer between one
    140       and the number of ( processor X threads ), inclusive.  In order to
     124      and the number of ( processor X threads ), inclusive. Several tests
     125      (about 20) fail because some error messages have changed in Python, or
     126      some deprecation warnings are printed, that were not present when the
     127      test was designed.
     128      <!--
     129      # Ran 908 tests, 65 skipped, 4 failed.  real  10m37.422s -bdubbs 6 Sep 22.
     130      # Ran 881 tests, 102 skipped, 23 failed. -plabs 17 Nov 22.
     131      -->
     132      In order to
    141133      investigate any apparently failing tests, you may use the
    142134      <command>run-tests.py</command> script. To see the almost forty switches,
     
    152144
    153145    <para>
    154       Normally, the previous failures will be confirmed. However, if
     146      Normally, the previous failures will be reproducible. However, if
    155147      you add the switch <option>--debug</option> before
    156       <option>--tmpdir</option>, and run again, some failures are gone, which
    157       seems to be a problem with the test suite. If this happens, normally,
    158       from now on, there will be no more such failures whether you use the
    159       debug switch or not.
    160       There are 13 of 876 tests that are known to fail.
    161     </para>
    162 
    163     <para>
    164       An interesting switch is <option>--time</option>, which will generate at
    165       the end of the test suite execution, a table with all executed tests and
    166       respective start, end, user, system and real times. Note that the
     148      <option>--tmpdir</option>, and run the tests again, some failures may
     149      disappear, which is a problem with the test suite. If this happens,
     150      there will be no more of these failures even if you do not pass the
     151      --debug switch again.
     152    </para>
     153
     154    <para>
     155      An interesting switch is <option>--time</option>, which will generate a
     156      table of all the executed tests and their respective start, end, user,
     157      system and real times once the tests are complete. Note that these
    167158      switches may be used with <command>make check</command> by including
    168159      them in the <envar>TESTFLAGS</envar> environment variable.
     
    183174<screen role="root"
    184175        remap="doc"><userinput>make PREFIX=/usr install-doc</userinput></screen>
    185 
    186     <para>
    187       Next, clean up the environment variable set earlier:
    188     </para>
    189 
    190 <screen><userinput>unset PYTHON</userinput></screen>
    191176
    192177    <para>
     
    246231        The great majority of extensions are disabled by default. Run
    247232        <command>hg help extensions</command> if you need to enable any, e.g.
    248         when investigating test failures. You will obtain the lists of enabled
    249         and disabled extensions, and more information, such as how to enable
    250         or disable them using configuration files.
     233        when investigating test failures. This will output a list of enabled
     234        and disabled extensions, as well as more information such as how to
     235        enable or disable extensions using configuration files.
    251236      </para>
    252237
     
    284269        </seg>
    285270        <seg>
    286           /etc/mercurial and
    287           /usr/lib/python&python3-majorver;/site-packages/{hgdemandimport,hgext,hgext3rd,mercurial}
     271          /etc/mercurial,
     272          /usr/lib/python&python3-majorver;/site-packages/hgdemandimport,
     273          /usr/lib/python&python3-majorver;/site-packages/hgext,
     274          /usr/lib/python&python3-majorver;/site-packages/hgext3rd,
     275          /usr/lib/python&python3-majorver;/site-packages/mercurial, and
     276          /usr/lib/python&python3-majorver;/site-packages/mercurial-&mercurial-version;-py&python3-majorver;.egg-info
    288277        </seg>
    289278      </seglistitem>
Note: See TracChangeset for help on using the changeset viewer.