Instalace na Debian Lenny

# aptitude install mercurial

FIXME: doplnit, odzkoušet

Krátké ukázky použití přímo z webu mercurial. Stažení (naklonování) projektu, práce na projektu a odeslání změn.

$ hg clone http://selenic.com/repo/hello
$ cd hello
$ # práce na projektu, editování souborů
$ hg add (new files)
$ hg commit -m 'Popis provedených změn.'
$ hg push

Vytvoření nového projektu.

$ hg init (project-directory)
$ cd (project-directory)
$ # práce na projektu, editování souborů
$ hg add
$ hg commit -m 'Initial commit'

Například zdrojové kódy této knihy jsem zavedl do Mercurial repository následujícím postupem.

$ cd ~/src/doc/book/unix        # přepnutí do adresáře projektu 
~/src/doc/book/unix$ make superclean    # vyčištění od produktů překladu
~/src/doc/book/unix$ cd ..
~/src/doc/book$ hg init unix    # inicializace repositráře Mercurial
~/src/doc/book$ cd unix
~/src/doc/book/unix$ hg add     # přidání všech souborů projektu 
~/src/doc/book/unix$ hg commit -m "Zavedení knihy do SCM Mercurial"

Pracovní cyklus projektu. Začneme tím, že máme aktualizovaný projekt. Nyní můžeme editovat jednotlivé soubory v projektu. Pokud nějaký soubor odstraníme, oznámíme to ihned příkazem

$ hg add soubor

Důležité je to udělat co nejdříve, ať na to nemusíme myslet. Pokud nějaký soubor naopak odstraníme oznámíme to příkazem

$ hg remove soubor

Průběžně se můžeme ptát jaký je stav projektu. T.j. které soubory se změnily, přibyly nebo byly odstraněny.

$ hg status

Můžeme se ptát i na rozdíly. Tedy co se v souborech změnilo. První příkaz zobrazí změny v jednom konkrétním souboru. Druhý příkaz změny ve všech souborech v projektu.

$ hg diff soubor
$ hg diff