hg init -e FICHIER —remotecmd FICHIER DESTINATION : Création d’un répertoire de dépôt, une base dans un répertoire donné. Si aucun répertoire de destination n’est donné, le répertoire courant est utilisé.

Options:

  • -e, --ssh ssh:// URL comme destination
  • --remotecmd commande spécifique mercurial pour travailler à distance sur un fichier

hg recover : Permet de revenir en arrière lorsqu’une commande a été inopinément interrompue. Par exemple lors d’un Ctrl C sur un add ou remove. Cette commande ramène la base à son état opérationnel. Elle ne doit être passée que dans le cas ou mercurial le demande. Une fois cette commande terminée, vérifier l’état de la base en lançant la commande verify.

hg verify : Vérifie l’intégrité du répertoire de dépôt ou bien base mercurial en décompressant les fichiers

hg rollback : Annule la dernière transaction (commit) ramenant le projet à son état précédent. Ci-dessous, la liste des commandes transactionnelles pouvant être annulé via le rollback :

  • commit, mais aussi (import, pull, push, unbundle)

Un rollback ne peut être annulé. Un rollback peut ne pas fonctionner dans le cas où un pull est en cours sur le même dépôt par exemple. Lorsqu’un commit est réalisé, il est possible de l’annuler tant qu’un autre commit n’a pas été passé par-dessus.

hg revert OPTION -r VERSION NOM : Permet de revenir en arrière sur le contenu d’un fichier/répertoire saisi en paramètre. Si le numéro de version n’est pas spécifié, les fichiers et répertoires spécifiés en paramètre seront ramenés à l’état de la version N-1. S’il existe deux versions N-1 (deux parents), alors le paramètre version devra être saisi. Les fichiers impactés sont sauvegardés avec comme extension .orig. Pour éviter ce comportement par défaut, utiliser l’option --no-backup. Si un nom de fichier est spécifié, tous les fichiers correspondants à ce nom seront ramenés à l’état de la version spécifiée. Si aucun nom de fichier n’est saisi, aucune modification ne sera impactée.

Options:

  • -a -–all annule toute modifications si aucun autre argument n’est donné
  • -d –-date prend en compte toutes les versions correspondant à la date donnée
  • -r –rev version sur laquelle se positionner
  • --no-backup Ne créé pas de backup des fichiers qui vont être modifier
  • -I –-include fichiers dont le nom doit correspondre
  • -I, --include prend en compte les fichiers dont le nom correspond au motif donné
  • -X, --exclude prend en compte les fichiers dont le nom ne correspond pas au motif donné

hg showconfig -u NOM : Affiche le contenu de tous les fichiers de configuration (hgrc) du système ( /etc/hgrc + hgrc du projet en cours) Si un argument représentant une option de configuration, seulement le nom et la valeur de cette option seront affichées (idem pour plusieurs arguments saisis).

Options:

  • -u –untrusted affiche les options de configuration non reconnues

Alias : debugconfig

hg clone OPTION… SOURCE DESTINATION : Crée une copie d'une base existante dans un nouveau répertoire Si aucun répertoire de destination n'est spécifié, il sera équivalent au nom du répertoire source. L'emplacement de la source est ajouté au .hg/hgrc du nouveau dépôt comme étant le dépôt à utiliser pour les futurs pulls (partage de changesets avec d’autres personnes). Par soucis de performance, des liens physiques sont utilisés lorsque la source et la destination appartiennent à un même système de fichier. Certains systèmes de fichier, comme AFS, n'implémentent pas correctement les liens physiques, mais n'affichent pas d'erreur. Dans ces cas, utilisez l'option --pull pour éviter les liens physiques.

Options:

  • -U, --noupdate ne met pas à jour le nouveau répertoire de travail
  • -r, --rev un changeset que vous aimeriez avoir après le clone
  • --pull utiliser le protocol de pull pour copier les meta-données
  • -e, --ssh spécifier la commande ssh à utiliser
  • --remotecmd spécifier la commande hg à lancer sur l'emplacement distant

hg identify : Affiche des informations sommaires sur la version courante utilisée. Ces informations identifient l’état d’utilisation du répertoire de dépôt ainsi que 1 ou 2 parents. Le changeset est affiché suivi d’un "+" si des modifications n’ont pas été prises en compte (état pre-commit) suivie de la liste des tags de la version.

Alias : id

hg manifest VERSION : Affichage de la liste des fichiers d’une version donnée. Si aucune version n’est donnée alors le premier parent de la base, répertoire de dépôt est utilisé.

Options :

  • -v flag affiche les permissions du fichier.
  • --debug flag affiche le changeset de la version d’un fichier.

