#language de

== Tutorial - Eine erste Änderung durchführen ==

Wir bauen auf GermanTutorialHistory auf und befinden uns in unserem {{{my-hello}}}-Repository, dass wir in GermanTutorialClone geklont haben.

Es ist gute Praxis beim Entwickeln mit Mercurial jede Änderung isoliert in einem separaten [[Repository]] durchzuführen.  Damit vermeidet man, dass nicht zusammengehöriger Code vermischt wird, und das Ergebnis nicht zusammengehöriger Arbeitsschritte lässt sich leichter testen. Lass uns anfangen, indem wir diesem Modell folgen.

Unser simples Ziel ist es, das "Hallo Welt!"-Program dazu zu bringen eine weitere Zeile auszugeben. Als erstes erzeugen wir ein neues Repository, das wir {{{my-hello-new-output}}} nennen, in dem wir von {{{my-hello}}} für unser kleines Projekt klonen.

{{{
$ cd ..
$ hg clone my-hello my-hello-new-output
}}}

In diesem Falle wird der "clone"-Befehl nichts ausgeben, wenn er erfolgreich ist.

'''Hinweis:''' ''Beachte, dass wir unserem neuen [[Repository]] einen beschreibenden Namen gegeben haben, der den grundsätzlichen Zweck des  [[Repository]] beschreibt.  Da  das Klonen  eines [[Repository]] in [[Mercurial]] "billig" ist, werden wir bald eine Menge etwas unterschiedlicher Repositories ansammeln.  Wenn wir diesen keine beschreibenden Namen geben, werden wir schnell Probleme haben, diese auseinander zu halten.''

Nun ist es an der Zeit eine Änderung in unserem neuen [[Repository]] zu machen. Lass uns dazu in unser Arbeitsverzeichnis ([[WorkingDirectory|working directory]]) gehen, welches einfach nur der Name des Verzeichnisses ist, in dem sich all unsere Dateien befinden und modifiziere dort den Quellcode mit deinem Lieblingseditor:

{{{
$ cd my-hello-new-output
$ vi hello.c
}}}

Der Inhalt von {{{hello.c}}} sollte beim ersten Öffnen so aussehen:

{{{#!cplusplus numbers=off
/*
 * hello.c
 *
 * Placed in the public domain by Bryan O'Sullivan
 *
 * This program is not covered by patents in the United States or other
 * countries.
 */

#include <stdio.h>

int main(int argc, char **argv)
{
        printf("hello, world!\n");
        return 0;
}
}}}

Lass uns die {{{main}}}-Funktion so editieren, dass sie noch eine zusätzliche Zeile ausgibt:

{{{#!cplusplus numbers=off
(...)

int main(int argc, char **argv)
{
        printf("hello, world!\n");
        printf("sure am glad I'm using Mercurial!\n");
        return 0;
}
}}}

Wenn wir soweit sind, können wir die Datei speichern, unseren Lieblingseditor schließen und sind fertig, das wars. Nach dieser Änderung sind wir bereit ein ChangeSet zu erstellen.

Aber was ist, wenn wir gestört wurden und vergessen haben, welche Änderungen in das ChangeSet kommen werden, wenn wir es erstellen? In diesem Fall nutzen wir den {{{status}}} Befehl.

{{{
$ hg status
M hello.c
}}}

Die Ausgabe ist zwar knapp, jedoch sagt uns das Präfix {{{M}}}, dass {{{hello.c}}} verändert wurde ('''M''' -> ''modified''), also die Änderung in den ChangeSet aufgenommen wird.

Die eigentliche Änderung, welche wir gemacht haben, können wir uns aber auch ansehen, indem wir den {{{diff}}}-Befehl nutzen:

{{{
$ hg diff
diff -r 82e55d328c8c hello.c
--- a/hello.c   Fri Aug 26 01:21:28 2005 -0700
+++ b/hello.c   Fri Sep 30 10:27:47 2005 +0800
@@ -12,5 +12,6 @@
 int main(int argc, char **argv)
 {
        printf("hello, world!\n");
+       printf("sure am glad I'm using Mercurial!\n");
        return 0;
 }
}}}

