Describe how to generate iplog.

Change-Id: I91f249422efbb6aea0491e276ccfe00f5ae7d212
Signed-off-by: Matthias Sohn <matthias.sohn@sap.com>

diff --git a/org.eclipse.jgit.iplog/README b/org.eclipse.jgit.iplog/README
new file mode 100644 (file)
index 0000000..8ea3233
--- /dev/null
+++ b/org.eclipse.jgit.iplog/README
@@ -0,0 +1,54 @@
+# -----------------------------------------------------------\r
+# This document describes how to generate the Eclipse ip log\r
+# for the eclipse project technology.jgit using a local clone\r
+# of the git repository\r
+#     git://egit.eclipse.org/jgit.git\r
+# starting point is a manually written file\r
+#     .eclipse_iplog\r
+# located in the repository's work dir root path\r
+# which is describing the project, see first section of this\r
+# file in the jgit root directory:\r
+#     $JGIT_BASE/.eclipse_iplog\r
+# -----------------------------------------------------------\r
+# Prepare:\r
+# jgit work tree base dir\r
+export JGIT_BASE="c:/data/ide/helios/jgit"\r
+\r
+# repository work dir root path\r
+export WORK_DIR="c:/data/ide/helios/jgit"\r
+\r
+# cd to repository work dir root path (for jgit this is identical to $JGIT_BASE)\r
+cd $WORK_DIR\r
+\r
+# -----------------------------------------------------------\r
+# Update the CQ list:\r
+# - this command updates file .eclipse_iplog\r
+java -jar $JGIT_BASE/org.eclipse.jgit.pgm/target/jgit-cli.jar eclipse-ipzilla\r
+\r
+# - if there are any updates 'git commit' them\r
+git add .eclipse_iplog\r
+git commit\r
+\r
+# - type in ipzilla user and password\r
+\r
+# -----------------------------------------------------------\r
+# Get the committer data from gerrit:\r
+# - start gerrit gsql via ssh\r
+# options:\r
+#     -p : ssh port gerrit is listening on\r
+ssh -p 29418 username@egit.eclipse.org gerrit gsql --format PRETTY\r
+\r
+# - type in ssh passphrase for your ssh key\r
+# - run the SQL query (cut and paste content to interactive gerrit shell)\r
+#      org.eclipse.jgit.iplog/src/org/eclipse/jgit/iplog/gsql_query.txt\r
+# - copy the query result into the file (no headers, no blank lines):\r
+#      $WORK_DIR/.git/gerrit_committers\r
+\r
+# -----------------------------------------------------------\r
+# Generate the iplog:\r
+# options:\r
+#     -- version : the project version the iplog is to be generated for\r
+#     - o : the output file\r
+java -jar $JGIT_BASE/org.eclipse.jgit.pgm/target/jgit-cli.jar eclipse-iplog --version=0.8.0 -o jgit-0.8.0.xml\r
+\r
+\r