(Cette page est une traduction de la version originale en Anglais : QuickStart
Guide de démarrage rapide
(référez vous aussi à FrenchUnderstandingMercurial, FrenchTutorial)
Contents
1. Fixer un nom d'utilisateur
Par défaut, Mercurial utilise un nom d'utilisateur de la forme 'user@localhost' pour les commits. Cela n'a souvent aucun sens. Il est conseillé de configurer votre propre adresse e-mail dans ~/.hgrc (ou pour un système Windows dans %USERPRIFILE%\Mercurial.ini) en ajoutant les lignes suivantes en les adaptant :
[ui] username = John Doe <john@example.com>
2. Travailler sur un projet Mercurial existant
Si vous avez une URL vers un dépôt consultable d'un projet (par exemple http://selenic.com/hg), vous pouvez en faire une copie ainsi :
$ hg clone http://selenic.com/hg mercurial-repo real URL is http://www.selenic.com/hg/ requesting all changes adding changesets adding manifests adding file changes added 6908 changesets with 13429 changes to 976 files updating working directory 861 files updated, 0 files merged, 0 files removed, 0 files unresolved
Ceci va créer un nouveau répertoire appelé mercurial-repo, récupérer l'historique complet du projet et mettre à jour le [[Tip|plus récent]] ChangeSet.
Pour regarder quelle révision a été récupérée :
$ cd mercurial-repo $ hg parents changeset: 6907:6dcbe191a9b5 tag: tip user: Matt Mackall <mpm@selenic.com> date: Mon Aug 18 16:50:36 2008 -0500 summary: Fix up tests
3. Mettre en place un nouveau projet Mercurial
Vous aller vouloir commencer par créer un dépôt :
$ cd project/ $ hg init # crée .hg
Mercurial va chercher un fichier appelé .hgignore à la racine de votre dépôt qui contient un ensemble de patterns au format "glob" et d'expressions régulières à ignorer dans les chemins de fichiers. Voici un exemple de fichier .hgignore :
syntax: glob *.orig *.rej *~ *.o tests/*.err syntax: regexp .*\#.*\#$
Testez votre fichier .hgignore avec :
$ hg status # Montre tous les fichiers non ignorés
Ceci va lister tous les fichiers qui ne sont pas ignorés avec un drapeau '?' (non suivi). Editez votre fichier .hgignore jusqu'à ce que seulement les fichier que vous voulez suivre soient listés par status. Vous voulez probablement suivre votre fichier .hgignore aussi, mais probablement pas les fichiers générés par le processus de construction. Une fois que vous être satisfaits, ordonnez vos fichiers à ajouter, ensuite [[Commit|commitez] :
$ hg add # Ajouter ces fichiers 'inconnus' $ hg commit # Commiter tous les changements, éditer le ChangeSet $ hg parents # Regardez la révision actuellement suivie
4. Clone, Commit, Merge
$ hg clone project project-work # cloner un dépôt $ cd project-work $ <faire des changements> $ hg commit $ cd ../project $ <faire d'autres changements> $ hg commit $ hg pull ../project-work # récupérer les ChangeSet de project-work $ hg merge # fusionner le nouveau Tip de project-work dans notre répertoire de travail $ hg parents # voir les révisions qui ont été fusionnées dans notre répertoire de travail $ hg commit # commiter le résultat de la fusion
Reportez vous aussi à : clone, ommit, pull, merge, parent
5. Exporter un patch
(make changes) $ hg commit $ hg export tip # exporter le commit le plus récent
Référez vous aussi à : export
6. Support réseau
# clone depuis le dépôt Mercurial principal $ hg clone http://selenic.com/hg/ $ cd hg # Mettre à jour un dépôt existant $ hg pull http://selenic.com/hg/ # Exporter votre dépôt actuel via HTTP avec une interface consultable sur le port 8000 $ hg serve -n "My repo" # Envoyer les changements vers un dépôt en utilisant SSH $ hg push ssh://user@example.com/hg/
Référez vous aussi à : serve, push, pull