Initially, TkP4 is just a clone of p4win.exe for UNIX (it might also
run on NT someday).
There are some added extras, such as one-step macros (or guided
wizards) for such multi-step activities as renaming files. More will
be added.
=======
Startup
=======
usage: tkp4 -p P4PORT -c P4CLIENT -u P4USER -P P4PASSWD -H P4HOST
Precedence of setup values starting with the highest:
- command line args: -p P4PORT -c P4CLIENT -u P4USER -P P4PASSWD -H P4HOST
- environment variables: $P4PORT $P4CLIENT $P4USER $P4PASSWD $P4HOST
also checked: user=$USER or $USERNAME
host=$HOSTNAME
- internal defaults: host=Tcl command [info hostname]
TkP4 maintains a list of servers that you can define and edit. If no
startup P4PORT is found as above, then the server dialog is presented
for choosing a server. If only one server is configured, it will just
connect to it. If the server config includes a client name, it is used
unless a P4CLIENT is found found above.
==========
Using TkP4
==========
Since TkP4 is mostly identical to p4win, there is no tkp4
documentation other than this file. Watch the main menu Help/Changes
item for updates. The Help/P4WinDifferences item is useful if you are
familiar with using P4Win.
Throughout TkP4, the popup menus on the right mouse button are context
sensitive. Clicking on directories or Changelists gives different
options than does clicking on files. Clicking on files gives different
options depending on whether they're checked out, locked, you have the
latest revision, etc.
TkP4 Wizards
------------
o File Rename
You can rename individual files, choose files from a directory, or
rename all files in a directory. This is done from the Rename option
of the popup menu in the Depot pane.
The usual restrictions exist:
- you cannot rename files that are currently open.
- you cannot rename files to target names that exist, even if the
target name has been deleted.
Here are features and functions that are not so obvious:
--------------------------------------------------------
o If a p4 command (such as a sunc) runs longer than a few seconds a
"Please Wait" dialog is presented that has a "Cancel Command"
button.
o Toolbar buttons for changing the Depot Pane view.
The first three buttons in the toolbar change the view between the
Entire Depot, Client, and Workspace. The Workspace view is like
an Explorer view that shows the local directory starting from the
top of the workspace "root" directory. Adding files to Perforce
is done from the Workspace view.
o Adding files to your Client.
The only way to add files to your client from within TkP4 is through
the Workspace View. Right-click on a directory or file and a dialog
is presented with all files not already managed by Perforce.
o Menu option "View/Changelists-Submitted-Filtered".
This filters or restricts the Changelist View to contain only
those changelists that include the file or directory that is
selected (highlighted in blue) in the Depot Pane view.
o Multi-column listboxes.
You can sort columns increasing and decreasing by clicking the
column headings. Click and drag the column heading separator
bars to resize columns.
o In the Revision History window:
- you can sync the client to any revision of the file.
- you can diff any two revisions by highlighting them
(click one, then CTRL-click the other) then click
the "Diff Revs" button.
o Reverting Files.
There are Depot directory and Pending Changelist revert functions
on the pop-up menus where you get to choose which files to
revert. This is somewhat in lieu of the current lack of multiple
selection support in the Depot and Pending pane tree widget.