HG(1)

Par Matt Mackall <mpm@selenic.com>

NOM

hg - Système de gestion de code source Mercurial

SYNOPSIS

hg [-v -d -q -y] <commande> [options de la commande] [fichiers]

DESCRIPTION

La commande hg(1) fournit une interface en ligne de commande au système Mercurial.

ELEMENTS DE LA COMMANDE

fichiers …

• indique un ou plusieurs noms de fichiers ou chemins relatifs vers de fichiers ; voir "FILE NAME PATTERNS" pour plus d'information sur la recherche par motif.

chemin

• inquide un chemin (vers un fichier ou dossier) sur la machine locale

révision

• indique un changeset qui peut être spécifié à l'aide d'un numéro de révision, un tag (étiquette), ou une sous-chaîne unique du hash d'un changeset

chemin vers le dépôt (repository)

• soit le chemin vers un dépôt local, soit l'URI d'un dépôt distant.Il y a deux protocoles URI disponibles, http:// qui est rapide, et le protocole static-http:// qui est bien plus lent mais qui ne requiert pas de serveur spécial sur la machine hébergeant le dépôt.

OPTIONS

-R, —repository

• racine du dossier du dépôt ou chemin symbolique vers celui-ci

—cwd

• change le dossier de travail

-y, —noninteractive

• ne demande pas de confirmation, utilise "oui" pour toutes les réponses requises.

-q, —quiet

• supprimer la sortie (silencieux)

-v, —verbose

• active la sortie additionnelle (mode verbeux)

—config

• active/sdésactive les options de configuration

—debug

• activer les informations de déboguage

—debugger

• activer le débogueur

—lsprof

• affiche les détails du profil d'exécution de la commande

—traceback

• affiche les informations traceback en cas d'erreur

—time

• le temps que prends la commande à s'éxecuter

—profile

• affiche le profil d'exécution de la commande

—version

• affiche les informations de version et quitte

-h, —help

• affiche l'aide et quitte

COMMANDES

add [OPTION]… [FICHIER]…

• Définit les fichiers qui seront versionnés et ajoutés dans le dépôt. Les fichiers seront ajoutés dans le dépôt au moment du prochain commit. Si aucun nom n'est donné, ajoute tous les fichiers dans le dépôt. options: -I, --include inclus les noms qui correspondent aux motifs donnés -X, --exclude exclut les noms qui correspondent aux motifs donnés -n, --dry-run ne pas appliquer la commande, simplement afficher la sortie

annotate [-r REV] [-a] [-u] [-d] [-n] [-c] FILE…

• Liste les changements dans les fichiers, en montrant le numéro de révision responsable de chaque ligne Cette commande est utile pour découvrir qui a fait une modification ou bien quand est-ce qu'une modification s'est produite. Sans l'option -a, annotate va ignorer les fichiers qu'il détecte comme étant binaires. Avec -a, annotate s'exécutera de toute façon, probablement avec des résultats non désirés. options: -r, --rev montre la liste des changements pour la révision donnée -a, --text considérer tous les fichiers comme du texte simple -u, --user afficher l'auteur des changements -d, --date afficher la date -n, --number afficher le numéro de la révision (défaut) -c, --changeset affiche le changeset -I, --include inclus les noms qui correspondent au motif donné -X, --exclude exclus les noms qui correspondent au motif donné

archive [OPTION]… DESTINATION

• Par défaut, la révision utilisée est le dernier parent dans le dossier de travail; utilisez "-r" pour spécifier une révision différente. Pour spécifier le type de l'archive à créer, utilisez "-t". Les types types are: "files" (default): un dossier plein de fichiers "tar": tar archive, non compressée "tbz2": tar archive, compressée en utilisant bzip2 "tgz": tar archive, compressée en utilisant gzip "uzip": zip archive, non compressée "zip": zip archive, compressée en utilisant "deflate" Le nom exact de l'archive de destination ou du dossier est donné dans une chaine formatée; voir "hg help export" pour plus de détails. Chaque membre ajouté à un fichier d'une archive a un préfix de dossier. Utilisez "-p" pour spécifier une chaîne formatée pour le préfix. Par défaut, le nom de l'archive sans ses suffixes est utilisé. options: --no-decode ne pas passer les fichiers par le décodeur -p, --prefix préfix du dossier pour l'archive -r, --rev révision à distribuer -t, --type type de distribution à créer -I, --include inclus les noms qui correspondent au motif donné -X, --exclude exclus les noms qui correspondent au motif donné

