Trac Changeset Modul

Table of Contents

Trac enthält ein integriertes Modul, um diffs (Dateiänderungen zwischen Revisionen) zu visualisieren.

Es gibt unterschiedliche Arten von changesets: Die Unterschiede zwischen einzelnen Revisionen im Repository, oder die gesammelten Unterschiede mehrerer Revisionen. Alle werden aber auf die gleiche Weise präsentiert.

Eine Changeset-Ansicht besteht aus zwei Teilen, dem header sowie der diff-Ansicht.

Changeset Header

Der Header zeigt eine Übersicht über das gesamte Changeset. Hier werden folgende Informationen angezeigt:

  • Timestamp -- Wann wurde das Changeset in die Versionskontrolle committet
  • Author -- Wer hat das Changeset hochgeladen
  • Message -- Eine kurze Beschreibung durch den Autor (die Commit Log Message)
  • Files -- Eine Liste von durch das Changeset betroffenen Dateien

Wenn mehr als eine Revision betrachtet wird, werden die Felder Timestamp, Author und Message nicht angezeigt.

Vor jeder aufgeführten Datei wird ein farbiges Icon angezeigt, welches die Art der Veränderung anzeigt.

  • Grün: hinzugefügt
  • Rot: gelöscht
  • Gelb: verändert
  • Blau: kopiert
  • Grau: verschoben

Die Legende des Farbcodes wird am Ende des Headers angezeigt.

Diff-Ansicht

Unterhalb des Headers ist der Hauptteil des Changesets, die Diff-Ansicht (Diff = Differenz). Jede Datei wird in einem eigenen Abschnitt angezeigt, in dem jeweils nur die veränderten Teile der Datei angezeigt werden. Es gibt zwei unterschiedliche Anzeigetypen, inline oder nebeneinander (die Umschaltung zwischen beiden Stilen erfolgt in den FIXME Voreinstellungen FIXME):

  • Der inline-Stil zeigt die Veränderungen untereinander an. Wurden Zeilen aus der Datei entfernt, erscheint der Bereich in rot. Neu hinzugefügte Bereiche erscheinen grün. Wurden Zeilen verändert, werden alte und neue Version in rot bzw. grün übereinander angezeigt. Die Zeilennummern auf der linken Seite zeigen die genaue Position der Änderung sowohl in der alten als auch der neuen Dateiversion an.
  • Der nebeneinander-Stil zeigt die alte Dateiversion links, die neue rechts an. Dies erfordert üblicherweise eine größere Fensterbreite des Browsers verglichen mit der inline-Variante. Hinzugefügte und entfernte Bereiche werden grün und rot dargestellt, lediglich veränderte Bereiche haben im Unterschied zu inline einen gelben Hintergrund.

Zusätzlich sind diverse Optionen verfügbar, mit denen man in den Einstellungen die Anzeige der diffs beeinflussen kann:

  • Die Anzahl der Zeilen vor und nach einer veränderten Zeile ist einstellbar (wenn der Wert auf all gesetzt wird, wird die gesamte Datei angezeigt)
  • Es ist einstellbar, ob leere Zeilen, Änderung der Groß-/Kleinschreibung und der Leerzeichen bei der Diff-Anzeige ignoriert werden, um die funktionalen Änderungen schneller aufzufinden.

Unterschiedliche Wege, um ein Diff anzuzeigen

Changeset untersuchen

Wenn ein Checkin ins Repository betrachtet wird, beispielsweise indem einem Changeset-Link oder einem Changeset-Event in der Timeline gefolgt wurde, zeigt Trac die Änderungen dieses Checkins an.

Außerdem werden Links anzeigt, die eine Navigation vor und zurück innerhalb der Changesets erlauben (Previous Changeset und Next Changeset).

Unterschiede zwischen Revisionen untersuchen

Oft sind die Veränderungen an einer einzelnen Datei interessant, oder an einem Verzeichnis, die mehrere Revisionen umfassen. Der einfachste Weg hierzu ist, im TracRevisionLog? die zu vergleichende alte und neue Revision einzugeben und View changes zu klicken.

Unterschiede zwischen Branches untersuchen

Eines der Kernfunktionen der Versionskontrolle ist die Möglichkeit, parallel an unterschiedlichen Entwicklungsversionen zu arbeiten, die üblicherweise als "Branch" (Zweig) bezeichnet werden. Trac erlaubt, die Unterschiede zwischen verschiedenen Zweigen anzuzeigen.

Im TracBrowser führt der Button View changes ... zu einer Eingabemöglichkeit von Pfad/Revision-Angaben für From: und To:. Das Ergebnis zeigt die Veränderungen, die notwendig wären, um aus dem Zustand in From den Zielzustand in To zu erzeugen.

Als Arbeitserleichterung existiert der Link Reverse Diff auf der Changeset-Seite, welcher die Zuweisung von From und To vertauscht.

Letzte Veränderung untersuchen

Die letzte Möglichkeit zur Überprüfung von Änderungen ist der Link Last Change im TracBrowser.

Der Link führt zur letzten Änderung, die im aktuell angezeigten Pfad vorgenommen wurde. Von dort aus stehen wieder die Links Previous Change und Next Change zur Verfügung, um die Historie der Datei oder des Verzeichnisses zu verfolgen.

Weiterführende Informationen: TracGuide, TracBrowser

Übersetzt von Sven Rautenberg, SELFHTML e.V.

Diese deutsche Übersetzung der Original-Trac-Wikiseite ist lizensierbar unter Creative Commons BY-SA: Namensnennung, Weitergabe unter gleichen Bedingungen.