<!> Für den Fall, dass wir unsere Änderung '''verwerfen''' und noch einmal von vorne anfangen wollen, können wir den {{{revert}}}-Befehl nutzen, um hello.c in seinen vorherigen Zustand (vor unserer Modifikation) wiederherzustellen (mit der Option -a werden alle Dateien wiederhergestellt). Aber sei dir vorher sicher, dass es  wirklich das ist, was du willst.

{{{
$ hg revert hello.c
}}}

Der Schritt einen ChangeSet zu erstellen nennt sich Committing. Wir führen einen Commit mit dem Befehl {{{commit}}} durch:

{{{
$ hg commit
}}}

Das {{{commit}}} bringt uns in einen Editor und zeigt uns ein paar kryptische Textzeilen.

'''Hinweis:''' ''Der Standard-Editor ist {{{vi}}}. Dies kann durch das Umstellen der Umgebungsvariablen {{{EDITOR}}} oder {{{HGEDITOR}}} geändert werden. Auch der Wert für {{{manifest hash}}} kann verschieden sein, je nachdem wie du die Datei gespeichert oder geschrieben hast.''

{{{
(empty line)
HG: manifest hash 14595beb70bcfb74bf227437d70c38878421c944
HG: changed hello.c
}}}

Die erste Zeile ist leer, und die darauf folgenden Zeilen identifizieren die Datei(en), die in das ChangeSet kommen werden.

Um den Commit zu vollenden müssen wir den Grund für das Changeset beschreiben. Dies wird üblicherweise als ChangeSet ''comment'' bezeichnet, ein Kommentar also, der uns und anderen helfen soll, die Änderungen zu beschreiben, die zum ChangeSet geführt haben. Lass uns so etwas wie das Folgende dort hinein schreiben:

{{{
Express great joy at existence of Mercurial
HG: manifest hash 14595beb70bcfb74bf227437d70c38878421c944
HG: changed hello.c
}}}

Als nächstes speichern wir den Test und verlassen den Editor. Wenn alles gut läuft, wird der {{{commit}}}-Befehl ohne weitere Ausgabe beendet.

<!> Wenn du den Editor verlässt ohne vorher den Text zu speichern, wird der {{{commit}}} die Operation abbrechen, und man kann alles nocheinmal überdenken bevor man den {{{commit}}} durchführt.

'''Hinweis:''' ''Bevor man etwas in einem ernsthaften Projekt "committed", sollte man einen aussagekräftigen Benutzernamen in {{{~/.hgrc}}} setzen. Siehe hierzu auch nach Hinweisen in [[QuickStart2]].''

Nun schauen wir mal, was der {{{status}}}-Befehl uns sagt.

{{{
$ hg status
}}}

Nichts, keine Ausgabe! Unsere Änderung wurde in den ChangeSet "''committed''", also gibt es keine geänderte, neue oder gelöschte Datei, die einen {{{commit}}} benötigt. Unser [[Tip]] stimmt nun mit dem Inhalt des Arbeitsverzeichnisses überein.  

Wir können uns nun einmal die Änderungshistorie unserer neuen Arbeit ansehen:
{{{
$ hg log
changeset:   2:a58809af174d
tag:         tip
user:        mpm@selenic.com
date:        Fri Aug 26 01:26:28 2005 -0700
summary:     Express great joy at existence of Mercurial

(...)
}}}

Da ist es! Wir haben mit dem {{{commit}}}-Befehl ein ChangeSet erstellt.

'''Hinweis:''' Der Benutzer (user), das Datum (date) und die ChangeSetID werden garantiert variieren.

Wie wir in dem TutorialClone besprochen haben, existiert das neue ChangeSet nur in diesem lokalen Repository(!). Dies ist wichtig zu merken und der kritische Teil von [[Mercurial]], zu diesem Zeitpunkt hat noch kein anderer Entwickler von unseren Änderungen an unserem Repository ''gehört''.

Um Änderungen auch anderen mitzuteilen, müssen wir mit dem GermanTutorialShareChange weiter machen.
----
CategoryGerman