hg parents -r VERSION FICHIER : Affiche les informations sur les versions parentes précédentes de la version donnée.

Options:

  • -b, --branches affiche les branches
  • -r, --rev version dont on veut connaître les versions parentes
  • --style affiche le fichier template
  • --template affiche le résultat selon un template donné.

hg version : Affiche la version de mercurial utilisée ainsi que le copyright

hg remove NOM : Efface le(s) fichier(s) mis en paramètre. (Tous si aucun paramètre saisi)

Alias : rm

hg addremove OPTION FICHIER : Ajoute tous les nouveaux fichiers, supprime tous les fichiers absents de la version à archiver. Les fichiers nouveaux peuvent être ignorés s’ils correspondent au modèle présent dans le fichier .hgignore. Comme pour le add les modifications prennent effet lors du commit.

Options:

  • -s, --similarity détecte les fichiers renommés. Si (0<=s<=100) les fichiers supprimés sont comparés avec les fichiers ajoutés. Les fichiers ayant une ressemblance sont enregistrés et un pourcentage de concordance est donné.
  • -I, --include affiche les articles ayant un nom correspondant au modèle
  • -X, --exclude affiche les articles n’ayant pas un nom correspondant au modèle
  • -n, --dry-run la commande n’est pas execute, mais le résultat est affiché à l’écran.

hg cat OPTION FICHIER : Affiche le contenu d’un fichier sans effectuer l’opération de Checkout. La version sur laquelle effectuée la recherche peut être indiquée, sinon la dernière version du répertoire de dépôt ou base est prise par défaut.

Options:

  • -o, --output Ecriture du contenu du fichier dans un fichier formaté (voir options suivantes) en sortie
  • %s nom du fichier de sortie,
  • %d nom du répertoire du fichier de sortie, ou bien '.' si l'emplacement actuel est la racine du dépôt
  • %p chemin relatif du fichier de sortie
  • -r, --rev affiche la version donnée
  • -I, --include affiche les articles ayant un nom correspondant au modèle
  • -X, --exclude affiche les articles n’ayant pas un nom correspondant au modèle

hg grep OPTION MODELE FICHIER : Permet d’effectuer des recherches à l’intérieur des fichiers d’une révision donnée. Cette commande accepte les expressions régulières PERL/PYTHON.

Options:

  • -0, --print0 ajoute un caractère nul en fin de fichier (pour utiliser la commande avec xargs)
  • --all affiche toutes les versions ou le modèle concorde
  • -f, --follow affiche l'historique du changeset suivant
  • -i, --ignore-case ignore la casse du modèle
  • -l, --files-with-matches affiche uniquement les fichiers et versions répondant au modèle
  • -n, --line-number affiche le nombre de lignes trouvées
  • -r, --rev recherche dans la version donnée
  • -u, --user affiche l’utilisateur ayant réalise les modifications
  • -I, --include affiche les articles ayant un nom correspondant au modèle
  • -X, --exclude affiche les articles n’ayant pas un nom correspondant au modèle

hg status OPTION FICHIER : Affiche le statut des fichiers lors du prochain commit Affiche les fichiers modifiés du répertoire de travail. Si le nom des fichiers est donné en paramètre, hg status n’affichera que le statut de ces derniers. La révision peut être spécifiée et si deux révisions sont données, hg status affichera la différence entre ces deux révisions. Les codes utilisés pour indiquer l’état des fichiers sont les suivants:

  • M= modifié
  • A= ajouté
  • R= effacé
  • C= Aucun changement
  • != non présent dans le répertoire de travail
  • ?= inconnu par mercurial
  • I= ignoré
  • = le fichier ajouté précèdent a été copié d’ici

Alias : st

Options :

  • -A –all affiche le status de tous les fichiers
  • -m –modified affiche seulement les fichiers modifiés
  • -a –added affiche seulement les fichiers ajoutés
  • -r –removed affiche seulement les fichiers effacés
  • -d –deleted affiche les fichiers non présents dans le répertoire de travail
  • -c –clean affiche les fichiers sans aucun changement
  • -u –unknown affiche les fichiers inconnus
  • -i –ignored affiche les fichiers ignorés
  • -n --no-status n’affiche pas le statut des fichiers
  • -C –copies affiche la source des fichiers copiés
  • -0 --print0 ajoute un caractère nul en fin de fichier (pour utiliser la commande avec xargs)
  • --rev pour spécifier la révision ou version
  • -I, --include affiche seulement les fichiers dont le nom correspond au motif donné
  • -X, --exclude affiche seulement les fichiers dont le nom ne correspond pas au motif donné

hg add OPTION FICHIER : Ajoute les fichiers mis en paramètre Ces fichiers seront enregistrés dans la base lors du prochain commit.

