Mercurial-7.2.1

Installation de Mercurial

Mercurial est construit et installé en une seule commande en tant qu'utilisateur root :

make PREFIX=/usr install

La documentation est construite par la commande ci-dessus (aux formats man et html), mais seules les pages de manuel sont installées. Si vous souhaitez installer la documentation html, exécutez en tant qu'utilisateur root :

mkdir /usr/share/doc/mercurial-7.2.1 &&
cp -R doc/html /usr/share/doc/mercurial-7.2.1

Si vous souhaitez exécuter les tests, les sources rust doivent être corrigées pour la version la plus récente de rust :

pushd rust                           &&
cargo fix --workspace --allow-no-scm &&
popd

Il y a également un problème avec les permissions dans le répertoire de construction, comme la commande install ci-dessus a créé des fichiers qui appartiennent à root, qu'un test essaye de modifier. Pour corriger cela, exécutez, en tant qu'utilisateur root :

chown -Rv username .

OU username devrait être remplacé par le nom d'utilisateur correspondant à la personne qui exécute les tests. Pour lancer la suite de tests, exécutez :

TESTFLAGS="-j<N> --with-hg /usr/bin/hg" make check

où <N> est un nombre entier entre un et le nombre de (processeurs × threads) inclus (la valeur par défaut est le nombre total de processeurs renvoyé par nproc). Plusieurs tests peuvent échouer si certains messages d'erreur ont changé dans Python, ou que certains avertissements d'obsolescence sont affichés, qui n'étaient pas présents au moment où le test a été conçu. De plus, certains tests utilisent beaucoup de mémoire, et peuvent être tués par le noyau si le système n'a plus de mémoire.

Afin de pouvoir investiguer un test qui a l'air d'échouer, vous pouvez utiliser le script run-tests.py dans le répertoire tests. Pour voir les presque quarante options, dont certaines très utiles, lancez tests/run-tests.py --help. Avec la commande suivante, vous exécuterez seulement les tests précédemment échoués :

pushd tests  &&
  ./run-tests.py --with-hg /usr/bin/hg --retest
popd

Une option intéressante est --time, qui génère un tableau avec tous les tests exécutés et leur temps respectifs de début, fin, utilisateur, système et réel à la fin de l'exécution de la suite de tests. Remarquez que ces options peuvent être utilisés avec make check, en les ajoutant à la variable d'environnement TESTFLAGS.

Après l'installation, vous devriez pouvoir correctement lancer deux tests très rapides et simples. Le premier demande un peu de configuration :

cat >> ~/.hgrc << "EOF"
[ui]
username = <user_name> <user@mail>
EOF

où vous devez remplacer <user_name> et <utilisateur@mail> (mail est facultatif et peut être omis, mais si vous le gardez, vous devriez également garder les chevrons « <> »). Une fois l'identité de l'utilisateur définie, lancez hg debuginstall et quelques lignes seront affichées, la dernière affichant « no problems detected ». Un autre test rapide et simple est juste hg, qui doit afficher les commandes basiques qui peuvent être utilisée avec hg.

install -v -d -m755 /etc/mercurial &&
cat > /etc/mercurial/hgrc << "EOF"
[web]
cacerts = /etc/pki/tls/certs/ca-bundle.crt
EOF