<html>
<head>
<title>Installation und Konfiguration</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="../styles/styles.css" type="text/css">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<h1>Installation und Konfiguration</h1>
<blockquote>
<p>Die Anwendung besteht aus einer jar - Datei, die in einem beliebigen Verzeichnis
abgelegt werden kann. Wenn P4 Client- Verzeichnis im Systempfad ist, braucht
man weiterhin nichts zu tun, ansonsten muss man dem Programm einen extra -
Startparameter mitzugeben, wo es nach Perforce suchen soll. Da es keine Nebenwirkungen
hat und am schnellstem ist, empfiehlt es sich das Programm einfach in das
P4 Client Verzeichnis zu kopieren (dann entfehlt ein Startparameter).</p>
<p>Für die korrekte Funktion des integrierten Diff - Werkzeuges muss das
frei verfügbares Programm ExamDiff™ von PrestoSoft™(<a href="http://www.prestosoft.com/examdiff/">http://www.prestosoft.com/examdiff/</a>)
im Systempfad liegen. Falls ExamDiff nicht im Systempfad liegt oder ein anderes
Diff - Werkzeug benutzt wird, muss die Anwendung entsprechend konfiguriert
werden (dazu später).</p>
<h2>Einrichtung vom Perforce - Client.</h2>
<p>Um die Anwendung aus dem Perforce Client starten zu können, muss man im
P4 Client unter <span class="code">Tools/Customize...</span> ein neues Tool
einrichten.<br>
Man klicke auf "<span class="code">Add</span>", dann irgendein Name
für den Menueintrag, dann "<span class="code">Ok</span>".<br>
Im Feld "<span class="code">Command:</span>" muss folgendes eingetragen
werden (eckige Klammern bedeuten, dass der Inhalt optional ist):</p>
<p class="code"><Pfad zu javaw.exe>javaw.exe -jar tp4branchview.jar</p>
<p>Falls javaw.exe im Systempfad ist, braucht man den Pfad zu javaw.exe nicht
einzugeben, es reicht also:</p>
<p class="code">javaw.exe -jar tp4branchview.jar</p>
<p><br>
Im Feld "<span class="code">Arguments:</span>" fügt man die
Startparameter des Programms ein, das sind im üblichem Fall (Erklärung
später):</p>
<p class="code">%D -all -stat</p>
<p>Im Feld "<span class="code">Initial directory:</span>" sollte Pfad
zum Verzeichnis stehen, wo tp4branchview.jar liegt, z.B.</p>
<p class="code">d:\programme\perforce</p>
<p>Nun klickt man auf "<span class="code">Ok</span>" und unter dem Menü
<span class="code">Tools</span> erscheint jetzt ein neuer Eintrag.</p>
<h2><br>
Startparameter und Konfigurationsdatei.</h2>
<p><br>
Die Anwendung erwartet folgende Parameter (Reihenfolge und Gross/Kleinschreibung
sind wichtig!):<br>
</p>
<table width="80%" border="0" cellspacing="2" cellpadding="3" bgcolor="#E5E5E5">
<tr align="center">
<td valign="top" bgcolor="#E5E5E5">Nummer der Parameter in der Kommandozeile</td>
<td valign="top" bgcolor="#E5E5E5">BranchView Parameter</td>
<td valign="top" bgcolor="#E5E5E5">Beschreibung</td>
<td valign="top" bgcolor="#E5E5E5">P4 Client Parameter</td>
</tr>
<tr valign="top" bgcolor="#FFFFFF">
<td align="center">1</td>
<td align="center"><Wert></td>
<td>P4 Benutzername</td>
<td align="center">$u</td>
</tr>
<tr valign="top" bgcolor="#FFFFFF">
<td align="center">2</td>
<td align="center"><Wert></td>
<td>P4 Clientname wie 'User-Hostname'</td>
<td align="center">$c</td>
</tr>
<tr valign="top" bgcolor="#FFFFFF">
<td align="center">3</td>
<td align="center"><Wert></td>
<td>P4 Serverport wie 'server_name.domain_name:port'</td>
<td align="center">$p</td>
</tr>
<tr valign="top" bgcolor="#FFFFFF">
<td align="center">4</td>
<td align="center"><Wert></td>
<td>P4 Dateipfad zu der gewünschten Datei wie '//a/b/c.txt'</td>
<td align="center">%D</td>
</tr>
<tr valign="top" bgcolor="#FFFFFF">
<td align="center">5, optional:</td>
<td align="center"><Wert></td>
<td>P4 Programmpfad wie 'c:\progra~2\perforce'</td>
<td align="center"> </td>
</tr>
<tr valign="top" bgcolor="#FFFFFF">
<td align="center">6, optional:</td>
<td align="center"><Wert></td>
<td>Benutzerkennwort</td>
<td align="center"> </td>
</tr>
<tr valign="top" bgcolor="#FFFFFF">
<td align="center">Optional:</td>
<td align="center">'-props'</td>
<td>um die Konfigurationsdatei statt Parameter zu benutzen. Falls die
Parameter durch die Property-Datei zu setzen sind, wird als <b>erster</b>
Parameter P4 Dateipfad zur gewünschten Datei wie '//a/b/c.txt'
erwartet, alle anderen können, müssen aber nicht mehr angegeben
werden, da sie aus der Konfigurationsdatei geladen werden.</td>
<td align="center"> </td>
</tr>
<tr valign="top" bgcolor="#FFFFFF">
<td align="center">Optional:</td>
<td align="center">'-stat'</td>
<td>Flag, um die filelog-Ausgabe in die Datei tp4branchview.log im Benutzerverzeichniss
auszugeben.</td>
<td align="center"> </td>
</tr>
<tr valign="top" bgcolor="#FFFFFF">
<td align="center">Optional:</td>
<td align="center">'-offline'</td>
<td>Flag, um die Quelle der Daten für die Anzeige auf den zuvor in
'tp4branchview.log' im Benutzerverzeichnis aufgezeichneten 'Logbuch'
des Komandos p4 -s [optionen] filelog -l -i [filepfad] zu setzen.</td>
<td align="center"> </td>
</tr>
<tr valign="top" bgcolor="#FFFFFF">
<td align="center">Optional:</td>
<td align="center">'-all'</td>
<td>Flag, um alle im Log gefundene 'branches' von P4 zu holen.<br>
</td>
<td align="center"> </td>
</tr>
</table>
<p> Diese und andere Parameter können der Anwendung über die Konfigurationsdatei
'tp4branchview.ini' übergeben werden, die im Benutzerverzeichnis liegen
soll, bei Windows NT: %SystemRoot%\profiles\%UserName%, bei Windows 2000:
%SystemDrive%\Dokumente und Einstellungen\%UserName%.</p>
<p>So sieht z.B. der Inhalt einer solchen Datei:</p>
<blockquote>
<p># Kommentar: das ist eine Kommentar - Zeile<br>
p4.user=Andy_the_Great<br>
p4.client=andy<br>
p4.port=1666<br>
p4.executable=p4.exe<br>
p4.password=xxxxxx<br>
p4.save_log=true<br>
p4.read_log_offline=false<br>
p4.fetch_all_branches=true<br>
p4.diff_exe_path=examdiff.exe</p>
</blockquote>
<p>Die Reihenfolge der Parameter entspricht hier der Reihenfolge der Parameter
in der Tabelle, kann aber willkürlich gewählt werden. Die Namen
der Parameter müssen mit den hier angegebenen 1:1 übereinstimmen.</p>
</blockquote>
</body>
</html>
| # | Change | User | Description | Committed | |
|---|---|---|---|---|---|
| #2 | 2222 | andrei_loskutov |
#13.10.2002 22:16 Revision 1.2.1 1) Documentation task is finished... Yes!!! 2) New feature: copy P4 depot path 3) Some small fixes to menu shortkeys belongs ctrl + c and ctrl + d 4) Clipboard fix because of JDK 1.2 - 1.3 bug 5) Smallest refactoring on some methods. 6) Html help updated |
||
| #1 | 1999 | andrei_loskutov | start english manual |