A brief overview of P4QTree
LEGEND (Old-School color scheme)
Gray bar at top: changelists, given in numerical(chronological) order.
Beige bar at top(if present): jobs, fixed by the changelists they appear under.
Stripes: Depot files. Name is at bottom left of the stripe.
Green: this is the file that you invoked P4QTree on.
(other stripes alternate gray and beige)
Circles: revisions of depot files, labeled with rev #.
White: an "add" or a "branch".
Gold: an "edit".
Blue: an "integ".
Black: a "delete".
Arrows: relationships between revisions.
Solid: sole contributor.
Medium: one of multiple contributors.
Dotted: not really a contributor.
Black: indicates progression within one file.
Yellow: a pure branch point.
Blue: a copy.
Purple: a pure merge.
Green: an ignore.
Red: an impure or downgraded merge or branch.
INTERFACE
Use scrollbars to view large graphs. The change and job bars maintain a
constant vertical position, while synchronizing their horizontal scrolling
with the rest of the graph.
Menu items (each has a simple shortcut key):
Close: duh.
Toggle Jobs: remove/show job bar, if enabled.
Branching-Only View: pop up a condensed view of the same graph.
About P4QTree: also duh.
Double-click on graph items for info dialogs:
Changelists
Jobs
File names
Circles
Drag 'n drop circles into each other to get a diff (P4DIFF/P4DIFFBIN used if set).
INTERACTION WITH OTHER PROGRAMS
Command line:
You may invoke "p4qtree" from the command line with the
same global options you would give any p4 command. P4CONFIG files and
env/reg settings are detected as normal. Run "p4qtree -h" for usage notes.
P4Win:
Drag 'n drop from P4QTree into P4Win to find the item you dragged.
(Example: drag a changelist from P4QTree into P4Win's
Submitted Changelist pane, and it will be highlighted
if it exists there. Ditto for jobs into the Jobs pane,
and files/revisions into the Depot pane.)
SQUID/other binary diff:
Set P4DIFFBIN to the name of your binary diff program, eg SQUID, and it will
be used whenever the target of a diff drag is binary.
Misc:
Drag 'n drop is in plain text format and can be dragged into any
application which supports text drops. This includes most modern
text editing programs (email, word processing, etc). (Unfortunately,
I haven't yet found a terminal program that handles this, or it'd be
great for dragging to the command line.)