backout [OPTION]… REV

• Commit (soumet) les changements inverses d'une révision comme un nouveau changeset. Le nouveau changeset est un enfant du changeset "inversé". Si vous retirez un changeset différent du tip, un nouveau "head" est créé. Ce "head" est le parent dans le dossier de travail. created. This head is the parent of the working directory. Si vous retirez un vieux changeset, votre dossier de travail apparaîtra comme vieux après le backout. Vous devrez fusionner le changeset de backout avec un autre "head". L'option --merge se souvient du parent du dossier de travail avant de faire le backout, puis fusionne le nouveau "head" avec ce changeset. Cela vous évite de faire la fusion à la main. Le résultat de la fusion n'est pas soumise (pas de commit), comme pour une fusion normale. options: --merge fusionner avec un vieux parent après le backout

  -m, --message utiliser <text> comme message de commit

  -l, --logfile lire le message de commit depuis le fichier <fichier> -d, --date enregistre le code de date comme date de commit -u, --user enregistre l'utilisateur comme comitter -I, --include inclus les noms qui correspondent au motif donné -X, --exclude exclus les noms qui correspondent au motif donné

bundle FICHER DESTINATION

• Crée un fichier comprimé de changements contenant tous les changesets qui n'ont pas été trouvé dans l'autre dépôt.

Ce fichier peut être transféré en utilisant les moyens conventionnels et appliqués à un autre dépôt en utilisant la commande "unbundle". C'est utile lorsque pull et push ne sont pas disponible ou bien lorsque exporter un dépôt complet n'est pas désiré. L'extension standart du fichier est ".hg".

Contrairement à import/export, unbundle préserve exactement tous les contenus des changesets, en tenant compte des permissions, des informations de renommage et de l'historique de révision.

options:

-f, --force appliquer même quand le dépôt n'est pas

cat [OPTION]… FICHIER…

• Affiche les fichiers spécifiés comme ils ont été à une révision donnée. Si aucune révision n'est donnée, c'est le tip qui est utilisé.

La sortie peut être un fichier, dans ce cas là le nom de fichier est donné à l'aide d'une chaine formatée. Les règles de formattage sont les mêmes que pour la commande export, avec les ajouts suivants:

%s nom du fichier qui sera affiché

%d nom du dossier du fichier qui sera affiché, ou bien '.' si l'emplacement actuel est la racine du dépôt.

%p chemin du fichier relatif à la racine qui sera affiché.

options:

-o, --output envoie la sortie au fichier donné

-r, --rev affiche la révision donnée

-I, --include inclus les noms qui correspondent au motif donné

-X, --exclude exclus les noms qui correspondent au motif donné

clone [OPTION]… SOURCE [DESTINATION]

• Crée une copie d'un dépôt existant dans un nouveau dossier.

Si aucun dossier de destination n'est spécifié, il sera équivalent au nom du dossier 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 pull.

Pour des soucis de performances, les hardlinks (lien hard) 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 hardlinks, mais n'affichent pas d'erreur. Dans ces cas, utilisez l'option --pull pour éviter les liens hard.

Voir pull pour les détails sur les formats valides.

options: -U, --noupdate ne pas mettre à jour le nouveau dossier 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

commit [OPTION]… [FICHIER]…

• Commiter les changements des fichiers donnés dans le dépôt.

Si la liste de fichiers est omise, tous les changements reportés par "hg status" seront commités (soumis)

Si aucun message de commit n'est spécifié, l'éditeur configuré dans votre hgrc ou bien dans la variable d'environement EDITOR est lancé pour que vous entriez votre message de commit. enter a message.

options:

-A, --addremove marquer les nouveau fichiers ou fichiers manquants comme ajoutés ou supprimés avant d'effectuer le commit

-m, --message utiliser <texte> comme message de commit

-l, --logfile lire le message de commit depuis le fichier <fichier>

-d, --date enregistrer la date donnée (datecode) comme date de commit

-u, --user enregistrer l'utilisateur comme commiter

-I, --include inclus les noms qui correspondent au motif donné

-X, --exclude exclus les noms qui correspondent au motif donné

alias pour cette commandes: ci