Gitk

Aus Siduction Wiki DE
Wechseln zu: Navigation, Suche

Vorbemerkung

gitk ist ein graphisches TCL/TK-Programm, das die Historie eines GIT-Repositories in verschiedenen Facetten anzeigt.

Installation

 apt-get install gitk

Aussehen

Gitk-screenprint.png

Legende

  • Rechts oben werden Commits als gefüllte Kreise dargestellt, gelb ist HEAD (jüngster Commit eines Branches), blau sind die anderen.
  • TAG-Namen werden als Schilder (Rechtecke mit Spitze) dargestellt, z.B. v0.1
  • Ein Branch ist mit einem Rechteck dargestellt, z.B. master.

Bedienung

  • Durch Anklicken eines Commits (einer Zeile im oberen Teil) wird im darunterliegenden Fenster die Info über diesen Commit angezeigt.
  • Durch Eintrag in das Suchfeld wird der passende Commit-Eintrag herausgesucht:
    • Suchkriterien sind Beschreibung, Dateien oder Änderungen
    • Als Bereich kann "Alle Felder", "Überschrift", "Beschreibung", "Autor" oder "Eintragender" eingestellt werden.
    • Als Optionen kommen "Exakt", "kein Groß/Klein" oder "Regexpr" in Frage.

Aufrufargumente

Aufruf: gitk [<options>] [revs] [--] [path] ...

Die die Argumente werden an git-rev-list weitergereicht. Dieses Programm sucht die anzuzeigenden Commits heraus.

Hinweis: Diese Argumente sind auch im Programm selber nachträglich einstallbar: Menü "Ansicht - Ansicht bearbeiten"

Hier sind einige der wichtigen erklärt:

<revs>

Hier kann man Revisionen (Commits) angeben, entweder einzeln oder als Bereich:

Beispiele

  • gitk v0.1..v0.2
  • gitk master^

<path>

Werden hier Dateien oder Verzeichnisse angegeben, werden nur Commits von den gelisteten angezeigt. Die Angabe eines Verzeichnisses bedeutet dessen Dateien.

--

Die Angabe von -- trennt Revisionen von Pfadangaben, da diese syntaktisch nicht unterschieden werden können.

--all

Standardmäßig wird nur der aktuelle Branch angezeigt, mit --all alle Branches.

--since=<date>

Es werden nur Commits angezeigt, die später als <date> getätigt wurden.

Beispiele:

  • gitk --since="2 weeks ago"
  • gitk --since=27.08.2011

--until

Es werden nur Commits angezeigt, die früher als <date> getätigt wurden.

Beispiele:

  • gitk --until="1 day ago"
  • gitk --until=25.08.2011/20:03