From 99cf3d7a3bd57059d7537e16aac53923a096fe01 Mon Sep 17 00:00:00 2001
From: Matthias Sohn <matthias.sohn@sap.com>
Date: Sat, 29 May 2010 01:03:04 +0200
Subject: [PATCH] Describe how to generate iplog.

Change-Id: I91f249422efbb6aea0491e276ccfe00f5ae7d212
Signed-off-by: Matthias Sohn <matthias.sohn@sap.com>
---
 org.eclipse.jgit.iplog/README | 54 +++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 org.eclipse.jgit.iplog/README

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