Options:

  • -I, --include affiche seulement les fichiers dont le nom correspond au motif donné
  • -X, --exclude affiche seulement les fichiers dont le nom ne correspond pas au motif donné
  • -n, --dry-run n’applique pas la commande, affiche simplement la sortie

hg remove FICHIER : Efface le(s) fichier(s) mis en paramètre. (Tous si aucun paramètre saisi)

Alias : rm

hg commitOPTION FICHIER : Valide la mise en configuration

Options:

  • -A, --addremove marquage des fichiers nouveaux (ajoutés modifiés)/manquants comme à ajoutés/à supprimés avant d'effectuer le commit. Ne pas utiliser pour une livraison partielle.
  • -m, --message commentaire
  • -l, --logfile lire le message de commit depuis le fichier <fichier>
  • -d, --date enregistrer la date donnée (date-code) comme date de commit.
  • -u, --user enregistre l'utilisateur comme personne ayant fait le commit.
  • -I, --include affiche seulement les fichiers dont le nom correspond au motif donné
  • -X, --exclude affiche seulement les fichiers dont le nom ne correspond pas au motif donné

Alias : ci

hg tag -l -m COMMENTAIRE -d DATE -u UTILISATEUR -r VERSION NOM : Ajoute un tag à la version courante ou la version spécifiée Si aucune version n’est spécifiée, la version parente est utilisée sinon la dernière est utilisée (tip) Le fichier .hgtags du répertoire .hg contient la liste des versions du projet. Les tags locaux sont enregistrés dans .hg/localtags.

Options :

  • -l –local créer le fichier .hgtags sous le répertoire .hg et non sous le répertoire courant ctrl
  • -m –message message de commentaire a affecter à la version apposée sur le commit précédent
  • -d –date enregistre la date du commit comme étant la date spécifiée.
  • -u –user enregistre « user » en tant qu’utilisateur effectuant le commit.
  • -r –rev la révision a apposer sur le commit précédent

hg view : lance une application graphique permettant de visualiser les branches …

hg tags : Liste les tags des versions du dépôt.

hg locate OPTION MODELE : Affiche tous les fichiers de la base Mercurial dont le nom correspond au modèle

Options:

  • -r, --rev recherché dans le repertoire correspondant à la version donnée
  • -0, --print0 ajoute un caractère nul en fin de fichier (pour utiliser la commande avec xargs)
  • -f, --fullpath affiche le chemin absolu des fichiers don’t le nom correspond au modèle
  • -I, --include affiche seulement les fichiers dont le nom correspond au motif donné
  • -X, --exclude affiche seulement les fichiers dont le nom ne correspond pas au motif donné

hg archive OPTION DESTINATION : extrait par défaut la dernière version dans le répertoire destination

Options:

  • --no-decode ne pas passer les fichiers par le décodeur
  • -p, --prefix préfix du répertoire pour l'archive
  • -r, --rev version à extraire
  • -t, --type format des données de l’archive à extraire ("tar, tbz2, tgz, uzip, zip)
  • -I, --include affiche seulement les fichiers dont le nom correspond au motif donné
  • -X, --exclude affiche seulement les fichiers dont le nom ne correspond pas au motif donné

hg log OPTION FICHIER : Affiche l’historique d’un article de configuration

Options:

  • -b, --branches affiche les branches
  • -f, --follow affiche l'historique du changeset ou l’historique du fichier au travers de ses copies et de ses renommages
  • --follow-first affiche uniquement les articles suivants le premier parent merge
  • -d, --date affiche les articles dont la date correspond au modèle (hg log –d Feb)
  • -C, --copies affiche les fichiers copiés
  • -k, --keyword recherche d’un mot clé dans les articles de configuration
  • -l, --limit Limite le nombre d’articles affichés.
  • -r, --rev affiche l’article dont la version est spécifiée
  • --removed affiche les articles où des fichiers ont été effacés
  • -M, --no-merges n’affiche pas les merges
  • --style affiche le fichier template utilisé (template map file)
  • -m, --only-merges n’affiche que les merge
  • -p, --patch affiche les patchs
  • -P, --prune n’affiche pas la version et ses ancêtres
  • --template affiche la version avec un template
  • -I, --include affiche les articles ayant un nom correspondant au modèle
  • -X, --exclude affiche les articles n’ayant pas un nom correspondant au modèle

Alias : history

hg update -C -d DATE VERSION :__ Met à jour ou fusionne le répertoire de travail Pour fusionner le répertoire de travail avec une autre révision, il faut utiliser la commande merge.

Alias : up, checkout, co

Options :

  • -C –clean Ne tient pas compte des modifications locales (du repertoire de travail).
  • -d –date tipmost revision matching date</fichier>