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 ces fichiers ; voir "FILE NAME PATTERNS" pour plus d'information sur la recherche par motif.
chemin
- inquide un chemin (vers un fichier ou répertoire) 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
- répertoire racine du dépôt ou chemin symbolique vers celui-ci
—cwd
- change le répertoire 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 prend 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 inclut 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 inclut les noms qui correspondent au motif donné -X, --exclude exclut 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 sont : "files" (défaut): un répertoire plein de fichiers "tar": archive tar, non compressée "tbz2": archive tar, compressée en utilisant bzip2 "tgz": archive tar, compressée en utilisant gzip "uzip": archive zip, non compressée "zip": archive zip, compressée en utilisant "deflate" Le nom exact de l'archive de destination ou du répertoire 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 répertoire. 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 répertoire pour l'archive -r, --rev révision à extraire -t, --type format des données à créer -I, --include inclut les noms qui correspondent au motif donné -X, --exclude exclut 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 répertoire de travail. Cette "head" est le parent du répertoire de travail. Si vous retirez un vieux changeset, votre répertoire de travail apparaîtra comme vieux après le backout. Vous devrez fusionner le changeset de backout avec un autre "head". L'option --merge garde en mémoire le parent du répertoire 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 archivé dans la base (pas de commit), comme pour une fusion normale. options: --merge fusionner avec un vieux parent après le backout
-m, --message utiliser <texte> 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 personne ayant effectué le commit -I, --include inclut les noms qui correspondent au motif donné -X, --exclude exclut 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és 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 les commandes "pull" et "push" ne sont pas disponibles ou bien lorsque exporter un dépôt complet n'est pas désiré. L'extension standard 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 des révisions.
options:
-f, --force appliquer même quand le dépôt distant n'a aucun lien -r, --rev le numéro du changeset que l'on veut transformer empaqueter --base indiquer le changeset d'une base plutôt qu'un chemin -e, --ssh indiquer la commande ssh à utiliser --remotecmd indiquer la commande hg à exécuter sur le site distant
cat [OPTION]… FICHIER…
- Affiche les fichiers spécifiés comme ils étaient à 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 répertoire 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 inclut les noms qui correspondent au motif donné
-X, --exclude exclut les noms qui correspondent au motif donné
clone [OPTION]… SOURCE [DESTINATION]
- Crée une copie d'un dépôt existant 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 pull.
Pour des 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.
Voir pull pour les détails sur les formats valides.
options: -U, --noupdate ne pas mettre à 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
commit [OPTION]… [FICHIER]…
- Enregistrer les modifications 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 enregistrés.
Si aucun message n'est spécifié lors de l'enregistrement, l'éditeur configuré dans votre hgrc ou bien dans la variable d'environement EDITOR est lancé pour que vous entriez votre message d'enregistrement.
options:
-A, --addremove marquer fichiers nouveaux/manquants comme ajoutés/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 personne ayant fait le commit
-I, --include inclut les noms qui correspondent au motif donné
-X, --exclude exclus les noms qui correspondent au motif donné
alias pour cette commandes: ci