|
Size: 6983
Comment: update section 2 vocabulary per GermanTranslation
|
Size: 9552
Comment: update section 4 per GermanTranslation and latest English page
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 79: | Line 79: |
| == Revisionen, Changesets, Heads, und Tip == Mercurial fasst zusammengehörige Änderungen an verschiedenen Dateien jeweils zu einem einzigen atomaren '''Changeset''' zusammen. Solche Changesets sind die '''Revisionen''' des gesamten Projekts, die jeweils eine aufeinanderfolgender Nummer erhalten. Da Mercurial gleichzeitiges verteiltes Entwickeln erlaubt, können diese Nummern sich zwischen den einzelnen Benutzern unterscheiden. Darum weist Mercurial außerdem jeder Revision eine globale '''Changeset-ID''' zu. Changeset-IDs sind 40-stellige Hexadezimalzahlen, können jedoch auf die Anfangsstellen (z. B. "e38487") abgekürzt werden, solange dadurch keine Zweideutigkeit entsteht. {{{#!dot digraph { rankdir = LR node [shape=box] "rev 0:838e" -> "rev 1:34ef" -> "rev 2:4563" "rev 1:34ef" -> "rev 3:fe56" "rev 2:4563" -> "rev 4:ac98" "rev 3:fe56" -> "rev 4:ac98" "rev 4:ac98" -> "rev 5:0345" "rev 4:ac98" -> "rev 6:19e3 (tip)" label="Beispiel-History" } }}} Zweige (branches) und Merges (Zusammenführungen) in der Revision-History können an jedem Punkt auftreten. Jeder nicht zusammengeführte Zweig erzeugt einen neuen '''Head''' der Revisionshistory. Hier sind die Revisionen 5 und 6 die Heads. Mercurial behandelt Revision 6 als '''Tip''' des Repositorys, also den Head mit der höchsten Revisionsnummer. == Klonen, Änderungen vornehmen, Zusammenführen und Pulling == Beginnen wir mit einem Benutzer Alice, deren Speicher so aussieht: {{{#!dot digraph { label="Alices Repo" rankdir = LR node [shape=box] a->b->c->d } }}} Bob '''klont''' das Repository, und gelangt zu einer vollständigen Kopie des Speichers von Alice (wobei sein Arbeitsverzeichnis unabhängig von ihrem ist!): {{{#!dot digraph { label="Bobs Repo" rankdir = LR node [shape=box] a->b->c->d } }}} Jetzt '''committet''' Bob einige Änderungen: {{{#!dot digraph { label="Bobs Repo" rankdir = LR node [shape=box] a->b->c->d->e->f e [color=blue] f [color=blue] } }}} Parellel dazu führt Alice ihre eigenen Änderungen durch: {{{#!dot digraph { label="Alices Repo" rankdir = LR node [shape=box] a->b->c->d->g g [color=red] } }}} Nun '''pullt''' Bob Alice' Repo für eine Synchronisation. Damit werden alle von Alice durchgeführten Änderungen in Bobs Repo übernommen: {{{#!dot digraph { label="Bobs Repo" rankdir = LR node [shape=box] a->b->c->d->e->f e [color=blue] f [color=blue] d->g g [color=red;label="g (tip)"] } }}} Weil Alice' '''g''' der jüngste "head" in Bobs Repository ist, wird er jetzt zum '''Tip'''. Bob führt dann einen '''Merge''' durch der seine letzte Änderung ('''f''') mit dem Tip verbindet, committet das Ergebnis, und erhält folgendes: {{{#!dot digraph { label="Bobs Repo" rankdir = LR node [shape=box] a->b->c->d->e->f e [color=blue] f [color=blue] d->g g [color=red] f->h g->h h [color=green;label="h (tip)"] } }}} Wenn Alice jetzt von Bob '''pullt''', erhält sie seine Änderungen e, f, und h, und sie sind vollkommen synchron: {{{#!dot digraph { label="Alice' Repo" rankdir = LR node [shape=box] a->b->c->d->g d->e->f e [color=blue] f [color=blue] g [color=red] f->h g->h h [color=green;label="h (tip)"] |
== Revisionen, Änderungssätze, Köpfe, und Spitze == Mercurial fasst zusammengehörige Änderungen an verschiedenen Dateien jeweils zu einem einzigen atomaren '''Änderungssatz''' zusammen. Solche Änderungssätze sind die '''Revisionen''' des gesamten Projekts, die jeweils eine aufeinanderfolgender Nummer erhalten. Da Mercurial gleichzeitiges verteiltes Entwickeln erlaubt, können diese Nummern sich zwischen den einzelnen Benutzern unterscheiden. Darum weist Mercurial außerdem jeder Revision eine globale '''Änderungssatz-ID''' zu. Änderungssatz-IDs sind 40-stellige Hexadezimalzahlen, können jedoch auf die Anfangsstellen (z. B. "e38487") abgekürzt werden, solange dadurch keine Zweideutigkeit entsteht. {{{#!dot digraph { rankdir = LR node [shape=record] rev0 [label="{{<p1> p1 | <p2> p2} | rev 0:838e}"]; rev1 [label="{{<p1> p1 | <p2> p2} | rev 1:34ef}"]; rev2 [label="{{<p1> p1 | <p2> p2} | rev 2:4563}"]; rev3 [label="{{<p1> p1 | <p2> p2} | rev 3:fe56}"]; rev4 [label="{{<p1> p1 | <p2> p2} | rev 4:ac98}"]; rev5 [label="{{<p1> p1 | <p2> p2} | rev 5:0345}"]; rev6 [label="{{<p1> p1 | <p2> p2} | rev 6:19e3 (tip)}"]; workingdir [label="{{<p1> p1 | <p2> p2} | Arbeitsverzeichnis}"]; rev0 -> rev1:p1 [dir=back] rev1 -> rev2:p1 [dir=back] rev1 -> rev3:p1 [dir=back] rev2 -> rev4:p1 [dir=back] rev3 -> rev4:p2 [dir=back] rev4 -> rev5:p1 [dir=back] rev4 -> rev6:p1 [dir=back] rev6 -> workingdir:p1 [dir=back] label="Beispiel-Archiv" } }}} Zweige (branches) und Zusammenführungen (merges) in der Revision-Historie können an jedem Punkt auftreten. Jeder nicht zusammengeführte Zweig erzeugt einen neuen '''Kopf''' der Revisionshistorie. Hier sind die Revisionen 5 und 6 die Heads. Mercurial behandelt Revision 6 als '''Spitze''' des Archivs, also den Kopf mit der höchsten Revisionsnummer. == Klonen, Änderungen vornehmen, Zusammenführen und Abrufen == Beginnen wir mit einem Benutzer Alice, deren Archiv so aussieht: {{{#!dot digraph { label="Alices Archiv" rankdir = LR node [shape=box] a -> b -> c -> d -> "Arbeitsverzeichnis" [dir=back] } }}} Bob '''klont''' den Archiv, und gelangt zu einer vollständigen, unabhängigen, lokalen Kopie des Speichers von Alice, sowie einem Arbeitsverzeichnis, das mit dem Speicher gleich lautet: {{{#!dot digraph { label="Bobs Archiv" rankdir = LR node [shape=box] a -> b -> c -> d -> "Arbeitsverzeichnis" [dir=back] } }}} Jetzt kann Bob unabhängig von Alice entwickeln. Er '''übernimmt''' danach einige Änderungen e und f: {{{#!dot digraph { label="Bobs Archiv" rankdir = LR node [shape=box] a -> b -> c -> d -> e -> f -> "Arbeitsverzeichnis" [dir=back] e [color=blue] f [color=blue] } }}} Gleichzeitig dazu übernimmt Alice ihre eigene Änderung g, wobei ihr Archiv von Bobs abzweigt (daher ein Zweig): {{{#!dot digraph { label="Alices Archiv" rankdir = LR node [shape=box] a -> b -> c -> d -> g -> "Arbeitsverzeichnis" [dir=back] g [color=red] } }}} Nun '''ruft''' Bob von Alices Archiv für eine Synchronisation '''ab'''. Damit werden alle von Alice übernommen Änderungen in Bobs Speicher abgeschrieben (hier nur eine einzige Änderungssatz, g). Beachten sie, dass Bobs Arbeitsverzeichnis dabei '''nicht''' verändert wird: {{{#!dot digraph { label="Bobs Archiv" rankdir = LR node [shape=box] a -> b -> c -> d -> e -> f -> "Arbeitsverzeichnis" [dir=back] e [color=blue] f [color=blue] d -> g [dir=back] g [color=red;label="g (Spitze)"] } }}} Da Alices '''g''' der jüngste Kopf in Bobs Repository ist, wird er jetzt zum '''Spitze''' (tip). Bob führt dann eine '''Zusammenführung''' (merge) durch, die seine letzte Änderung (f) mit der Spitze in sein Arbeitsverzeichnis verbindet. Nun hat sein Arbeitsverzeichnis zwei Vorgänger (f und g): {{{#!dot digraph { label="Bobs Archiv" rankdir = LR node [shape=box] a -> b -> c -> d -> e -> f [dir=back] e [color=blue] f [color=blue] d -> g [dir=back] g [color=red] f -> "Arbeitsverzeichnis" [dir=back, weight=3.0] g -> "Arbeitsverzeichnis" [dir=back, weight=3.0] } }}} Nachdem Bob das Ergebnis der Zusammenführung beobachtet, um zu überzeugen, es vollkommen sei, übernimmt Bob das Ergebnis, und erhält eine neue '''Zusammenführung-Änderungssatz''' in seinem Speicher: {{{#!dot digraph { label="Bobs Archiv" rankdir = LR node [shape=box] a -> b -> c -> d -> e -> f [dir=back] e [color=blue] f [color=blue] d -> g [dir=back] g [color=red] f -> h [dir=back, weight=3.0] g -> h [dir=back, weight=3.0] h -> "Arbeitsverzeichnis" [dir=back] h [color=green, label="h (Spitze)"] } }}} Wenn Alice jetzt von Bob '''abruft''', erhält sie seine Änderungen e, f, und h in ihren Speicher: {{{#!dot digraph { label="Alices Archiv" rankdir = LR node [shape=box] a -> b -> c -> d -> e -> f [dir=back] e [color=blue] f [color=blue] d -> g -> "Arbeitsverzeichnis" [dir=back] g [color=red] f -> h [dir=back, weight=3.0] g -> h [dir=back, weight=3.0] h [color=green, label="h (Spitze)"] } }}} Beachten sie, dass Alices Arbeitsverzeichnis von Abruf nicht verändert wird. Um ihren Arbeitsverzeichnis mit der Änderungssatz h abzugleichen, muss sie es '''aktualisieren'''. Damit wird der Vorgänger ihres Arbeitsverzeichnisses zur Änderungssatz h verändert und die Dateien im Arbeitsverzeichnis zur Änderungssatz h aktualisiert. {{{#!dot digraph { label="Alices Archiv" rankdir = LR node [shape=box] a -> b -> c -> d -> e -> f [dir=back] e [color=blue] f [color=blue] d -> g [dir=back] g [color=red] f -> h [dir=back, weight=3.0] g -> h [dir=back, weight=3.0] h -> "Arbeitsverzeichnis" [dir=back] h [color=green, label="h (Spitze)"] |
Mercurial verstehen
Mercurials Model dezentraler Entwicklung kann neue Benutzer verwirren. Diese Seite beleuchtet einige grundlegende Konzepte. Im Tutorial finden sie eine Schritt-für-Schritt-Anleitung.
(This page in English: UnderstandingMercurial)
Contents
1. Was ist in einem Archiv
Mercurial-Archive enthalten ein Arbeitsverzeichnis gekoppelt mit einem Speicher:
Der Speicher enthält die vollständige Historie (alle jemals übernommenen Änderungen) des Projekts. Anders als traditionelle SCMs, bei denen es nur eine zentrale Kopie dieser Historie gibt, besitzt jedes Arbeitsverzeichnis eine eigene private Kopie der Historie. Dies erlaubt es, gleichzeitig zu entwickeln.
Das Arbeitsverzeichnis enthält eine Kopie der Dateien eines Projekts zu einem gegebenen Zeitpunkt (beispielsweise rev 2), bereit zum Bearbeiten. Auch Tags und ignorierte Dateien werden von der Revisionskontrolle verwaltet, sind also ebenfalls enthalten.
2. Änderungen übernehmen
Wenn sie übernehmen, wird der Zustand des Arbeitsverzeichnisses mit den Änderungen im Vergleich zu seinen Vorgängern als eine neue Revision aufgezeichnet:
Beachten sie, dass Revision 4 ein Zweig (branch) der Revision 2 ist, die zuvor die Revision im Arbeitsverzeichnis war. Jetzt ist Revision 4 der Vorgänger des Arbeitsverzeichnisses.
3. Revisionen, Änderungssätze, Köpfe, und Spitze
Mercurial fasst zusammengehörige Änderungen an verschiedenen Dateien jeweils zu einem einzigen atomaren Änderungssatz zusammen. Solche Änderungssätze sind die Revisionen des gesamten Projekts, die jeweils eine aufeinanderfolgender Nummer erhalten. Da Mercurial gleichzeitiges verteiltes Entwickeln erlaubt, können diese Nummern sich zwischen den einzelnen Benutzern unterscheiden. Darum weist Mercurial außerdem jeder Revision eine globale Änderungssatz-ID zu. Änderungssatz-IDs sind 40-stellige Hexadezimalzahlen, können jedoch auf die Anfangsstellen (z. B. "e38487") abgekürzt werden, solange dadurch keine Zweideutigkeit entsteht.
Zweige (branches) und Zusammenführungen (merges) in der Revision-Historie können an jedem Punkt auftreten. Jeder nicht zusammengeführte Zweig erzeugt einen neuen Kopf der Revisionshistorie. Hier sind die Revisionen 5 und 6 die Heads. Mercurial behandelt Revision 6 als Spitze des Archivs, also den Kopf mit der höchsten Revisionsnummer.
4. Klonen, Änderungen vornehmen, Zusammenführen und Abrufen
Beginnen wir mit einem Benutzer Alice, deren Archiv so aussieht:
Bob klont den Archiv, und gelangt zu einer vollständigen, unabhängigen, lokalen Kopie des Speichers von Alice, sowie einem Arbeitsverzeichnis, das mit dem Speicher gleich lautet:
Jetzt kann Bob unabhängig von Alice entwickeln. Er übernimmt danach einige Änderungen e und f:
Gleichzeitig dazu übernimmt Alice ihre eigene Änderung g, wobei ihr Archiv von Bobs abzweigt (daher ein Zweig):
Nun ruft Bob von Alices Archiv für eine Synchronisation ab. Damit werden alle von Alice übernommen Änderungen in Bobs Speicher abgeschrieben (hier nur eine einzige Änderungssatz, g). Beachten sie, dass Bobs Arbeitsverzeichnis dabei nicht verändert wird:
Da Alices g der jüngste Kopf in Bobs Repository ist, wird er jetzt zum Spitze (tip).
Bob führt dann eine Zusammenführung (merge) durch, die seine letzte Änderung (f) mit der Spitze in sein Arbeitsverzeichnis verbindet. Nun hat sein Arbeitsverzeichnis zwei Vorgänger (f und g):
Nachdem Bob das Ergebnis der Zusammenführung beobachtet, um zu überzeugen, es vollkommen sei, übernimmt Bob das Ergebnis, und erhält eine neue Zusammenführung-Änderungssatz in seinem Speicher:
Wenn Alice jetzt von Bob abruft, erhält sie seine Änderungen e, f, und h in ihren Speicher:
Beachten sie, dass Alices Arbeitsverzeichnis von Abruf nicht verändert wird. Um ihren Arbeitsverzeichnis mit der Änderungssatz h abzugleichen, muss sie es aktualisieren. Damit wird der Vorgänger ihres Arbeitsverzeichnisses zur Änderungssatz h verändert und die Dateien im Arbeitsverzeichnis zur Änderungssatz h aktualisiert.
5. Ein dezentrales System
Mercurial arbeitet vollkommen dezentral und kommt ohne internes Konzept eines zentralen Repositorys aus. Daher steht es den Benutzern frei, eigene Topologien zu definieren über die sie Änderungen teilen wollen:
Für eine praktische Einführung in die Benutzung von Mercurial, siehe GermanTutorial.