Dieser Text befindet sich gegenwärtig in Bearbeitung, unterliegt ständigen Änderungen und kann dadurch nicht stets akkurat irgendeine freigegebene Version der Software Apache™ Subversion® beschreiben. Das Speichern dieser Seite als Lesezeichen oder andere auf diese Seite zu verweisen, ist keine so gute Idee. Besuchen Sie http://www.svnbook.com/, um stabile Versionen dieses Buchs zu erhalten.
Für einen Entwickler ist es üblich, zu einem gegebenen Zeitpunkt an mehreren unterschiedlichen, individuellen Änderungen an Teilen des Source-Codes zu arbeiten. Das liegt nicht notwendigerweise an schlechter Planung oder einer Art digitalen Masochismus. Ein Software-Engineer entdeckt oft Fehler am Rande während er an einem Teil des Codes in der Nähe arbeitet. Vielleicht ist er auch halbwegs mit einer großen Änderung fertig, wenn er feststellt, dass die von ihm übertragene Lösung besser als eine Sammlung kleinerer logischer Einheiten übergeben werden sollte. Oft befinden sich diese logischen Einheiten nicht in einem Modul, das sicher von anderen Änderungen getrennt ist. Die Einheiten könnten sich überlappen, mehrere unterschiedliche Dateien im gleichen Modul betreffen oder sogar verschiedene Zeilen in derselben Datei.
Entwickler können verschiedene Arbeitsweisen anwenden, um diese logischen Änderungen zu organisieren. Manche verwenden getrennte Arbeitskopien desselben Projektarchivs, um jede einzelne Änderung voranzutreiben. Andere wiederum wählen kurzlebige Arbeitszweige im Projektarchiv und verwenden eine einzelne Arbeitskopie, die ständig zwischen solchen Zweigen hin- und her geschaltet wird. Eine weitere Gruppe verwendet diff- und patch-Werkzeuge, um noch nicht übertragene Änderungen in entsprechenden Patch-Dateien zu sichern und wiederherzustellen Jede dieser Methoden hat ihre Vor- und Nachteile, und zu einem großen Teil beeinflussen die Details der vorzunehmenden Änderungen die Methodik, sie auseinander zu halten.
Subversion bietet das Leistungsmerkmal Änderungslisten mit, die dieser Mischung eine weitere Methode hinzufügen. Im Grunde sind Änderungslisten beliebige Label (momentan höchstens eins pro Datei), die ausschließlich zum Zweck der Zusammenfassung mehrerer Dateien auf Dateien der Arbeitskopie vergeben werden. Benutzer vieler Software-Angebote von Google kennen dieses Konzept bereits. Gmail beispielsweise verfügt nicht über den traditionellen, ordnerbasierten Ansatz der Gliederung von E-Mail. In Gmail vergeben Sie beliebige Labels auf E-Mails, und mehrere E-Mails gelten zu einer Gruppe gehörend, falls sie gemeinsam ein bestimmtes Label haben. Das Ansehen nur einer Gruppe ähnlich gelabelter E-Mails wird damit zu einem einfachen Trick der Benutzeroberfläche. Viele andere Web-2.0-Präsenzen verfügen über ähnliche Mechanismen – betrachten Sie etwa die „Tags“, die von YouTube und Flickr verwendet werden, „Kategorien“, die auf Blog Posts angewendet werden, usw. Den Menschen ist heutzutage bewusst, dass die Organisation von Daten kritisch ist, die Art und Weise der Organisation jedoch ein flexibles Konzept sein muss. Das alte Paradigma der Dateien und Ordner ist für manche Anwendung zu starr.
Subversions Unterstützung von Änderungslisten erlaubt Ihnen die Erstellung von Änderungslisten durch das Anbringen von Labels auf Dateien, die Sie mit dieser Änderungsliste in Verbindung bringen wollen, das Entfernen dieser Label und die Einschränkung des Wirkbereiches von Unterbefehlen auf die Dateien mit einem bestimmten Label. In diesem Abschnitt werden wir einen detaillierten Blick darauf werfen, wie so etwas gemacht werden kann.
Sie können Änderungslisten mit dem Befehl svn changelist erstellen, bearbeiten und löschen. Genauer gesagt verwenden Sie diesen Befehl, um die Verbindung einer Änderungsliste mit einer Datei der Arbeitskopie herzustellen oder aufzulösen. Eine Änderungsliste wird tatsächlich erstmals dann erstellt, wenn Sie eine Datei mit diesem Änderungslisten-Label versehen; sie wird gelöscht, wenn dieses Label von der letzten damit versehenen Datei entfernt wird. Sehen wir uns einmal einen Anwendungsfall an, der diese Konzepte vorstellt.
Harry beseitigt einige Fehler in der mathematischen Logik des Rechnerprogramms. Seine Arbeit veranlasst ihn, einige Dateien zu ändern:
$ svn status M integer.c M mathops.c $
Während er die Fehlerbehebung testet, bemerkt Harry, dass
seine Änderungen einen tangential in Bezug stehenden Fehler
der Logik der Benutzerschnittstelle in
button.c
ans Tageslicht bringen. Harry
entschließt sich, auch diesen Fehler als eine von seinen
Mathe-Reparaturen getrennte Übertragung zu beheben. In einer
kleinen Arbeitskopie mit nur einer handvoll Dateien und
wenigen logischen Änderungen kann Harry wahrscheinlich seine
zwei logisch gruppierten Änderungen ohne Problem im Kopf
auseinander halten. Heute jedoch wird er, um den Autoren
diesen Buchs einen Gefallen zu tun, die Änderungslisten von
Subversion verwenden.
Harry erstellt zunächst eine Änderungsliste und stellt sie in Beziehung zu den beiden von ihm bereits geänderten Dateien. Er macht das, indem er diesen Dateien mit dem Befehl svn changelist dieselbe, frei wählbare Änderungsliste zuweist:
$ svn changelist math-fixes integer.c mathops.c A [math-fixes] integer.c A [math-fixes] mathops.c $ svn status --- Änderungsliste »math-fixes«: M integer.c M mathops.c $
Wie Sie sehen können, spiegelt die Ausgabe von svn status diese neue Gruppierung wider.
Harry legt nun los, das sekundäre Problem der Benutzerschnittstelle zu beheben. Da er weiß, welche Datei er ändern wird, weist er auch diesen Pfad einer Änderungsliste zu. Unglücklicherweise weist Harry diese dritte Datei achtlos derselben Änderungsliste wie den beiden vorigen Dateien zu:
$ svn changelist math-fixes button.c A [math-fixes] button.c $ svn status --- Änderungsliste »math-fixes«: button.c M integer.c M mathops.c $
Zum Glück entdeckt Harry seinen Fehler. An dieser
Stelle hat er zwei Optionen. Er kann die Verbindung zur
Änderungsliste von button.c
lösen und
dann einen unterschiedlichen Listennamen zuweisen:
$ svn changelist --remove button.c D [math-fixes] button.c $ svn changelist ui-fix button.c A [ui-fix] button.c $
Oder er kann sich das Entfernen sparen und bloß einen
neuen Änderungslisten-Namen zuweisen. In diesem Fall wird
Subversion Harry warnen, dass button.c
von der ersten Änderungsliste entfernt wird:
$ svn changelist ui-fix button.c D [math-fixes] button.c A [ui-fix] button.c $ svn status --- Änderungsliste »ui-fix«: button.c --- Änderungsliste »math-fixes«: M integer.c M mathops.c $
Harry hat nun zwei unterschiedliche Änderungslisten in
seiner Arbeitskopie, und svn status
gruppiert seine Ausgaben nach den Bezeichnungen dieser
Änderungslisten. Beachten Sie, dass Harry die Datei
button.c
zwar noch nicht geändert hat,
sie aber trotzdem als interessant in der Ausgabe von
svn status erscheint, da eine Verknüpfung
mit einer Änderungsliste besteht. Änderungslisten können
jederzeit Dateien hinzugefügt oder entzogen werden, egal, ob
sie lokale Änderungen beinhalten.
Harry behebt nun das Problem der Benutzerschnittstelle in
button.c
.
$ svn status --- Änderungsliste »ui-fix«: M button.c --- Änderungsliste »math-fixes«: M integer.c M mathops.c $
Die visuelle Gruppierung, die Harry in der Ausgabe von
svn status im vorangegangenen Abschnitt
sieht, ist ganz nett, jedoch nicht so richtig nützlich. Der
Befehl status ist nur einer von mehreren,
die er vielleicht in seiner Arbeitskopie ausführen möchte.
Erfreulicherweise können viele andere Befehle von Subversion
auf Änderungslisten arbeiten, wenn die Option
--changelist
verwendet wird.
Wenn ihnen die Option --changelist
mitgegeben wird, beschränken Befehle von Subversion ihren
Wirkbereich auf die Dateien, die mit einer bestimmten
Änderungsliste verknüpft sind. Falls Harry nun die
eigentlichen Änderungen sehen möchte, die er an Dateien in
seiner Änderungsliste math-fixes
vorgenommen hat, könnte er in der
Kommandozeile des Befehls svn diff
ausdrücklich nur die Dateien angeben, die diese Änderungsliste
ausmachen.
$ svn diff integer.c mathops.c Index: integer.c =================================================================== --- integer.c (Revision 1157) +++ integer.c (Arbeitskopie) … Index: mathops.c =================================================================== --- mathops.c (Revision 1157) +++ mathops.c (Arbeitskopie) … $
Bei ein paar Dateien funktioniert das einwandfrei, was wäre aber, wenn Harrys Änderung 20 oder 30 Dateien beträfe? Das wäre eine schrecklich lange Liste ausdrücklich aufgeführter Dateinamen. Da Harry nun jedoch Änderungslisten verwendet, kann er das explizite Aufführen der Dateimenge in seiner Änderungsliste von nun an vermeiden und stattdessen nur den Namen der Änderungsliste angeben:
$ svn diff --changelist math-fixes Index: integer.c =================================================================== --- integer.c (Revision 1157) +++ integer.c (Arbeitskopie) … Index: mathops.c =================================================================== --- mathops.c (Revision 1157) +++ mathops.c (Arbeitskopie) … $
Und wenn es an der Zeit ist, zu übertragen, kann Harry
wieder die Option --changelist
verwenden, um
die Übertragung auf die Dateien einer bestimmten
Änderungsliste zu beschränken. Er könnte seine Fehlerbehebung
an der Benutzerschnittstelle etwa so übertragen:
$ svn commit -m "Fix a UI bug found while working on math logic." \ --changelist ui-fix Sende button.c Übertrage Daten . Revision 1158 übertragen. $
Der Befehl svn commit verfügt über eine
zweite Option in Zusammenhang mit Änderungslisten:
--keep-changelists
. Normalerweise werden
Verknüpfungen zu Änderungslisten nach der Übertragung von
Dateien aufgelöst. Wenn jedoch
--keep-changelists
angegeben wird, bewahrt
Subversion die Verknüpfung der übertragenen (und nun
unveränderten) Dateien zur Änderungsliste. In allen Fällen
berührt die Übertragung von Dateien einer Änderungsliste alle
anderen Änderungslisten nicht.
$ svn status --- Änderungsliste »math-fixes«: M integer.c M mathops.c $
Anmerkung | |
---|---|
Die Option |
Auch der Befehl svn changelist versteht
die Option --changelist
. Er ermöglicht Ihnen
das schnelle Umbenennen oder Entfernen einer
Änderungsliste:
$ svn changelist math-bugs --changelist math-fixes --depth infinity . D [math-fixes] integer.c A [math-bugs] integer.c D [math-fixes] mathops.c A [math-bugs] mathops.c $ svn changelist --remove --changelist math-bugs --depth infinity . D [math-bugs] integer.c D [math-bugs] mathops.c $
Schließlich können sie die Option
--changelist
mehrfach für einen Befehl auf
einer einzelnen Kommandozeile angeben. Das beschränkt den
auszuführenden Befehl auf Dateien, die in irgendeiner der
angegebenen Änderungslisten zu finden sind.
Die Änderungslisten von Subversion sind ein praktisches Werkzeug, um Dateien in Arbeitskopien zu gruppieren; allerdings besitzen sie ein paar Einschränkungen. Änderungslisten sind Artefakte einer bestimmten Arbeitskopie, was bedeutet, dass Änderungslisten-Zuweisungen nicht an das Projektarchiv weitergegeben und auch anderweitig nicht gemeinsam von anderen Benutzern verwendet werden können. Änderungslisten lassen sich nur Dateien zuordnen – momentan unterstützt Subversion nicht die Verwendung von Änderungslisten für Verzeichnisse. Schließlich können Sie einer gegebenen Datei der Arbeitskopie höchstens eine Änderungsliste zuweisen. Hier passen die Analogien der Blog-Posts-Kategorien oder der Foto-Tags nicht mehr – sollte es notwendig sein, eine Datei mehreren Änderungslisten zuzuweisen, haben Sie Pech.