QuickStartDe

This is a translated version of QuickStart. This is the mock-german version.

Einen Benuzternamen setzen

Voreingestellt nutzt Mercurial für Commits einen Benuzternamen der Form 'user@localhost'. Dieser ist oft bedeutungslos. Es ist das beste eine richtige E-Mail-Adresse in ~/.hgrc (oder auf einem Windows-System %USERPROFILE%\Mercurial.ini) zu konfigurieren, in dem man folgende Zeilen hinzufügt:

[ui]
username = Vorname Nachname <email@seite.de>

An einem existierenden Mercurial-Projekt arbeiten

Wenn Du eine URL für ein browsbares Projekt-Repository hast (z. B: http://selenic.com/hg), kannst Du folgendermaßen eine Kopie anlegen:

$ hg clone http://selenic.com/hg

Dies erzeugt ein neues Verzeichnis namens hg, holt eine komplette Projekt-Historie und checkt das neueste Changeset aus.

Ein neues Mercurial-Projekt einrichten

Ein neues hg-Repository wird aus einem existierende Projektverzeichnis wie folgt eingerichtet:

$ cd projekt/
$ hg init           # erzeugt .hg

Mercurial berücksichtigt falls existent eine Datei [".hgignore"] im root-Verzeichnis Deines Repositories, das eine Reihe von regulären Ausdrücken beinhalten kann, die in Dateipfaden ignoriert werden sollen:

syntax: glob
*.orig
*.rej
*~
*.o
tests/*.err

syntax: regexp
.*\#.*\#$

Teste Deine .hgignore Datei mit:

$ hg status         # zeigt alle nicht-ignorierten Dateien

Dies wird alle Dateien listen, die die nicht ignotiert werden mit de 'U'-Flag (unberkannt). Bearbeite Deine .hgignore Datei bis nur die Dateien. die Du verfolgen willst nach Status gelistet werden. Du wist Deine .hgignore Datei auch verfolgen wollen! Aber Du wirst wahrscheinlich nicht Dateien verfolgen, die durch den Build-Prozess erzeugt werden. Wenn Du zufrieden bist, setze Deine Dateien zum hinzufügen an und committe:

$ hg add            # füge diese 'unbekannten' Dateien hinzu
$ hg commit         # committe alle Änderungen, bearbeite Changelog-Eintrag

Branching und Merging

$ hg clone projekt projekt-work    # erzeuge einen neuen Branch (Zweig)
$ cd projekt-work
$ <mache Änderungen>
$ hg commit
$ cd ../projekt
$ hg pull ../projekt-work     # hole die Changesets von projekt-work
$ hg merge                  # merge den neuen tip (hinweis) von projekt-work in
                            # (alte Versionen benutzen stattdessen "hg update -m")
                            # das Arbeitsverzeichnis
$ hg commit                 # committe alle Ergebnisse des Merge

Einen Patch exportieren

(mache Änderungen)
$ hg commit
$ hg export tip   # exportiere den letzten Commit

Netzwerksupport

# hole vom primären Mercurial Repo
foo$ hg clone http://selenic.com/hg/
foo$ cd hg

# exportiere Dein aktuelles Repo via HTTP mit browsbarer Schnittstelle
foo$ hg serve -n "Mein repo" -p 80

# pushe Änderungen zu einem entfernten Repo mit SSH
foo$ hg push ssh://user@example.com/~/hg/

# merge Änderungen von einer Remotemaschine
bar$ hg pull http://foo/
bar$ hg merge # merge Änderungen in Dein Arbeitsverzeichnis

# Setze einen CGI-Server auf Deinem Webserver auf
foo$ cp hgwebdir.cgi ~/public_html/hg/index.cgi 
foo$ emacs ~/public_html/hg/index.cgi # adjust the defaults