Allgemeine Darstellung von Versionsinformationen
Darstellung von erweiterten Versionsinformationen
Funktionentabele
Menüsteuerung: Beispiele
Maussteuerung: Kurzübersicht
Tastatursteuerung: Kurzübersicht
Darstellung von VersionsinformationenDas, was BranchView anzeigt, hängt eng damit zusammen, wie man BranchView konfiguriert.
Falls BranchView mit dem Parameter "-all" gestartet wurde, werden Informationen über sämtliche Versionen aus allen Branchen, die P4 Client zum eingegebener Datei/Verzeichnis bieten kann, geholt. Für die konstruierte Beispiel- Datei //depot/perforce/testroot/itest/Test.java sieht es dann so aus:
Bild 1: Darstellung nach dem Start mit dem Parameter "-all"
Jede Version ist durch ein grau gefülltes schwarz umrandetes Rechteck dargestellt.
Über den oberen Versionen steht der abgekürzter Pfad der Datei, die diese Versionen im P4 Depot haben.
Im Rechteck steht an ertster Stelle die Versionsnummer und daneben die Changenummer.
Dass die Versionen schwarz umrandet sind, bedeutet, dass sämtliche Versionsinformationen dem Programm vorliegen.
Von einigen Versionen gehen nach unten oder zu Seite Pfeile ab, die auf die Verbindung zu anderen Versionen aus dasselben Branch (grüner Schriftzug) oder dem anderen Branch (blauer Schriftzug) hinweisen.
Die Art der Verbindung (branch, edit, merge etc.) steht als Überschrift auf den Pfeilen.
Wäre BranchView stattdessen ohne Parameter "-all" gestartet, wurde man folgendes Bild sehen:
Bild 2: Darstellung nach dem Start ohne den Parameter "-all" Man sieht den Unterschied: es sind weniger Versionen Dargestellt, einige sind rot umrandet, andere orange und punktiert.
Die rot umrandeten Versionen enthalten ausserdem keine Changenummer, stattdessen ein Fragezeichen. Das heisst, dass die "roten" Versionen dem BranchView nur indirekt bekannt sind und die Informationen, die P4 lieferte, noch keine Changenummer enthalten haben.
Die "orangen" Versionen enthalten zwar alle Informationen über sich, aber es fehlen eventuell weitere Informationen über die nachfolgende Versionen aus dem selben Branch.
Wie bei den "roten", sind die Informationen über die "orangen" Versionen auf indirektem Weg gekommen.
Würde man nun auf einer dieser Versionen 2x klicken, werden die fehlende Informationen von Perforce geholt und wie im Bild 1 dargestellt.
Schliesst man nun BranchView und startet es im "offline" - Mode, versucht das Programm die alte Logdatei zu laden und darszustellen. Da aber jetzt die Informationen nur aus "zweiter Hand" sind, zeichnet BranchView alle Versionen orange bzw. rot umrandet.
Bild 3: Darstellung nach dem Start mit dem Parameter "-offline" Und im nächsten Bild sind sämtliche Arten der Vererbungsbeziehungen dargestellt, die BranchView kennt: branch, copy, ignored, merge, edit, integrate, delete.
Die Versionen, die gelöscht sind, zeigt das Programm rot durchgekreuzt.
Die Pfeile von Versionen, die beim integrieren "ignoriert" wurden, sind rot mit roten Spitzen.
Die durchgezogenen Linien bedeuten, dass es sich um eine direkte Vererbungsbeziehung zwischen den verbundenen Versionen handelt.
Punktierte graue Linien bedeuten nur die Zugehörigkeit der Versionen zum selben Branch.
Bild 4: Weitere Merkmale der Darstellung (nach dem Start mit dem Parameter "-all")
Darstellung von erweiterten Versionsinformationen
BranchView kann ausser den bereits gezeigten Informationen noch weitere darstellen. Geht man mit der Maus über eine der Versionen, zeichnet BranchView eine "ToolTip"- Hilfe, die weiterführende Informationen über die Version enthält:
Bild 5: Darstellung der erweiterten Informationen über eine "bekannte" Version Wäre diese Version BranchView noch nicht "bekannt", würde man folgendes sehen:
Bild 6: Darstellung der erweiterten Informationen über eine "unbekannte" Version Und so sieht ein Ausschnitt aus dem "Snapshot" von dem Public Depot von Perforce, wo aus einer Version gleich mehrmals integriert wurde (4 mal branch und ein mal copy):
Bild 7: Darstellung der erweiterten Informationen mit mehreren Integrate's im "offline" - Modus Hier sieht man sehr schön, dass im BranchView durch scrollen weitere Bildauschnitte sichtbar gemacht werden können, wenn nicht alle Versionen in ein kleines Fenster passen.
Funktionentabelle
Es gibt viele Funktionen, die auf drei unterschiedlichen Wegen erreichbar sind: Per Maussteuerung, Tastatur oder zwei Menüs, die durch 1x rechts klicken auf der Oberfläche erscheinen. Für fast jede Funktion existiert ein entsprechender Menüeintrag.
BranchView bietet zwei unterschiedliche kontextsensitive Menüs: Eins für die allgemeine Operationen und eins, das versionsbezogen ist. Falls ein Menüpunkt z.Z. nicht aktiviert ist (leicht grau), bedeutet es, dass diese Operation im aktuellen Kontext nicht möglich ist.
Menüpunkt Beschreibung der Funktion Besonderheiten /
aktiv wennTastatur- Kürzel oder Mausklick
Spezielles Version - Menüget info's for this branch Fordert von Perforce Informationen über den ausgewählten Branch Eine als "unbekannt" dargestellte Version muss angeklickt sein 2x links klicken get info's over all branches Fordert von Perforce Informationen über alle Branches, die z.Zt. nicht vollständig "bekannt" sind Eine Version muss angeklickt sein, und es muss mindestens eine Version als "unbekannt" dargestellt sein - diff to... Maussteuerung: durch Markierung der zwei Versionen naceinander wird automatisch ein vorkonfiguriertes Diff-Tool gestartet.
Menü: Zeigt ein Hinweis
Im "offline" - Modus nicht verfügbar.
Es kann keine "gelöschte" Version mit einer anderen verglichen werden.
1x "from" - Version links klicken und dann 1x "to" - Version links klicken copy info to clipboard Kopiert Informationen über die ausgewählte Version in die Zwischenablage Eine Version muss selektiert/angeklickt sein.
Ctrl + C - Kopiert die gesamte Logdatei in die Zwischenablage Es darf keine Version selektiert sein. Ctrl + C
Allgemeines Menüredo layout Strukturiert die Anzeige neu, dabei werden die Veränderungen an Positionen, die durch Benutzer durchgeführt wurden, verworfen Ctrl + R save as image... Bietet den Dialog zum speichern der Anzeige als ein GIF - Bild an Ctrl + S get/set properties... Öffnet ein Einstellungsdialog Die Einstellungen sind für alle zur Zeit geöffneten BranchView Fenster gültig Ctrl + P view another file... Menü: öffnet ein Dialog zum auswählen einer neuen Datei für die Anzeige. Dabei wird ein neues Fenster geöffnet.
Tastatur: die Pfadinformationen aus der Zwischenablage werden übernommen und die Anzeige wird mit diesem Pfad neu aufgebaut
Im "offline" - Modus nicht verfügbar.
Falls in der Zwischenablage ein ungültiger Pfad ist, und der Menüpunkt per Tastaturkürzel aktiviert wurde, wird ein Fehler angezeigt.
Ctrl + V - Öffnet ein neues Fenster mit der selben Ansicht Ctrl + N change logfile location... "Online" - Modus: wechselt den Pfad zu der Datei, in der die von P4 empfangene Daten gespeichert werden sollen
"Offline" - Modus: wechselt den Pfad zu der Datei, von der die Daten für die Anzeige stammen sollen, baut dann die Anzeige im selben Fenster neu auf
Strg + L zoom Verkleinert/vergrössert den Zoom Bei grösseren Bildausschnitten kann es lange dauern, bei zu grossen Werten kann bei vielen Versionen ( > 200 ) zum OutOfMemoryError führen
Ctrl + '+' zoom in
Ctrl + '-' zoom outx space Verkleinert/vergrössert den Abstand zwischen den einzelnen Branchen in der Anzeige. Bei zu grossen Werten kann bei vielen Versionen ( > 200 ) zum OutOfMemoryError führen - y space Verkleinert/vergrössert den Abstand zwischen den einzelnen Changes in der Anzeige. Bei zu grossen Werten kann bei vielen ( > 200 ) Versionen zum OutOfMemoryError führen - help Zeigt eine kurze online - Hilfe F1 about Zeigt einige Informationen über das System, Java- Laufzeitumgebung, Programmversion und Autor Ctrl + A
Menüsteuerung: Beispiele
So z.B. kann man über eine "unbekannte" Version folgendes Menü bekommen, wenn man mit der Maus 1x rechts klickt:
Bild 8: Spezielles Menü bei nicht "bekannter" Version
Gleiches über eine "bekannte" Version erzeugt folgendes Menü (beachte den ersten Eintrag): hier sind die Informationen über die Branch ITEST bereits komplett und deswegen der Menüeintrag, der die Informationen über diese Branch holen soll, deaktiviert.
Bild 9: Spezielles Menü bei "bekannter" Version
Hier sind die Informationen über alle Branchen bereits komplett und daher sind beide Menüeintrage zum Anfordern der Daten von Perforce deaktiviert.
Bild 10: Spezielles Menü wenn alle Versionen "bekannt" sind
Hier sieht man die Wirkung des "redo layout" Menüeintrages: bevor ...
Bild 11: Darstellung vom Benutzer verändert
.. und danach.
Bild 12: Vom Benutzer veränderte Darstellung zurückgesetzt und neu strukturiert
BranchView bietet ausserdem die Möglichkeit, die Anzeige aktuellen Bedürfnissen anzupassen, indem die Abstände zwischen den Branchen und/oder Changes verändert werden ("x" bzw. "y space" -Schieber).
Verglichen mit dem Bild 8 ist die nächste Anzeige kompakter.
Bild 13: Veränderung der Abstände auf der X- Achse
Und nun auch die Y -Achse:
Bild 14: Veränderung der Abstände auf der Y- Achse
Hier wurden Zoom, x und y Abstände erhöht.
Bild 15: Veränderung des Zooms, X und Y Abstände
Falls man eine Version 1x links anklickt, wird diese "selektiert" Dargestellt, und eine dünne Linie verfolgt die Maus. Das bedeutet, dass die erste Version für den Diff -Tool ausgewählt wurde und nun eine zweite Version angeklickt werden muss.
Bild 16: Start der Auswahl von Versionen für das Diff - Tool
Nun ist die zweite Version selektiert, es wird automatisch ein vorkonfiguriertes Diff -Tool gestartet.
Um diese Markierung später zu löschen, reicht es, einfach mit der Maus irgendwo im lehrem Feld oder auf die Ausgangsversion 1x links zu klicken.
Bild 17: Ende der Auswahl von Versionen für das Diff - Tool
Im Konfigurationsdialog kann man sämtliche Laufzeitparameter von BranchView festlegen.
Bild 18: Konfigurationsdialog
Tastatursteuerung: Kurzübersicht
STRG + N öffnet ein neues Fenster
STRG + V öffnet ein neues Fenster, wenn im Clipboard ein P4 Pfad ist
STRG + C kopiert Informationen nur über die ausgewählte Version in die Zwischenablage
STRG + C kopiert gesamte P4 Ausgabe in in die Zwischenablage, wenn keine Version ausgewählt ist
STRG + S öffnet ein Dialog zum Speichern als GIF-Grafik
STRG + R strukturiert die Anzeige neu
STRG + P öffnet ein Dialog mit Einstellungen
STRG + L öffnet ein Dialog zum ändern der Logdatei
STRG + '+' vergrössert Zoom
STRG + '-' verkleinert Zoom
'Pos 1' springt nach ganz oben
'Ende' springt nach ganz unten
F1 zeigt diese Hilfe
Maussteuerung: Kurzübersicht
2x links klicken auf eine Version holt evt. fehlende Daten von Perforce.
1x links klicken markiert die erste Version für den Diff-Tool, (gelöschte Versionen können nicht verglichen werden!) jede andere Version, die dann 1x angeklickt wird, wird die zweite Version für den Diff-Tool.
1x klicken auf den Hintergrund löscht die aktuelle Markierung.
1x links klicken und ziehen auf eine Version verschiebt nur diese eine Version
1x links klicken und ziehen auf den Hintergrund scrollt die Ansicht
1x links klicken + CTRL + SHIFT halten und ziehen auf eine Version verschiebt ganzes Bild.
1x rechts klicken, (oder 1x links klicken + CTRL halten) und ziehen auf eine Version verschiebt ganzes Branch.
1x rechts klicken auf den Hintergrund öffnet ein allgemeines Menü.
1x rechts klicken auf eine Version öffnet ein Version-spezifisches Menü.